Minecraft Serverpack Generation

Minecraft Server Pack Generation

把客户端 modpack 转成可部署的服务端包。互补于 minecraft-modpack-server（那是 host 已有 server pack 的步骤）。

触发条件

• 用户有客户端 modpack（PCL/HMCL/官方启动器/Prism 实例目录，或 modrinth .mrpack / curseforge zip），想开服
• 用户说"做这个整合包的服务端" / "我要跑多人服" / "generate a server pack for X"
• 用户说"用 ServerPackCreator 怎么搞" / "spc 怎么用"
• 用户的 modpack 文件路径类似 E:\.minecraft\versions\XXX\XXX.zip（Modrinth）或 C:\Users\<u>\CurseForge\Instances\XXX\

推荐路径（按"用户多快能拿到结果"排序）

A. Web 端（最省事，2 分钟出结果）

https://serverpackcreator.de

• 上传 modpack zip → 下服务端 zip
• 不要装 Java、不学 CLI、不开 WSL
• 适合：第一次用、不想折腾、本地环境特殊

B. WSL 本地 CLI（用户偏好"在 WSL 里搞定"，可重复跑）

参见 references/spc-cli-wsl.md，涵盖：

• JDK 21 安装
• jar 拉取（注意 JWT 签名 URL 陷阱 + 浏览器替代）
• modpack zip 解压 → cgen → 改 conf → 跑生成
• 输出到 ~/spc/output/ + zip 到 ~/spc/output_server_pack.zip
• 跨 NTFS 拷贝到 Windows 用 PowerShell SMB 路径（不要 cp 大文件到 /mnt/e/，会静默截断）

C. GUI 模式

启动 jar 弹窗口，点点点。WSL 默认 headless 不开 GUI；要 GUI 走 Windows PowerShell 下 jar 启动。

关键概念（讲了少踩坑）

工作流速记（CLI）

# 1. 解 modpack zip
mkdir -p ~/spc/work/modpack_src && cd ~/spc/work/modpack_src
unzip -q /path/to/modpack.zip
# 看到 modrinth.index.json 或 manifest.json

# 2. 装 JDK + 拿 SPC jar (略，见 references)

# 3. 生成 conf
java -jar spc.jar -cgen ~/spc/work/modpack_src -config ~/ServerPackCreator/configs/x.conf

# 4. 编辑 conf（最少改这 4 行）
#   minecraftVersion = "1.20.1"
#   modLoader = "Forge"
#   modLoaderVersion = "47.4.13"
#   inclusions = [{source="overrides/config",destination="config"}, ...]

# 5. 跑生成（必须前台，Hermes 后台 >60s 必砍）
timeout 580 java -jar spc.jar -config ~/ServerPackCreator/configs/x.conf \
  --destination ~/spc/output < /dev/null > run.log 2>&1

给未来 agent 的提示

如果用户说"想给这个 modpack 开服"或问"spc 怎么用"：

1. 先看 modpack 来源：
   • 已有 server pack zip → 用 minecraft-modpack-server skill 跑部署
   • 只有客户端 modpack → 用本 skill + references/spc-cli-wsl.md
2. 优先 Web 端试 → 用户拒绝/要自动化再走 CLI
3. 三必填字段 + inclusions 是 90% 配置失败的原因
4. 输出到 Windows 不用 cp /mnt/ → PowerShell SMB 路径（见 references/wsl-to-windows-file-copy.md）
5. 用户偏好：能不装东西就不装东西、报错给根因、不给更多试错步骤。WSL 默认用户保持 root，PO 是开发/安装用户

参考文件

• references/spc-cli-wsl.md — 完整 CLI 流程（jar 获取、JDK 安装、conf 模板、运行陷阱、跨 NTFS 拷贝）
• references/spc-inclusions.md — Modrinth 整合包的 inclusions 字段配置模板（按 modpack 子目录逐条列出）

错误信息速查