jacobsmile/tmodloader1.4 Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

tModLoader Docker镜像

在Github上查看 | 在Dockerhub上查看

此Docker镜像旨在简化基于tModLoader的模组化Terraria服务器的配置和搭建过程。

特性

• 通过Workshop ID轻松下载tModLoader模组
• 计划世界保存功能
• 优雅关闭机制
• 配置文件可选
• Github自动化以保持与tModLoader发布周期同步更新

致谢与提及

• Terraria
  • 官方网站
  • Steam商店页面
• tModLoader
  • 官方网站
  • Steam商店页面
  • Github仓库
• ldericher 的Terraria 1.3 tModLoader Docker实现及命令注入功能
• rfvgyhn 的Terraria 1.3 tModLoader Docker实现
• guillheu 的Terraria 1.4 tModLoader Docker实现
• FlorentLM 帮助优化Dockerfile并解决部分安全问题

查看我的所有Terraria镜像!

1.4 原版Terraria: Github | Dockerhub

1.4 tModLoader: Github | Dockerhub

容器准备

数据目录

在主机上创建一个目录用于存储持久化文件。

bash
# 创建数据目录
mkdir /path/to/data/directory

bash
# 以下是Docker容器的映射卷配置
-v /path/to/data/directory:/data

此目录将包含以下文件结构:

/data/
├─ steamMods/
│  ├─ steamapps/
│  │  ├─ workshop/
│  │  │  ├─ content/
│  │  │  │  ├─ ***/
├─ tModLoader/
│  ├─ ModConfigs/
│  ├─ Mods/
│  │  ├─ enabled.json
│  ├─ Worlds/

Steam Workshop内容存储在steamMods目录中。

服务器的模组配置、模组目录和世界目录存储在tModLoader目录中。

下载模组

Steam上的每个Workshop项目都有唯一标识符，可通过访问商店页面获取。例如，Calamity Mod的URL中，2824688072即为Workshop ID。此Docker容器支持直接从Steam Workshop下载tModLoader模组，简化搭建流程。

在运行容器时传递的环境变量中，指定TMOD_AUTODOWNLOAD变量，值为逗号分隔的模组ID列表。

例如，要下载Calamity模组和Calamity模组音乐，指定以下变量:

bash
-e TMOD_AUTODOWNLOAD=2824688072,2824688266

启用模组

要成功运行容器，需理解下载模组和启用模组的区别。

下载模组仅将其存储在Steam Workshop缓存中（位于/data/mods目录），映射/data到主机目录可实现容器重启间的持久化。

启用模组是指将模组名称写入tModLoader启动时读取的enabled.json文件。模组必须先通过TMOD_AUTODOWNLOAD下载后才能启用。

要在服务器上启用模组，指定TMOD_ENABLEDMODS环境变量，值为逗号分隔的模组ID列表:

bash
-e TMOD_ENABLEDMODS=2824688072,2824688266

环境变量

以下是容器支持的所有环境变量，用于处理服务器功能和Terraria服务器配置。

以下是控制旅途模式设置的环境变量，所有设置值含义：

• 0 = 所有人锁定
• 1 = 仅主机可更改
• 2 = 所有人可更改

默认值均为0（未显式设置时）：

• TMOD_JOURNEY_SETFROZEN
• TMOD_JOURNEY_SETDAWN
• TMOD_JOURNEY_SETNOON
• TMOD_JOURNEY_SETDUSK
• TMOD_JOURNEY_SETMIDNIGHT
• TMOD_JOURNEY_GODMODE
• TMOD_JOURNEY_WIND_STRENGTH
• TMOD_JOURNEY_RAIN_STRENGTH
• TMOD_JOURNEY_TIME_SPEED
• TMOD_JOURNEY_RAIN_FROZEN
• TMOD_JOURNEY_WIND_FROZEN
• TMOD_JOURNEY_PLACEMENT_RANGE
• TMOD_JOURNEY_SET_DIFFICULTY
• TMOD_JOURNEY_BIOME_SPREAD
• TMOD_JOURNEY_SPAWN_RATE

运行容器

Docker命令

bash
# 拉取镜像
docker pull jacobsmile/tmodloader1.4:latest

# 运行容器
docker run -p 7777:7777 --name tmodloader --rm \
  -v /path/to/data:/data \
  -e TMOD_SHUTDOWN_MESSAGE='再见！' \
  -e TMOD_AUTOSAVE_INTERVAL='15' \
  -e TMOD_AUTODOWNLOAD='2824688072,2824688266' \
  -e TMOD_ENABLEDMODS='2824688072,2824688266' \
  -e TMOD_MOTD='欢迎来到我的tModLoader服务器！' \
  -e TMOD_PASS='secret' \
  -e TMOD_MAXPLAYERS='16' \
  -e TMOD_WORLDNAME='地球' \
  -e TMOD_WORLDSIZE='2' \
  -e TMOD_WORLDSEED='not the bees!' \
  -e TMOD_DIFFICULTY='3' \
  jacobsmile/tmodloader1.4

Docker Compose

Github仓库中包含示例docker-compose.yml文件。配置完成后，使用以下命令启动：

bash
docker compose up --build

与服务器交互

服务器启动后，可通过主机执行以下命令向服务器发送指令。例如，发送"Hello World"到游戏聊天：

bash
docker exec tmodloader inject "say Hello World!"

如果未命名容器，可使用容器ID代替tmodloader。

（此命令注入方法归功于ldericher）

注意事项

我不拥有tModLoader或Terraria的所有权。此Docker镜像仅为玩家提供便捷的Docker化服务器搭建方式，无意侵犯任何版权、商标或知识产权。