tModLoader 模组服
泰拉瑞亚 tModLoader 模组服的目录结构、通过创意工坊 ID 或上传 .tmod 安装模组、启用列表、版本升级,以及模组服的内存和控制台注意事项。
泰拉瑞亚 · 更新于
tModLoader 版本是泰拉瑞亚的模组专用服务器,与 Steam 上的 tModLoader 联机。开服流程和通用参数见 泰拉瑞亚开服入门,这里只介绍模组相关的内容。
目录结构
| 路径 | 用途 |
|---|---|
Worlds/ |
世界存档(注意是大写 W),每个世界有 .wld 和同名 .twld 两个文件 |
Mods/ |
模组文件 .tmod 和启用列表 Mods/enabled.json |
steamapps/workshop/content/1281930/ |
通过创意工坊下载的模组,每个模组一个 ID 目录 |
serverconfig.txt |
服务器配置 |
banlist.txt |
封禁名单 |
server/ |
tModLoader 程序,重新安装时会整体替换 |
dotnet/ |
运行 tModLoader 需要的 .NET 运行时,请勿删除 |
方式一:填写创意工坊模组 ID
推荐用这种方式,平台会自动下载并启用模组。
-
在 Steam 创意工坊打开模组页面,网址形如
https://steamcommunity.com/sharedfiles/filedetails/?id=2824688072,id=后面的数字就是模组 ID。 -
把要装的模组 ID 都找出来,包括它依赖的前置模组。模组页面的「必需物品」里会列出前置模组。
-
打开实例详情的「环境变量」,在「创意工坊模组」中填写 ID,多个用逗号分隔:
2824688072,2824688266 -
点「保存变量」,然后点实例卡片底部操作栏的「重新安装」。
-
在「查看安装日志」中可以看到每个模组的下载结果,例如
2824688072 → CalamityMod。第一次下载需要先安装下载工具,约 2~5 分钟;之后再改模组列表通常很快。 -
安装完成后点「开机」。
注意:
- 重新安装会保留世界、模组配置和
serverconfig.txt。 - 从列表中删掉某个 ID 后重新安装,该模组会被卸载并从启用列表中移除。
- 任何一个 ID 下载失败(ID 写错、不是 tModLoader 模组、网络问题),安装都会显示失败,请检查 ID 后再次重新安装。
方式二:上传 .tmod 文件
适合创意工坊以外的模组或自己制作的模组。
-
关机。
-
在「文件管理」中把
.tmod文件上传到Mods/目录。 -
编辑
Mods/enabled.json,把模组名(文件名去掉.tmod)加进去。这个文件是一个 JSON 数组,例如:["CalamityMod", "MyMod"] -
开机。
两种方式可以混用。重新安装只会增删创意工坊方式装的模组,手动上传和手动启用的模组不受影响。想临时停用某个模组,从 enabled.json 里删掉它的名字后重启即可。
玩家如何获得模组
玩家用 tModLoader 加入服务器时,会自动从服务器下载缺少的模组,不需要提前订阅。要求是玩家的 tModLoader 版本和服务端一致。连接步骤见 连接泰拉瑞亚服务器。
升级 tModLoader
「tModLoader 版本」默认是 latest,表示安装时的最新正式版,之后不会自动更新。Steam 上的 tModLoader 更新后:
- 先备份
Worlds/目录。 - 点实例卡片底部操作栏的「重新安装」,会同时升级 tModLoader 和创意工坊模组。
- 完成后开机。
也可以填写历史版本号(如 v2026.08.3.0)安装指定版本,再重新安装。新版本保存过的世界可能无法用旧版本打开,降级前一定要先备份。
内存建议
模组越多,内存占用越高。不装模组时中世界约 0.9 GB、大世界约 1.4 GB;灾厄等大型模组整合建议 4 GB 以上。内存不够时服务器会被终止并保持关机,实例卡片下方的提示条会显示「服务器因内存不足被终止」,可以减少模组或 升级套餐。
控制台与关机
- 「服务器语言」为简体中文时,控制台命令也是中文,例如「帮助」「保存」「退出」;切到 English 后使用
help、save、exit。 - 点「关机」时,服务端会先保存世界再退出,通常 1 秒左右完成。
- 不建议开启「刷屏保护」,模组武器和高射速武器很容易被误踢。
常见问题
开机后控制台报某个模组加载失败:通常是缺少前置模组,或模组版本和 tModLoader 版本不兼容。补全前置模组 ID 后重新安装;如果是手动上传的模组,先从 enabled.json 中移除。
上传的世界缺少模组物品:上传世界时要把 .wld 和同名的 .twld 一起放进 Worlds/,并启用原来的全部模组。
更多问题见 泰拉瑞亚常见问题。
