我的世界插件Additions+ | Custom Commands, Menus, Books, Actions, 1.8-1.14 2.2.4

— 翻译 –翻译我想
翻译的高级资源

PlaceholderAPI是一种软依赖。安装它以在动作、物品知识、物品名称、书籍和所有其他文本中使用占位符。

MVdWPlaceholderAPI是一个软依赖。安装它以在动作、物品知识、物品名称、书籍和所有其他文本中使用占位符。

Vault是一种软依赖。安装它以使用 [money]、[permission]、[group] 和 [price] 操作。

头部数据库是软依赖。安装它以使用其插件中的自定义头像。使用格式hdb-<headID>作为材料名称。

ProtocolLib是一个软依赖。安装它以使用 [language] 操作。

MineTopiaSDB是一个软依赖。安装它以使用他们的自定义事件。

ASkyBlock是一个软依赖。安装它以使用他们的自定义事件。

/Command – 命令描述 -权限

/additions – 主命令 – additions.command
/additions togglescoreboard – 切换记分板 – additions.command.togglescoreboard
/additions menus – 注册菜单列表 – additions.command.menus
/additions books – 已注册书籍列表 – additions.command.books
/additions commands – 已注册命令列表 – additions.command.commands
/additions items – 已注册项目列表 – additions.command.items
/additions reload – 重新加载插件 – additions.command.reload
/additions giveitem <item> [player] – 给自定义物品（给玩家） – additions.command.giveitem
/additions givebook <book> [player] – 给自定义书（给玩家） – additions.command.givebook
/additions openmenu <menu> – 打开自定义菜单 – additions.command.openmenu

/customitem info <item> – 获取项目的所有信息
/customitem create <name> – 创建当前 handitem 的项目
/customitem remove <item> – 删除项目
/customitem setamount <item> <amount> – 设置数量the item
/customitem setdisplayname <item> <name> – 设置项目的显示名称
/customitem setslot <item> <slot> – 设置项目的插槽
/customitem setcooldown <item> <cooldown> – 设置冷却时间item
/customitem setcooldownmessage <item> <message> – 设置冷却消息
/customitem setpermission <item> <permission>- 设置项目的权限
/customitem setnopermission <item> <message> – 设置项目的 noPermission 消息
/customitem actions <item> – 获取项目的操作列表
/customitem addaction <item> <action> – 添加一个操作到项目的操作列表
/customitem removeaction <item> <actionInteger> – 从项目的动作列表中删除一个动作
/customitem lore <item> – 获取项目的知识
/customitem addlore <item> <lore> – 在项目的知识中添加知识行
/ customitem remoplore <item> <loreInteger> – 从项目的知识中删除知识行

这不是一个复杂的系统。您只需将事件名称（请参阅事件列表）放入文件中，添加：在它后面，然后按 enter，添加 2 个空格，键入actions:，按 enter，然后在actions:下键入一行 (-) 并将 action 放在其中。如需更多操作，只需添加更多行。

join:
描述：当玩家第一次加入服务器时
触发 join:
描述：当玩家第一次加入服务器时触发
leave:
描述：当玩家离开服务器时触发
drop:描述
：当玩家掉落物品时触发 – %dropped% : 返回掉落的物品名称 fishing: description:当玩家抓到鱼占位符时触发：

– %fished% ：返回捕获的鱼/物品名称
kill：
描述：当玩家杀死另一个玩家
占位符时触发：-
%killed% ：被杀死的玩家的名字
dead： 描述
：当玩家死亡时触发:当玩家 剪掉 一个实体时触发_ _ _ _ consumed% : 消耗物品的显示名称 entitykill:

描述：当玩家杀死一个实体（不是玩家）时触发
占位符：
– %killed% ：被杀死的实体类型名称

下面的剧透是来自另一个插件的事件。
如果您不想对该事件执行操作，只需删除事件类型（请参阅事件列表中带下划线的词）或将该事件的操作设置为 []。一个例子是：
代码（YAML）：

加入：
动作：[]

还有可能设置玩家的死亡、加入和离开消息。如果你想删除它，只需将它设置为”。
正确的使用方法是：
代码 (YAML):

join:
joinMessage: ‘&a&l%player% joined the server’
actions: []
leave:
leaveMessage: ‘&c&l%player% 离开了服务器’
actions: []
dead:
deathMessage: ‘&c%player% 很快就要以幽灵的身份主持他自己的葬礼。请在那里，他会喜欢的。&lR.IP’
actions: []

使用这个简单的系统创建自定义命令并不难。它实际上与事件的工作方式相同，但您在 commands.yml 文件中执行此操作，而不是事件名称，您键入命令。
所有动作都可以用于事件或命令。
代码 (YAML):

help: # 将是 ‘/help’ ingame
actions:
– ‘[msg]&7—- &bHelp Menu &7—-‘
– ‘[msg]&b/helpop &7Get help from an operator’
– ‘[消息]&r’

actions:
– ‘[msg]&7—- &bHelp Menu &7—-‘
– ‘[msg]&b/helpop &7Get help from an operator’
– ‘[msg]&b/help 2 &7帮助菜单的下一页
– ‘[msg]&r’
– ‘[msg]&fpage 1/2’
help 2: # would be ‘/help 3’ ingame
actions:
– ‘[msg]&7—- &bHelp Menu &7—-‘
– ‘ [msg]&b/server &7选择服务器’
– ‘[msg]&b/help 1 &7帮助菜单的上一页’
– ‘[msg]&r’
– ‘[msg]&fpage 2/2’

命令可以有占位符参数。
参数的占位符是：{integer}、{double}、{boolean}、{string}、{player} 和 {}。

但是 {}（空括号）是一个没有限制或什么都没有的长消息。 所以你 可以用它来使它成为一个 广播 命令
：在行动中。 如果您的命令是“test this is a {string}”，则您有 4 个参数。格式为{arg<NUMBER>}。因此，{arg1} 返回“this”，{arg2} 返回“is”，{arg3} 返回“a”，{arg4} 返回指定的字符串。 命令也可以有权限。如果不指定权限，则任何人都可以执行该命令。如果您确实指定了权限，则播放器需要它来执行它。

如果玩家没有权限，将向玩家发送 noPermission 消息。这可以在每个命令中指定。如果您不指定 noPermission 消息，将发送默认消息：“&c您无权执行此操作”。
权限和 noPermission 消息的正确用法是：
Code (YAML):

rankup 3:
permission: yourperm.rankup.2
noPermission: ‘&cYou must be at least rank 2 to rankup to rank 3. You can buy ranks in our store. ‘
actions:
– ‘[title]&a&lRANKED UP\n&7你现在是 3 级了！’
– ‘[msg]&a恭喜！你现在排名第三。
– ‘[console]pex user %player% add yourperm.rankup.2’

Additions+ 还提供了在命令中使用冷却时间。您可以为命令添加冷却时间。您还可以向命令添加 cooldownMessage。当该玩家的命令处于冷却状态时，此消息将发送给该&#8203;&#8203;玩家。在剩余时间的 cooldownMessage 中使用 %time%。
这些功能的正确用法是：
代码 (YAML):

mycommand:
cooldown: 1200 # 1200/20 = 60 seconds ( 1 minute )
cooldownMessage: ‘&c你每分钟只能使用这个命令一次。您必须等待另一个 %time%’
操作：
– ‘[msg]&aThis is a command with a cooldown’

创建自定义菜单并不难。该插件在启用时会自动生成一个“菜单”文件夹。在该文件夹中，您可以创建自定义菜单。每个菜单都在其自己的 YAML 文件中分开。菜单的名称是不带.yml 的文件名。

您只需创建一个名为菜单名称的 YML 文件。您只能使用此名称在 /additions 命令或操作中打开菜单。
示例：example.yml。您可以使用/additions openmenu example打开此菜单。

您可以从字面上设置新版本中项目的所有内容。您可以添加附魔，添加物品标志以隐藏附魔，以及所有其他东西。请注意，所有消息都支持颜色代码和占位符。
以下是您可以为菜单设置的非项目选项：
title:
描述：菜单的标题
类型：String
必需：true
command：
描述：打开菜单的命令
类型：String
必需：true
size：
描述：菜单的大小。必须是 9,18, 27, 36, 45 或 54。
类型：整数
需要：true
权限：
描述：打开菜单所需的权限
类型：字符串
noPermission：
描述：当玩家不打开菜单时将发送的消息’ 具有打开菜单的指定权限
类型：字符串
cooldown：
描述：玩家可以再次打开菜单之前的冷却时间（以滴答为单位）。（1 秒 = 20 个刻度）
类型：Long
cooldownMessage：
描述：当玩家处于该菜单的冷却时间时将发送的消息。剩余时间使用 %time%
类型：String
openActions：
描述：当玩家打开菜单时将执行的操作
类型：String List
closeActions
描述：一旦玩家关闭菜单将执行的操作
类型：String List
如果您设置所有这些，您的文件将如下所示：
现在您已准备好将内容添加到菜单中。您在内容部分下添加所有项目。然后在其下方括号之间添加槽号（从 1 开始，而不是 0）：“1”。像这样：
代码（文本）：
内容：
‘1’：
‘2’：
然后你设置项目信息。以下是您可以添加到项目以对其进行自定义的所有选项的列表，这实际上是一切可能。
材料：
描述：项目的材料类型。如果您有 HeadDatabase 插件，您可以使用“hdb-<headID>”将此项设置为自定义头部。将 <headID> 替换为头部的 ID。您还可以使用“head-<player>”设置玩家头部。将 <player> 替换为玩家名称（这也支持占位符 %player%）
类型：材料类型
必需：真实
数据：
描述：项目的数据（仅适用于 1.8-1.12）
类型：字节（整数）显示名称
：
描述：项目的显示名称（标题）
类型：
必需：真实
数量：
描述：物品的数量
类型：整数
耐久性：
描述：物品的耐久性
类型：短（整数）
知识：
描述：物品的知识
类型：字符串列表项目标志
：
描述：物品标志的项目。单击此处获取项目标志列表
类型：ItemFlag 附魔列表
：
描述：应用于项目的附魔。要设置附魔级别，请使用格式 ENCHANTMENTEVEL (DURABILITY:3)。单击此处查看 1.12.2 附魔列表。
类型：附魔列表
牢不可破：
描述：物品是否应该牢不可破
类型：布尔值
left_click_commands：
描述：左键单击项目时将执行的操作
列表类型：字符串列表
right_click_commands：
描述：右键单击项目时将执行的操作列表
类型：字符串列表
如果你做了所有这些，文件看起来像：
Oof。您现在知道如何创建菜单

自定义项与菜单中的项具有完全相同的可能性，并且工作方式完全相同。以下是您可以更改项目的所有内容的列表。
插件包含两个示例项目，一旦插件运行，它们将被放入插件文件夹中。

permission:
描述：打开菜单需要的权限
类型：字符串
noPermission：
描述：当玩家没有打开菜单的指定权限时将发送的消息
类型：字符串
cooldown：
描述：玩家可以再次打开菜单之前的冷却时间（以滴答为单位）。（1 秒 = 20 ticks）
类型：Long
cooldownMessage：
描述：当玩家处于该菜单的冷却时间时将发送的消息。剩余时间使用 %time%
类型：字符串
操作：
描述：单击项目时将执行的操作列表
类型：字符串 列表

材料：
描述：项目的材料类型。如果您有 HeadDatabase 插件，您可以使用“hdb-<headID>”将此项设置为自定义头部。将 <headID> 替换为头部的 ID。您还可以使用“head-<player>”设置玩家头部。将 <player> 替换为玩家名称（这也支持占位符 %player%）
类型：材料类型
必需：真实
数据：
描述：项目的数据（仅适用于 1.8-1.12）
类型：字节（整数）显示名称
：
描述：项目的显示名称（标题）
类型：字符串
必需：真实
数量：
描述：项目的数量
类型：整数
耐久性：
描述：项目的耐久性
类型：短（整数）
知识：
描述：项目的知识
类型：字符串列表项目标志
：
描述：项目的项目标志。单击此处获取项目标志列表
类型：ItemFlag 附魔列表
：
描述：应用于项目的附魔。要设置附魔级别，请使用格式 ENCHANTMENTEVEL (DURABILITY:3)。单击此处查看 1.12.2 附魔列表。
类型：附魔列表
牢不可破：
描述：物品是否应该牢不可破
类型：布尔值
itemOptions：
描述：应该应用于物品的所有自定义选项。以下是包含所有项目选项的列表
类型：字符串列表
slot:
描述：如果指定，物品将被放入的插槽。如果您不指定它，它只会被添加到库存中。槽位从 0 开始
类型：整数

自定义项的名称是部分名称。示例：
代码 (YAML)：
diamond: # item name
material: DIAMOND
slot: 3 # actually slot 4
Item Options:
DISABLE_INVENTORY_MOVING:
描述：这禁止物品在库存中移动。
DISABLE_DROP
说明：这将禁止项目被删除。
DISABLE_BLOCK_BREAK
描述：这会禁用手中物品破坏方块。
DISABLE_BLOCK_PLACE：
说明：这将禁止放置该项目。这仅在项目是块时才需要。
DISABLE_CONSUME：
说明：这会禁止玩家使用物品。只有当物品是食物时才需要这样做。
DISABLE_PVP：
说明：这会禁用手中物品的 PvPing。这样就不会造成任何伤害。

按照本指南将您的自定义项变成连接项。
它真的很容易使用，您可以放弃 CustomJoinItems。

首先，在 customitems.yml 文件中创建自定义项。阅读上面的解释以了解如何操作。确保指定项目的插槽。您还必须确保添加“DISABLE_INVENTORY_MOVING”和“DISABLE_DROPPING”itemOptions。

大多数连接项执行用于例如连接菜单的命令。您还可以使用 Additions 创建一个加入菜单。
只需将命令/菜单或任何其他操作添加到项目的操作列表中，当他们单击它时，一切都会发生

。一旦你完成了所有这些，你就可以转到 config.yml。在那里，您将 [citem] 操作添加到加入事件的操作列表中。这样做：
代码 (YAML):

join:
actions:
– ‘[citem]youritem’
– ‘[msg]&bWelcome to our server, %player%!’

确保将“youritem”替换为自定义项目的名称。

好吧，就是这样。只需重新加载插件，加入，您就会在指定的插槽中看到库存中的项目。您将无法移动或放下它。

就像其他一切一样，定制书籍真的很容易制作。就像菜单系统一样，每本书都有一个文件，位于 books 文件夹中。
本书的名字是文件的名字，不包括.yml。

这些是您可以添加到文件中以自定义书籍的内容：
title:
Description:书籍的标题。
类型： String
author：
Description：书的作者
类型： String
generation：
Description：书的世代。可以是 ORIGINAL、TATTERED、COPY_OF_ORIGINAL 或 COPY_OF_COPY
类型：生成（字符串）
页面：
描述：该书的页面列表
类型：字符串列表
槽：
描述：应将书添加到的槽
类型：整数显示名称
：
描述：书的显示名称（覆盖标题）
类型：字符串
lore：
描述：书的知识（覆盖传说中的作者和世代）
类型：字符串列表

因此，如果您添加所有这些。您的文件将如下所示：

如果您安装了 PlaceholderAPI，则可以使用它们的占位符。
如果你没有，那你很幸运！我们已经实现了一些自定义占位符作为 PlaceholderAPI 的替代方案。

如果您安装了 MVdWPlaceholderAPI，您还可以使用它们的占位符。

每个事件占位符：
%dropped% 返回掉落物品的物品类型。仅适用于掉落事件。
%fished% 返回捕获的鱼的鱼种。仅限钓鱼活动。
%killed% 在杀死事件中使用时返回玩家名称。它在 entitykill 事件中返回被杀死实体的类型。
%item% 返回项目的显示名称。对于 itembreak 事件。
%consumed% 返回消耗项目的显示名称。对于消费事件。

其他语言：

全占位符：
%player% 返回玩家的名字。
%uuid% 返回玩家的 uuid。
%player_name% 返回玩家的名字。
%player_gamemode% 返回玩家的游戏模式。
%player_x% 返回玩家的 x 坐标。
%player_y% 返回玩家的 y 坐标。
%player_z% 返回玩家的 z 坐标。
%player_world% 返回玩家的世界名称。
%player_uuid% 返回玩家的 UUID。
%player_is_op% 返回玩家是否被选择。
%player_health% 返回玩家的生命值。

[command]:
别名: [player]
描述:这将作为播放器本身执行命令。
示例： ‘[player]say hi’
[message]：
别名： [msg]
描述：这将向玩家发送一条消息。支持颜色代码。
例子：'[message]&aWelcome &l%player%’
[console]:
description:这将作为控制台执行命令。
示例： ‘[console]give %player% stick 1’
[title]:
描述：这将向玩家发送一个标题。使用 \n 切换到字幕。支持颜色代码。
示例： ‘[title]&a&Welcome!\n&7%player%’
[actionbar]：
别名： [action]
描述：这将向玩家发送一个 actionbar。支持颜色代码。
example: ‘[actionbar]&6Welcome to our server!’
[json]：
别名： [jsonmessage]、[jsonmsg]
说明：这将向玩家发送一条 json 消息。使用这样的生成器来创建 json 消息。不要包含 json 的[“”,和]部分。所以以 { 开始，以 } 结束。
示例： ‘[json]{“text”:”Text”,”color”:”green”,”hoverEvent”:{“action”:”show_text”,”value”:{“text”:””,”extra “:[{“text”:”More text”}]}}}’