配置详解

EmakiCodex 的配置分为主配置、成就页配置和语言文件。本页说明 config.yml 与 lang/*.yml：

config.yml：全局开关、默认资源释放、成就注册和 PacketEvents 坐标通道。
lang/*.yml：命令与控制台提示。

advancements/*.yml 的页面与节点字段见成就页定义，自动授予的触发器见事件触发器。

config.yml

默认主配置：

yaml

version: "1.0.0"
language: "zh_CN"
release_default_data: true
op_bypass: false

advancement:
  enabled: true
  platform: unsafe
  announce-default: false
  remove-on-disable: true
  packet-coordinates: true
  triggers-enabled: true

debug: false

字段说明：

字段	类型	默认	说明
`version`	string	`1.0.0`	默认资源版本标记。
`language`	string	`zh_CN`	使用 `lang/<language>.yml` 语言文件。
`release_default_data`	boolean	`true`	缺失默认示例数据时是否释放内置 `advancements/example_page.yml`。
`op_bypass`	boolean	`false`	默认配置中保留的键。当前实现会读取该值但没有使用它的权限分支，OP 仍按 `paper-plugin.yml` 中的权限默认值获得管理权限。
`advancement.enabled`	boolean	`true`	是否启用原版 Advancement 注册。
`advancement.platform`	string	`unsafe`	动态注册平台。当前实现使用 Bukkit unsafe advancement 注册路径；留空时回退 `unsafe`。
`advancement.announce-default`	boolean	`false`	节点没有单独配置 `announce` 时，是否默认全服广播。
`advancement.remove-on-disable`	boolean	`true`	插件禁用时是否移除已注册的动态成就。`/codex reload` 的重建流程始终会先清理本插件命名空间再注册，不受此开关控制。
`advancement.packet-coordinates`	boolean	`true`	安装 PacketEvents 时，是否把节点 `x` / `y` 注入客户端成就树。该开关只在插件启用时决定是否注册 PacketEvents 监听，运行中切换需重启。
`advancement.triggers-enabled`	boolean	`true`	是否启用 `triggers.entries` 自动授予。关闭后只能通过命令、API 或 CoreLib Action 手动授予。
`debug`	boolean	`false`	默认配置中保留的键。当前实现不读取此键；调试开关通过 `/codex debug` 管理。

语言文件

语言文件位于 lang/*.yml。默认包含：

yaml

version: "1.0.0"
general:
  prefix: "<gray>[ <gradient:#F59E0B:#EC4899>EmakiCodex</gradient> ]</gray>"
  no_permission: "<red>你没有权限执行此操作。</red>"

command:
  help:
    commands:
      reload: "重载配置、重注册成就并给全员重发成就"
      grant: "授予玩家成就"
      revoke: "撤销玩家成就"
      debug: "管理 Debug 模式"

语言文本支持 MiniMessage。修改后执行 /codex reload。

修改 config.yml、advancements/*.yml 与 lang/*.yml 后，执行 /codex reload 应用变更。

配置详解 ​

config.yml ​

语言文件 ​

相关页面 ​

配置详解

config.yml

语言文件

相关页面