命令与方块
按 / 或 ^ 打开输入行，框里会自动带一个 /。按 T 是聊天，不带斜杠；聊天里手打 /... 也会按命令执行。
输入行的规则
- 命令名不区分大小写；执行前会把原话（带斜杠和参数）原样写进左下角消息记录。
- Tab 只补全内置命令名，不补参数，也不补模组命令；按去掉斜杠后的前缀匹配。
- ↑ / ↓ 翻最近 30 条历史，存的是带斜杠的原话。
- Enter 执行 / 发送，Esc 取消；输入时鼠标解锁，移动和世界更新暂停。
- Ctrl + V 粘贴，只保留可打印 ASCII；换行和制表符变成空格。
内置命令
| 命令 | 作用 |
|---|---|
| 帮助与模式 | |
/help | 列出内置命令。模组命令不在里面，用 /mods 看已加载的模组。 |
/gamemode survival|creative|spectator/gm 0|1|3 | 切换游戏模式；也接受 s、c 简写。 |
/spectator | 在旁观和上一个模式之间切换。 |
| 移动与位置 | |
/tp <x> <y> <z> | 传送到坐标；坐标是绝对整数，不支持 ~ 相对写法。 |
/spawn | 回到世界出生点。 |
/kill | 回出生点并把速度清零；生存模式会播受伤音效。它不会单独重置生命值。 |
/village/village tp | 查 800 格内最近的村庄 / 传送到村中心。 |
| 世界 | |
/time day|night|set <0-1> | 设置时间；day = 0.25，night = 0.75，set 接受 0–1。 |
/weather clear|rain|snow | 切换天气，并把下次切换倒计时设为 90 秒。 |
/seed | 显示当前世界种子（无符号整数）。 |
/save | 保存当前世界和房主自己的玩家状态。 |
/mobs [n] | 在附近生成生物，n 默认 5，范围 1–20。 |
/fill <x1> <y1> <z1> <x2> <y2> <z2> <block> | 填充区域，最多 4096 格；y 会被夹到 0–63。 |
| 玩家与界面 | |
/give <block> [count] | 往背包里加方块；count 默认 1。 |
/clear | 清空 36 格背包和手里拿着的堆叠。 |
/render <4-16> | 设置渲染距离（区块），会同步给区块流式加载器。 |
/fov <55-100> | 设置视野。 |
/debug | 开关 F3 调试面板。 |
/mods | 列出已加载的模组数量和名字。 |
/version | 显示当前构建版本。 |
联机时客户端不能执行 /time、/weather、/fill、/mobs 和 /save；这些只对房主生效。客户端执行 /tp、/spawn、/give、/gamemode 只改自己的状态。
方块名与 ID
/give、/fill 和模组 API 用方块名，不区分大小写；也可以写完整命名空间，例如 caelcraft:stone。内置方块固定 0–14，模组从 15 起追加，完整名是 <模组 id>:<方块 id>。
| ID | 名字 | 硬度 | 掉落 / 备注 |
|---|---|---|---|
| 0 | air | — | 只能用于 /fill 清除区域；/give air 无效。 |
| 1 | grass | 0.4 | 掉土。 |
| 2 | dirt | 0.4 | 掉自己。 |
| 3 | stone | 1.4 | 掉圆石。 |
| 4 | sand | 0.35 | 掉自己。 |
| 5 | wood | 1.2 | 原木，掉自己。 |
| 6 | leaves | 0.2 | 叶，cutout 透明；掉自己。 |
| 7 | snow | 0.3 | 雪块，掉自己。 |
| 8 | water | — | 流体，走半透明网格；/fill 可以放。 |
| 9 | lava | — | 流体，走不透明网格；碰到会回出生点。 |
| 10 | planks | 0.8 | 木板；8 块换 1 个书架。 |
| 11 | cobblestone | 1.5 | 圆石。 |
| 12 | bricks | 1.6 | 砖块。 |
| 13 | bookshelf | 0.9 | 书架；顶 / 底是木板纹理。 |
| 14 | gravel | 0.5 | 碎石。 |
模组方块也可以直接用于 /give 和 /fill，例如 /give ruby:block 8。如果模组没装，名字会解析失败，提示 Unknown block。
几个例子
命令示例 / 输入行
/gamemode survival
/give stone 64
/fill 10 40 10 20 42 20 planks
/village
/village tp
/time set 0.25
/weather rain
/mobs 5
/render 10
/fov 80
/fill 的 y 会被夹到 0–63，体积超过 4096 格会直接拒绝。填充后会同步重建周围区块，量大时会卡一下。
模组命令
模组通过 cael.register_command(name, fn) 注册命令，回调收到 args（字符串）和 player（玩家名），返回一段字符串显示在消息里。命令名不区分大小写，开头的 / 会被去掉。
/mods 列出已加载的模组；/help 不会列出模组命令。Tab 也只补全内置命令名。模组命令的完整写法看对应模组的说明或它的 main.lua。
API 细节见 模组。