帮助文档
execute · tellraw / titleraw 完整使用指南
Part 1 · Execute
Execute 指令
改变执行者、位置、朝向与条件,构建任意执行链。
一、什么是 Execute 指令
Execute 是 Minecraft 中最强大也最复杂的指令之一。它允许你改变指令的执行者、执行位置、执行朝向,并添加各种条件判断,从而实现高度灵活的指令逻辑。
简单来说,Execute 指令的格式为:
你可以按任意顺序组合多个子命令,每个子命令都会影响后续指令的执行上下文。最终通过 run 来执行你想要的指令。
二、如何使用本工具
本工具采用积木式模块化设计,你只需要按照以下步骤操作:
- 步骤1:在 execute 根模块右侧点击 「+」 按钮,添加第一个子模块。
- 步骤2:在弹出的子模块中,选择你要使用的子命令类型(如「作为」、「在」、「执行位置」等)。
- 步骤3:点击子模块内部的 「+」 按钮,展开该子命令的具体参数填写区。
- 步骤4:填写目标选择器、坐标、角度等具体参数。
- 步骤5:如果需要更多子命令,点击子模块右侧的 「+」 按钮继续添加。
- 步骤6:在最底部的 run 模块中输入最终要执行的指令。
- 步骤7:点击底部的 「生成指令」 按钮,即可获得完整的指令文本。
三、模块层级与从属关系
本工具中的模块通过缩进来表示层级关系,缩进越深表示从属层级越深。
- 第0层(无缩进):execute 根模块和 run 模块,固定不可移动。
- 第1层(缩进一级):执行上下文子模块(「作为」和「在」),直接从属于 execute 根模块。
- 第2层(缩进两级):修饰子模块(「执行位置」、「朝向」、「旋转角度」、「锚点」、「维度」、「条件判断」),从属于第1层模块或同级模块。
- 第3层及更深:目标选择器模块、条件判断中的具体参数模块等,从属于上一级模块。
四、目标选择器详解
目标选择器用于指定指令作用的对象。本工具支持以下六种目标选择器:
目标选择器可以添加参数条件进行筛选,格式为:
本工具支持的参数类型包括:
type=zombietag=abcscores={health=1..5}family=monstername=Stevem=survivall=10lm=5r=10rm=3c=1rx=45rxm=-45ry=90rym=-90x=100,y=64,z=-200dx=10,dy=5,dz=10=(等于)和 =!(不等于)两种比较方式。scores 参数必须使用大括号包裹,格式为 scores={记分项=分数范围}。
示例:
五、执行上下文子模块
执行上下文子模块用于改变指令的执行者或执行位置。
- 作用:改变指令的执行者。后续指令将以该目标选择器选中的实体身份执行。
- 格式:
as <目标选择器> - 示例:
as @a— 让所有玩家分别执行后续指令
- 作用:改变指令的执行位置和朝向。后续指令将在该目标选择器选中的实体位置执行。
- 格式:
at <目标选择器> - 示例:
at @p— 在最近玩家的位置执行后续指令
as @a at @s 表示"以所有玩家各自的身份,在各自的位置执行"。
六、修饰子模块
- 作用:直接修改执行位置为指定的坐标。
- 格式(坐标模式):
positioned <x> <y> <z> - 格式(作为模式):
positioned as <目标选择器> - 示例:
positioned 100 64 -200— 将执行位置设为指定坐标 - 示例:
positioned as @e[type=armor_stand]— 将执行位置设为盔甲架的位置
- 作用:修改执行朝向,使其面对指定坐标或实体。
- 格式(坐标模式):
facing <x> <y> <z> - 格式(实体模式):
facing entity <目标选择器> <eyes|feet> - 示例:
facing 0 64 0— 朝向坐标 (0, 64, 0) - 示例:
facing entity @p eyes— 朝向最近玩家的眼睛位置
- 作用:直接修改执行朝向的角度。
- 格式(角度模式):
rotated <偏航角> <俯仰角> - 格式(作为模式):
rotated as <目标选择器> - 注意:偏航角范围为 -180 ~ 180,俯仰角范围为 -90 ~ 90。
- 示例:
rotated 45 30— 将朝向设为偏航角45度、俯仰角30度 - 示例:
rotated as @p— 将朝向设为与最近玩家相同
- 作用:切换执行朝向的基准点。
- 格式:
anchored <eyes|feet> - 示例:
anchored eyes— 以眼部为基准点 - 示例:
anchored feet— 以脚部为基准点
- 作用:将执行维度切换到指定的维度。
- 格式:
in <overworld|nether|end> - 示例:
in nether— 在下界执行后续指令
七、条件判断子模块
条件判断用于在满足特定条件时才执行后续指令。「如果」表示条件成立时执行,「除非」表示条件不成立时执行。
- 作用:检测指定位置的方块是否匹配。
- 格式:
block <x> <y> <z> <方块ID> [方块状态] - 示例:
block ~ ~-1 ~ grass— 检测脚下是否是草方块 - 示例:
block 100 64 -200 stone— 检测指定位置是否是石头
- 作用:检测一个区域内的方块是否与另一个区域完全匹配。
- 格式:
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 @a[r=3]— 检测3格内是否有玩家 - 示例:
entity @e[type=zombie]— 检测是否存在僵尸
- 作用:检测实体的计分板分数是否满足条件。
- 格式(与固定值比较):
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为正下方
九、完整示例
下面是一个完整的指令搭建示例,展示如何使用本工具生成复杂指令:
指令拆解:
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格
十、注意事项
- 子命令顺序:子命令的顺序会影响最终执行结果,请根据实际逻辑需求排列。
- 目标选择器参数:参数值必须符合 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 的参数:
在 rawtext 页面顶部的「指令类型」中选择 tellraw 或 titleraw 的显示位置,下方节点会按顺序组成 rawtext 数组,再自动拼接成完整指令。
text 节点补充。
十二、显示位置与标题时长
同样的 rawtext 内容,换一个指令类型就会出现在不同位置:
titleraw 只负责标题内容,不负责显示时长。时长由 /title ... times 控制,单位为游戏刻(20 刻 ≈ 1 秒):
动作栏(actionbar)不参与 title 的淡入淡出计时。需要隐藏或重置标题时:
/title 接收普通文本,/titleraw 接收 rawtext 对象,两者不能混用。
十三、四种节点类型
每个节点是数组中的一项,用不同的键表示类型:
- 纯文本,支持
§格式化与\n换行。 - 示例:
{"text":"§a你好世界"}
- 显示目标选择器解析出的实体名称,支持通用选择器参数。
- 示例:
{"selector":"@p"}、{"selector":"@e[type=zombie]"} @n表示最近的实体,是基岩版特有的选择器。
- 显示某个计分项的分数值。
- 字段:
name为目标,objective为记分项名称。 - 示例:
{"score":{"name":"@s","objective":"points"}}
- 根据客户端语言显示翻译键对应的文本。
- 字段:
translate为键名,with为可选的参数节点数组。 - 示例:
{"translate":"chat.type.text","with":[{"selector":"@p"},{"text":"你好"}]}
十四、文本、颜色与换行
颜色与样式:在 text 中使用 § 加上格式码。常用代码如下:
换行:直接在文本里输入反斜杠加 n(\n)。本工具会把它原样保留为 JSON 转义序列,不会再转义成 \\n,粘贴进游戏后可以正常换行。
\\n)。那会被当成字面量,游戏里会显示成 “\n”。
引号、反斜杠等字符由工具自动做 JSON 转义,不需要手动加转义符号。
十五、translate 与 with
translate 节点使用客户端的语言文件,把翻译键换成当前语言文本。键名必须与游戏内语言键完全一致,否则会直接显示键名。
with 是一个节点数组,按顺序替换翻译文本中的占位符。例如原键为 <%s> %s 时,上面的写法会显示成 <玩家名> 你好。
with里的每一项也是一个 rawtext 节点,可以是 text、selector、score 或 translate。- 占位符数量与
with项数不一致时,可能显示缺失或多余的占位符。 - 本工具通过节点右侧的「编辑 with」进入子编辑器,最多嵌套 4 层。
十六、完整示例与常见问题
示例 1:聊天栏欢迎语
示例 2:主标题、副标题与动作栏
示例 3:带参数的翻译文本
常见问题
- 输出里出现 \\n:输入时只写一个反斜杠(
\n);本工具不会再加一层转义。 - 标题不显示:先执行
/title ... times;确认目标是玩家且没有被clear覆盖。 - § 显示成普通字符:需要使用真正的段落符号
§,而不是$或&。 - translate 显示键名:检查键名拼写、客户端语言以及
with数量。 - @n 无效:
@n是基岩版选择器;Java 版或部分旧版本不支持。