条目/分类教程
在本页中你可以找到条目或分类的完整配置文件。每次你对这些文件的改动都可以通过 /codex reload
命令应用。
界面物品
每个物品的格式如下:
inventory_items:
<类型>:
<物品>
信息
需要注意的是在这里显示的 item
有一些属性,可以在这里浏览。
信息
你可以在这些物品的名称与描述中使用 PlaceholderAPI 变量。
1. 分类
每个分类都会在主界面中有代表物品。你可以在这里告诉玩家分类的条目数,以及它的相关介绍。
category:
id: MAP
name: "&7分类: #6bcbfe&l世界区域"
lore:
- "#eeeeee你探索过的区域都会显示在这里."
- ""
- "&7进度: %unlocked% &8[%progress_bar%&8] &8(&7%percentage%&8)"
可用变量:
%unlocked%
(会被下列 message.yml 对应键的消息替代,取决于发现的条目数:currentUnlockedDiscoveriesColorNone
、currentUnlockedDiscoveriesColorAll
、currentUnlockedDiscoveriesColorIncomplete
)%progress_bar%
(显示此分类解锁进度的进度条)%percentage%
(显示此分类解锁进度的百分比)
2. 已解锁条目
在条目已解锁时显示在分类界面的物品样式。
discovery_unlocked:
id: PAPER
name: "%name%"
lore:
- "%description%"
- ""
- "&8于 %date% 发现"
可用变量:
%name%
(条目名称)%description%
(条目描述)%date%
(条目解锁的日期)
3. 未解锁条目
在条目未解锁时显示在分类界面的物品样式。
discovery_blocked:
id: GRAY_DYE
name: "&c??"
lore:
- "&7尚未发现该条目中的对应内容."
奖励
奖励通过动作给予。所有动作可在这里找到。
单条目
发现该分类条目内容时执行的默认动作。
rewards:
per_discovery:
- "centered_message: #6bcbfe&m00 00"
- "centered_message: "
- "centered_message: #eeeeee&l日志已更新"
- "centered_message: &7世界区域: %name%"
- "centered_message: "
- "centered_message: &7通过命令 #eeeeee/codex &7打开"
- "centered_message: "
- "centered_message: &7奖励: &a+50XP"
- "centered_message: "
- "centered_message: #6bcbfe&m00 00"
- "title: 20;60;20;#eeeeee&l日志已更新;&7区域名称: %name%"
- "playsound: BLOCK_GILDED_BLACKSTONE_STEP;10;0.1"
- "console_command: xp give %player% 50"
可用变量:
%name%
(发现条目的名称)%player%
(玩家名称)
全解锁
发现该分类条目所有内容时执行的默认动作。
rewards:
all_discoveries:
- "centered_message: #6bcbfe&m00 00"
- "centered_message: "
- "centered_message: #eeeeee&l日志分类已完成"
- "centered_message: &7世界区域"
- "centered_message: "
- "centered_message: &7祝贺!"
- "centered_message: "
- "centered_message: &7奖励: &a+5000XP"
- "centered_message: "
- "centered_message: #6bcbfe&m00 00"
- "title: 20;60;20;#eeeeee&l日志分类已完成;&7世界区域"
- "playsound: BLOCK_GILDED_BLACKSTONE_STEP;10;0.1"
- "console_command: xp give %player% 5000"
可用变量:
%player%
(玩家名称)
发现条目
发现条目必须按如下格式添加至 discoveries
部分。
discoveries:
<条目 ID>:
name: <名称>
description:
- <描述内容>
名称
条目的名称。会展示在界面及消息文本中。
name: "#6bcbfe&l阴影沼泽"
描述
条目的描述。会展示在界面及消息文本中。
description:
- "#eeeeee阴影沼泽中所发现的异象."
- "#eeeeee难以战胜."
- ""
- "&7掉落物:"
- "&8❱ #eeeeee阴影魔药 &8(25%)"
- "&8❱ #eeeeee铁锭 &8(90%)"
发现条件
决定该条目可被发现的条件。
WorldGuard 区域
对应条目会在进入 WorldGuard(https://dev.bukkit.org/projects/worldguard)区域时解锁。
将 type
设置为 WORLDGUARD_REGION。
value.region_name:
区域名称。
discovered_on:
type: WORLDGUARD_REGION
value:
region_name: shadow_swamp
击杀实体
对应条目会在击杀原版实体时解锁。
将 type
设置为 MOB_KILL。
value.mob_type:
实体类型。所有可用实体列表可在这里查询:https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html
value.mob_name:
可选。实体的自定义名称。请勿使用颜色字符。
discovered_on:
type: MOB_KILL
value:
mob_type: ZOMBIE
mob_name: Shadow Warrior
击杀 MythicMobs 实体
对应条目会在击杀 MythicMobs 实体时解锁。
将 type
设置为 MYTHIC_MOB_KILL.
value.mob_type:
MythicMobs 实体的 ID。你可以使用“;”表示多个 ID。
::::
点击动作
在玩家点击与已解锁条目相关内容时触发的动作。所有动作可在这里浏览。可选。
click_actions:
- "console_command: warp shadow_swamp %player%"
自定义界面物品
你可以将分类界面物品替换为只对该条目生效的内容。
已解锁条目
显示在分类界面的已解锁条目物品。所有来自于这里的变量都可使用。
inventory_items:
discovery_unlocked:
id: PAPER
name: "%name%"
lore:
- "%description%"
- ""
- "&8于 %date% 发现"
- ""
- "&a&l点击 &a传送."
未解锁条目
显示在分类界面的未解锁条目物品。所有来自于这里的变量都可使用。
自定义奖励
你可以将条目的单独奖励替换为只对该条目生效的内容。
rewards:
- "centered_message: #6bcbfe&m00 00"
- "centered_message: "
- "centered_message: #eeeeee&l日志已更新"
- "centered_message: &7世界区域: %name%"
- "centered_message: "
- "centered_message: &7可通过命令 #eeeeee/codex &7查看"
- "centered_message: "
- "centered_message: &7奖励: &a+300XP&7, &a$5.000"
- "centered_message: "
- "centered_message: #6bcbfe&m00 00"
- "title: 20;60;20;#eeeeee&l日志已更新;&7世界区域: %name%"
- "playsound: BLOCK_GILDED_BLACKSTONE_STEP;10;0.1"
- "console_command: xp give %player% 300"
- "console_command: eco give %player% 5000"