tModLoader模组世界加载与保存验收
本篇适用于已经能正常运行的tModLoader 1.4.4系列专用服务器,示例为Linux原生部署。任务是把已有模组世界加载到正确位置,并确认修改能够保存。客户端、服务端和世界所需模组应使用匹配版本;原版Terraria、TShock或其他大版本存档不直接套用。
先记录版本与真正使用的数据目录
从启动日志和现有配置记录tModLoader完整版本、模组名称与版本、启用清单、世界路径及启动方式。只看到“都是1.4.4”还不够,月度版本和模组更新也可能影响加载。先保留原环境,不在导入世界的同时升级整包或更新所有模组。
核对实际启动使用的配置文件,以及是否带有-world、-tmlsavedirectory、-savedirectory或-modpath参数。安装目录不等于存档目录;-savedirectory与-tmlsavedirectory的目录规则也不同。Docker部署应使用容器内部能够读写的路径,不能直接填宿主机路径。
保存并停服后,复制同一时点的整套资料
- 让源世界正常保存并退出;来自专用服务器时,使用当前部署已验证的保存并停止方式。等待保存完成且进程退出,保存报错时先停止迁移。
- 目标服务器也先正常停服,保存它原来的世界、启动配置、模组及相关配置副本。备份放在独立受限目录,不放进网站公开目录。
- 把要导入的世界复制到新的测试目录,保留源文件;不要直接覆盖目标服的唯一旧存档。
- 复制后核对文件数量、大小和SHA256;传输方法见SFTP上传下载,校验方法见文件哈希核验。
| 资料 | 要点 |
|---|---|
| MyWorld.wld与MyWorld.twld | 已有模组世界的主文件和模组扩展数据要成对保留,名称主体一致,来自同一次保存。 |
| 已有.bak文件和Backups压缩包 | 一并保留作回退,不把旧日期的其中一个文件拼入当前存档。 |
| 模组、启用清单与模组配置 | 世界文件不替你安装或启用原来需要的模组;目标端应恢复匹配环境。 |
缺少原本配套的.twld时,先寻找同一时点的完整备份,不把“仍能启动”当成模组数据完整。世界目录和人物目录也不是同一份资料;本篇不进行人物档案转换或原版与模组版互转。
用world指定实际.wld文件
在目标服实际读取的配置中,保留其他已确认参数,仅把world设为新副本的完整路径。例如文件确实位于以下位置:
world=/srv/tmodloader-check/Worlds/MyWorld.wld
这是一行配置,不是Shell命令;路径必须换成真实值。MyWorld.twld应在同目录中配对存在,world不能指向.twld。运行服务的账号要能读取并保存该目录,不通过全目录777解决权限问题。
导入期间关闭配置和启动参数中的自动创建世界选项,避免路径拼错时悄悄生成空白世界。worldname只控制自动创建时的名称,不能代替world选择已有地图。也要核对启动参数没有另指一个-world,不能只编辑未被读取的serverconfig.txt。
进服检查内容,再做保存重开验收
- 按原来的启动方式运行目标服,先看日志中的版本、模组加载和世界路径;报缺模组或加载异常时停下,不通过删除内容模组后保存来试错。
- 先由测试玩家进入,核对熟悉的建筑、箱子、世界进度,以及原来使用的模组物品和地形。没有全部核对前,不让玩家继续往新旧两套世界写入进度。
- 在世界副本中做一个容易确认的小改动,再按原流程保存并正常停服,确认日志没有保存失败。
- 重新启动同一配置和世界,确认小改动仍在,关键模组内容也正常,才安排正式使用。
如果出现空白世界,优先查路径、实际配置与自动创建;模组物品异常则查配对存档和版本;重开丢进度则查保存错误、目录权限及是否启动了另一份副本。不要继续覆盖原备份。回退时先停目标服,恢复匹配的原世界、配置和模组环境;备份与恢复原则见恢复验证方法。