Java 版模组安装：先配对版本，再动手

模组不能只按“最新版”三个字来装。一个兼容组合至少包含 Minecraft 游戏版本、模组加载器及其版本、模组本身的版本和依赖项。四者有一个不匹配，就可能无法启动。

准备兼容信息卡

打开你要安装的模组作者页，记录 Minecraft 版本、加载器（例如 Forge、Fabric 或 NeoForge）、模组文件版本、所需前置项目和已知限制。不要看到文件名里有“1.20.1”就推断它支持所有加载器；同一游戏版本可能有不同加载器构建，彼此不能随意互换。兼容性以作者当前项目页为准，本站不替任意模组承诺版本。

再记录当前启动器使用的游戏目录和版本配置。为模组单独建立启动配置或实例，避免污染无模组的原版环境。保留原版启动入口，若新配置无法启动，可以退回稳定环境，而不是在原有实例上连续覆盖文件。

安装步骤

1. 备份世界。退出游戏后复制重要存档，记录当前版本。不要在唯一存档上测试新模组。
2. 安装匹配的加载器。从加载器项目的官方发布页获取适配版本，按项目说明安装，并先启动一次该加载器配置，确认基础环境能正常进入主菜单。
3. 核对模组和依赖。从作者或可信发布平台的项目页面获取文件。确认文件类型、版本与加载器匹配，并按项目说明安装必要前置。不要运行与项目说明无关的安装程序。
4. 找到当前实例的 mods 目录。不同启动器可以使用不同游戏目录。以启动器实际配置为准；若目录不存在，先按加载器文档创建。不要把文件随意放进下载文件夹或另一个启动器的目录。
5. 每次只加一个或少量项目。把模组文件放入正确目录，启动匹配的配置。检查日志和项目说明，确保没有漏依赖或重复版本。
6. 用新建测试世界验证。确认模组功能按预期工作、退出游戏后能重新启动。测试通过后，再考虑将模组加入长期世界的副本。

配置文件与目录说明

常见 Java 加载器会在游戏目录中保存模组文件和配置文件。mods 通常放模组本体；config 通常放模组配置。不同项目可能使用自定义子目录或启动参数，具体以加载器、启动器和模组自己的文档为准。升级模组前复制相关配置文件；修改配置时先保存原文件，逐项调整并记录改动，出问题便于回退。

打不开时如何定位

• 确认启动器启动的是刚装入加载器的配置。
• 核对游戏版本与加载器版本，确认模组页面明确支持这一组合。
• 检查是否缺少前置依赖、放入了重复版本，或误把其他加载器的文件混进来。
• 一次只撤回最近添加的项目，查看日志中的首个相关错误，不要删除存档来“清理”。
• 如需求助，分享错误片段前先遮掉用户名、完整本地路径和任何访问令牌。

基岩版怎么办

Java 版加载器安装流程不适用于基岩版。基岩版内容可能通过游戏内商店、官方支持的附加内容机制或平台提供的方式分发。先核对你设备对应的官方说明，不要下载声称“把 Java 文件直接装进基岩版”的内容。