饥荒联机版:配置文件、世界设置与模组
饥荒环境变量与 cluster.ini 的对应关系和生效方式、集群目录结构、修改令牌与人数、地面和洞穴的世界生成设置,以及创意工坊模组的安装与配置。
饥荒 · 更新于
集群目录结构
饥荒的配置和存档都在数据目录的 DoNotStarveTogether/config/server/ 下(下文称“集群目录”),可以用「文件管理」或 SFTP 访问:
DoNotStarveTogether/config/server/
├── cluster.ini 集群(房间)设置
├── cluster_token.txt Klei 服务器令牌
├── adminlist.txt 管理员(需自行创建)
├── whitelist.txt 白名单(需自行创建)
├── blocklist.txt 封禁名单(需自行创建)
├── Master/ 地面世界
│ ├── server.ini
│ ├── worldgenoverride.lua
│ ├── modoverrides.lua 模组开关与配置(需自行创建)
│ └── save/ 地面存档
└── Caves/ 洞穴世界
├── server.ini
├── worldgenoverride.lua
├── modoverrides.lua 模组开关与配置(需自行创建)
└── save/ 洞穴存档
「重新安装」只会补全缺失的配置文件,不会覆盖已有的配置和存档。
环境变量与 cluster.ini
下表中的变量在「环境变量」标签修改,点「保存变量」后,会在下次开机或重启时写入 cluster.ini:
| 变量 | 默认值 | 对应项 | 说明 |
|---|---|---|---|
| 最大支持玩家数量 | 32 | [GAMEPLAY] max_players |
1 到 64,生效方式见下文 |
| 游戏模式 | survival | game_mode |
生存、无尽(可随时复活)、荒野(死亡后随机重生) |
| PVP | false | pvp |
允许玩家互相攻击 |
| 无人时暂停 | true | pause_when_empty |
没人在线时暂停世界 |
| 允许投票 | true | vote_enabled |
允许投票踢人、回档等 |
| 房间名称 | 饥荒联机服务器 | [NETWORK] cluster_name |
显示在服务器列表中 |
| 房间描述 | 空 | cluster_description |
可留空 |
| 房间密码 | 空 | cluster_password |
不能含空格 |
| 游戏风格 | social | cluster_intention |
休闲、合作、竞争、疯狂 |
| 服务器语言 | zh | cluster_language |
简体中文或 English |
| 网络同步频率 | 15 | tick_rate |
15、30、60,越高越流畅,CPU 和带宽占用越高 |
| 白名单预留位 | 0 | whitelist_slots |
0 到 64 |
| 自动存档 | true | autosaver_enabled |
每天开始时自动保存 |
| 回档快照数 | 6 | [MISC] max_snapshots |
1 到 99,可回档的存档数量 |
| 允许控制台命令 | true | console_enabled |
关闭后面板控制台无法执行 Lua 命令 |
| 仅 Steam 组成员 / Steam 组 ID / Steam 组管理员即服务器管理员 | false / 空 / false | [STEAM] |
见 玩家如何连接 |
不要手动修改 cluster.ini 中由上表管理的项目,它们每次开机都会被环境变量的值覆盖。[SHARD] 段和 Master/server.ini、Caves/server.ini 中的端口、主从设置由平台维护,也请不要改动。
需要重建容器的两项
「Klei 服务器令牌」和「最大支持玩家数量」也会用在启动命令中,启动命令是在容器创建时确定的,只「重启」不会更新。修改这两项后:
- 在「环境变量」修改并点击「保存变量」。
- 打开「启动设置」标签,不需要改动内容,直接点击「保存启动参数」。平台会按当前变量重建容器,运行中的实例会自动重新启动。
令牌说明:「Klei 服务器令牌」留空时会保留现有的 cluster_token.txt;填写了令牌时,每次开机都会用它覆盖 cluster_token.txt,所以手动改这个文件不会生效,请改变量。
世界生成设置
地面和洞穴的世界生成选项分别在 Master/worldgenoverride.lua 和 Caves/worldgenoverride.lua 中,在 overrides 里填写选项即可,例如:
return {
override_enabled = true,
preset = "SURVIVAL_TOGETHER",
overrides = {
season_start = "default",
world_size = "default",
},
}
- 也可以在本地游戏的“创建世界”里调好选项,生成本地存档后,把对应世界的
leveldataoverride.lua上传到Master/或Caves/中使用。使用leveldataoverride.lua时,建议把同目录的worldgenoverride.lua改名停用(例如改为worldgenoverride.lua.bak),避免两者设置冲突。 - 洞穴世界必须保持洞穴预设:
Caves/worldgenoverride.lua中的preset = "DST_CAVE"、task_set = "cave_default"不能删改,否则洞穴会被生成成第二个地面世界。 - 世界生成设置只对新世界生效。已有世界想应用新设置,需要在控制台执行
c_regenerateworld()重新生成(当前世界会被丢弃,请先备份save目录)。
安装创意工坊模组
饥荒服务器通过两个文件安装模组:一个负责下载,一个负责启用和配置。
1. 填写要下载的模组
在数据目录的 mods/dedicated_server_mods_setup.lua 末尾,为每个模组加一行,括号里是创意工坊链接中 id= 后面的数字:
ServerModSetup("378160973")
ServerModSetup("666155465")
2. 启用模组
在 Master/modoverrides.lua 和 Caves/modoverrides.lua 中写入相同的内容(文件不存在就新建):
return {
["workshop-378160973"] = { enabled = true, configuration_options = {} },
["workshop-666155465"] = { enabled = true, configuration_options = {} },
}
configuration_options 用于填写模组的配置项,不填则使用模组默认配置。配置项名称可以在本地游戏中启用该模组后,从本地存档的 modoverrides.lua 中复制。
3. 重启
「重启」实例,服务器会在启动时下载并加载模组,可以在「控制台」查看加载情况。
注意事项
- 地面和洞穴的
modoverrides.lua要保持一致,否则跳洞穴时可能出错。 - 玩家进服时,客户端会自动订阅服务器上的模组,玩家不需要手动安装。
- 服务器无法下载某个模组时,可以在本地订阅后,把本地模组文件夹整体上传到
mods/workshop-模组ID/,再按第 2 步启用。 - 模组越多,内存占用越高,请留意「控制台」标签中的内存指标卡。
备份
平台暂不提供自动备份,可通过「文件管理」或 SFTP 自行下载备份。建议关机后下载整个集群目录,或至少下载 Master/save 和 Caves/save。游戏自带的「回档快照数」只能在服务器内回档,不能替代下载备份。
