WeGame饥荒专用服务器 3 大核心配置文件详解:cluster.ini、server.ini、leveldataoverride.lua
2026/7/13 13:59:23 网站建设 项目流程

WeGame饥荒专用服务器三大核心配置文件深度解析与实战调优指南

1. 配置文件架构设计与基础原理

在WeGame版饥荒专用服务器的生态中,配置文件如同游戏世界的DNA,精确控制着从基础规则到复杂生态的每一个细节。与Steam版本不同,WeGame专用服务器的配置文件采用独特的RAIL架构,其核心由三个关键文件构成:

  • cluster.ini:服务器全局控制中枢
  • server.ini:分片世界运行参数
  • leveldataoverride.lua:动态世界生成蓝图

这三个文件通过层级化设计形成完整的配置体系。当服务器启动时,配置加载遵循cluster.ini → server.ini → leveldataoverride.lua的优先级顺序,后加载的配置会覆盖先前的默认设置。

关键提示:所有配置文件必须使用UTF-8无BOM编码保存,Windows记事本默认保存的ANSI编码会导致参数解析失败。推荐使用VS Code或Notepad++等专业文本编辑器。

配置文件的基础目录结构如下(以存档名MyDediServer为例):

MyDediServer/ ├── cluster.ini # 主配置文件 ├── cluster_token.txt # 服务器令牌 ├── Master/ # 地面世界 │ ├── server.ini # 地面服务器配置 │ ├── leveldataoverride.lua # 地面地形配置 │ └── modoverrides.lua # 地面MOD配置 └── Caves/ # 洞穴世界 ├── server.ini # 洞穴服务器配置 ├── leveldataoverride.lua # 洞穴地形配置 └── modoverrides.lua # 洞穴MOD配置

2. cluster.ini:服务器神经中枢详解

作为服务器最高级别的控制文件,cluster.ini定义了跨分片的全局规则。其采用经典的INI格式,通过方括号划分配置区块,每个区块包含若干键值对参数。

2.1 核心配置区块解析

[GAMEPLAY] 游戏规则模块
[GAMEPLAY] game_mode = endless ; 游戏模式(endless/survival/wilderness) max_players = 8 ; 最大玩家数(1-64) pvp = false ; 玩家对战开关 pause_when_empty = true ; 空服暂停 tick_rate = 15 ; 服务器帧率(15/30/60)

游戏模式对比表:

模式死亡惩罚重生机制适合场景
无尽任意复活台休闲建造
生存掉落物品受限复活硬核挑战
荒野角色重置随机出生生存竞赛
[NETWORK] 网络与访问控制
[NETWORK] cluster_name = "永恒国度" ; 服务器名称(中文需引号) cluster_password = "" ; 访问密码 cluster_language = zhr ; 语言代码 lan_only_cluster = false ; 局域网限制 offline_cluster = false ; 离线模式 steam_group_only = false ; Steam组独占
[SHARD] 分片协调配置
[SHARD] shard_enabled = true ; 洞穴分片开关 master_ip = 127.0.0.1 ; 主分片IP master_port = 10888 ; 主分片端口 cluster_key = "dontstarve" ; 分片通信密钥

特别注意:当master_ip设置为127.0.0.1时,地面和洞穴必须在同一物理主机运行。如需分布式部署,需改为服务器公网IP并配置端口转发。

2.2 高阶调优参数

[MISC] console_enabled = true ; 控制台开关 max_snapshots = 6 ; 最大存档快照数 log_path = "logs" ; 日志目录 [STEAM] steam_group_id = 0 ; Steam组ID steam_group_admins = false ; 组管理员权限

避坑指南

  1. 修改max_players超过16时需同步调整操作系统的最大连接数限制
  2. tick_rate高于30可能增加客户端CPU负载
  3. Steam组相关配置仅在WeGame国际服生效

3. server.ini:世界分片精细控制

每个分片世界(Master/Caves)都有独立的server.ini,负责管理分片特有参数。地面与洞穴配置存在关键差异:

3.1 地面服务器(Master)配置范式

[NETWORK] server_port = 10999 ; 分片通信端口 [SHARD] is_master = true ; 主分片标识 name = Master ; 分片名称 id = 1 ; 分片ID [STEAM] master_server_port = 27018 ; Steam主端口 authentication_port = 8768 ; 认证端口

3.2 洞穴服务器(Caves)特殊配置

[NETWORK] server_port = 10998 ; 必须与地面端口不同 [SHARD] is_master = false ; 从分片标识 name = Caves ; 固定命名 id = 2 ; 需唯一且≠地面ID [ACCOUNT] encode_user_path = true ; 用户路径编码

端口配置对照表

分片类型推荐端口范围冲突检测
地面主端口10888-10898不可重复
地面分片端口10999-11009需唯一
洞穴分片端口10998-11008需唯一
Steam主端口27015-27025需唯一
认证端口8766-8776需唯一

实战技巧:使用netstat -ano命令检查端口占用情况,避免冲突导致分片无法启动

4. leveldataoverride.lua:世界生成的艺术

这个Lua脚本文件提供了超越游戏内建选项的世界定制能力,通过覆盖默认参数实现精准控制。

4.1 基础结构解析

return { override_enabled = true, -- 启用参数覆盖 unprepared = { -- 基础资源设置 berrybush = "often", -- 浆果丛数量 flint = "default", -- 燧石分布 }, animals = { -- 生物群落控制 beefalo = "rare", -- 牛群稀少 spiders = "often", -- 蜘蛛密集 }, misc = { -- 世界规则 season_start = "winter", -- 始于冬季 world_size = "huge", -- 巨型地图 } }

4.2 高阶地形控制参数

季节系统精细调控

misc = { autumn = "longseason", -- 秋季长度 winter = "veryshortseason", spring = "noseason", -- 禁用春季 summer = "default", season_start = "autumn", -- 起始季节 }

季节参数可选值:

  • 时长控制:"noseason", "veryshortseason", "shortseason", "default", "longseason", "verylongseason"
  • 起始季节:"autumn", "winter", "spring", "summer", "random"

生物群落密度梯度

resources = { trees = "always", -- 树木极多 grass = "rare", -- 草稀少 reeds = "never", -- 禁用芦苇 } monsters = { hounds = "often", -- 猎犬频繁 deerclops = "never", -- 禁用巨鹿 }

密度参数可选值:"never", "rare", "default", "often", "always"

4.3 洞穴专属配置项

overrides = { cave_ponds = "default", -- 洞穴池塘 lichen = "often", -- 苔藓分布 bats = "rare", -- 蝙蝠数量 earthquakes = "default", -- 地震频率 start_location = "caves" -- 洞穴出生 }

5. 配置文件联调实战案例

5.1 创建高难度生存世界

cluster.ini配置

[GAMEPLAY] game_mode = survival max_players = 8 pvp = true pause_when_empty = false [NETWORK] cluster_name = "地狱生存挑战" cluster_password = "hardcore" cluster_intention = madness

leveldataoverride.lua配置

return { override_enabled = true, unprepared = { berrybush = "rare", carrot = "never", flint = "rare" }, animals = { beefalo = "rare", rabbits = "rare" }, monsters = { hounds = "often", spiders = "often" }, misc = { season_start = "winter", wildfires = "often", world_size = "small" -- 小地图增加冲突 } }

5.2 构建建筑创作服务器

cluster.ini配置

[GAMEPLAY] game_mode = endless max_players = 16 pvp = false pause_when_empty = true [NETWORK] cluster_name = "创意工坊" cluster_description = "自由建造服务器"

leveldataoverride.lua配置

return { override_enabled = true, resources = { trees = "always", rock = "always", flint = "always" }, monsters = { hounds = "never", spiders = "never" }, misc = { boons = "always", -- 大量奖励 touchstone = "always"-- 多处复活台 } }

6. 常见故障排查手册

6.1 配置文件加载失败

症状:服务器启动时报错"Could not load configuration file"

  • 检查文件编码是否为UTF-8无BOM
  • 验证文件路径是否正确(注意WeGame版使用DoNotStarveTogetherRail目录)
  • 确认文件扩展名正确(非.txt后缀)

6.2 参数修改未生效

排查步骤

  1. 确认修改后保存文件
  2. 完全关闭服务器进程后重启
  3. 检查server_log.txt查看加载的配置
  4. 验证无重复参数定义

6.3 分片服务器连接异常

网络诊断流程

# 测试端口连通性 telnet 127.0.0.1 10888 # 查看端口占用 netstat -ano | findstr 10888 # 验证防火墙规则 netsh advfirewall firewall show rule name=all

7. 性能优化与安全配置

7.1 服务器性能调优

cluster.ini关键参数

[MISC] max_snapshots = 3 ; 减少存档快照 autosaver_enabled = false ; 禁用自动存档 [GAMEPLAY] tick_rate = 30 ; 平衡性能与流畅度

7.2 安全管理配置

管理员与名单控制

  1. 在存档目录创建admin.txt添加Klei ID
  2. 配置whitelist.txt实现白名单控制
  3. 使用blocklist.txt封禁问题玩家

网络加固建议

[NETWORK] cluster_password = "ComplexP@ssw0rd" lan_only_cluster = false offline_cluster = false

8. 配置版本管理与迁移

8.1 存档备份方案

# Windows备份脚本示例 @echo off set BACKUP_DIR=D:\DST_Backups set SAVE_PATH=%USERPROFILE%\Documents\Klei\DoNotStarveTogetherRail robocopy %SAVE_PATH% %BACKUP_DIR%\%date:~0,4%%date:~5,2%%date:~8,2% /MIR /Z

8.2 跨服务器迁移步骤

  1. 打包整个存档目录
  2. 复制cluster_token.txt和certificate.txt
  3. 同步mods文件夹内容
  4. 调整server.ini中的端口设置

9. 动态配置与热更新技巧

9.1 运行时参数调整

通过控制台命令动态修改配置:

-- 修改玩家数量上限 TheNet:SetMaxPlayers(12) -- 更改PVP状态 TheNet:SetPVPEnabled(true)

9.2 定时任务配置

使用Windows任务计划定期执行:

:: 每天重启服务器 schtasks /create /tn "DST_Restart" /tr "D:\DST\restart.bat" /sc daily /st 03:00

10. 可视化配置工具推荐

虽然手动编辑配置文件提供最大灵活性,但以下工具可提升效率:

  1. DST Server Setup Tool:图形化配置生成器
  2. Notepad++:支持INI/Lua语法高亮
  3. WinMerge:配置差异对比工具
  4. Process Explorer:服务器进程监控

终极建议:任何重要修改前备份原始配置,使用版本控制工具管理配置变更历史

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询