- 选择最接近你目标的配置分组。
- 点击字段，先看“什么时候需要修改”。
- 复制 YAML 片段并只替换需要的值。
主配置 config.yml
服务器标识、默认语言、数据库、资料保存、渲染距离与 GUI 防抖。
- 群组服的每台后端服应使用唯一 server-id。
- 数据库类型与连接参数修改后建议完整重启。
- accessory-update-ticks 越低更新越频繁。
主配置
config.yml以下内容来自插件当前默认资源。先确定你想改变的功能，再选择配置分组；技术路径只用于在 YAML 中准确定位。
先看懂这个文件
服务器、数据库与渲染
定义 server-id、默认语言、SQLite/MySQL/MariaDB、连接池、资料超时与自动保存、限时检查、观察距离、配饰刷新和 GUI 点击防抖。
config-version / server-id / default-localedatabase.type / sqlite.file / mysql.* / pool.*profile.load-timeout-seconds / autosave-seconds / expiration-check-secondsrender.view-distance / accessory-update-ticks / respect-player-visibilityrender.actual-equipment.*gui.click-cooldown-ms
完整入门示例
server-id: "survival-1" default-locale: "zh_cn" database: type: "MYSQL" render: view-distance: 64.0 accessory-update-ticks: 2
03字段教程
整数
Config Version
config-version
这项配置控制什么
配置版本。插件会拒绝加载未知版本，避免错误解释配置。
什么时候需要修改
只有默认行为不符合你的服务器需求时才修改；不确定用途时保留默认值最安全。
可以怎样填写
整数：填写不带引号的完整数字。
当前默认值
1可复制的 YAML 片段
# 这是文件根级字段
config-version: 1修改步骤
- 先在服务器中找到路径
config-version。 - 填写数字；除非原文件原本带有引号，否则不要自行添加。
- 保存文件并执行
/fc reload，随后查看控制台。
注意事项
保持原有 YAML 缩进。建议一次只修改一个字段，保存后立即重载并查看控制台。