DeerFoliaPlus · 配置文件总览
查找 DeerFoliaPlus 配置文件、运行数据和重启规则。
配置文件和运行数据
DeerFoliaPlus 的核心设置位于服务器根目录的 config/：
| 文件或目录 | 作用 | 读取时机 |
|---|---|---|
| config/deer-folia-plus.yml | FakePlayer、要塞、协议、配方同步、姿态等开关 | 核心启动加载 |
| config/custom-recipes.yml | 自定义配方定义 | custom-recipe.enabled 开启后加载 |
| worlds/world-name/fakeplayer.dat | 已保存假人的列表 | 世界存档加载 |
| worlds/world-name/fakeplayerdata/ | 已保存假人的 NBT 数据 | 假人保存或加载 |
| syncmatica/litematica/ | Syncmatica 已上传的投影文件 | Syncmatica 开启后使用 |
| syncmatica/temp/ | Syncmatica 上传过程的临时文件 | Syncmatica 运行时使用 |
FakePlayer 数据跟随对应世界存档，不在 plugins/ 中。Syncmatica 文件位于服务器根目录的 syncmatica/，需要和世界、配置一起备份。
配置如何生成
核心第一次加载配置时会生成 config/deer-folia-plus.yml。Java 的 camelCase 字段名会转成 kebab-case。例如，amountPerPlayer 变成 amount-per-player，skipFabricOnViaNonNative 变成 skip-fabric-on-via-non-native。
开启 custom-recipe.enabled 后，核心会在 config/ 下创建 custom-recipes.yml。文件默认没有启用配方。请在 recipes 节点中添加内容。解析失败时先看完整启动日志，不要先删除文件。
推荐修改顺序
- 停止服务器。等待世界保存完成。
- 备份
config/deer-folia-plus.yml、config/custom-recipes.yml、世界目录和syncmatica/。 - 只修改一个功能组或一个配方。
- 检查 YAML 缩进、引号、列表和命名空间。
- 启动测试目录。查看完整日志。
- 使用实际玩家、客户端组件和目标世界测试。
- 将测试通过的修改迁移到生产目录。
重启和客户端边界
deer-folia-plus.yml 在核心启动阶段加载。配置修改后重启服务器。Bukkit 或 Paper reload 不会重新加载核心配置。自定义配方在服务器加载阶段注册。修改后重启并检查注册数量。
Syncmatica、Servux 和 Recipe Sync 同时受服务器开关、客户端支持和协议兼容性影响。服务器配置为 true 不代表没有匹配客户端组件的玩家也能使用这些功能。
YAML 注意事项
- YAML 使用空格。不要使用 Tab。
- 布尔值写
true或false。不要加引号。 - 消息、命名空间和包含冒号的值使用引号。
- 自定义配方中的 item 使用完整命名空间，例如
minecraft:diamond。 - 修改前保留可恢复副本。
- 出现未知键或解析错误时，先恢复最近一次能启动的文件。