条目/分类教程
在本页中你可以找到条目或分类的完整配置文件。每次你对这些文件的改动都可以通过 /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 区域时解锁。
将 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%"点击动作冷却
在玩家点击与已解锁条目相关内容时触发动作的冷却时间（单位为秒）。
click_actions_cooldown: 60自定义界面物品
你可以将分类界面物品替换为只对该条目生效的内容。
已解锁条目
显示在分类界面的已解锁条目物品。所有来自于这里的变量都可使用。
inventory_items:
discovery_unlocked:
id: PAPER
name: "%name%"
lore:
- "%description%"
- ""
- "&8于 %date% 发现"
- ""
- "&a&l点击 &a传送."未解锁条目
显示在分类界面的未解锁条目物品。所有来自于这里的变量都可使用。
inventory_items:
discovery_blocked:
id: GRAY_DYE
name: "&c??"
lore:
- "&7尚未发现该条目中的对应内容."
- ""
- "&7提示: 重要的城市."自定义奖励
你可以将条目的单独奖励替换为只对该条目生效的内容。
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"
SnowCutieOwO