2026-02-07

ServerPackCreator 使用指南（泛用版）

ServerPackCreator 是一款强大的自动化工具，可帮助玩家快速创建 Minecraft 整合包的服务端版本。以下内容将以步骤为导向，帮助您通过该工具创建完美的服务端整合包。

1. 前置准备（环境检查清单）

Java 版本确认（运行 ServerPackCreator 需要 Java 21，但生成的服务端可能需要其他版本如 Java 17）。
整合包基本信息收集：
- Minecraft 版本（如 1.20.1）。
- 模组加载器类型（Forge/Fabric/NeoForge/Quilt）。
- 加载器版本号（如 Forge 47.4.16）。
客户端整合包已正常运行（确保无损坏）。

ServerPackCreator 是一款自动化工具，而非万能解决方案。以下是几点重要说明：

选择整合包目录：选择包含 mods/、config/ 等文件夹的目录。
配置服务端参数：
- 内存分配（建议 -Xms4G -Xmx8G 起步）。
- 确认 Minecraft 版本和加载器版本。
设置额外包含目录（重要！）：
- scripts/（CraftTweaker 脚本）。
- kubejs/（KubeJS 数据）。
- defaultconfigs/。
- 自定义数据包文件夹（如 tacz/）。
生成服务器包。

必须审查以下客户端专属模组，并将其删除：

注意事项：
某些模组如 JEI 有服务端兼容版本，例如 jei-1.20.1-forge-xxx.jar，应保留。
删除依赖特定客户端模组的扩展模组时可能引发崩溃（如 elementalcombat_jade 依赖 Jade）。

错误现象	可能原因	解决方案
`Attempted to load class ... for invalid dist DEDICATED_SERVER`	客户端模组未删除	删除对应模组
`requires xxx ... Currently, xxx is not installed`	依赖模组缺失	安装缺失模组，或删除依赖它的模组
`NoClassDefFoundError: mezz/jei/...`	JEI 扩展模组残留	删除所有 JEI 相关扩展
`Initial heap size set to a larger value than the maximum heap size`	内存参数配置错误	检查 `-Xms` 是否大于 `-Xmx`
`Error: Unable to access jarfile server.jar`	下载失败	手动下载 `server.jar` 放入目录
启动后长时间无输出	世界生成中	等待 2-10 分钟

在 ServerPackCreator GUI 中配置 “Exclude Mods” 列表：

jei
jeresources
jeitweaker
jecharacters
jade
journeymap
xaeros
optifine
oculus
rubidium
mousetweaks
controlling
trashslot
appleskin
torohealth

⚠️ ServerPackCreator 不是万能的
它只能处理约 70-80% 的客户端模组识别，剩余的 20-30% 需要：
根据崩溃日志人工判断。
了解各模组的功能定位。
多次迭代测试。
建议：首次处理某整合包时，预留 30-60 分钟的调试时间。