迁移整合包

概述

Cleanroom Loader 与绝大多数 Forge 模组兼容，通常可以直接运行而无需额外操作。
然而，部分模组仍属于已弃用、冗余或完全不兼容的范畴——这要么是因为它们已被更好的替代品取代，要么是因为它们会引发严重问题。
为了让整合包适配 Cleanroom Loader，请查阅以下列表并在必要时进行替换。

注意

提示：如果想要自动化此过程，可以使用 Barebones Template 构建/更新整合包，这是一个极简的优化模板。它包含 PackCompanion，一个运行时分析工具，可以扫描实际模组列表并生成针对性的报告，标记有问题或已弃用的模组，并附带自定义脚本以将其从实例中彻底移除。

Cleanroom Launcher 上不兼容/有问题的模组

模组	原因	操作
AdvancedShader	二进制补丁，不兼容。	🚫 移除
Essential.gg	虽已打补丁，但仍会导致许多问题。	✅ 使用 Lan UPNP (非代理选项) 或 E4MC Retro (代理选项)
FoamFix	已过时，且在 Cleanroom 环境中容易引发问题	✅ 使用 VintageFix
Mouse Tweaks	已过时，容易引发问题	✅ 使用 Mouse Tweaks Unofficial
Phosphor	不兼容	✅ 使用 Alfheim Lighting Engine / Hesperus
Polyfrost系列	等待官方修复。	—
原始鼠标输入或类似模组	已包含在 Cleanroom 中。	🚫 移除
Secret Rooms	更新器存在问题	🚫 在配置文件中禁用更新检查器
SerializationIsBad	冗余。现代 Java 版本已修复了该模组解决的问题	🚫 移除
TexFix	已合并并重写到 CensoredASM	✅ 使用 CensoredASM
VanillaFix	已合并到 CensoredASM 并进行改进	✅ 使用 CensoredASM
Sound Physics	ASM 不兼容	✅ 使用 Sound Physics Remixin
Custom Loading Screen	与新版的 GSON 不兼容	✅ 使用来自此 Issue 页面的构建版本
UltimateStack	ASM 不兼容	✅ StackUp! 应能在大多数情况下替代此模组
The One Probe	无人维护	✅ 推荐使用 The One Probe Community Edition
Baubles	无人维护	✅ 推荐使用 Bubbles
Shadowfacts' Forgelin	无人维护	✅ 使用 Forgelin-Continuous 替代

WARNING

如果整合包使用了 Bansoukou 4，请务必在安装 Cleanroom Loader 之前至少运行一次实例，以便应用其补丁。

性能/内存优化模组

对于 Minecraft 1.12.2 最重要的优化模组总结如下：

CensoredASM：针对 Minecraft 1.12.2 的巨大优化。
VintageFix：改善 Minecraft 1.12.2 的加载时间和内存使用。
Universal Tweaks：一个社区项目，旨在将各种错误修复和调整整合为 Minecraft 1.12.2 的统一解决方案。
Stellar Core：提供广泛的错误修复、性能改进以及跨多种模组的附加功能。
Gnetum：通过将 HUD 更新分散到多帧来提升性能。
Fixeroo：包含了错误修复和经验球优化。
Alfheim Lighting Engine：更好的mc光照引擎实现，进行了性能优化并且修复了诸多漏洞。

注意

Universal Tweaks 取代了许多模组，因此这里不再赘述。您可以通过游戏内警告或查看 不兼容模组列表 来确认这一点。

渲染优化模组

对于 Minecraft 1.12.2 最突出的渲染优化整合包括：

Optifine (建议搭配 OptiNotFine 使用)
Celeritas (需要 Cleanroom Loader，并且在与 CensoredASM 同时使用时需要确保使用 CensoredASM 5.30+ 版本)
Nothirium (同时需要 Naughthirium)

注意

Celeritas 和 Nothirium 会降低内存占用并改进整体内存负担，而 Optifine 可能会增加内存占用并延长加载时间。

压力测试结果

在模拟的高负载基地场景中，我们对上述模组进行了基准测试，并根据使用的 GPU 对其性能进行了排名：

NVIDIA GPU → Nothirium > Optifine > Celeritas
AMD GPU → Celeritas > Optifine > Nothirium
Intel 集成显卡 → Nothirium > Optifine > Celeritas

注意

性能因硬件和驱动程序而异。请测试所有三个模组，以确定哪个能在操作系统上提供最佳效果。

MCreator 和 AI 生成的模组

使用 MCreator 制作的 1.12.2 模组强烈不推荐使用，无论是什么类型的模组。MCreator 在 1.12.2 已不再正式支持，使用其创建的模组存在严重的问题，例如未优化的代码、硬编码 ID、NBT 数据损坏以及难以调试生成的代码。可以使用 Crash assistant 或 MCreatorDetector 来快速找出哪些模组是 MCreator 制作的。

完全使用 AI 生成的代码（而非作为学习工具）创建的模组也强烈不推荐使用，其代码质量参差不齐（通常较差），且容易出现崩溃或毫无作用，尤其是性能优化相关的模组。

注意

如果您是模组开发新手并想开始制作模组，我们强烈建议从头开始制作模组，以避免学习过程中遇到复杂的麻烦。
您可以加入我们的 discord 服务器从中获得关于模组开发的支持。

已被取代的模组

注意

这些模组不一定与 Cleanroom Loader 冲突，但已被更新的分支取代，或者不再有任何优势，因此我们建议您遵循我们的推荐操作。对于以下未列出的分支，请记住，并非所有分支都是更好的。某些分支引入了原模组中没有的额外漏洞，有些分支主要是针对于某个整合包打造的，还有些分支是由于与原模组开发者的内部冲突而分叉的。请自行决定是否使用这些分支。

库模组 (Library Mods)

模组	原因	推荐操作
Baubles	已过时	✅ 使用 Bubbles 如果出现不兼容问题，请在此报告或回退到 Baubles。请自行决定使用此处未列出的其他 Baubles 或 Bubbles 分支，因为它们有很多！
Custom Mob Spawner	会破坏几乎所有其他模组的生物生成	🚫 移除
Forgelin	已过时	✅ 使用 Forgelin-Continuous
LibrarianLib	无法与 Forgelin-Continuous 正常配合工作	✅ 使用 LibrarianLib-Continuous (可能会破坏 Wizardry 动画，若存在请回退到 LibrarianLib + Forgelin)
MixinBootstrap	使用最新版 MixinBooter 时不需要。	🚫 移除
Mixin 0.7-0.8 Compatibility (MixinCompat)	使用最新版 Mixinbooter 时不需要	🚫 移除
OpenModsLib	已合并到 OpenBlocks Reopened，没有其他模组需要它。	✅ 使用 OpenBlocks Reopened
Patchouli	已过时	✅ 使用 Patchouli ROFL Edition 如果出现不兼容问题，请回退到 Patchouli。

内容模组 (Content Mods)

模组	原因	推荐操作
AcademyCraft	已弃用	✅ 使用 Academycraft UES
Advanced Rocketry	过时且充满漏洞	✅ 使用 Advanced Rocketry - Reworked
Aether II	打包了 Phosphor，导致与 Alfheim Lighting Engine / Hesperus 不兼容	✅ 使用 Aether II: Phosphor Not Included
Aetherium Ashen Armor	已合并到 Aetherworks Unofficial Extended Life	✅ 使用 Aetherworks Unofficial Extended Life
Aetherworks	已过时	✅ 使用 Aetherworks Unofficial Extended Life
Alchemistry	已过时	✅ 使用 Alchemistry - Redox
Applied Energistics 2	已过时	✅ 使用 AE2 Unofficial Extended Life
Avaritia 1.1x / Avaritia 1.1x Kedition	Avaritia 1.1x：已过时 Avaritia 1.1x Kedition：主要添加了模组集成的替代分支。Avaritia 1.1x Unofficial Extended Life 拥有更多内容和修复，同时保留了大部分模组集成。	✅ 使用 Avaritia 1.1x Unofficial Extended Life
Better Questing	已过时	✅ 使用 Better Questing Unofficial
Better Questing - Quest Book / Better Questing Triggerer	已在 Better Questing Unofficial 中重新实现。	✅ 使用 Better Questing Unofficial
Better Questing - Standard Expansion	已合并到 Better Questing Unofficial。	✅ 使用 Better Questing Unofficial
Binnie's Mods	已过时	✅ 使用 Binnie's Mods Patched
BitHop	已过时	✅ 使用 QBitHop
Bloodmoon	存在性能问题，其事件光照与 OptiFine 不兼容（除非使用非官方补丁）。Hyxcate 的事件光照无需任何补丁即可与 OptiFine 兼容，且性能更优。	✅ 使用 Hyxcate
Classic Bars	已过时	✅ 使用 Classic Bars Legacy
Crimson Revelations	已过时	✅ 使用 New Crimson Revelations
Davinci's Vessels	已过时	✅ 使用 Valkyrien Skies
Deadly Monsters	已过时	✅ 使用 Deadly Monsters Patched
Dynamic Trees	已过时	✅ 使用 Dramatic Trees
Earthworks	已过时且被 CurseForge 标记为弃用	✅ 使用 Earthworks Unofficial Extended Life
Embers/Embers Rekindled	已过时，可能引发问题	✅ 使用 Embers Unofficial Extended Life 如果出现不兼容问题，请回退到 Embers Rekindled。
Engineered Golems	已合并到 Congrega Mystica 并修复了漏洞	✅ 使用 Congrega Mystica
Expanded Arcanum	已合并到 Congrega Mystica 并修复了漏洞	✅ 使用 Congrega Mystica
Mekanism	已过时	✅ 使用 Mekanism-CE-Unofficial 或 Mekanism Community Edition
MmmMmmMmmMmm (Target Dummy)	该模组已被完全重写。2.0.0 及以上版本存在更多问题，且通常比原始的 1.14 版本更不稳定。	✅ 使用 MmmMmmMmmMmm 1.14
Mo' Creatures	已过时，需要 Custom Mob Spawner 且存在 numerous 破坏游戏的漏洞	✅ 使用 Mo' Creatures Extended
Modular Machinery	已过时	✅ 使用 Modular Machinery: Community Edition
MrCrayfish's Furniture Mod (Legacy)	已过时	✅ 使用 MrCrayfish's Furniture Mod Rebuilt
Mutant Beasts	已过时	✅ 使用 Mutant Creatures Legacy
Natura	已过时，影响性能	✅ 使用 Natura Legacy
Nature's Aura	已过时，影响性能	✅ 使用 Nature's Aura Simplified
Nyx / Nyx: RotN Edition / Xyn	Nyx：已过时 Nyx: RotN Edition / Xyn：Nyx 的分支，差异较小。	✅ 使用 Hyxcate
Oh The Biomes You'll Go / Biomes You'll Go Fixed	MCreator 制作，存在大量漏洞（与 1.12.2 之后的版本不同）。请改用其他生物群系模组。	🚫 移除
OpenBlocks	已过时	✅ 使用 OpenBlocks Reopened
Pillar	已过时	✅ 使用 Pillar Patched
Railcraft (Release version)	该模组已弃用，且最新 beta 版本包含更多错误修复	✅ 使用 Railcraft Beta
Random Things	已过时	✅ 使用 Quantum Things
RPGLoot	已过时	✅ 使用 RPGLoot Patched
Rustic Thaumaturgy	已合并到 Congrega Mystica 并修复了漏洞	✅ 使用 Congrega Mystica
Seared Ladder (Backport)	已合并到 Tinkers' Antique	✅ 使用 Tinkers' Antique
Soot	已过时	✅ 使用 Soot Unofficial Extended Life
Soul Shards Respawn	已过时	✅ 使用 Soul Shards Respawn Patched
Straw Golem	已过时且不再在 CurseForge 上提供。	✅ 使用 Straw Golem Unofficial Extended Life
Techguns	已过时且未完成	✅ 使用 Techguns-CE
Thaumic Wonders / Thaumic Konders	已过时	✅ 使用 Thaumic Wonders Unofficial
Thicc Entities	已过时，会与 Aqua Acrobatics 崩溃	✅ 使用 Entifier
Tinkers' Arsenal	已过时且不再在 CurseForge 上提供	✅ 使用 Tinkers' Arsenal Reloaded
Tinkers' Construct	已过时	✅ 使用 Tinkers' Antique
Tough Expansion	存在 RCE 漏洞	✅ 使用 Survival Tools
Twilight Forest	已过时	✅ 使用 Twilight Forest: Deforestation Edition
Wizardry	最新版本会导致不兼容	✅ 使用 Wizardry 0.11.1

性能优化模组 (Performance Mods)

模组	原因	推荐操作
!!Pigium - Performance	并非真正的优化模组。它是为了吸引用户观看 YouTube 视频而制作的。	🚫 移除
Better Biome Blend / Betterer Biome Blender	未提供有意义的改变	🚫 移除
BetterFPS	破坏核心功能。	🚫 移除
Clumps	已过时	✅ 使用 Fixeroo
Farsight	几乎不起作用，只是将 `unloadChunk` 从 `ChunkProviderClient` 移到 `tick`，并无限缓存区块，可能会影响内存使用	🚫 移除
FastFurnace	已合并并重写到 CensoredASM	✅ 使用 CensoredASM
FastWorkbench	已合并并重写到 Universal Tweaks	✅ 使用 Universal Tweaks
FermiumASM / BlahajASM	CensoredASM 的克隆版，禁用了 Dynamic Trees 的修复且依赖 FermiumBooter。	✅ 使用 CensoredASM
FPS Boost	无任何益处。	🚫 移除
GPU Tape	无任何益处。	🚫 移除
Multithreaded Noise	已知会导致崩溃，不推荐使用。	🚫 移除
Neonium	过时的 Vintagium 克隆版，参见渲染优化模组	🚫 移除
NormalASM	CensoredASM 的过时分支，无实质性变化。	✅ 使用 CensoredASM
Performant	空 jar 文件，不起任何作用。	🚫 移除
Redirectionor	未提供真正的性能提升。	🚫 移除
Relictium	过时的 Vintagium 克隆版，参见渲染优化模组	🚫 移除
Spark / Spark Unforged	Spark: 已过时 Spark Unforged: 现代 Spark 的回移植版，但移除了一半的功能。	✅ 使用 Flare
Surge	使用已弃用的方法，完全未提升性能	✅ 使用 Universal Tweaks

辅助优化模组 (QoL Mods)

模组	原因	推荐操作
AppleSkin	已过时	✅ 使用 LemonSkin
AttributeFix	已合并并重写为 Universal Tweaks	✅ 使用 Universal Tweaks
Bed Patch	修复已包含在 Forge / Cleanroom Loader 中，安装后不起作用。	🚫 移除
Better Foliage / RLFoliage	导致大量不兼容和性能问题	🚫 移除
Born in a Barn	修复已包含在 Forge 中，安装后不起作用	🚫 移除
Crafting Tweaks	已过时	✅ 使用 Crafting Tweaks Unofficial
DupeFix Project	与 MixinBooter 不兼容	✅ 使用 Universal Tweaks
Eigencraft Unofficial Patch / MUP	已过时，会导致与其他模组不兼容	✅ 使用 Universal Tweaks
Fireproof Items	Future Fireproof 拥有更好的实现和 API 功能。	✅ 使用 Future Fireproof
Hot or Not	已过时	✅ 使用 Hot or Not Plus
Immersive Craft	已过时	✅ 使用 Immersive Craft Patched
Just Enough Characters	已过时	✅ 使用 Had Enough Characters
JustEnoughIDs (JEID) / NotEnoughIDs (NEID)	已过时	✅ 使用 RoughlyEnoughIDs (REID)
JustEnoughItems (JEI)	已过时	✅ 使用 HadEnoughItems (HEI)
MiniEffects	已过时	✅ 使用 MiniEffects-Legacy Extended Life
Mod Director	已过时且不再在 CurseForge 上提供。	✅ 使用 FileDirector
NetherPortalFix	已在 Universal Tweaks 中重写实现	✅ 使用 Universal Tweaks
Paintings ++	设置复杂且不太用户友好。建议同时使用 JSON Paintings 和 Painting Selection GUI，以获得更好的体验。	✅ 使用 JSON Paintings 和 Painting Selection GUI
RandomPatches	已知会导致崩溃。	✅ 使用 Universal Tweaks
RandomTweaks	已知与某些模组一起会导致崩溃。Universal Tweaks 涵盖了其大部分功能。	✅ 使用 Universal Tweaks
SmoothFont	会破坏某些模组。	🚫 移除
Thaumic Fixes	仅修复一个 bug 且可能与其他模组不兼容	✅ 使用 Thaumcraft Fix
Thaumic Meme	ThaumicTweaker 已经包含了类似的研究字幕功能，且实现更优。	✅ 使用 ThaumicTweaker
ThaumTweaks	过时且有问题的模组，会导致与其他模组不兼容	✅ 使用 ThaumicTweaker
Tinker's JEI	Tinkers' Antique 已经包含完整的 JEI 材料支持。虽然两者可以同时使用，但建议移除以避免重复功能。	✅ 使用 Tinkers' Antique
Tips	已过时	✅ 使用 AnotherTips

必备推荐 (Should Have)

一系列辅助模组，可进一步提升您与其他模组搭配的体验

模组	原因	推荐操作
AtomicStryker's Battle Towers	存在大量漏洞	✅ 添加 Battle Towers Fixes
Balkon's WeaponMod: Legacy	缺乏模组集成。	✅ 添加 Balkon's Expansion
HadEnoughItems (HEI)	部分模组与 HEI 界面存在重叠问题	✅ 添加 JEI Area Fixer
IC2 EXP	存在大量漏洞	✅ 添加 IC2 Patcher
Industrial Foregoing	存在大量漏洞	✅ 添加 IFPatcher
Just Enough Resources (JER)	缺乏模组集成。	✅ 添加 Just Enough Magiculture
Mowzie's Mobs	可选的 Baubles 集成。	✅ 添加 Mowzie's Mobs' Baubles 请确保使用 Mowzie's Mobs 的最新 beta 版本，否则会崩溃！
Patchouli ROFL Edition	可选的模组集成和体验提升。	✅ 添加 Patchouli Books
Railcraft	存在大量漏洞	✅ 添加 Railway Depot Worker
Thaumcraft 6	存在漏洞且缺乏集成	✅ 添加 Thaumcraft Fix 和 ThaumicTweaker (若想获得更多集成功能，请添加 Congrega Mystica)
VoxelMap	存在大量漏洞	✅ 添加 VoxelMap Fixes
Witchery: Resurrected	基础模组无法使用	✅ 添加 Witchery: Companion

Cleanroom 独占模组

以下模组替换和配套模组是 Cleanroom 独占的，因为它们依赖于 Cleanroom 或现代 Java 版本的功能，因此它们无法在 Forge 上运行。

模组	原因	推荐操作
Blockcraftery	已过时且存在多个漏洞。	✅ 使用 Blockcraftery: Refurbished
CodeChicken Lib	已过时且存在多个漏洞。	✅ 使用 CodeChicken Lib CRE
Charset	已过时且存在多个漏洞。	✅ 使用 Charset CRE
Emojicord	已过时且存在多个漏洞。	✅ 使用 Goslingcord 如果您仍想使用 Forge，请使用 2.0.0 版本。
GeckoLib 3	已过时且存在多个漏洞。SauriaLib 保持与依赖 GeckoLib 3 的现有模组的兼容性。	✅ 使用 SauriaLib
RandomPortals	无法与 Cleanroom Launcher 兼容，且依赖 RandomPatches。	✅ 使用 Clean Portals
Sound Filters / Sound Filters Continued	已过时	✅ 使用 Sound Physics Remixin 如果您仍想使用 Forge，请使用 1.1.15 或以下版本。