> For the complete documentation index, see [llms.txt](https://helpchat.wiki.complexstudio.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpchat.wiki.complexstudio.net/helpchat-zhong-wen-wei-ji/deluxemenus/xuan-xiang-pei-zhi/tiao-jian.md).

# 条件

### 基本结构

```yaml
# 其他可用的条件类型:
# 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`)

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

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

> 如果您想检测玩家是否`没有`某一权限，您可以在`has permission`前加上一个感叹号(`!`) 就像这样 `type: !has permission`
>
> 但请注意,必须是英文输入模式下的感叹号. 下文中所有以`has`/`is`开头等的条件类型均适用这一技巧

#### 拥有一定数量的金钱

```yaml
type: has money
amount: #
```

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

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

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

> 同样,您可以在`has money`前加上感叹号(**!**),以表示反义(即检测玩家是否`没有`一定数量的金钱) 就像这样 `type: !has money`
>
> 如果您想将一个PAPI变量用作阈值, 那么请将 `amount: #` 替换为 `placeholder: 变量` 即
>
> ```yaml
> type: has money
> placeholder: 变量
> ```

#### 拥有一定数量的某一物品

```yaml
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

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

例子:

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

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

#### 字符串比较

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

例子:

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

比较 输入值 `input` 和 输出值 `output`

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

#### 忽略大小写的字符串比较

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

例子:

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

比较 输入值 `input` 和 输出值 `output`

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

#### 是否包含字符串

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

例子:

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

比较 输入值 `input` 和 输出值 `output`

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

#### 正则表达式

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

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

访问 [这个网站](https://regexr.com/) 轻松创建正则表达式

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

#### 比较

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

比较 输入值 `input` 和 `output` 输出量

**可用选项**

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

### 例子

#### 打开条件

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

#### 查看条件

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

#### 左/右键条件

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

翻译仅供参考，若存在异议或建议请发送邮件至 `azurehanchen@complexstudio.net`