配置说明
修改 config.yml、message.yml 和 commands/*.yml 后,可以使用 /yccmd reload 重载。
配置文件
| 文件 / 目录 | 用途 |
|---|---|
config.yml | 基础设置 |
message.yml | 消息文本 |
commands/ | 中文命令规则 |
配置示例
下面是一个精简后的规则示例。复制时注意文件路径。
yaml
# 是否开启调试模式
# 说明:调试模式会打印较多内部信息,仅在开发或排查 bug 时建议开启。
debug: false
# 是否启用 bStats
# 说明:bStats 会收集一些匿名使用数据(如插件版本、服务器软件等),用于插件开发者改进功能与兼容性。
# 该统计不包含个人可识别信息;如需完全不发送任何数据可设为 false。
# 详细说明与查看: https://bstats.org/plugin/bukkit/YlesChineseCommand/
metrics: trueyaml
菜单:
type: chat
match:
- "菜单"
action:
- "[message]&a已打开菜单。"
回家:
type: command
match:
- "/回家"
action:
- "back"
- "[message]&a正在回家。"
创建重生点:
type: command
match:
- "/创建重生点"
action:
- "[message]&a正在创建重生点。"
- "[op]yr create <args1>"yaml
MESSAGE:
RELOAD: '配置文件重载完成'
COMMAND:
RELOAD: '重载插件的配置文件'
ADMIN:
NO_PERMISSION_CMD: '你没有权限执行此指令'
NO_CMD: '未找到此子指令'
NO_FORMAT: '格式错误'
NO_ONLINE: '玩家不在线或玩家不存在'
PLUGIN_RELOAD: '插件已重载'
ERROR:
USAGE_COMMAND: '未找到此子指令'规则字段
commands/*.yml 里的顶层节点就是一条规则。
| 字段 | 说明 |
|---|---|
type | 触发类型,可用 chat 或 command |
match | 匹配内容列表 |
action | 匹配成功后执行的动作列表 |
触发类型
chat 匹配玩家聊天内容。匹配成功后,原聊天会被取消。
command 匹配玩家输入的命令。匹配成功后,原命令会被取消。
提示
command 类型的匹配内容需要带 /,例如 /回家。
参数占位符
插件会把触发内容后面的参数按空格拆分。
| 占位符 | 返回内容 |
|---|---|
<args1> | 第 1 个参数 |
<args2> | 第 2 个参数 |
<args3> | 第 3 个参数 |
例如玩家输入 /创建重生点 主城 普通,<args1> 是 主城,<args2> 是 普通。