Melius Commands

Melius Commands

一个 Fabric 服务端模组，用于创建自定义命令并修改现有命令

自定义命令

要添加自定义命令，请在 ./config/melius-commands/commands 中创建一个 json 文件。
示例文件请参见 examples/commands！在游戏内运行 /reload 即可应用你的更改。

JSON 格式

Json 格式中包含用于说明的注释（请勿将 // 复制到你的文件中）

命令节点（字面量 / 参数）

查看在线生成器，快速轻松地创建你的自定义命令！
这也会确保你的语法有效。

根节点必须始终是字面量节点。

{
  "id": "...",
  // 命令 id（字面量命令节点的命令名称）（必填）
  "type": "...",
  // 参数类型，见下文。（仅参数节点，必填）
  "executes": [
    // 命令节点执行列表，见下文。
  ],
  "require": {
    // 更多信息请参见 https://github.com/Patbox/PredicateAPI/。
    // 如果对某个命令源求值为 true，则该命令源将有权访问此命令节点！
  },
  "literals": [
    // 字面量子节点列表
  ],
  "arguments": [
    // 参数子节点列表
  ],
  "redirect": "..."
  // 如果指定，命令将从指定节点复制执行、要求和子节点。
  // 这实际上可以为另一个命令创建别名
}

执行

这可以是一个简单的字符串，将以控制台身份、op 等级 4 静默执行，也可以像这样手动配置：

{
  "command": "...",
  // 将要执行的命令（可以使用 ${id} 引用参数值）
  "silent": false,
  // 如果设为 true，则禁用命令输出
  "as_console": false,
  // 此命令是否应作为控制台命令源执行
  "op_level": 4
  // 命令源的 operator 等级（可选）（可能的值：0 - 4）
}

command 执行值可以使用命令参数中的占位符以及
全局占位符，格式为 ${PLACEHOLDER}，其中 PLACEHOLDER
可以是参数 id，也可以是全局占位符，
例如 player:name。

参数类型

所有参数类型的完整列表请参阅参数类型 wiki。
某些参数类型需要额外参数，必须以空格分隔追加。

命令修饰符

要添加命令要求，请在 ./config/melius-commands/modifiers 中创建一个 json 文件。
示例文件请参见 examples/modifiers！

JSON 格式

查看在线生成器，快速轻松地创建你的自定义命令
修饰符！这也会确保你的语法有效。

Json 格式中包含用于说明的注释（请勿将 // 复制到你的文件中）

命令修饰符

语法取决于你选择的修饰符类型。最重要的是要注意，有两种
命令匹配器：

• 节点匹配器会根据路径匹配命令节点（Brigadier 用于在内部表示命令的结构）（例如，teleport.location 会匹配任何类似 /teleport 0 100 0 的命令）
• 命令匹配器会匹配命令执行时使用的字符串（例如，warp end 会匹配 /warp end）

这两种类型都各有三种模式：

• strict 修饰符只会应用于完全匹配的节点 / 命令输入
• starts_with 修饰符会应用于指定的节点 / 命令，以及所有比它“更长”的内容
• regex 修饰符会应用于所有符合正则表达式的内容

节点匹配器有一个额外字段 requirement_modifier，可用于修改节点的要求，
这会将该命令从不满足要求的玩家 / 命令源中完全移除！

命令节点路径

你可以使用 /melius-commands path <cmd> 命令来确定任意命令的节点路径。
例如，要检查 /tp DrexHD 0 100 0（将实体传送到方块位置）的路径，请输入
/melius-commands path tp DrexHD 0 100 0，你将得到 teleport.targets.location，可在命令
修饰符中使用。

占位符

• %melius-commands:cooldown [id]% / %melius-commands:cooldown [id] [formatting]% – 玩家命令冷却时间。
• [id] 是冷却修饰符中指定的 ID。
• [formatting] 是时长格式，请确保正确转义。