# 快捷键
一个用于创建命令快捷键的 Minecraft 插件，无需其他插件
> *重新加载就绪！ 此插件在执行 /reload 时没有不良影响：命令将根据配置文件中的更改被禁用和添加*
## 配置文件
每个命令都可以单独配置
基本 YAML 结构如下：
```yml
# 这是你在游戏中将输入的命令名称/标签（例如 /command_name）
command_name:
# 可选的权限，可以是任何内容
# 如果发送者没有此权限，则无法运行此快捷键
permision: example.permission
# 如果命令只能由玩家执行（这也是可选的）
# 对于非玩家，执行方法将立即返回
playerOnly: false
# 可选的描述如何使用该命令的方法
usage: "/command_name "
# 实际用于控制快捷键执行的内容
executions:
- {
# 要运行的命令
# %%0 将替换为提供的第一个参数，%%1 是第二个参数，依此类推
# 如果你愿意，可以使用占位符
run: say %%0,
# 作为谁运行命令
# 必须是 "sender" 或 "console"
as: sender
}
- {
# 要发送给用户的消息
# 可以在这里使用格式和占位符
display: Example message with §aFormatting!
}
```
### 示例
以下是“gmc”命令快捷键的一个示例：
> 此示例中使用了占位符，如果你想使用它，请确保你安装了 PlaceHolderApi
```yml
# 要使用的命令标签
gmc:
# 运行此快捷键所需的权限
# 这不会绕过代理上的原始命令的检查！
# 占位符在这里不起作用
permission: command.gamemode
# 如果命令只能由玩家运行
# 占位符在这里不起作用
playerOnly: true
# 在发布无效版本的此命令时显示
# 占位符在这里不起作用
usage: /gmc
executions:
# 作为发送者运行命令“gamemode creative”
# 可以在这里使用占位符
- { run: gamemode creative %player_name%, as: console }
# 向执行者显示此消息
# 可以在这里使用占位符
- { display: "§0[§a✓§0]§r You are now in creative mode" }
```
以下是每个元素的说明：
| 组件 | 使用的值 | 描述 |
| --- | --- | --- |
| 权限 | command.gamemode | 指定运行“gmc”命令所需的权限。 尝试执行此命令的用户必须具有“command.gamemode”权限。 |
| 仅限玩家 | true | 设置为 `true` 时，此配置可确保只有玩家（而不是控制台或其他实体）才能执行“gmc”命令。 |
| 用法 | /gmc | “usage”字段指定用户应遵循的命令语法来调用“gmc”命令。 |
执行步骤 1
| 操作 | 要运行的命令 | 作为发送者 |
| --- | --- | --- |
| 运行命令 | `gamemode creative %player_name%` | `console` |
此步骤指示系统将执行者的游戏模式设置为创造模式。 占位符 `%player_name%` 被替换为执行者的姓名。 命令作为控制台运行。
执行步骤 2
| 操作 | 要显示的提示信息 |
| --- | --- |
| 显示消息 | "§0[§a✓§0]§r You are now in creative mode" |
此步骤向执行者显示一条消息，指示他们现在处于创造模式。 消息包含格式以增强视觉效果。