Minecraft(我的世界)中文论坛

标题: [Wiki][PCD] DeluxeMenus 翻译
作者: 秋风残叶    时间: 2017-5-14 13:21
标题: [Wiki][PCD] DeluxeMenus 翻译
本帖最后由 秋风残叶 于 2017-9-1 22:19 编辑



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

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

如果你想这么做的话，请在config.yml的“gui_menus:”下面添加
  1. main:
  2.     file: main.yml
复制代码
在文件名后面添加.yml是必不可少的

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

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

DeluxeMenus示例 - 菜单商店 [查看Wiki原文]
DeluxeMenus可以让你创建一个多功能的GUI菜单，你可以用这个菜单做一个子服/世界选择传送，或者做一个商店（就像下面我要展示给你看的一样），你可能需要一些别的插件，除了DeluxeMenus以外，你还需要安装PlaceholderAPI，当你安装好这两个插件之后，重启服务器以确保他们工作正常，当一切都完成后，请在游戏内输入
  1. /papi ecloud download Player
  2. /papi ecloud download Vault
复制代码
然后请稍等一会，然后重载插件
  1. /papi reload
复制代码
这样就下载好了Player玩家信息和Vault经济两个papi拓展包，做好这一切以后就可以开始制作商店了，我会给你展示一个例子，然后解释每部分的功能
  1. menu_title: '&6商店'
  2. open_command: shop
  3. open_requirement:
  4.   expression: 'BukkitPlayer.hasPermission("inventory.shop");'
  5.   deny_commands:
  6.   - '&f未知指令. 请使用 "/help" 获得帮助'
  7. size: 54
  8. items:
  9.   '1':
  10.     material: STONE
  11.     data: 1
  12.     slot: 0
  13.     display_name: '&7花岗岩'
  14.     lore:
  15.     - '&7购买价格: &a$80'
  16.     - '&7出售价格: &c$40'
  17.     left_click_commands:
  18.     - '[console] eco take %player_name% 80'
  19.     - '[console] give %player_name% stone:1 64'
  20.     - '[message] &3菜单系统 &a?&7 你成功购买了64个花岗岩.'
  21.     left_click_requirement:
  22.       expression: '%vault_eco_balance% >= 80'
  23.       deny_commands:
  24.       - '[close]'
  25.       - '[message] &3菜单系统 &a?&7 你的钱不够哦.'
  26.     right_click_commands:
  27.     - '[console] eco give %player_name% 40'
  28.     - '[console] clear %player_name% stone:1 64'
  29.     - '[message] &3菜单系统 &a?&7 你成功出售了64个花岗岩'
  30.     right_click_requirement:
  31.       expression: '"%player_hasitem-mat:STONE-amt:64-data:1%".equals("yes");'
  32.       deny_commands:
  33.       - '[close]'
  34.       - '[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小时的冷却时间，让我们先从菜单名和开启指令开始
  1. menu_title: '&c&l礼包 &7[&8点击选择&7]'
  2. open_command: kits
  3. size: 9
  4. update_interval: 1
复制代码
让我们继续编辑菜单内物品，大家可以看到菜单内已经设置了两个物品
  1. menu_title: '&c&l礼包 &7[&8点击选择&7]'
  2. open_command: kits
  3. size: 9
  4. update_interval: 1
  5. items:
  6.   'starteron':
  7.     material: iron_sword
  8.     slot: 0
  9.     priority: 1
  10.     update: true
  11.     hide_attributes: true
  12.     view_requirement: '"%essentials_kit_is_available_starter%".equalsIgnoreCase("yes")'
  13.     display_name: '&c&lStarter礼包'
  14.     lore:
  15.     - '&8+---------------------+'
  16.     - '&7这是一个礼包.'
  17.     left_click_commands:
  18.     - '[player] kit starter'
  19.     - '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.2 1'
  20.     - '[close]'
  21.     right_click_commands:
  22.     - '[player] kit starter'
  23.     - '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.2 1'
  24.     - '[close]'
  25.   'starteroff':
  26.     material: barrier
  27.     slot: 0
  28.     priority: 2
  29.     update: true
  30.     hide_enchantments: true
  31.     enchantments:
  32.     - 'DURABILITY;1'
  33.     display_name: '&8[&7当前不可用&8] &c&lStarter礼包'
  34.     lore:
  35.     - '&8+---------------------+'
  36.     - '&7尚未过冷却时间！'
  37.     - '&7请再等待 &c%essentials_kit_time_until_available_starter%'
  38.     left_click_commands:
  39.     - '[console] playsound mob.bat.takeoff %player_name% ~ ~ ~ 1 1.5 1'
  40.     - '[console] playsound mob.horse.armor %player_name% ~ ~ ~ 1 1.5 1'
  41.     right_click_commands:
  42.     - '[console] playsound mob.bat.takeoff %player_name% ~ ~ ~ 1 1.5 1'
  43.     - '[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
  1. view_requirement: '"%essentials_kit_is_available_starter%".equalsIgnoreCase("yes")'
复制代码
这个前提以及变量会检测这个礼包当前是否是可领取状态，如果可以领取，会返回结果“yes”...所以前提就是检测这个变量是否返回“yes”，如果是，starton这个物品就会显示给打开菜单的玩家

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

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

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

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


GUI菜单配置


GUI物品配置


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

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

限制的种类有两种，变量限制（使用PlaceholderAPI变量）和Java限制（也可以使用PlaceholderAPI变量，但不是必要的）以下是一个例子
  1. view_requirement: '%vaulteco_balance% > 100'
复制代码
这个限制检测的是玩家的金钱是否大于100，如果大于100，玩家就可以看到这个物品，反之，这个物品将会被隐藏，你可以在这个格子里显示其它物品（首先需要把两个物品放在同一格子中，然后给有浏览限制view_requirement的物品更高的优先级，请参考“GUI物品配置”Wiki部分）或者直接让这个格子留空

这种限制可以用于显示数字的papi变量，我们不止可以设置这种简单的限制，下面这个是检测玩家有无权限的Java限制
  1. view_requirement: 'BukkitPlayer.hasPermission("some.permission");'
复制代码
这种限制可以让VIP玩家在菜单里看到不同于普通玩家的物品，比如VIP每日礼包或者VIP奖励，你还可以制作更多，同样，你还可以把papi变量放入Java限制中来看它返回什么结果，例如：
  1. view_requirement: '"%player_world%".equalsIgnoreCase("world_nether");'
复制代码
请注意一下括在papi变量周围的引号，这比较特殊，这个限制会检测玩家的所在世界 %player_world% 是什么. 如果检测到不是 "world_nether" 的值，该物品将不会显示 你可以通过启用"chat"附属来检测一个papi变量的值 在聊天栏里输入带大括号的papi变量 (例如: {player_world}). 会显示这个变量的值

那么，上面那个例子中，该怎么设置才能让玩家只有不在world_nether世界才能看到物品呢（也就是正好反过来）请看这个例子：
  1. 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_<礼包名>%
  1. 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]
作者: 幻境雲達達    时间: 2017-5-14 14:24
你速度怎么这么快，那怎么办？
当然是选择原谅你啊！
作者: 水煮清娃    时间: 2018-6-11 06:28
最新的菜单，每日礼包复制楼主的配置，是无效的，而且有不少配置代码已经跟楼主的不同，希望楼主可以更新一下配置每日礼包的方案，自己折腾了很久也没有眉目，主要的问题应该在可视权限那里。

改变的配置例子：如楼主的“menu_title: '&c&l礼包 &7[&8点击选择&7]'” 新版本已经不叫menu_title而是 display_name