任务与奖励
750 字约 3 分钟
本页列出 orders.yml 支持的所有任务类型与奖励类型,以及插件实际会统计什么。
任务类型
break_block
quest:
mine_stone:
type: break_block
item: stone
amount: 16玩家每破坏一个指定材料的方块,进度 +1。 被取消的破坏事件不会计数;玩家自己放置的方块同样会正常计数。
place_block
quest:
build_wall:
type: place_block
item: dirt
amount: 8玩家每放置一个指定材料的方块,进度 +1。
mob_kill
quest:
hunt_zombies:
type: mob_kill
mob: zombie
amount: 5玩家击杀指定实体类型的生物时,进度 +1。 击杀者从伤害来源解析,因此用弓箭击杀也会计数。 如果生物死亡时没有玩家作为造成伤害的实体,则不会计数。
fish
quest:
catch_cod:
type: fish
item: cod
amount: 1成功钓上指定材料的物品时,进度 +1。 空竿、或者钓上其他物品都不会计数。
feed
quest:
feed_cows:
type: feed
mob: cow
amount: 2玩家手持该动物接受的食物右键点击指定动物时,进度 +1。 可接受的食物由插件固定:
| 实体 | 可接受食物 |
|---|---|
cow、sheep、horse、llama | wheat |
pig、rabbit | carrot |
chicken、parrot | wheat_seeds |
fox | sweet_berries |
turtle | seagrass |
wolf | bone |
cat | cod 或 salmon |
只有表中的动物能用于喂食任务。右键其他动物,或手持其他物品,都不会增加进度。
奖励类型
奖励列表会从上到下依次读取,每个条目使用 ; 分隔:
reward:
- 'item;diamond;16'
- 'company_income;1500.0'
- 'money;100.0'
- 'experience;10'
- 'console_command;say %player% 完成了一个订单!'item
item;<材料>;<数量>把物品放进玩家背包。 材料或数量无效时会跳过该奖励行。订单完成前请确认玩家背包有足够空间。
company_income
company_income;<金额>把金额加到公司余额,并计为公司收入。 它会触发公司收入事件,因此会计入当日收入,并像其他公司收入一样纳税。详见 公司资金。
money
money;<金额>通过 Vault 把金额存入玩家余额。
experience
experience;<数量>给予玩家对应数量的经验值。
console_command
console_command;<指令>以控制台身份执行指令,%player% 会替换为玩家名称。 指令不要带开头的斜杠,例如 say %player% 完成了一个订单!。
由于条目按 ; 分割,指令本身不能包含分号。 控制台指令会在订单完成时执行,但不会显示在订单菜单的奖励行里。
菜单显示的内容
订单菜单会从语言文件拼装每个订单条目:
quest-progress—— 单行进度,使用%action_description%、%target%、%progress_value%、%target_value%action-description.*—— 动作名称,例如Break block(s)rewards.item、rewards.company_income、rewards.money、rewards.experience—— 奖励标签order-finished—— 订单完成后代替进度显示menu.orders.items.order.display_name与.lore—— 订单条目本身
%quest_progress% 与 %order_reward% 会被替换为多行内容,因此菜单 lore 中的一行占位符会展开成每个任务或每个奖励一行。
菜单文件与语言路径的规则见 菜单配置。