注意

Cleanroom的安装器和Forge相比并无任何变化，因此任何适用于 Minecraft Forge 的安装方法同样适用于 Cleanroom。同时，因为一样的原因，Cleanroom的安装器仅支持传统基于.minecraft文件的启动器。

对mmc系启动器的支持已初步完善，请查看文中各个与MMC系启动器相关的章节。


下载

通用安装器

  1. 从相关链接打开项目GitHub页面。

  2. 查看页面右边栏，会有一个名为Releases的版块，名字下方即为最新的发布版本。

Cleanroom安装教程-第1张图片示例，Releses在右下角

  1. 点击进入，往下滑动到Assets部分，其中会有数个文件。

  2. 找到以installer结尾的jar文件，文件名格式通常为 cleanroom-{版本号}-{可能的额外标记}-installer.jar ，此即为下一步需要的安装器。

Cleanroom安装教程-第2张图片示例，目标是cleanroom-0.2.1-alpha-installer.jarMMC系启动器特有

CleanroomMMC项目为MMC系启动器提供了特别支持，你可以在上文提到的Releases页面直接下载mmc实例压缩包，无需下载installer。实例压缩包文件名格式会为 Cleanroom-MMC-instance-{版本}-{可能会有的额外标记}.zip，比如 Cleanroom-MMC-instance-0.2.1-alpha.zip 。

由于存放相关运行库的服务器为私人搭建，可能出现多线程时无法下载、服务器暂时下线等状况。如果多次重试仍无法解决问题，请到Discord反馈。


安装

通用

  1. Windows用户可尝试双击运行，也可尝试寻找Java安装目录下的javaw.exe并在终端中运行javaw -jar cleanroom-版本号-installer.jar。

  2. 选择你.minecraft文件夹目录，确定安装。此安装方式无法兼容mmc系启动器

  3. 进入启动器，设置合适的jre，之后可尝试启动。Cleanroom是为更现代的Java（比如Java21）而非Java8设计的，不要用Java8启动。


MMC系启动器

包括MMC自身即MultiMC，以及衍生启动器，比如Prism Launcher。这些启动器使用的文件结构与Mojang官方使用的文件结构不同，因此不能用上一节提供的方法。

下载实例压缩包后可直接解压到实例文件夹，也可通过导入压缩包安装。安装后可能需要重新设置Java目录。如果想将现有实例升级为Cleanroom，则只能通过解压安装，安装时需注意保留原来的instance.cfg。


HMCL提供的快速安装

HMCL是少有的实现了快速简便更换模组加载器的功能，并允许从本地文件加载对应安装器Jar的启动器。由于 Cleanroom 的安装器与 Forge 的安装器是一致的，所以可以借用 HMCL 提供的功能快速安装。

如下图，直接把安装器拖入一个 1.12.2 实例的“自动安装”窗口即可，不过此安装方式可能在部分HMCL版本失效。通过上方的“从本地文件安装/升级”安装同样有效。

Cleanroom安装教程-第3张图片

额外步骤

  1. 如果你使用的是HMCL启动器，请按以下顺序操作：游戏管理->启用游戏特定设置->修改高级设置，将不添加默认JVM参数、不检查游戏完整性、不检查JVM兼容性、不尝试自动替换本地库打开。

  2. 如果仍有错误，请尝试生成启动脚本，然后在脚本中将lwjgl2.9.4/51.2版本的ICU4J/老版本OSHI的几项删掉。这些是mojang启动器逻辑的遗留，有概率影响游戏运行，但未找到办法去除。

  3. 对于其他所有启动器，妨碍启动的原因一般是2，具体解决方法请咨询启动器作者。

Cleanroom仍在开发中，不兼容属正常现象！