帮助文档

Part 1 · Execute

Execute 指令

改变执行者、位置、朝向与条件,构建任意执行链。

一、什么是 Execute 指令

Execute 是 Minecraft 中最强大也最复杂的指令之一。它允许你改变指令的执行者、执行位置、执行朝向,并添加各种条件判断,从而实现高度灵活的指令逻辑。

简单来说,Execute 指令的格式为:

execute <子命令1> <子命令2> ... run <最终指令>

你可以按任意顺序组合多个子命令,每个子命令都会影响后续指令的执行上下文。最终通过 run 来执行你想要的指令。

二、如何使用本工具

本工具采用积木式模块化设计,你只需要按照以下步骤操作:

  • 步骤1:在 execute 根模块右侧点击 「+」 按钮,添加第一个子模块。
  • 步骤2:在弹出的子模块中,选择你要使用的子命令类型(如「作为」、「在」、「执行位置」等)。
  • 步骤3:点击子模块内部的 「+」 按钮,展开该子命令的具体参数填写区。
  • 步骤4:填写目标选择器、坐标、角度等具体参数。
  • 步骤5:如果需要更多子命令,点击子模块右侧的 「+」 按钮继续添加。
  • 步骤6:在最底部的 run 模块中输入最终要执行的指令。
  • 步骤7:点击底部的 「生成指令」 按钮,即可获得完整的指令文本。
提示:你可以通过拖动模块左侧的 「≡」 手柄来调整模块的顺序或从属关系。将模块拖到另一个模块的上方、下方或内部,即可改变其层级位置。

三、模块层级与从属关系

本工具中的模块通过缩进来表示层级关系,缩进越深表示从属层级越深。

  • 第0层(无缩进):execute 根模块和 run 模块,固定不可移动。
  • 第1层(缩进一级):执行上下文子模块(「作为」和「在」),直接从属于 execute 根模块。
  • 第2层(缩进两级):修饰子模块(「执行位置」、「朝向」、「旋转角度」、「锚点」、「维度」、「条件判断」),从属于第1层模块或同级模块。
  • 第3层及更深:目标选择器模块、条件判断中的具体参数模块等,从属于上一级模块。
从属关系规则:每个子模块都从属于它上方最近的、缩进级别更低的模块。拖动时,虚线框的位置会告诉你目标层级。

四、目标选择器详解

目标选择器用于指定指令作用的对象。本工具支持以下六种目标选择器:

@p
最近的玩家
@a
所有玩家
@r
随机玩家
@e
所有实体(包含玩家)
@n
最近的实体(基岩版特有)
@s
指令执行者自身

目标选择器可以添加参数条件进行筛选,格式为:

@<类型>[<参数1>,<参数2>,...]

本工具支持的参数类型包括:

type — 实体类型,如 type=zombie
tag — 标签,如 tag=abc
scores — 计分板分数,如 scores={health=1..5}
family — 实体家族,如 family=monster
name — 实体名称,如 name=Steve
m — 游戏模式,如 m=survival
l — 最大经验等级,如 l=10
lm — 最小经验等级,如 lm=5
r — 最大距离,如 r=10
rm — 最小距离,如 rm=3
c — 数量,如 c=1
rx — 最大俯仰角,如 rx=45
rxm — 最小俯仰角,如 rxm=-45
ry — 最大偏航角,如 ry=90
rym — 最小偏航角,如 rym=-90
x,y,z — 坐标,如 x=100,y=64,z=-200
dx,dy,dz — 体积尺寸,如 dx=10,dy=5,dz=10
注意:参数值支持 =(等于)和 =!(不等于)两种比较方式。scores 参数必须使用大括号包裹,格式为 scores={记分项=分数范围}。

示例:

@e[type=zombie,tag=!boss,r=10] 选择半径10格内、类型为僵尸、没有 boss 标签的实体 @p[scores={health=1..5}] 选择生命值在1到5之间的最近玩家

五、执行上下文子模块

执行上下文子模块用于改变指令的执行者或执行位置。

「作为」(as)
  • 作用:改变指令的执行者。后续指令将以该目标选择器选中的实体身份执行。
  • 格式:as <目标选择器>
  • 示例:as @a — 让所有玩家分别执行后续指令
「在」(at)
  • 作用:改变指令的执行位置和朝向。后续指令将在该目标选择器选中的实体位置执行。
  • 格式:at <目标选择器>
  • 示例:at @p — 在最近玩家的位置执行后续指令
提示:「作为」和「在」经常搭配使用。例如 as @a at @s 表示"以所有玩家各自的身份,在各自的位置执行"。

六、修饰子模块

「执行位置」(positioned)
  • 作用:直接修改执行位置为指定的坐标。
  • 格式(坐标模式):positioned <x> <y> <z>
  • 格式(作为模式):positioned as <目标选择器>
  • 示例:positioned 100 64 -200 — 将执行位置设为指定坐标
  • 示例:positioned as @e[type=armor_stand] — 将执行位置设为盔甲架的位置
「朝向」(facing)
  • 作用:修改执行朝向,使其面对指定坐标或实体。
  • 格式(坐标模式):facing <x> <y> <z>
  • 格式(实体模式):facing entity <目标选择器> <eyes|feet>
  • 示例:facing 0 64 0 — 朝向坐标 (0, 64, 0)
  • 示例:facing entity @p eyes — 朝向最近玩家的眼睛位置
「旋转角度」(rotated)
  • 作用:直接修改执行朝向的角度。
  • 格式(角度模式):rotated <偏航角> <俯仰角>
  • 格式(作为模式):rotated as <目标选择器>
  • 注意:偏航角范围为 -180 ~ 180,俯仰角范围为 -90 ~ 90。
  • 示例:rotated 45 30 — 将朝向设为偏航角45度、俯仰角30度
  • 示例:rotated as @p — 将朝向设为与最近玩家相同
「锚点」(anchored)
  • 作用:切换执行朝向的基准点。
  • 格式:anchored <eyes|feet>
  • 示例:anchored eyes — 以眼部为基准点
  • 示例:anchored feet — 以脚部为基准点
「维度」(in)
  • 作用:将执行维度切换到指定的维度。
  • 格式:in <overworld|nether|end>
  • 示例:in nether — 在下界执行后续指令

七、条件判断子模块

条件判断用于在满足特定条件时才执行后续指令。「如果」表示条件成立时执行,「除非」表示条件不成立时执行。

「判断方块」(block)
  • 作用:检测指定位置的方块是否匹配。
  • 格式:block <x> <y> <z> <方块ID> [方块状态]
  • 示例:block ~ ~-1 ~ grass — 检测脚下是否是草方块
  • 示例:block 100 64 -200 stone — 检测指定位置是否是石头
「判断多个方块」(blocks)
  • 作用:检测一个区域内的方块是否与另一个区域完全匹配。
  • 格式:blocks <x1> <y1> <z1> <x2> <y2> <z2> <目标x> <目标y> <目标z> <masked|all>
  • all — 全部方块必须完全匹配
  • masked — 忽略空气方块
  • 示例:blocks 0 0 0 10 10 10 100 64 -200 all
「判断实体」(entity)
  • 作用:检测是否存在匹配的实体。
  • 格式:entity <目标选择器>
  • 示例:entity @a[r=3] — 检测3格内是否有玩家
  • 示例:entity @e[type=zombie] — 检测是否存在僵尸
「判断分数」(score)
  • 作用:检测实体的计分板分数是否满足条件。
  • 格式(与固定值比较):score <目标> <记分项> matches <数值范围>
  • 格式(与另一个记分项比较):score <目标A> <记分项A> <比较符> <目标B> <记分项B>
  • 比较符:< <= = >= >
  • 数值范围支持:具体数字(如 5)或区间(如 3..5 或 0..)
  • 示例:score @s health matches 1..5 — 检测自己的生命值在1到5之间
  • 示例:score @s health > @p health — 检测自己的生命值是否大于最近玩家

八、坐标与角度格式

坐标格式:

  • 绝对坐标:直接填写数字,如 100 64 -200
  • 相对坐标:使用 ~ 表示当前执行位置,如 ~ ~ ~ 表示当前位置,~10 ~-5 ~3 表示相对偏移
  • 局部坐标:使用 ^ 表示以执行者朝向为基准,如 ^ ^ ^1 表示前方一格

角度格式:

  • 偏航角(水平旋转):范围为 -180 ~ 180,0为正南方,顺时针增加
  • 俯仰角(垂直旋转):范围为 -90 ~ 90,0为水平,-90为正上方,90为正下方
示例角度:rotated 45 30 偏航角45度(东南方向),俯仰角30度(向下30度)

九、完整示例

下面是一个完整的指令搭建示例,展示如何使用本工具生成复杂指令:

execute as @e[type=armor_stand] at @s if entity @a[r=3] as @e[name=a] unless block ~ ~-1 ~ grass at @s run tp @s ~ ~1 ~

指令拆解:

  • as @e[type=armor_stand] — 执行者变为所有盔甲架
  • at @s — 执行位置变为每个盔甲架自己的位置
  • if entity @a[r=3] — 检查3格内是否有玩家
  • as @e[name=a] — 执行者切换为名字为 "a" 的实体
  • unless block ~ ~-1 ~ grass — 判断脚下是否不是草方块
  • at @s — 执行位置切换为名字为 "a" 的实体的位置
  • run tp @s ~ ~1 ~ — 将执行者向上传送1格
最终效果:当盔甲架附近3格内有玩家,且名字为 "a" 的实体脚下不是草方块时,将该实体向上传送1格。

十、注意事项

  • 子命令顺序:子命令的顺序会影响最终执行结果,请根据实际逻辑需求排列。
  • 目标选择器参数:参数值必须符合 Minecraft 标准格式,scores 必须使用大括号包裹。
  • 坐标格式:支持绝对坐标、相对坐标(~)和局部坐标(^)。
  • 角度范围:偏航角 -180 ~ 180,俯仰角 -90 ~ 90。超出范围会导致指令报错。
  • run 模块:必须放在所有子模块的最后,且只能出现一次。
  • 方块状态:为可选参数,格式为 [状态1=值1,状态2=值2]。
  • 网易版兼容性:本工具以网易版(基岩版)语法为标准,部分较新版本的国际版子命令可能不受支持。
提示:如果生成的指令在游戏中报错,请检查目标选择器参数是否填写正确,坐标和角度是否在有效范围内。

Part 2 · RawText

RawText 文本

tellraw / titleraw 的原始文本组件、节点与显示控制。

十一、RawText 是什么

RawText 是基岩版(Bedrock)用来描述一段「富文本」的 JSON 结构。它把文本、实体名、计分板分数、翻译键等拆成节点,按数组顺序拼接后显示。Java 版使用的是另一套 JSON 文本组件,两者语法不同。

RawText 本身不会执行,它要作为 tellraw 或 titleraw 的参数:

/tellraw <目标> <rawtext JSON> /titleraw <目标> <title|subtitle|actionbar> <rawtext JSON>

在 rawtext 页面顶部的「指令类型」中选择 tellraw 或 titleraw 的显示位置,下方节点会按顺序组成 rawtext 数组,再自动拼接成完整指令。

{"rawtext":[ {"text":"§6欢迎 "}, {"selector":"@p"}, {"text":" 进入服务器"} ]}
提示:数组中的节点会依次拼接,节点之间不会自动插入空格或换行,需要自己用 text 节点补充。

十二、显示位置与标题时长

同样的 rawtext 内容,换一个指令类型就会出现在不同位置:

tellraw — 聊天栏消息
titleraw title — 屏幕中央主标题
titleraw subtitle — 主标题下方的副标题
titleraw actionbar — 物品栏上方的动作栏

titleraw 只负责标题内容,不负责显示时长。时长由 /title ... times 控制,单位为游戏刻(20 刻 ≈ 1 秒):

/title @a times 10 40 10 /titleraw @a title {"rawtext":[{"text":"§6游戏开始"}]} /titleraw @a subtitle {"rawtext":[{"text":"§7准备战斗"}]}

动作栏(actionbar)不参与 title 的淡入淡出计时。需要隐藏或重置标题时:

/title @a clear /title @a reset
注意:/title 接收普通文本,/titleraw 接收 rawtext 对象,两者不能混用。

十三、四种节点类型

每个节点是数组中的一项,用不同的键表示类型:

text
  • 纯文本,支持 § 格式化与 \n 换行。
  • 示例:{"text":"§a你好世界"}
selector
  • 显示目标选择器解析出的实体名称,支持通用选择器参数。
  • 示例:{"selector":"@p"}、{"selector":"@e[type=zombie]"}
  • @n 表示最近的实体,是基岩版特有的选择器。
score
  • 显示某个计分项的分数值。
  • 字段:name 为目标,objective 为记分项名称。
  • 示例:{"score":{"name":"@s","objective":"points"}}
translate
  • 根据客户端语言显示翻译键对应的文本。
  • 字段:translate 为键名,with 为可选的参数节点数组。
  • 示例:{"translate":"chat.type.text","with":[{"selector":"@p"},{"text":"你好"}]}
提示:一个 rawtext 可以混用多种节点。工具中的「编辑 with」可以为 translate 节点继续添加子节点,最多 4 层。

十四、文本、颜色与换行

颜色与样式:在 text 中使用 § 加上格式码。常用代码如下:

§0–§9 — 黑、深蓝、深绿、深青、深红、紫、金、灰、深灰、蓝
§a–§f — 绿、青、红、粉、黄、白
§l — 粗体
§o — 斜体
§n — 下划线
§k — 随机字符
§r — 重置所有样式

换行:直接在文本里输入反斜杠加 n(\n)。本工具会把它原样保留为 JSON 转义序列,不会再转义成 \\n,粘贴进游戏后可以正常换行。

第一行\n第二行 §6金色文字 §r普通文字
注意:不要输入两个反斜杠(\\n)。那会被当成字面量,游戏里会显示成 “\n”。

引号、反斜杠等字符由工具自动做 JSON 转义,不需要手动加转义符号。

十五、translate 与 with

translate 节点使用客户端的语言文件,把翻译键换成当前语言文本。键名必须与游戏内语言键完全一致,否则会直接显示键名。

{"translate":"chat.type.text","with":[ {"selector":"@p"}, {"text":"你好"} ]}

with 是一个节点数组,按顺序替换翻译文本中的占位符。例如原键为 <%s> %s 时,上面的写法会显示成 <玩家名> 你好。

  • with 里的每一项也是一个 rawtext 节点,可以是 text、selector、score 或 translate。
  • 占位符数量与 with 项数不一致时,可能显示缺失或多余的占位符。
  • 本工具通过节点右侧的「编辑 with」进入子编辑器,最多嵌套 4 层。
提示:如果翻译键在当前客户端不存在,游戏会显示键名本身而不是报错;发布前建议在目标语言环境下测试。

十六、完整示例与常见问题

示例 1:聊天栏欢迎语

/tellraw @a {"rawtext":[{"text":"§6欢迎 "},{"selector":"@p"},{"text":" 来到服务器"}]}

示例 2:主标题、副标题与动作栏

/title @a times 10 40 10 /titleraw @a title {"rawtext":[{"text":"§e第一章"},{"text":"\n§7荒原"}]} /titleraw @a subtitle {"rawtext":[{"text":"§7点击开始探索"}]} /titleraw @a actionbar {"rawtext":[{"text":"§a在线: "},{"score":{"name":"@a","objective":"online"}}]}

示例 3:带参数的翻译文本

/tellraw @a {"rawtext":[{"translate":"chat.type.text","with":[{"selector":"@p"},{"text":"大家好"}]}]}

常见问题

  • 输出里出现 \\n:输入时只写一个反斜杠(\n);本工具不会再加一层转义。
  • 标题不显示:先执行 /title ... times;确认目标是玩家且没有被 clear 覆盖。
  • § 显示成普通字符:需要使用真正的段落符号 §,而不是 $ 或 &。
  • translate 显示键名:检查键名拼写、客户端语言以及 with 数量。
  • @n 无效:@n 是基岩版选择器;Java 版或部分旧版本不支持。