饥荒联机版:配置文件、世界设置与模组

饥荒环境变量与 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 服务器令牌」和「最大支持玩家数量」也会用在启动命令中,启动命令是在容器创建时确定的,只「重启」不会更新。修改这两项后:

  1. 在「环境变量」修改并点击「保存变量」。
  2. 打开「启动设置」标签,不需要改动内容,直接点击「保存启动参数」。平台会按当前变量重建容器,运行中的实例会自动重新启动。

令牌说明:「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。游戏自带的「回档快照数」只能在服务器内回档,不能替代下载备份。