条件

这里有DeluxeMenus中所有的(子)条件语法

基本结构

# 其他可用的条件类型:
# open_requirement: 
# view_requirement:
# left_click_requirement:
# right_click_requirement:
# shift_left_click_requirement:
# shift_right_click_requirement:
click_requirement:
  # 至少需要达到的子条件数 这一选项是完全_可选_的.
  # 这意味着若您不需要此选项,请直接删除它.
  minimum_requirements: 1
  # 此项依赖于上方的 至少需要达到的子条件数 选项
  stop_at_success: true
  requirements:
    # 你可以在此定义多个子条件
    # 每个子条件必须有一个独一无二的命名
    requirement_name:
      type: TYPE
      # 若用户达到了该子条件,会执行下述行为
      success_commands:
      - "[ACTIONTYPE] ACTION"
      - "[ACTIONTYPE] ACTION"
      # 若用户未能达到该子条件,则会执行下述行为
      deny_commands:
      - "[ACTIONTYPE] ACTION"
      - "[ACTIONTYPE] ACTION"
      # 仅仅只有在启用并设定上方的
      # 至少需要达到的子条件数 选项 时才有效
      # 同样地,那一选项也仅仅只适用于设定为可选的子选项
      optional: true
  # 若玩家未能符合所有子选项或所要求的最低选项数
  # 即最后执行下述行为
  deny_commands:
    - "[ACTIONTYPE] ACTION"
    - "[ACTIONTYPE] ACTION"

条件

类型	介绍
打开菜单的条件	定义打开菜单的条件
看到物品的条件	定义能看到该物品的条件
单击或右击的条件	定义单击或右击的条件

• 您同样可以在撰写条件中使用PlaceholderAPI所提供的变量(下文称PAPI变量)

条件类型

拥有某一权限 (has perimission)

type: has permission
permission: '在这里填写权限'

检测玩家是否拥有某一权限

如果您想检测玩家是否没有某一权限，您可以在has permission前加上一个感叹号(!) 就像这样 type: !has permission

但请注意,必须是英文输入模式下的感叹号. 下文中所有以has/is开头等的条件类型均适用这一技巧

拥有一定数量的金钱

type: has money
amount: #

检测玩家是否拥有一定数量的金钱

• 请注意,上文所赘述的金钱即与Vault挂钩的经济系统的余额称呼,

  在不同的服务器对该余额可能有不同的称呼和权重定义

同样,您可以在has money前加上感叹号(!),以表示反义(即检测玩家是否没有一定数量的金钱) 就像这样 type: !has money

如果您想将一个PAPI变量用作阈值, 那么请将 amount: # 替换为 placeholder: 变量 即

type: has money
placeholder: 变量

拥有一定数量的某一物品

type: has item
material: "TEXT"
#物品的英文ID,例如CLOCK
data: #
#物品的子ID,例如白色羊毛即0,
#若该物品没有子ID,请删去此参数
amount: #
#物品的数量
name: "TEXT"
#该物品的名字,可以使用颜色/样式代码
#也可以使用PAPI变量
#若物品未被重命名,请忽略该参数
lore:
  - "TEXT"
#该物品的Lore,可以填写的字符同上
#若该物品没有Lore请删去此参数

必填的物品参数:

• material

• amount

若该物品有多个子ID,但您仍然删去了data参数 则将会默认视为子ID为0

检测玩家是否拥有一定数量的某一物品

若想在name和lore中使用颜色亦或者样式代码,请使用§而非&

拥有某一属性

type: has meta
key: "TEXT"
# 指定键
meta_type: <STRING, BOOLEAN, DOUBLE, LONG, INTEGER>
# 属性类型
value: EXPECTED VALUE
# 值

必填的物品参数:

• key

• meta_type

• value

检查玩家是否有特定关键字的属性

如果 meta_type 是数字类型 (DOUBLE, LONG, INTEGER) 则会检查玩家的 value 值是否大于或等于该值

同样,您可以在has meta前加上感叹号(!)，以表示反义就像这样 type: !has meta

请注意,此条件为DeluxeMenus较新版本所更新的新属性

判断是否在某一点附近

type: is near
location: "WORLDNAME,X,Y,Z"
# 位置 (世界名,X,Y,Z)
# 译者提醒: 世界名请填写原始名称,勿填写某个世界的别称
distance: #
# 玩家需在以该距离为半径的球体内方判定为true

必填的物品参数:

• location

• distance

判断玩家是否在以定义的 location 点为球心，以设定的 distance 距离为半径的球体内。

同样,您可以在is near前加上感叹号(!)，以表示反义。就像这样 type: !is near

JavaScript

type: javascript
# 类型
expression: 'EXPRESSION'
# 表达式

例子:

type: javascript
# 类型
expression: '%vault_eco_balance% >= 100'
# 表达式 判定玩家经济系统余额是否大于 100

使用 JavaScript , 必须整体返回 true 或者 false

字符串比较

type: string equals
#类型
input: 'TEXT'
# 输入字符串
output: 'TEXT'
# 输出字符串
# 比较输入字符串是否相等

例子:

type: string equals
# 类型
input: '%server_name%'
# 输入字符串
output: 'HelpChat'
# 输出字符串

比较 输入值 input 和 输出值 output

同样,您可以在string equals前加上感叹号(!)，以表示反义。 就像这样 type: !string equals

忽略大小写的字符串比较

type: string equals ignorecase
# 类型
input: 'TEXT'
# 输入字符串
output: 'TEXT'
# 输出字符串
# 比较输入字符串是否相等(忽略大小写)

例子:

type: string equals ignorecase
# 类型
input: '%server_name%'
# 输入字符串
output: 'HelpChat'
# 输出字符串

比较 输入值 input 和 输出值 output

同样,您可以在string equals ignorecase前加上感叹号(!)，以表示反义。 就像这样 type: !string equals ignorecase

是否包含字符串

type: string contains
# 类型
input: 'TEXT'
# 输入字符串
output: 'TEXT'
# 输出字符串
#比较输入字符串是否包含输出字符串

例子:

type: string contains
# 类型
input: '%server_name%'
# 输入字符串
output: 'HelpChat'
# 输出字符串

比较 输入值 input 和 输出值 output

同样,您可以在string contains前加上感叹号(!)，以表示反义。 就像这样 type: !string contains

正则表达式

type: regex matches
# 类型
input: 'TEXT'
# 输入字符串
regex: 'EXPRESSION'
# 正则表达式

比较 输入值 input 是否匹配 regex 中的正则表达式:

访问 这个网站 轻松创建正则表达式

同样,您可以在regex matches前加上感叹号(!)，以表示反义。 就像这样 type: !regex matches

比较

type: regex matches
# 类型
input: #
# 输入量
regex: #
# 输出量

比较 输入值 input 和 output 输出量

可用选项

类型	介绍
==	input 是否等于 output
>=	input 是否大于等于 output
<=	input 是否小于等于 output
!=	input 是否不等于 output
>	input 是否大于 output
<	input 是否小于 output

例子

打开条件

open_requirement:
  requirements:
  # 条件
    example_1:
    # 节点
      type: has permission
      #类型
      permission: open.menu.one
      #权限
  deny_commands:
    - "[message] &cYou don't have the permission."
    #执行动作

查看条件

view_requirement:
  requirements:
  # 条件
    example_2:
    # 节点
      type: string equals
      #类型
      input: "%player_is_op%"
      #输入量
      output: "yes"
      #输出量

左/右键条件

# left_click_requirement: or
right_click_requirement:
  requirements:
    example_3:
    # 节点
      type: has money
      # 类型
      amount: 100
      # 数量
  deny_commands:
    - "[message] &7You don't have enough money."
    # 执行动作

翻译仅供参考，若存在异议或建议请发送邮件至 [email protected]