订单配置
911 字约 3 分钟
订单定义在 plugins/MyCompany/orders.yml。 文件不存在时会在首次启动时生成,并在服务器启动时读取。
文件结构
orders.yml
stone_breaker:
label: '石头破坏者'
description:
- '&7我们接到了矿工委托'
- '&7需要处理一批石头'
quest:
1:
type: break_block
item: stone
amount: 16
reward:
- 'item;diamond;16'
- 'company_income;1500.0'
- 'money;100.0'
- 'experience;10'| 键 | 说明 |
|---|---|
| 订单 id | 顶层 key(例如 stone_breaker),管理员指令与玩家数据都会用到。请保持稳定。 |
label | 菜单中显示的名称。支持 & 颜色代码。 |
description | 菜单中显示的 lore 行列表。支持 & 颜色代码。 |
quest | 必需。下面的每个 key 都是一个必须完成的任务。 |
reward | 整个订单完成后发放的奖励列表。 |
任务(quest)
quest:
quest_id:
type: break_block
item: stone
amount: 16- 任务 id(上例中的
quest_id)可以任意命名,只需在同一订单内唯一。 type是五种任务类型之一,详见 任务与奖励。break_block、place_block、fish需要item。mob_kill、feed需要mob。amount是目标数量,必须是正整数。
订单里的每个任务都必须完成。不存在“任一任务完成即可”的写法:五个任务就意味着五个都要完成。
奖励(reward)
reward:
- 'item;diamond;16'
- 'company_income;1500.0'
- 'money;100.0'
- 'experience;10'
- 'console_command;say %player% 完成了一个订单!'每个条目用分号分隔。可用类型与参数见 任务与奖励。
item发放物品,money给玩家发钱,experience给玩家发经验。company_income会增加公司余额,并计入公司收入。console_command以控制台身份执行指令,%player%会替换为玩家名称。- 格式错误的条目会被跳过,其他奖励仍会照常发放。
- 菜单的奖励列表会显示
item、company_income、money、experience;指令会执行,但不会显示在菜单的奖励行中。
新增订单
- 在
orders.yml顶层新增一个块,使用新的订单 id。 - 填写
label和description。 - 在
quest下至少添加一个任务。 - 在
reward下添加奖励。 - 重启服务器。
/myc reload不会重新读取orders.yml。 - 新订单会在下一次每日刷新时加入随机池。
插件每个玩家分配 5 个随机订单。这个数量是固定的,不是配置项。 如果文件中的订单少于 5 个,则全部都会分配;多于 5 个时随机抽取 5 个。
删除或重命名订单
玩家数据会在每日列表和进度数据中保存订单 id。
- 如果删除一个仍在玩家每日列表里的订单,该条目可能无法正常显示,也无法完成,直到下一次每日刷新。
- 建议在接近刷新时间时删除订单,或者接受受影响玩家在下一次刷新前看到异常条目。
- 重命名 id 相当于创建新订单,旧进度会留在旧 id 下。
- 最稳妥的顺序是:删除或重命名订单 → 重启服务器 → 等下一次刷新生成新的每日列表。
校验
- 没有
quest区块的订单在分配时会出错,因为插件要求至少有一个任务。 - 未知的
type永远不会增加进度,订单无法完成。请使用文档中的五种类型之一。 - 物品与实体名称是 Bukkit 名称,比较时不区分大小写,
stone和STONE都可以。 amount按整数读取;缺失或不是数字时按0处理。- 刷新时间由
config.yml中的company-funds.cost-per-day.tax-time决定,详见 员工订单。
订单菜单的布局见 菜单配置。它的文本位于语言文件的 menu.orders 下。