自定义命令（简单命令）

CustomCommands (Hytale)

一个简单的 Hytale 服务器插件，允许你在 JSON 文件中定义简单的聊天命令。

功能

• 在 config.json 中定义自定义命令
• 每个命令回复可配置的消息
• 通过 linkUrl 可选的可点击链接输出
• 支持每个命令的权限节点
• 管理员命令用于列出和重新加载已注册的命令

安装

1. 将 JAR 文件复制到服务器的 mods/ 文件夹中。
2. 启动一次服务器以生成配置文件。

支持

Embed Removed: https://discord.com/widget?id=744980147404406894&theme=dark

配置

配置文件路径：

• mods/CommandsPlugin/config.json（插件写入/读取此路径）

示例：

• debugEnabled (布尔值): 启用额外的调试输出（默认: false）
• commands (数组): 自定义命令列表

{
  "debugEnabled": false,
  "commands": [
    {
      "name": "discord",
      "response": "Discord: https://discord.gg/DEIN_INVITE",
      "linkUrl": "https://discord.gg/DEIN_INVITE"
    },
    {
      "name": "rules",
      "response": "Regeln:\\n1) Sei respektvoll\\n2) Kein Spam\\n3) Kein Cheating\\n4) Folge den Anweisungen des Teams"
    }
  ]
}

命令字段

• name (字符串，必需): 命令名称（可以带或不带前导 /）。
• response (字符串，必需): 发送给玩家的消息。
• linkUrl (字符串，可选): 如果设置，插件将 URL 作为单独的可点击消息发送。
• permission (字符串，可选): 使用该命令所需的权限节点。
  • 如果省略，默认值为 CustomCommand.Command.<name>

权限

该插件使用命令系统内置的权限要求（requirePermission(...)）。

每个命令

默认情况下，每个配置的命令都需要：

• CustomCommand.Command.<commandName>

示例：

• /discord -> CustomCommand.Command.discord
• /rules -> CustomCommand.Command.rules

如果你在配置中设置了 permission，则将使用该权限节点代替。

管理员

• /cmdreload -> CustomCommand.admin.reload
• /cmdlist -> CustomCommand.admin.list
• 两个管理员命令均支持通配符：CustomCommand.admin.*

命令

• /<name>: 在 config.json 中定义的任意命令
• /cmdlist: 列出当前已注册的可配置命令
• /cmdreload: 重新加载 config.json 并注册新添加的命令

注意事项 / 限制

• 重新加载目前仅注册新的命令（不会删除或替换已注册的命令）。
• 如果你更改了现有命令的回复，请重启服务器（或扩展插件以取消注册/重新注册）。