专精方向配置
1592 字约 5 分钟
一个专精方向由 plugins/MyCompany/focus/ 中的 YAML 文件定义。文件名就是专精方向 id,例如 mob.yml 定义 mob 专精方向。
提示
focus/none.yml 与 focus/mob.yml 中的树都是示例。你可以随时增删、重命名或重写专精;本节页面描述的是默认内容。
当前构建只加载 none 与 mob 两个专精方向 id;新增一个专精方向文件不会被当成第三个专精方向。不过这两个文件里的专精树完全可以自由编辑。
插件目录下的 focus.yml 仍然包含 focus-tree 区块,但该区块已经不再被读取。请始终修改 focus 文件夹里的文件。
文件生成
- 第一次启动且
generate-default-config为true时,focus/none.yml与focus/mob.yml会作为示例从 jar 复制出来。 - 该次启动结束时,插件会把
generate-default-config设回false。 - 如果某个专精方向文件缺失,把
config.yml中的generate-default-config设为true并重启服务器即可重新生成。 不要删除仍有公司在使用的专精方向文件;插件会在启动时加载它们对应的专精树。
专精方向文件结构
focus/mob.yml
id: mob
label: Mob
description:
- 'Focus on killing mobs'
- 'Four branches: zombie loot, general loot, combat and company profit.'
condition:
company_money: 60000
expertise:
zombie_loot_1:
label: 'More Zombie Loot I'
description:
- '&7Zombie drops: &a30% &7chance of &a+1 rotten flesh&7.'
value_type: boolean
default:
value: 'false'
condition:
company_money: 15000
effect:
mob_drops_add:
ZOMBIE:
- 'ROTTEN_FLESH,+1,30'
action:
console_command:
- 'eco give %player% 500'| 键 | 说明 |
|---|---|
id | 仅作说明。实际专精方向 id 来自文件名。 |
label | 专精方向的显示名称。缺失时回退为 id。 |
description | lore 行列表。支持 & 颜色代码。 |
condition | 选择该专精方向的条件。可选。资金条件会被检查,但在这里不会扣除。 |
expertise | 专精树的节点。该区块必须存在。 |
专精字段
| 键 | 说明 |
|---|---|
label | 节点的显示名称。缺失时回退为 No Label。 |
description | 菜单中显示的 lore 行列表。 |
value_type | boolean、integer、double 或 string。省略时默认为 boolean。 |
default.value | 节点学习前保存的初始值,必须与 value_type 匹配。 |
condition | 解锁节点的条件。必需;没有要求时写 condition: {}。 |
effect | 节点学习期间生效的加成。可选。 |
action | 节点解锁时执行一次的动作。可选。 |
注意
每个专精都必须有 condition 区块,即使它是空的。缺少该区块会导致专精方向加载失败,因此没有要求时请写 condition: {}。
增删改专精
专精树在启动时从文件读取,因此以下修改都不需要改代码。修改后请重启服务器。
- 新增:在
expertise下新增一个 key,并填写上面的字段。condition: {}的节点可以立即学习。 - 删除:删除对应区块。已保存的进度会留在公司数据中但被忽略。请检查是否有其他节点把它列为前置,或在
disable_expertise/enable_expertise中引用它。 - 重命名:修改节点的 key。公司会失去旧 id 的进度,因为进度按 id 保存。
- 修改:直接修改已有节点的费用、条件、效果、动作、标签与描述。
- 查看:在游戏内打开专精菜单,树会显示文件当前的标签、条件与费用。
两个专精方向文件中的 id 必须全局唯一。同一个 id 使用两次时,后加载的会覆盖前一个的配置与标签。
已有节点的 value_type 请保持不变。之后修改 value_type 会使该节点的旧存档数据无法读取。
本地化
首次启动且 generate-default-config: true 时,插件会用所选语言文件中的文本覆盖每个专精方向与专精的标签、描述:
lang/zh_CN.yml
focus:
focus:
mob:
label: 'Mob'
description:
- '专注于击杀怪物'
- '四条分支: 僵尸战利品、通用战利品、战斗与公司收益。'
expertise:
zombie_loot_1:
label: '僵尸战利品 I'
description:
- '&7僵尸掉落: &a30% &7概率额外获得 &a+1 腐肉&7。'这些文本会写回 focus/*.yml,因此首次启动后,focus/ 中的文件就是实际生效的来源。
- 之后想应用语言文件里的改动,把
config.yml中的generate-default-config设为true并重启。 - 语言文件缺少条目时,描述会变成空,专精标签会显示
No Label。 - 菜单标题与按钮文本是另一套,位于语言文件的
menu.focus与menu.focus_list下。
应用修改
修改 focus/ 中的任何内容后,请重启服务器。配置重载主要用于菜单与语言文件;专精相关修改通过重启应用可以避免旧的专精列表残留。
进度按专精 id 保存。重启后:
- 新节点以
default.value作为初始状态,处于未学习状态 - 被删除的节点不再加载,但它们的进度仍留在公司数据中
- 重命名 id 会使公司失去旧 id 的进度
校验规则
- 专精 id 必须在所有专精方向文件中唯一,因为条件与标签都按 id 缓存。
condition与effect的 id 区分大小写。请使用 条件、效果与动作(在新窗口打开) 中的准确小写 id。- 未知的 condition id 会被静默忽略,等同于移除该条件。请仔细检查拼写。
- 未知的 effect 与 action id 会记录警告并被跳过。
- 格式错误的 effect 参数(例如未知的材料或实体类型)会在加载专精方向时抛出错误。
- 实体 key 使用 Bukkit 实体类型(
ZOMBIE、SKELETON、CREEPER);物品 key 使用 Bukkit 材料(ROTTEN_FLESH);两处都接受ALL。
常见问题
| 现象 | 原因 |
|---|---|
| 已学会的节点从菜单消失 | 它被 disable_expertise 动作禁用了。学习重新启用它的节点即可。 |
| 修改没有效果 | 服务器没有重启。修改 focus/*.yml 后请重启。 |
专精显示 No Label | 语言文件没有对应条目,且首次启动的本地化已经执行过。 |
| 专精方向文件没有生成 | generate-default-config 已经是 false。设为 true 后重启。 |
| lore 中缺少某条条件 | 条件 id 未知,被插件忽略了。检查拼写。 |
| 某个条件永远不满足 | 专精 id 属于其他专精方向,或者击杀数量还没有达到要求。 |
| 插件加载专精方向失败 | 某个专精缺少 condition,或者 effect 参数无效。查看控制台中的专精方向与专精 id。 |