命令版本¶
命令版本(Command Version)控制命令解析器采用的语法规则。它不等同于游戏外显版本;游戏版本只能用于判断某项命令语法大约在何时加入、移除或解除实验性限制。
使用范围¶
命令版本会影响函数、命令方块和附加包内命令的解析。对于普通聊天栏或服务端控制台输入的命令,游戏通常使用当前构建可用的最新命令语法;对于附加包内命令,最低引擎版本会影响命令解析逻辑。
不要混淆版本类型
本页目前不列出可稳定核对的命令版本整数映射表。在没有足够证据前,不应把游戏版本、外显版本、引擎版本或协议版本直接当作命令版本使用。
近期语法变更线索¶
以下表格按游戏版本整理近期命令语法变更,用于判断命令功能的最低可用游戏版本。实验性要求会随版本变化而移除,因此同一语法在较早版本可能需要实验性玩法,在较新版本可能不再需要。
| 游戏版本 | 变更摘要 |
|---|---|
| 26.10.25 | camera attach_to_entity、camera detach_from_entity和camera play_spline不再需要特定实验性玩法。 |
| 26.0.27 | camera play_spline加入实验性语法。 |
| 26.0.23 | 新增packstack命令。 |
| 1.21.120.24 | camera新增attach_to_entity和detach_from_entity子命令(实验性)。 |
| 1.21.100.25 | camera fov_clear和camera fov_set不再需要特定实验性玩法。 |
| 1.21.90.23 | controlscheme命令不再需要特定实验性玩法。 |
| 1.21.90.21 | place jigsaw和place structure新增liquidSettings参数。 |
| 1.21.80.27 | 新增实验性controlscheme命令。 |
| 1.21.70.23 | aimassist命令不再需要特定实验性玩法。 |
| 1.21.60.24 | script命令新增diagnostics startcapture和diagnostics stopcapture子命令。 |
| 1.21.50.20 | schedule新增delay子命令。 |
历史关键节点¶
| 游戏版本 | 变更摘要 |
|---|---|
| 1.20.20.22 | camera命令主体不再需要特定实验性玩法。 |
| 1.19.50.23 | 新版execute子命令链语法不再需要特定实验性玩法。 |
| 1.19.10.20 | execute开始采用子命令链调用形式。 |
| 1.18.10.26 | 新增damage命令。 |
| 1.17.30.23 | 新增script debugger相关子命令。 |
| 1.16.100.52 | 新增playanimation、ride和structure命令。 |
| 1.8.0.10 | 新增function命令。 |
| 1.7.0.2 | 新增scoreboard命令。 |
| 0.15.90.0 | 早期基岩版命令系统加入多项基础命令。 |
延伸阅读¶
当前命令列表¶
以26.10.25预览版的命令语法为例,当前测试构建的命令集合包含常规管理命令、世界编辑命令、实体与物品命令、相机命令、脚本诊断命令、结构放置命令、记分板命令和教育版命令等。启用教育版选项后,还会额外提供ability、immutableworld、wb和worldbuilder等语法。
若目标是当前正式版,则应先以26.1.1命令表判断可用语法。packstack、controlscheme、inputpermission和schedule delay已经进入正式版;camera attach_to_entity、camera detach_from_entity和camera play_spline则仍应按预览版语法看待,不能直接当作正式版默认可用。
完整命令语法会频繁随预览版和正式版更新而变化。编写教程或参考页时,应优先依据目标游戏版本的实际导出命令表或官方更新日志校验语法。