[Wiki][PCD] DeluxeMenus 翻译

本帖最后由秋风残叶于 2017-9-1 22:19 编辑

前言 [查看Wiki原文]

DeluxeMenus是一种多合一的GUI菜单，你可以创建可以用特定指令打开的GUI菜单，玩家打开后可以看到一系列可设置的属性
玩家的菜单是完全可编辑的，你可以设置让不同的玩家看到特定的物品，或者在菜单里执行已经设置好脚本的特定的指令，所有的这些都是可设置的，你可以按照你想要的把这些功能设置的相对复杂，或者相对简单
作者很活跃，正努力给插件添加更多特性来让其变得更高效易用，本Wiki包含了本插件的介绍，以及菜单及各物品属性的介绍，同样也包含了几个菜单的例子

创建更多yml菜单 [查看Wiki原文]

第一次加载插件，会自动生成一个DeluxeMenus文件夹，在这个文件夹里你可以找到一个文件 config.yml，你可以把所有菜单都放进这个文件，或者你可以新建一个文件来创建新的菜单（在另一个文件夹里）

如果你想这么做的话，请在config.yml的“gui_menus:”下面添加

main:
file: main.yml

复制代码

在文件名后面添加.yml是必不可少的

你可以添加很多菜单，当你完成以后请务必重载插件，然后请查看DeluxeMenus文件夹，你会发现里面新生成了一个名叫“gui_menus”的文件夹，该文件夹内包含了所有新建的GUI菜单，你可以直接打开并编辑它们

编辑这些菜单文件和编辑主文件config格式相同，只是配置开头不是“gui_menus:”而是“menu_title:”，新建的文件包含了几行可用物品属性的介绍，同时也有菜单属性的介绍，不妨查看下面的Wiki来获得更多帮助

DeluxeMenus示例 - 菜单商店 [查看Wiki原文]

DeluxeMenus可以让你创建一个多功能的GUI菜单，你可以用这个菜单做一个子服/世界选择传送，或者做一个商店（就像下面我要展示给你看的一样），你可能需要一些别的插件，除了DeluxeMenus以外，你还需要安装PlaceholderAPI，当你安装好这两个插件之后，重启服务器以确保他们工作正常，当一切都完成后，请在游戏内输入

/papi ecloud download Player
/papi ecloud download Vault

复制代码

然后请稍等一会，然后重载插件

/papi reload

复制代码

这样就下载好了Player玩家信息和Vault经济两个papi拓展包，做好这一切以后就可以开始制作商店了，我会给你展示一个例子，然后解释每部分的功能

menu_title: '&6商店'
open_command: shop
open_requirement:
expression: 'BukkitPlayer.hasPermission("inventory.shop");'
deny_commands:
- '&f未知指令. 请使用 "/help" 获得帮助'
size: 54
items:
'1':
material: STONE
data: 1
slot: 0
display_name: '&7花岗岩'
lore:
- '&7购买价格: &a$80'
- '&7出售价格: &c$40'
left_click_commands:
- '[console] eco take %player_name% 80'
- '[console] give %player_name% stone:1 64'
- '[message] &3菜单系统 &a?&7 你成功购买了64个花岗岩.'
left_click_requirement:
expression: '%vault_eco_balance% >= 80'
deny_commands:
- '[close]'
- '[message] &3菜单系统 &a?&7 你的钱不够哦.'
right_click_commands:
- '[console] eco give %player_name% 40'
- '[console] clear %player_name% stone:1 64'
- '[message] &3菜单系统 &a?&7 你成功出售了64个花岗岩'
right_click_requirement:
expression: '"%player_hasitem-mat:STONE-amt:64-data:1%".equals("yes");'
deny_commands:
- '[close]'
- '[message] &3菜单系统 &a?&7 你的花岗岩数量不够'

复制代码

menu_title 箱子GUI界面的标题
open_command 玩家可以使用这个指令打开菜单
open_requirement 玩家打开这个菜单需要满足的条件，在此设置下：
deny_commands 当玩家不满足条件时显示的内容，在范例中我把条件设置为了权限，你可以将其设置为任何东西
size 菜单的大小，最大是 54.
items 菜单内物品的各种属性，在此标题下你还需要设置物品的名称，种类等等
'1' 这个数字代表加载菜单时第一个被加载的物品
material 物品的种类，你可以使用物品的ID或者物品的英文名
data i物品的子ID，需要注意的是你不能把物品的种类设置成例如“1:1”之类的，你必须设置为种类1+子ID1
slot 物品在菜单的哪个格子，第一格请输入0，第二格请输入1，以此类推
display_name 物品的名称，你可以使用彩色代码
lore 物品的lore，你可以创建多行
left_click_commands 设置左键点击物品触发的指令在范例中，我们扣除了点击者80金钱，这个地方就是placeholderapi发挥作用的地方. %player_name% 变量代表点击者的名字. 点击者被扣除80金钱，然后获得64个花岗岩. 然后看到一条消息提示购买成功
left_click_requirement 玩家左键点击物品需要的前提首先设置一个 expression. 它使用的是 javascript 脚本. 我们用Vault的papi变量来检查点击者的金钱是否大于或等于80 ，如果不满足条件，我们将关闭GUI并提示玩家金钱不够
right_click_commands 设置右键点击物品触发的指令与之前扣除80金钱不同的是, 我们支付给点击者40金钱并从他的背包里扣除64个花岗岩，并使用消息提示他
right_click_requirement 与左键点击前提稍有不同. 并不是检查他们有没有40金钱, 而是检测他们有没有足够的物品来出售. 我们用另一个papi变量, %player_hasitem-mat:MATERIALNAME-amt:AMOUNT-dataATA%. 如果满足这个条件 "yes" 则成功交易反之则关闭菜单并提示背包内的花岗岩不够

建议：我建议你在重载插件之前先把编辑好的菜单保存，因为如果你编辑出了偏差，你的文件可能会被重置，当编辑出现偏差的时候，物品序号便派上用场，控制台上会显示是哪个序号的物品出现问题，来提示你修复

希望这个例子对您有帮助

DeluxeMenus示例 - 礼包菜单 [查看Wiki原文]

今天来教大家做一个礼包菜单，可以让玩家看到礼包冷却时间（使用Essentials作为前置）

在开始之前，请务必注意placeholderapi默认使用“yes/no”来做逻辑判断(而不是“true/false”,除非你自己做了更改)，如果你不知道我在说什么，你就不用担心这些

我只会用一个物品做范例，ess的礼包名字为starter并且有24小时的冷却时间，让我们先从菜单名和开启指令开始

menu_title: '&c&l礼包 &7[&8点击选择&7]'
open_command: kits
size: 9
update_interval: 1

复制代码

让我们继续编辑菜单内物品，大家可以看到菜单内已经设置了两个物品

menu_title: '&c&l礼包 &7[&8点击选择&7]'
open_command: kits
size: 9
update_interval: 1
items:
'starteron':
material: iron_sword
slot: 0
priority: 1
update: true
hide_attributes: true
view_requirement: '"%essentials_kit_is_available_starter%".equalsIgnoreCase("yes")'
display_name: '&c&lStarter礼包'
lore:
- '&8+---------------------+'
- '&7这是一个礼包.'
left_click_commands:
- '[player] kit starter'
- '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.2 1'
- '[close]'
right_click_commands:
- '[player] kit starter'
- '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.2 1'
- '[close]'
'starteroff':
material: barrier
slot: 0
priority: 2
update: true
hide_enchantments: true
enchantments:
- 'DURABILITY;1'
display_name: '&8[&7当前不可用&8] &c&lStarter礼包'
lore:
- '&8+---------------------+'
- '&7尚未过冷却时间！'
- '&7请再等待 &c%essentials_kit_time_until_available_starter%'
left_click_commands:
- '[console] playsound mob.bat.takeoff %player_name% ~ ~ ~ 1 1.5 1'
- '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.5 1'
right_click_commands:
- '[console] playsound mob.bat.takeoff %player_name% ~ ~ ~ 1 1.5 1'
- '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.5 1'

复制代码

我们已经设置好了两个物品，starton和startoff，我绝不会用简单的更换物品种类或者附魔来达到效果，请注意这两个变量优先级priority和浏览前提view_requirement, Startoff这个物品代表礼包正在冷却中，它的优先级priority是2而且它和另一个物品在同一个格子
Starton这个物品的优先级priority是1，所以他会“覆盖”startoff这个物品，这个物品有一个浏览前提，如果不满足这个前提的话，这个物品starton就会被隐藏，同时显示下面的startoff，startoff这个物品有一个placeholderapi变量%essentials_kit_time_until_available_starter%，会显示这个ess礼包剩下的冷却时间

让我们看一下starton的浏览前提view_requirement

view_requirement: '"%essentials_kit_is_available_starter%".equalsIgnoreCase("yes")'

复制代码

这个前提以及变量会检测这个礼包当前是否是可领取状态，如果可以领取，会返回结果“yes”...所以前提就是检测这个变量是否返回“yes”，如果是，starton这个物品就会显示给打开菜单的玩家

至此我们就做好了一个礼包菜单，礼包可领取时可以点击，礼包正在冷却时会显示一个屏障，方便地告诉玩家什么时候可以领取礼包

GUI/物品属性&配置 [查看Wiki原文]

本部分包含了有关GUI菜单及物品的各项属性，每项都提供有正确的格式，并有关于它的用途进行的描述
本部分由两部分组成，GUI的相关属性和物品相关属性，GUI的相关属性排在config前面，物品相关属性是每个“items:”下面的各项设置

相关链接

PlaceholderAPI变量大全https://www.spigotmc.org/wiki/placeholderapi-placeholders/
物品名称列表https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html
附魔列表https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/enchantments/Enchantment.html
染色列表https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/DyeColor.html
旗帜图案列表https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/block/banner/PatternType.html

需要注意的是，某些附魔不能被加到不适合该附魔的物品上

注意事项

TEXT = 使用任意文字，你可以使用彩色代码
BOOLEAN = 逻辑值，使用true/false（如果你使用的是PlaceholderAPI变量，则应该用默认yes/no来替换true/false，这是papi的默认设置）
EXPRESSION = Java/papi变量名称请参考这里获得帮助
# = 使用任意数字

GUI菜单配置

GUI物品配置

物品属性应该按照下面这个格式来设置

gui_menus:
menuname:
menu_title: 'TEXT'
open_command: TEXT
size: #
update_interval: #
items:
'ItemName':
material: TEXT
slot: 0

复制代码

如果你使用的是外部的gui.yml文件，你的配置文件将以menu_title开头，你可以把“ItemName”设置成任何东西，无论设置成什么都不会影响config的运作，因为它只起到一个标识作用，你可以把它设置成数字，或者任意字符

material: TEXT

复制代码

这个属性代表菜单内物品的种类（物品名称列表参本帖上方），这个属性直接对应子ID“data”这个属性（当你需要设置药水或者木头等等带有子ID的物品时发挥作用），本属性与旗帜图案属性“banner-meta”也有关，同样，你也可以使用“head:玩家名”来把物品设置成正版玩家的头颅（玩家名使用PAPI变量%player_name%）

data: #

复制代码

这个属性代表物品的子ID，本属性与物品种类属性有关，你可以利用子ID来设置多种彩色的羊毛等等

amount: #

复制代码

这个属性代表一个格子内会显示多少个物品

slot: #

复制代码

这个属性代表该物品在菜单内的第几个格子，多个物品可以被放入同一个格子，但是你可能要设置优先级属性priority和浏览前提view_requirement来让它工作正常，需要注意的是一个菜单最多只有54个格子，从左上角开始是第一个格子（序号为0），也就是说第九个格子序号是8，这个是没法改变的，用一张图来帮助你理解：

priority: #

复制代码

当多个物品存在于同一个格子时，这个属性代表物品的优先级（本属性与格子slot和浏览前提view_requirement有关），数字越大，优先级越低，举个例子，当存在一个优先级为2的物品时，优先级为5的物品将不会显示，如果同时存在优先级为1的物品，那么之前两个物品都不会显示

view_requirement: 'EXPRESSION'

复制代码

这个属性是浏览前提，与格子slot和优先级priority属性有关，你可以在这里设置基础的逻辑判断，或者利用papi做数字判断（papi判断例如：'%vaulteco_balance% > 100'只有你的金钱大于100金币时，你才能看见这个物品，需要Vault作为前置，Java判断例如： 'BukkitPlayer.hasPermission ("some.permissions")'玩家只有拥有这个权限才能看到这个物品）请查看下一部分Wiki来了解更多

update: BOOLEAN

复制代码

如果这个属性设置为true，这个物品名称和lore中的papi变量会被自动刷新，刷新的频率和GUI菜单设置中的"update_interval"属性有关，这个属性可用于显示冷却时间和实时统计

下面这个是一个papi变量刷新的例子

hide_attributes: BOOLEAN

复制代码

这个属性将会隐藏原版物品的各种属性，设置成true以后，原版物品例如剑，镐，斧上的“+5 攻击伤害”将被隐藏

hide_effects: BOOLEAN

复制代码

这个属性与上面那个hide_attributes属性很相似，将会隐藏原版物品的各种效果，设置成true以后，原版药水等物品上的药水效果将会被隐藏

banner_meta:
- <dyecolor>;<patterntype>
- <dyecolor>;<patterntype>

复制代码

只有物品种类为旗帜，这个属性才会生效，这个属性可以设置旗帜的颜色和图案，创造出漂亮而独特的旗帜，染色和旗帜图案列表请参考本部分开头链接，要注意的一点是你必须要用英文分号来分隔颜色和图案，而不是通常的英文逗号

display_name: 'TEXT'

复制代码

物品的名称，可以使用彩色代码，也可以使用papi变量

lore:
- 'TEXT'
- 'TEXT'

复制代码

物品的lore，可以使用彩色代码，也可以使用papi变量，只要原版Minecraft允许，你加多少行都可以

enchantments:
- enchantmentid;level
- enchantmentid;level

复制代码

物品的附魔，附魔名称列表请参考本部分开头列出的链接，请务必注意某些物品/方块不能被打上附魔，某些附魔只对特定的物品生效，如果你不想显示附魔，只想显示附魔的闪光效果，可以使用hide_enchantments这个属性

left_click_commands:
- '[player] command'
- '[console] command'
- '[commandevent] command'
- '[message] TEXT'
- '[openguimenu] MenuName'
- '[connect] ServerName'
- '[close]'
right_click_commands:
- '[player] command'
- '[console] command'
- '[commandevent] command'
- '[message] TEXT'
- '[openguimenu] MenuName'
- '[connect] ServerName'
- '[close]'

复制代码

这些属性相当于对功能的解释，Left_click_commands 设置的是玩家左键点击物品发生的事件, right_click_commands 控制的是玩家右键点击物品发生的事件，你想添加多少行都可以，指令会按照从上到下依次执行，指令分为很多种，会在下面列出 (请注意所有指令和内容前面都要留一个空格):

[player] - 以玩家身份执行指令

[console] - 以控制台身份执行指令

[commandevent] - 执行一个特殊的指令世界，类似插件 MyCommand Aliases 或者 DeluxeCommands 里的那样

[message] - 给玩家发送一条消息，可以添加papi变量或者彩色代码

[openguimenu] - 打开另一个菜单，只要输入正确的菜单标题就可以了

[connect] - 传送玩家至一个bungee子服，只要输入正确的子服名称就可以了

[close] - 关闭菜单

<delay=(延迟的tick数)> - 给执行指令添加延迟

- '[close]'

- '[message] 距离这个菜单关闭已经过去 5 秒了 <delay=100>'

- '[message] 已经过去 10 秒了<delay=200>'

20 ticks i= 1秒. 我们建议不要给打开菜单添加延迟，因为不知情的玩家可能会不停地尝试打开，造成服务器卡顿

left_click_requirement:
expression: 'EXPRESSION'
deny_commands:
- '[player] 指令'
- '[console] 指令'
- '[commandevent] 指令'
- '[message] TEXT'
- '[openguimenu] 菜单名'
- '[connect] 子服名'
- '[close]'
right_click_requirement:
expression: 'EXPRESSION'
deny_commands:
- '[player] 指令'
- '[console] 指令'
- '[commandevent] 指令'
- '[message] TEXT'
- '[openguimenu] 菜单名'
- '[connect] 子服名'
- '[close]'

复制代码

使用Java/papi来检测使用限制，格式和浏览限制view_requirement相同（只是玩家一直能看的见这个物品罢了），这个限制检测的是玩家能否左键/右键点击这个物品。deny_commands部分可选，如果你设置了这个，它们会和 left_click_commands 属性和 right_click_commands 属性同步工作当玩家左键/右键触发指令的时候，本限制也会开始工作，若玩家不满足前提，指令将不会生效，同时开始执行deny_commands里的内容（若是你没有设置，将什么都不会执行）

使用/浏览前提限制 [查看Wiki原文]

DeluxeMenus可以提供检查该按钮对特定玩家是否可以使用的限制功能，我们可以给按钮添加无数种类的限制，本功能可以用于view_requirement浏览限制和click_requirement点击限制

点击限制按照字面意思很好理解，我们不会去过多叙述它，本部分我们着重介绍浏览限制view_requirement，所有浏览限制的内容同样可用于点击限制

限制的种类有两种，变量限制（使用PlaceholderAPI变量）和Java限制（也可以使用PlaceholderAPI变量，但不是必要的）以下是一个例子

view_requirement: '%vaulteco_balance% > 100'

复制代码

这个限制检测的是玩家的金钱是否大于100，如果大于100，玩家就可以看到这个物品，反之，这个物品将会被隐藏，你可以在这个格子里显示其它物品（首先需要把两个物品放在同一格子中，然后给有浏览限制view_requirement的物品更高的优先级，请参考“GUI物品配置”Wiki部分）或者直接让这个格子留空

这种限制可以用于显示数字的papi变量，我们不止可以设置这种简单的限制，下面这个是检测玩家有无权限的Java限制

view_requirement: 'BukkitPlayer.hasPermission("some.permission");'

复制代码

这种限制可以让VIP玩家在菜单里看到不同于普通玩家的物品，比如VIP每日礼包或者VIP奖励，你还可以制作更多，同样，你还可以把papi变量放入Java限制中来看它返回什么结果，例如：

view_requirement: '"%player_world%".equalsIgnoreCase("world_nether");'

复制代码

请注意一下括在papi变量周围的引号，这比较特殊，这个限制会检测玩家的所在世界 %player_world% 是什么. 如果检测到不是 "world_nether" 的值，该物品将不会显示你可以通过启用"chat"附属来检测一个papi变量的值在聊天栏里输入带大括号的papi变量 (例如: {player_world}). 会显示这个变量的值

那么，上面那个例子中，该怎么设置才能让玩家只有不在world_nether世界才能看到物品呢（也就是正好反过来）请看这个例子：

view_requirement: '!"%player_world%".equalsIgnoreCase("world_nether");'

复制代码

看起来很复杂吧？让我来解释一下这个限制是如何发挥作用的，要知道，浏览限制view_requirement只接受true和false两种返回结果，也就是说，浏览限制只会检测事件的返回结果是true还是false，在这个前提下，如果一个位于世界“world”的玩家打开了菜单，本限制会检测玩家所在世界，当检测到玩家所处世界是“world_nether”以外的世界时会返回结果true，这就是为什么要在前面加一个英文感叹号，如果你移除了那个感叹号，只有玩家处于世界“world_nether”的时候才会返回结果true

如果你了解了这些，你就应该知道了，当浏览限制返回结果true时会显示物品，反之，返回结果false时会隐藏物品

现在，让我们谈谈papi变量返回值是true/false的限制，例如礼包是否可用变量%essentials_kit_is_available_<礼包名>%

view_requirement: '"%essentials_kit_is_available_<kitname>%".equalsIgnoreCase("yes")'

复制代码

这个限制会检测ess礼包是否可用，如果可用，这个物品就会在菜单里显示，你应该注意到了，我在指令中使用的是“yes”而不是“true”，这是因为检测是通过PlaceholderAPI进行的，在默认的papi配置中，逻辑值结果返回的是yes/no而不是true/false(如果你在papi配置里修改了这个，那么同样在这里的指令里也要修改)

再说一遍，如果你发现papi限制用不了，请在聊天里检测一下相应变量的返回值是什么

注意：指令里使用的 ".equalsIgnoreCase", 你可以将其替换为 ".equals" 本替换将会严格区分大小写. 比如说你有一个世界名叫 "WoRLd_TeSt" 你需要使用 ".equals" 严格大小写来保证返回值正确

[groupid=1330]PluginsCDTribe[/groupid]

[Wiki][PCD] DeluxeMenus 翻译

回复: