# 条件 ### 基本结构 ```yaml # 可以是 # open_requirement: # left_click_requirement: # right_click_requirement: view_requirement: requirements: # 你可以创建多个条件. # 每个条件必须有一个不重复的名字 requirement_name: type: 条件类型 # 只能在open_requirement # 或left/right_click_requirement下使用deny_commands deny_commands: - "[ACTIONTYPE] ACTION" - "[ACTIONTYPE] ACTION" ``` ### 条件 | 类型 | 介绍 | | --------------------------------------------------------------------------------------------------------------------------- | ----------- | | [打开菜单的条件](https://a1621035369.gitbook.io/deluxemenus/xuan-xiang-pei-zhi/gui#da-kai-yao-qiu) | 定义打开菜单的条件 | | [看到物品的条件](https://a1621035369.gitbook.io/deluxemenus/xuan-xiang-pei-zhi/wu-pin-pei-zhi#cha-kan-tiao-jian) | 定义能看到该物品的条件 | | [单击或右击的条件](https://a1621035369.gitbook.io/deluxemenus/xuan-xiang-pei-zhi/wu-pin-pei-zhi#shift-you-zhong-zuo-jian-tiao-jian) | 定义单击或右击的条件 | * 您同样可以在撰写条件中使用PlaceholderAPI所提供的变量(下文称`PAPI变量`) * 如果您同时设置了多个条件,则玩家需全部满足才可被认为是符合条件 (您也可以使用JavaScipt来添加**必须满足**或**可不满足**的条件) ### 条件类型 #### 拥有某一权限 (`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 > amount: 变量 > ``` #### 拥有一定数量的某一物品 ```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中使用颜色亦或者样式代码,请使用`§`而非`&` #### 拥有某一属性 ```yaml type: has meta key: "TEXT" #关键字 meta_type: #属性类型 value: EXPECTED VALUE #值 ``` 必填的物品参数: * key * meta\_type * value 检查玩家是否有特定关键字的属性 如果 meta\_type 是数字类型 (DOUBLE, LONG, INTEGER) 则会检查玩家的 value 值 是否大于或等于该值 同样,您可以在`has meta`前加上感叹号(**!**),以表示反义(即检测玩家是否`没有`一定数量的金钱)\ 就像这样 `type: !has meta` > 请注意,此条件为DeluxeMenus最新版所更新的新属性 #### 判断是否在附近 ```yaml type: is near location: "WORLDNAME,X,Y,Z" #位置 (世界名,X,Y,Z) distance: # #距离多远会判断 ``` 必填的物品参数: * location * distance 判断玩家距离 location 点还有多远 同样,您可以在`is near`前加上感叹号(**!**),以表示反义(即检测玩家是否`没有`一定数量的金钱)\ 就像这样 `type: !is near` #### JavaScript 脚本语言 ```yaml type: javascript # 类型 expression: 'EXPRESSION' # 表达式 例子: ``YAML type: javascript # 类型 expression: '%vault_eco_balance% >= 100' # 表达式 判定玩家经济是否大于 100 `` ``` 使用 JavaScript , 必须返回真或者假 #### 字符串比较 ```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` #### 正则表达式 ```yaml 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` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://deluxemenu.wiki.complexstudio.net/xuan-xiang-pei-zhi/tiao-jian.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.