|
Additions+ | Custom Commands, Menus, Books, Actions, Nametags and much more | 1.8-1.14 2.2.4
添加+ | 自定义命令、菜单、书籍、动作、名牌等等 | 1.8-1.14 2.2.4
如果它由于某种原因停止工作，请使用讨论部分进行报告！谢谢你！
~
 qt陈
原始链接：https ://www.spigotmc.org/resources/...ctions-nametags-and-much-more-1-8-1-14.67706/
-- 翻译 --翻译我想
翻译的高级资源
- 标签列表中的自定义播放器名称（动画）[PREMIUM]
有了所有这些功能，您几乎可以使用 /heal、/tp、/fly、/kill、/clear、/speed、/warp 创建一个完整的基本插件。除此之外，您可以创建一个 /calc 命令，例如 WorldEdit 的命令。然后你也可以放弃 RandomTeleport 插件，因为你可以在两个数字之间生成一个随机数，然后安全地传送到那个位置。更多信息在我们的 Discord 中。
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。当该玩家的命令处于冷却状态时，此消息将发送给该​​玩家。在剩余时间的 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 附魔列表
：
描述：应用于项目的附魔。要设置附魔级别，请使用格式 ENCHANTMENT EVEL (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"}]}}}'
[everyone]:
描述：这将为所有在线玩家执行操作，而不仅仅是事件玩家。
示例： '[msg][everyone]&a%player% joined the server!'
:
description:这将使消息的文本居中。这仅适用于[message]操作。
example: '[msg]&aThis is a centered message'
[language]:
description:这只会在玩家使用特定 Minecraft 语言/语言环境时执行操作。您可以在此处找到 Minecraft 语言环境列表。如果玩家没有该区域设置，则该玩家的操作将被跳过。此操作适用于[everyone]。使用 [language=""] 作为基础，然后将目标区域设置放在双引号之间。
示例： '[msg][everyone][language="en_us"]&a您的语言是英语（美国）'
[延迟]：
描述：这将延迟指定数量的刻度（1 秒 = 20 个刻度）的动作。使用 [delay=""] 作为基础，然后将延迟时间（以滴答为单位）放在双引号之间。
示例： '[msg][delay="100"]&7此消息延迟 5 秒。'
[连接]：
描述：这会将播放器连接到另一个服务器。这只能在 bungeeCord 服务器上使用，并且指定的服务器必须连接到它。服务器的名称与 bungee 主机上的 config.yml 中的名称相同。
示例： '[connect]pvp'
[money]：
描述：这将向/从玩家的余额中存入/提取金钱。必须安装 Vault 才能使用它。
示例： '[金钱]10', '
[menu]::
description：这将打开一个自定义菜单。只需在其后添加菜单名称（不带 .yml）。
example: '[menu]example'
[close]:
description:这将关闭玩家的物品栏。在指定[menu]操作后不要使用它。菜单将不会打开。
示例： '[close]'
[permission]：
描述：这会检查玩家是否具有指定的权限，如果玩家没有，则停止操作。
example: '[msg][permission="myperm"]&aYou have the specified permission'
[vgroup]:
description:这将检查玩家是否是指定组的成员。需要 Vault 才能使用此操作。此外，还需要一个 Vault 应该支持的权限插件。
example: '[msg][vgroup="donator"]&dYou are a donator'
[chance]:
description:这增加了行动的机会。这应该是 0-100 之间的百分比量。如果将其设置为 50，则将有 50% 的机会执行操作。
example: '[msg][chance=50]&aThere is 50% chance of getting this message'
[sound]:
description:这会为玩家播放声音。确保播放与您的服务器版本匹配的声音。
示例： '[sound]NOTE_PLING'
[citem]：
描述：这为玩家
示例提供了自定义项目： '[citem]myFirstItem'
[book]：
描述：这为玩家
示例提供了自定义书籍： '[book]myBook'
[safelanding]：
描述：这将玩家传送到它们的 x,z 坐标的最高位置。
示例： '[safelanding]'
[kick]：
描述：踢玩家
示例： '[kick]&c&lU got kicked suckaa'
[teleport]：
描述：将玩家传送到指定位置
示例：
- '[teleport]player'
- '[传送]xy z'
- '[传送]World xy z'
- '
- '[teleport]World xyz pitch yaw'
[fly]:
description: Toggles/Sets the flying of a player
example:
- '[fly]true'
- '[fly]'
[allowfly]:
description:切换飞行限额玩家
示例：
- '[allowfly]true'
- '[allowfly]'
[food]:
描述：设置玩家
示例的食物条： '[food]20'
[health]:
描述：设置玩家
示例的生命值: '[health]20'
[kill]:
description:杀死一个玩家
example: '[kill]'
[clear]:
description:清除玩家的清单
示例： '[clear]'
[clearchat]：
描述：清除玩家的聊天
示例： '[clearchat]'
[天气]：
描述：设置（世界的）天气。天气类型有：太阳、雨和风暴。
示例：
- '[weather]SUN'
- '[weather]World STORM'
[playerweather]:
描述：设置玩家的个人天气。天气类型有：SUN、RAIN 和 RESET。
示例： '[playerweather]RESET'
[time]：
描述：设置（世界的）时间。时间类型可以是 DAY、NIGHT 或某个特定的整数。
示例： '
[playertime]：
描述：设置玩家的个人时间。时间类型可以是 DAY、NIGHT、RESET 或某个特定的整数。
示例： '[playertime]RESET'
[gamemode]：
描述：设置玩家的游戏模式。游戏模式可以是 SURVIVAL、ADVENTURE、CREATIVE 或 SPECTATOR。
示例： '[gamemode]CREATIVE'
[flyspeed]：
描述：设置玩家的飞行速度。这应该是 0 到 1 之间的整数！不要使用大于 1 的整数。
示例： '[flyspeed]0.5'
[walkspeed]：
描述：设置玩家的步行速度。这应该是 0 到 1 之间的整数！不要使用大于 1 的整数。
示例： '[walkspeed]0.4'
[speed]：
描述：设置玩家的行走/飞行速度。取决于玩家是否在飞行。这应该是 0 到 1 之间的整数！不要使用大于 1 的整数。
示例： '[speed]0.3'
[chat]：
描述：作为玩家聊天消息。
示例： “[聊天]我刚得到奖励”
[目标]：
描述：这会将动作目标设置为指定的玩家。然后将不会为“主要”玩家执行该操作。如果您想要多个玩家，请在名称/占位符之间添加一个,来拆分他们。没有空间。这尤其可以与命令参数结合使用。
示例： '[target=%player%,LukasIsTheName][msg]&aYou are a target'
[rng]:
描述：这不是真正的动作。这会变成您可以指定的数字。RNG 代表随机数生成器。您可以指定一个或两个数字。然后它将在它们之间选择一个随机数。如果您只指定一个，它将从 0 到您指定的数字。标签末尾的 / 是必需的！
示例： '[rng=10/]'（从 0-10 中选择）
示例： '[rng=10,100/]'（从 10-100 中选择）
[math]：
描述：计算开始和结束数学标签之间的所有内容. 开始标签是[math]结束标签是[/math]. 所以数学标签将变成解决方案。
示例： '[msg]Solution 1*3+7-4 = &a[math]1 * 3 + 7 - 4[/math]'
[price]：
描述：检查玩家是否有指定数量的钱。需要金库。这不会从玩家的账户中提取任何资金！
示例： '[msg][money=100]&7您至少获得了 100 美元
| 
成长值: 19225
