模组核心：Fabric、Forge、NeoForge、Quilt

你在电脑上玩得好好的整合包，搬到手机开服，客户端能进，服务端却停在半路：日志里一串 Missing or unsupported mandatory dependencies，或者干脆提示找不到某个 mod。你明明把 mods 文件夹整个复制过去了。

模组服和插件服是两种玩法。插件只装在服务端，玩家客户端不用动；模组改的是游戏本体，大多数情况下两边都要装，而且版本要严格对上。

这一页讲清四个加载器的区别、Minexa 下载时多出来的 installer 步骤、整合包导入能做什么，以及手机上跑整合包的现实边界。

四个加载器，先认清定位#

• Fabric：轻量级模组加载器，启动链路简单，优化、辅助、小型整合包常用。它对旧版模组的包袱少，但也不是「什么模组都能跑」。

• Forge：老牌加载器，大型科技、魔法整合包和旧版本模组最多。它的安装链路最重，下载后要跑 installer。

• NeoForge：从 Forge 分出来的继任分支，新模组逐渐迁入。它同样要 installer，而且对版本匹配更「硬」：没有对应构建时直接报错，不会退回最新版。

• Quilt：Fabric 的分支，安装后靠 quilt-server-launch.jar 启动。部分 Fabric 模组可以跑，但不是全部，装之前看模组页的支持说明。

四个都不支持 Bukkit 插件。你不能把 Paper 的插件丢进 mods/，也不能指望 Forge 核心读 plugins/。

「随 MC 版本」仍然是那套规则：1.21 及以上用 Java 21，1.17～1.20.6 用 17，1.16 及更早用 8，26.x 用 25。Forge 1.16 及更早是特例：需要 Java 8 或 11，而 Java 8 只有 PRoot 的 Ubuntu 20.04 提供。如果你一直用 Termux Java，老 Forge 会在这里失败，应用会提示你换来源或换版本，详见 游戏版本与 Java 版本。

模组分三种，装错端就进不去#

下载模组时，页面通常会标 Client、Server 或 Both。这不是装饰：

• 客户端模组（Client）：只改画面、按键、HUD、光影联动等。装到服务端通常没用，严重的会直接让服务端起不来。

• 服务端模组（Server）：只影响服务端逻辑，客户端不装也能进。

• 双端模组（Both）：两边都要装，而且版本必须一致。科技、魔法、新方块、新物品大多属于这一类。

装错端的典型表现：

版本要三件套对齐#

模组服能不能跑，取决于三样东西同时对上：

1. Minecraft 版本：1.21.1 的模组不能装进 1.21.4 的服务端。

2. 加载器版本：Forge、NeoForge、Fabric Loader、Quilt Loader 各有自己的版本号，模组会声明依赖哪个范围。

3. 模组自身版本：同一个模组的不同版本对应不同 MC 版本，下载时别拿错文件。

再加上前置依赖：很多模组要求先装 Fabric API、Architectury API、某个库模组。Minexa 不会替你自动补依赖——它只负责下载核心和启动，模组之间的依赖关系要你自己按模组页面说明装齐。缺依赖时日志通常很直接，会写出缺的是哪个 mod id。

这也是为什么「客户端能跑」不等于「服务端能跑」：客户端整合包里的模组是配好的，你只把其中一部分搬到服务端，依赖链就断了。

在 Minexa 里下载模组核心，会多一步 installer#

Fabric 是四个里最省事的：下载完直接得到一个可启动的 server.jar，第一次启动时它会自己联网补依赖，启动阶段会显示「下载依赖」。

另外三个不一样。Forge、NeoForge、Quilt 下载到的先是 installer，应用会在下载完成后自动执行安装命令，把真正的启动文件生成出来。所以你会看到进度条走完后又多等一段，这是正常的，不是卡死。

失败时常见两种提示：installer 执行失败 (exit=N)，或者 installer 未生成启动文件。前者多半是 Java 不对、网络中断或 installer 自身报错；后者是装完了但入口没生成，通常和安装日志里的具体错误有关。带着日志去 启动失败排查 比盲目重装有效。

整合包：用 mrpack 导入，别手动拆#

Minexa 的「导入服务器」支持 Modrinth 的 .mrpack 整合包。它会做这些事：

• 读取整合包里的 minecraft 版本和加载器信息，推断核心与版本；

• 按清单逐个下载服务端需要的文件，并校验 SHA-1；

• 跳过标记为「仅客户端」的文件；

• 解开 overrides/ 和 server-overrides/，把整合包自带的配置放到服务端目录；

• 删除整合包自己的索引文件，留下一个服务端目录（能不能启动还要看 Java 和模组本身）。

它不能做这些：

• 不支持 CurseForge 的整合包格式，只认 Modrinth .mrpack；

• 不会替你安装 Java，也不会验证每个模组在手机上都能跑；

• 不会自动补模组之间的依赖（清单里没有的，它不会猜）；

• 不保证整合包作者提供了完整的服务端适配——服务端能不能跑，仍要看作者有没有提供 server 端文件。

所以导入完成后，第一件事不是点启动，而是确认 Java 版本、看 mods/ 里有没有明显的客户端模组、然后启动看日志。导入流程本身见 导入服务器与整合包。

手机跑整合包的现实#

Minexa 能让模组服在手机上跑起来，但不能把手机变成一台服务器。几个硬边界：

• 内存：大型整合包按经验要 3072～4096 MB 堆内存，手机总内存最好 8 GB 以上。4 GB 手机不要碰重整合，系统会在服务端之前先把应用杀掉。

• 启动时间：模组越多，启动越久。首次启动还要生成世界、下载依赖，几分钟很常见；这不一定是卡死。

• 存储：整合包、世界、备份加起来很容易上 GB，开服前先看剩余空间。

• CPU 与散热：模组服的红石、实体、机器 ticking 比原版重得多，手机降频后 TPS 会明显下降。

• 兼容性：不是所有模组都为 Android/arm64 设计，涉及原生库的模组可能直接加载失败。

内存该给多少、怎么观察是否 OOM，见 内存分配；卡顿的通用排查见 TPS 与 MSPT。

崩了先查什么#

模组服崩溃，按这个顺序看，比反复重装快：

1. 日志最后 30 行：找 Missing、NoClassDefFoundError、Mixin、mod id、requires 这些词。

2. 是不是装错端：把客户端模组从 mods/ 里拿掉，再启动一次。

3. 是不是版本不对：MC 版本、加载器版本、模组版本三者逐个核对。

4. 是不是缺依赖：按日志里的 mod id 去补前置，不要一次补十个。

5. 二分法：把模组分成两半，先装一半启动，能起来再换另一半，直到定位到具体模组。

具体命令和日志关键词见 模组安装、依赖与排错 和 模组冲突与插件报错。

下一步#

• 回到全局对比：18 个核心选项总览

• 准备装模组：模组安装、依赖与排错

• 版本怎么选：选版本、升级与降级