写在前面

服务器上的重度机械症（Mechanomania）从 1.1.11.1 升到了 1.1.12.0。作者的更新说明里有几条挺关键：修了末地相关的崩溃和一些内存泄漏，优化了大后期工厂的帧率，改了墓碑的生成方式（更不容易吞墓碑），世界生成速度提升到约 2.5 倍，还修了几个物品复制问题。

作者也提醒了两件事：这个版本用了一些比较激进的优化，如果和你自己加的模组冲突，可以退回 1.1.11.1；另外想自己加”航空学”的话，注意它和铁魔法有一定的冲突风险。

这篇是进阶篇，只讲”怎么把双端安全升上去”，顺序是：看懂两种包 → 备份 → 服务端换包 → 启动命令 → 客户端导入与数据迁移 → 冲突排查 → 回滚。

前置阅读：同系列《在 Debian 13 服务器上用 MCSManager 部署一个普通生电服》，面板、Java、实例这些概念那篇讲过了，这里不再重复。

一、先看懂手里这两个包

二、升级总览：五步走

1. 备份：停服后打包世界、配置与白名单，出了问题能整体退回去；
2. 换包：用新服务端包替换 mods/、config/、libraries/ 等，保留 world/ 与运行数据；
3. 改启动命令：NeoForge 版本号变了，面板里的启动命令要同步；
4. 客户端：导入新版本，再把存档、地图、按键这些个人数据搬过去；
5. 验证：看日志确认没有致命报错，进服跑一圈。

后面几节就是这五步的展开。

三、第一步：先备份，再动手

先停服（面板点停止，并确认进程真的没了），然后打包：

D=/opt/mcsmanager/daemon/data/InstanceData/<实例ID>
mkdir -p /opt/mcsmanager/backups
tar -C "$D" -czf /opt/mcsmanager/backups/mech-旧版本-$(date +%F).tar.gz \
  --exclude=logs --exclude=crash-reports --exclude=simplebackups --exclude=cache \
  world config mods libraries kubejs configureddefaults defaultconfigs \
  server.properties eula.txt whitelist.json ops.json \
  banned-ips.json banned-players.json usercache.json usernamecache.json

客户端不用额外备份：导入会新建一个版本文件夹，旧文件夹本身就是回滚点。

四、第二步：服务端换包，删什么留什么

把新服务端包解压到临时目录，然后按清单处理。

要替换的：config/、configureddefaults/、defaultconfigs/、kubejs/、libraries/、mods/，以及 run.sh、run.bat、unix_args.txt、win_args.txt、user_jvm_args.txt。

要保留的：world/、server.properties、eula.txt、whitelist.json、ops.json、banned-*.json、logs/、simplebackups/ 这些运行数据。

D=/opt/mcsmanager/daemon/data/InstanceData/<实例ID>
cd "$D"
for x in config configureddefaults defaultconfigs kubejs libraries mods \
         run.sh run.bat unix_args.txt win_args.txt user_jvm_args.txt; do
  rm -rf "$D/$x"
done
cp -a /tmp/新包/. "$D/"

顺手两件小事：user_jvm_args.txt 会被替换回默认值，内存（-Xms / -Xmx）要重新填；你在旧配置里改过的项目（例如我们改过的货物蛙港交互距离）也要重新应用一次。

五、第三步：NeoForge 版本号与启动命令

新包把 NeoForge 从 21.1.233 升到了 21.1.248，而启动参数里的路径跟着变了：

# 旧
{java} @user_jvm_args.txt @libraries/net/neoforged/neoforge/21.1.233/unix_args.txt nogui
# 新
{java} @user_jvm_args.txt @libraries/net/neoforged/neoforge/21.1.248/unix_args.txt nogui

• 面板「实例设置」里的启动命令必须同步改版本号，否则会报找不到文件的错；
• Linux 用 unix_args.txt（classpath 用冒号分隔），Windows 用 win_args.txt（分号），两者不能混用；
• 内存写在 user_jvm_args.txt 里，例如 -Xms4G、-Xmx10G。

六、第四步：启动验证，看三样东西

1. 控制台出现 Done (xxs)!；
2. 日志里没有 FATAL，也没有 MixinApplyError；
3. 模组数量与包内一致，白名单、正版验证等设置还在。

七、第五步：客户端导入新版本，然后手工搬数据

把客户端包拖进 PCL2，装成新版本（比如 Mechanomania-1.1.12.0），等它把模组下载完。先别急着进游戏，下面这些东西不会自己跟过来：

三个小提醒：

• 用脚本拷贝时，文件名里的方括号在 PowerShell 里会被当成通配符，用资源管理器拖拽或字面路径更省事；
• 旧版本的同名模组不要带过去，新版包里已经是新版本了；
• 自己额外加的模组，要么两端都加同一版本、要么都别加，单端装容易出各种同步和报错问题。

八、附录：一次真实的模组冲突（byepregen × Carpet）

我们遇到过一次很典型的模组冲突，现象值得记一下：

• 启动到”加载世界”这一步直接 FATAL；
• 日志关键词：MixinApplyError、cannot inject into ... ServerChunkCache::tickChunks，并同时点名 byepregen 与 Carpet。

原因很朴素：两个模组都要改同一个方法，先来的那个把注入点改掉了，后来的就找不到位置。

九、常见问题速查与回滚

回滚：停服，删掉替换过的新目录，解压之前那份备份 tar，再把启动命令里的版本号改回旧版，启动。

小结

整合包升级真正麻烦的从来不是”下载新包”，而是三件事：备份、别丢世界、别忘同步启动命令里的版本号。客户端那边再多做一步数据迁移，基本就稳了。

系列内互链：面板怎么装、Java 怎么准备、实例怎么建，都在《在 Debian 13 服务器上用 MCSManager 部署一个普通生电服》里。

文中版本号、路径与实例 ID 均为示例，请以你实际使用的整合包与面板环境为准。