自定义斜杠

Custom Slash

Custom Slash 是一个以 GUI 为主体的 Hytale 插件，用于创建、管理和运行可复用的命令与变量。

它专为想要快速执行命令而无需记忆命令语法的玩家和服务器管理员打造。

自 1.0.0 版本起，输入 /cs 即可打开完整界面来管理命令别名、变量、预览刷新和内置功能。

GUI 优先教程

1) 打开界面

/cs

顶部选项卡：

• 命令：创建/更新/删除可运行的命令别名
• 变量：创建/更新/删除可复用的值（@名称）
• 内置功能：方法、运行时令牌和关键词（delay、repeat）

2) 建议先创建变量

变量可让你在多个命令中复用值。

1. 打开 变量。
2. 点击 新建变量。
3. 设置：
   • 名称：homePos
   • 值：5103 169 4982 （或 %getPlayerCurrPos() 如果你想捕捉当前坐标）
4. 点击 创建变量。

之后可作为 @homePos 使用。

3) 创建使用变量的命令

1. 打开 命令。
2. 点击 新建命令。
3. 设置：
   • 名称：home
   • 命令：tp %me @homePos
4. 点击 刷新预览 来解析当前草稿。
5. 点击 创建命令。

4) 管理和编辑条目

• 在左侧列表中选择任意命令/变量进行编辑。
• 通过操作按钮进行更新。
• 删除需确认，确保破坏性操作更安全。
• 使用 搜索 快速过滤大量列表。

5) 可在命令中使用的内置功能

运行时令牌：

• %me -> 当前玩家名称
• %pos -> 当前玩家坐标
• %world -> 当前世界名称
• %time -> 当前世界刻/时间

捕捉方法：

• %getPlayerCurrPos()
• %getPlayerName()
• %getWorldName()

关键词：

• delay <毫秒> （50-10000）
• repeat <次数> <命令> （1-10）

6) 运行已保存的命令

保存 home 后，运行：

/cs home

要单次执行命令：

/cs run "tp %me @homePos"

安全与行为

• 破坏性操作在命令行流程中需要显式确认。
• /cs 对所有玩家开放。
• 底层命令执行仍遵循原生 Hytale 权限检查。
• 未定义的变量、递归变量和格式错误的链条会以清晰错误信息失败。

命令行等效操作

宏命令

/cs addcommand --name=home --command="tp self 5103 169 4982"
/cs ac home "tp self 5103 169 4982"
/cs updatecommand --name=home --command="tp self 0 0 0"
/cs uc home "tp self 0 0 0"
/cs rename 旧名称 新名称
/cs info home
/cs dryrun home
/cs run tp %me @home
/cs run "say start; delay 500; repeat 2 say ready"
/cs listcommands
/cs listc
/cs home

变量命令

/cs setvar --name=warp --value="5103 169 4982"
/cs upvar --name=warp --value="5104 169 4983"
/cs delvar warp
/cs listvars
/cs listv

自动化示例

/cs run "cs tp1; delay 500; cs tp2; delay 500"
/cs run "repeat 3 say ready"
/cs run "repeat 2 cs tploop"

安全与实用命令

/cs listall
/cs help
/csy
/cs cancel

兼容性

• 为现代 Hytale 服务器插件工作流设计。
• 每个玩家的数据持久化到 JSON，并具有备份感知的加载和保存行为。