官方启动器可以运行模组。但它不会替你管理模组。

从加载器官网安装,让其创建启动器配置,再将匹配的 jar 放入该配置的 mods 文件夹。在同一文件夹混用 Fabric 和 Forge 会导致黑屏和 200 行日志。

Minecraft 生物和装备宣传图,用于模组和加载器章节

安全操作顺序

  1. 使用官方安装配置,先启动一次要模组化的原版版本。这可验证账户、运行时和版本 JSON 下载是否正常。
  2. 关闭启动器。从以下地址下载 Fabric fabricmc.net,从 NeoForge 获取 neoforged.net,或从 Forge 获取 files.minecraftforge.net — 而非「模组安装器」广告页面。
  3. 运行安装程序,选择相同的 Minecraft 版本,保持 Create profile 启用。
  4. 在启动器中编辑该配置并设置 独立游戏目录.
  5. 先运行一次并退出,再将模组复制到 mods。Fabric 整合包几乎总是还需要 Fabric API。

版本匹配是关键

1.21.4 的 Fabric 模组无法在 1.21.1 上加载。Forge 的 jar 无法在 Fabric 上运行。启动器仍会显示「开始游戏」。日志位于 logs/latest.log 记录了版本不匹配的信息。

资源包放在 resourcepacks。光影包需要 Iris(Fabric)或加载器文档中说明的光影路径。启动器里的 Bedrock「模组」是 Marketplace 附加内容,不是这些 jar 文件。

如果点击开始游戏后崩溃: 崩溃指南。如果你在设置了自定义可执行文件后 Java 丢失: 运行时指南.