选择器参数

本页汇总国际版命令中常用目标选择器参数的语义、筛选行为与组合边界，用于命令排错和语法校验。

选择器变量

变量	作用
@a	选择所有玩家。
@p	选择最近的玩家。
@r	随机选择玩家；附带type时可用于随机实体。
@e	选择所有实体。
@s	选择当前执行者。
@initiator	选择与NPC交互的玩家。

参数总表

参数	取值类型	作用	备注
x、y、z	数值	设置搜索起点坐标。	未设置时使用命令执行位置。
r、rm	数值	按球形距离筛选目标。	r为最大值，rm为最小值。
dx、dy、dz	数值	按长方体体积筛选目标。	任一体积参数出现时，未给出的轴按0处理。
c	整数	限制返回目标数量。	负数会按反向顺序截取。
type	标识符	按实体类型筛选。	可用!排除类型。
name	字符串	按名称筛选。	可用!排除名称。
tag	字符串	按标签筛选。	可重复；可用!排除标签。
family	字符串	按族筛选。	可重复；可用!排除族。
scores	对象	按记分板值筛选。	支持N..、..N、N..M区间。
l、lm	整数	按经验等级筛选玩家。	仅玩家有效。
m	枚举	按游戏模式筛选玩家。	可用!排除模式。
rx、rxm	数值	按俯仰角筛选。	范围通常为-90到90。
ry、rym	数值	按偏航角筛选。	范围通常为-180到180。
hasitem	对象或数组	按物品栏内容筛选。	支持item、quantity、location、slot等字段。

排序与截取规则

• @a、@p、@e默认按距离由近到远排序。
• @r按随机顺序排序。
• @p与@r默认仅返回1个目标。
• c只负责截取，不单独定义排序逻辑。

常见组合模式

目标	示例
检测半径内特定实体	@e[type=sheep,r=8]
检测分数区间	@a[scores={timer=1..200}]
检测多标签交集	@e[tag=active,tag=tracked]
检测物品条件	@a[hasitem={item=apple,quantity=4..}]

相关参考

• 命令参数类型
• 命令清单
• 目标选择器