跳到主要内容

🔗 链式参数

简介

链式参数使用点表示法(通过 . 连接),以层级结构访问与对象相关的参数。

举个例子,在一个交互事件中,如果我们能够访问到玩家实例,就可以通过这个对象来获取额外的参数。

通过链式属性访问器,例如:

  • player.world → 获取玩家当前所在的世界
  • world.name → 获取该世界的名称

我们可以将它们组合成参数标签,如 <arg:player.world.name>。这个标签会动态返回玩家当前所在世界的名称。

<arg:路径><viewer_arg:路径> 都支持链式参数。第一段是上下文键,因此可用的根参数取决于文本的执行位置。例如,同一种物品对象可能以 itemitem_in_handfurniture_itemplayer.main_hand_itemplayer.off_hand_itementity.item 提供。

如果参数可能不存在,可以用 <arg:路径:默认值> 提供默认值,例如 <arg:entity.item.id:none>。参数不存在且未提供默认值时会报错。

对象

player

参数类型描述
x双精度浮点数玩家的 x 坐标
y双精度浮点数玩家的 y 坐标
z双精度浮点数玩家的 z 坐标
pitch单精度浮点数玩家的俯仰角
yaw单精度浮点数玩家的偏航角
position#position玩家的位置
block_x整数玩家的 x 坐标
block_y整数玩家的 y 坐标
block_z整数玩家的 z 坐标
food整数玩家的饥饿值
saturation单精度浮点数玩家的饱和度
name字符串玩家的名称
uuid通用唯一识别码玩家的通用唯一识别码
world#world玩家所在的世界
is_sneaking布尔是否处于潜行状态
is_swimming布尔是否正在游泳
is_climbing布尔是否正在攀爬
is_gliding布尔是否正在滑翔
is_flying布尔是否处于飞行状态
gamemode字符串玩家的游戏模式
game_edition字符串玩家的游戏版本
main_hand_item#item主手中的物品
off_hand_item#item副手中的物品

block

参数类型描述
x整数方块的 x 坐标
y整数方块的 y 坐标
z整数方块的 z 坐标
block_x整数方块的 x 坐标
block_y整数方块的 y 坐标
block_z整数方块的 z 坐标
custom_block方块定义自定义方块定义;原版方块不存在此值
custom_block_state方块状态完整的自定义方块状态;原版方块不存在此值
world#world方块所在的世界
position#position方块的位置

world

参数类型描述
name字符串世界的名称
uuid通用唯一识别码世界的通用唯一识别码
time长整数世界的时间

entity

参数类型描述
x双精度浮点数实体的 x 坐标
y双精度浮点数实体的 y 坐标
z双精度浮点数实体的 z 坐标
pitch单精度浮点数实体的 yRot 值(偏航角)
yaw单精度浮点数实体的 xRot 值(俯仰角)
block_x整数实体的 x 坐标
block_y整数实体的 y 坐标
block_z整数实体的 z 坐标
name字符串实体的名称
uuid通用唯一识别码实体的通用唯一识别码
world#world实体所在的世界
position#position实体的位置
fire_ticks整数实体剩余的着火游戏刻
speed双精度浮点数实体当前速度的模,单位为方块/游戏刻
health双精度浮点数生物的生命值;其他实体返回 0
max_health双精度浮点数生物的最大生命值;其他实体返回 0
item#item掉落物实体中的物品;其他实体不存在此值

position

参数类型描述
world#world世界
coordinate#position同一个带世界信息的坐标对象
x双精度浮点数x 坐标
y双精度浮点数y 坐标
z双精度浮点数z 坐标
yaw单精度浮点数位置的 xRot 值(俯仰角)
pitch单精度浮点数位置的 yRot 值(偏航角)
block_x整数向下取整后的 x 坐标
block_y整数向下取整后的 y 坐标
block_z整数向下取整后的 z 坐标
biome字符串生物群系的命名空间 id
block#block向下取整坐标处的方块

item

参数类型描述
id字符串物品的标识符
custom_model_data整数物品的自定义模型数据
is_custom布尔检查物品是否为自定义物品
count整数物品的数量
is_block_item布尔检查物品是否为原版方块物品
random.<id>双精度小数物品上已生成的随机值(见 random_values

random

参数类型描述
<id>双精度小数当前上下文中的命名随机值;缺少的 id 会在 01 间生成并缓存

furniture

参数类型描述
id字符串家具的标识符
uuid通用唯一识别码家具的通用唯一识别码
variant字符串家具的变体
x双精度浮点数家具的 x 坐标
y双精度浮点数家具的 y 坐标
z双精度浮点数家具的 z 坐标
yaw单精度浮点数家具的水平旋转角度
pitch单精度浮点数家具的垂直旋转角度
position#position家具的位置