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

推荐用这种方式,平台会自动下载并启用模组。

  1. 在 Steam 创意工坊打开模组页面,网址形如 https://steamcommunity.com/sharedfiles/filedetails/?id=2824688072,id= 后面的数字就是模组 ID。

  2. 把要装的模组 ID 都找出来,包括它依赖的前置模组。模组页面的「必需物品」里会列出前置模组。

  3. 打开实例详情的「环境变量」,在「创意工坊模组」中填写 ID,多个用逗号分隔:

    2824688072,2824688266
    
  4. 点「保存变量」,然后点实例卡片底部操作栏的「重新安装」。

  5. 在「查看安装日志」中可以看到每个模组的下载结果,例如 2824688072 → CalamityMod。第一次下载需要先安装下载工具,约 2~5 分钟;之后再改模组列表通常很快。

  6. 安装完成后点「开机」。

注意:

  • 重新安装会保留世界、模组配置和 serverconfig.txt。
  • 从列表中删掉某个 ID 后重新安装,该模组会被卸载并从启用列表中移除。
  • 任何一个 ID 下载失败(ID 写错、不是 tModLoader 模组、网络问题),安装都会显示失败,请检查 ID 后再次重新安装。

方式二:上传 .tmod 文件

适合创意工坊以外的模组或自己制作的模组。

  1. 关机。

  2. 在「文件管理」中把 .tmod 文件上传到 Mods/ 目录。

  3. 编辑 Mods/enabled.json,把模组名(文件名去掉 .tmod)加进去。这个文件是一个 JSON 数组,例如:

    ["CalamityMod", "MyMod"]
    
  4. 开机。

两种方式可以混用。重新安装只会增删创意工坊方式装的模组,手动上传和手动启用的模组不受影响。想临时停用某个模组,从 enabled.json 里删掉它的名字后重启即可。

玩家如何获得模组

玩家用 tModLoader 加入服务器时,会自动从服务器下载缺少的模组,不需要提前订阅。要求是玩家的 tModLoader 版本和服务端一致。连接步骤见 连接泰拉瑞亚服务器。

升级 tModLoader

「tModLoader 版本」默认是 latest,表示安装时的最新正式版,之后不会自动更新。Steam 上的 tModLoader 更新后:

  1. 先备份 Worlds/ 目录。
  2. 点实例卡片底部操作栏的「重新安装」,会同时升级 tModLoader 和创意工坊模组。
  3. 完成后开机。

也可以填写历史版本号(如 v2026.08.3.0)安装指定版本,再重新安装。新版本保存过的世界可能无法用旧版本打开,降级前一定要先备份。

内存建议

模组越多,内存占用越高。不装模组时中世界约 0.9 GB、大世界约 1.4 GB;灾厄等大型模组整合建议 4 GB 以上。内存不够时服务器会被终止并保持关机,实例卡片下方的提示条会显示「服务器因内存不足被终止」,可以减少模组或 升级套餐。

控制台与关机

  • 「服务器语言」为简体中文时,控制台命令也是中文,例如「帮助」「保存」「退出」;切到 English 后使用 help、save、exit。
  • 点「关机」时,服务端会先保存世界再退出,通常 1 秒左右完成。
  • 不建议开启「刷屏保护」,模组武器和高射速武器很容易被误踢。

常见问题

开机后控制台报某个模组加载失败:通常是缺少前置模组,或模组版本和 tModLoader 版本不兼容。补全前置模组 ID 后重新安装;如果是手动上传的模组,先从 enabled.json 中移除。

上传的世界缺少模组物品:上传世界时要把 .wld 和同名的 .twld 一起放进 Worlds/,并启用原来的全部模组。

更多问题见 泰拉瑞亚常见问题。