HT命令

HTCommands

一个适用于Hytale服务器的轻量级命令链插件。将多组命令保存为命名集合，并通过单条命令一次性执行所有命令。每条命令可配置为以玩家身份或控制台身份运行。

Discord : https://discord.gg/y6RemcjSaD

特性

• 将命令链保存为JSON文件，并通过/htrun <名称>运行
• 每条命令均可控制：使用前缀指定以玩家身份或控制台身份运行
• {player}占位符会自动替换为执行玩家的名称
• 可在游戏内管理命令集，或直接编辑JSON文件
• 热重载配置，无需重启服务器

命令

命令	描述
/htrun 名称	执行已保存命令集中的所有命令
/htcmd create 名称	创建新的空命令集
/htcmd add 名称 "命令"	向命令集添加命令（多词命令请用引号包裹）
/htcmd remove 名称 序号	按序号（从1开始）删除命令
/htcmd delete 名称	删除整个命令集
/htcmd list	列出所有已保存的命令集
/htcmd info 名称	查看命令集中的所有命令
/htcmd reload	从磁盘重新加载命令集

别名： /htcmd也可以使用/htc

权限

权限	描述
htcommands.run	使用/htrun执行命令集
htcommands.admin	所有/htcmd子命令的父权限
htcommands.admin.create	创建新命令集
htcommands.admin.add	向命令集添加命令
htcommands.admin.remove	从命令集删除命令
htcommands.admin.delete	删除命令集
htcommands.admin.list	列出所有命令集
htcommands.admin.info	查看命令集中的命令
htcommands.admin.reload	从磁盘重新加载配置

命令前缀

命令集中的每条命令均可添加前缀，以控制其运行身份：

前缀	运行身份	描述
(无)	玩家	以输入/htrun的玩家身份运行。要求玩家拥有该命令的权限。
player:	玩家	与无前缀相同——显式标记命令为玩家执行。
console:	控制台	以完全的控制台权限运行。用于玩家无需直接拥有权限的管理员命令。
silent:	两者	静默执行命令，使其不在聊天中显示。

占位符

占位符	替换为
{player}	执行/htrun的玩家的用户名

示例

新手礼包（混合玩家与控制台身份）

/htcmd create starterkit /htcmd add starterkit "console:give {player} stone 64" /htcmd add starterkit "console:give {player} wood 64" /htcmd add starterkit "island home"

然后运行：/htrun starterkit

• give命令以控制台身份运行（玩家无需拥有give权限）
• island home命令以玩家身份运行

批量区域标志设置

/htcmd add plotsetup "console:rg flag singleplot1 build allow -g Members"
/htcmd add plotsetup "console:rg flag singleplot1 pvp deny"
/htcmd add plotsetup "console:rg flag singleplot1 mob-spawning deny"

然后运行：/htrun plotsetup

直接编辑JSON

对于大型命令集，建议直接编辑plugins/HTCommands/commands.json并使用/htcmd reload。

{
  "entries": [
    {
      "name": "starterkit",
      "commands": [
        "console:give {player} stone 64",
        "console:give {player} wood 64",
        "island home"
      ]
    },
    {
      "name": "plotsetup",
      "commands": [
        "console:rg flag singleplot1 build allow -g Members",
        "console:rg flag singleplot1 pvp deny",
        "console:rg flag singleplot1 mob-spawning deny",
        "console:rg flag singleplot2 build allow -g Members",
        "console:rg flag singleplot2 pvp deny",
        "console:rg flag singleplot2 mob-spawning deny"
      ]
    }
  ]
}

注意事项

• JSON中的命令不要包含前导的/
• 在游戏内添加命令时，多词命令请用引号包裹：/htcmd add 名称 "console:give {player} stone 64"
• 对于批量命令（50条以上），建议直接编辑JSON文件 + /htcmd reload
• {player}占位符同时适用于console:和player:前缀