Bedrock Wiki
  • QQ
  • 原站
新手入门指南
  • Guide
    • 1. 简介
      指南
    • 2. 附加组件详解
    • 3. 软件与准备工作
    • 4. 项目设置
    • 5. 创建自定义物品
    • 6. 创建自定义实体
    • 7. Blockbench:建模、贴图与动画制作
    • 8. 添加战利品表、生成规则与合成配方
  • Extra
    • a. 理解JSON
    • b. 下载示例包
    • c. 故障排除
      帮助
    • d. 高级清单文件指南
    • e. 格式版本
    • f. Android 项目设置
JSON UI
  • General
    • JSON UI 入门指南
      指南
    • 最佳实践
      指南
  • Tutorials
    • Aseprite 动画
    • 保留标题文本
      中级
    • 修改服务器表单
      中级
    • 字符串与数字转换
      中级
    • 按钮与开关
      新手
    • 添加HUD界面元素
      新手
  • Documentation
    • JSON UI 文档
Meta
  • Style Guide
  • 使用JSON模式(Schemas)
  • 实用链接
  • 版本控制
  • 附加包性能优化
  • Q&A
    • GameTest 问答集 2021/08/06
    • 世界生成问答 2024/11/15
    • 延迟渲染技术预览问答 2024/02/23
    • 方块与物品问答 2024/08/30
    • 脚本与编辑器问答 2023/09/22
NBT
  • General
    • .mcstructure
  • Tutorials
    • 扩展结构限制
      简单
    • 教育版中的实验功能
      简单
  • NBT in Depth
    • NBT 库列表
      专家
    • NBT读取示例
      专家
    • 关于NBT(命名二进制标签)
      专家
世界生成
  • General
    • 世界生成入门
      指南
      实验性
    • 特性类型
      实验性
    • 生物群系
      指南
      实验性
  • Tutorials
    • 特征(Feature)的方块条件
      实验性
    • 生成地表区块
      实验性
    • 生成自定义矿石
      实验性
    • 生成自定义结构
      实验性
    • 高度图噪声地形
      实验性
  • Documentation
    • 生物群系标签
动画控制器
  • 动画控制器入门指南
    指南
  • 实体命令
    中级
  • AFK检测器
  • 将Molang变量转换为计分板数值
  • 死亡指令
  • 重生指令
命令
  • General
    • 命令方块入门指南
    • 函数
    • NBT 命令
    • 坐标系
    • 方块状态
    • 理解目标选择器
    • 记分板操作
  • Commands
    • Execute
      简单
    • Playanimation
    • 伤害
    • 播放音效
  • On Event Systems
    • 玩家首次加入时
    • On Player Join
    • 玩家离开时触发
    • 玩家死亡事件
    • 玩家重生事件系统
    • 首次加载世界时
  • Scoreboard Systems
    • 实体计数器
    • 计分板计时器
    • 比较与获取分数
  • Techniques
    • 执行逻辑门
    • MBE - Max的方块实体
    • FMBE - 创建显示实体的新方法
    • 视线检测
    • 移动状态检测
    • 轨道摄像机
  • Useful Creations
    • 多人位置重排系统
      函数
    • 自定义合成台
      简单
实体
  • General
    • Intro to Entities BP
      指南
      新手
    • 实体资源包入门
      指南
      新手
    • 实体问题排查指南
      帮助
    • NPC对话系统
      中级
    • 实体事件
      新手
    • 实体属性
    • 渲染控制器
      新手
    • 生成规则
  • Tutorials
    • 任意坐标系间的坐标转换(世界、实体、骨骼)
      中级
    • 创建船只
      中级
    • 实体手持物品
      中级
    • 实体攻击机制
      中级
    • 实体睡眠机制
      中级
    • 实体碰撞体
      中级
    • 实体移动
    • 实体计时器
      中级
    • 无敌实体
      新手
    • 村庄机制实现指南
    • 检测其他实体
      中级
    • 生成已驯服的实体
      脚本
      中级
    • 视线检测实体
      中级
    • 禁用队友伤害
      中级
    • 范围效果云入门指南
      中级
    • 虚拟实体
      新手
    • 飞行实体控制
      中级
  • Documentation
    • Vanilla Usage Spawn Rules
    • 原版使用组件
    • 抛射物
    • 虚拟组件
    • 运行时标识符
    • 非生物实体运行时标识符
战利品、配方与交易
  • General
    • 交易行为
  • Documentation
    • 战利品表
    • 交易表
    • 合成配方
    • 物品函数
  • Tutorials
    • 随机化结构战利品
      简单
文档
  • Shared Constructs
  • Molang 查询详解
  • Vanilla Materials
    专家
  • 声音定义
  • 文件类型
  • 材质配置文件说明
    专家
  • 菜单分类
  • 资源包文件夹结构
  • 雾效ID
  • 高级Molang指南
方块
  • General
    • 方块入门指南
      指南
      新手
    • 方块组件
    • Block Tags
    • 方块状态
    • Block Traits
    • 方块排列组合
    • 方块事件
      脚本
    • 方块事件迁移指南
      帮助
    • 方块物品化
      中级
    • 方块问题排查指南
      帮助
  • Visuals
    • 方块剔除
      中级
    • 方块模型
      指南
      新手
      简单
    • 方块着色
      简单
    • 方块纹理动画
      中级
    • 方块纹理变体
      中级
  • Tutorials
    • Precise Interaction
      专家
      脚本
    • Precise Rotation
      专家
      脚本
    • 伪方块
      中级
    • 可旋转方块
    • 应用持续效果
      简单
      脚本
    • 矿石战利品表
      简单
      脚本
    • 规避状态值限制
      专家
  • Vanilla Re-Creations
    • 自定义作物
      中级
      脚本
    • 自定义活板门
      中级
      脚本
    • 自定义玻璃
      新手
      简单
      已弃用
    • 自定义釉面陶瓦
      简单
  • Documentation
    • 原版方块模型
      新手
    • 方块形状
    • 方块格式历史
    • 方块音效
服务器
  • Software
    • Bedrock Server Software
  • Protocols
    • Bedrock Protocol
    • NetherNet 协议
    • RakNet 协议
概念
  • contents.json
  • Molang
    中级
  • Rawtext
  • textures_list.json
  • 命名空间
  • 子包
  • 文本与本地化
  • 着色器
  • 纹理图集
    中级
  • 表情符号与特殊字符
  • 覆盖资源
    中级
  • 音效
    中级
物品
  • General
    • 物品入门指南
      指南
      新手
    • 物品组件
    • 物品标签
    • 物品事件
      脚本
    • Item Event Migration
      帮助
    • 物品问题排查指南
      帮助
  • Tutorials
    • Custom Pottery Sherds
    • 可投掷物品
      中级
    • 生成物品
      中级
    • 自定义武器
      简单
    • 自定义盔甲
    • 自定义食物
      简单
      脚本
    • 通过装备物品执行命令
      实验性
      中级
    • 高分辨率物品
  • Documentation
    • 附魔
    • Numerical Item IDs
    • Vanilla Usage Components
    • 原版物品标识符
      已弃用
    • 可附着物
      新手
    • 物品格式历史记录
视觉效果
  • General
    • 实体视觉效果简介
      指南
    • 基岩版建模指南
    • 动画中的特效
    • 基于数学的动画
      中级
    • 材质
      专家
    • 材质创作
      专家
    • 皮肤包制作指南
    • 自定义死亡动画
      中级
  • Tutorials
    • Glowing Entity Texture
    • 受伤动画
      中级
    • 实体纹理动画
      中级
    • 栓绳位置调整
      简单
    • 玩家几何模型
      新手
    • 移除实体阴影
      中级
    • 重绘生成蛋纹理
      新手
  • Ideas
    • 结构展示技巧
粒子效果
  • General
    • 粒子效果入门
      指南
  • Tutorials
    • 禁用粒子效果
      新手
  • Documentation
    • 原版粒子效果
脚本编写
  • General
    • 脚本编程入门
    • 什么是Script API?
    • API 模块
  • Tutorials
    • GameTests
      实验性
    • 简易聊天命令
      实验性
    • 脚本核心功能
    • 脚本表单
      实验性
    • 脚本请求API
      实验性
    • 阻止方块放置
  • Documentation
    • JavaScript 问题排查指南
    • Script Resources
    • Script Watchdog
      实验性
    • TypeScript
    • 引擎环境
虚拟现实
  • General
    • 启用VR模式
      指南
    • 配置资源包
      专家
  • Tutorials
    • 编辑你的第一个模型
      专家

理解目标选择器

理解目标选择器
  • 选择器变量
  • 选择器参数
    • 类型(Type)
    • 数量(Count)
    • 位置(Position)
    • 距离(Distance)
    • 体积(Volume)
    • 分数(Scores)
    • 名称(Name)
    • 标签(Tag)
    • 族系(Family)
    • 旋转(Rotation)
    • 等级(Level)
    • 游戏模式(Game Mode)
    • 物品(Items)

目标选择器用于命令中,无需明确指定目标(如玩家名称)即可选择命令执行对象。一个目标选择器由选择器变量和可选的选择器参数列表组成。

选择器变量 ​

选择器变量定义了待选实体的基础范围。共有六种选择器变量可供选择:

  • @a - 选择所有玩家
  • @p - 选择最近的玩家
  • @r - 选择随机玩家
  • @e - 选择所有实体
  • @s - 选择命令执行者
  • @initiator - 选择与NPC交互的玩家

选择器参数 ​

选择器参数可以进一步筛选符合特定条件的候选目标。使用选择器参数前必须先指定选择器变量。参数需添加在目标选择器后的方括号[]内,例如:kill @e[]。多个参数之间用逗号分隔。

类型(Type) ​

通过实体标识符筛选目标。添加感叹号可反选不符合标识符的实体。由于每个实体只能有一个标识符,该参数不可重复使用(反选除外)。可与@r选择器搭配实现随机选择。

  • type=<标识符>—仅包含符合标识符的实体
  • type=!<标识符>—排除符合标识符的实体

示例:

对所有猪施加漂浮效果:

  • /effect @e[type=pig] levitation

清除所有非箭矢和雪球的实体:

  • /kill @e[type=!arrow,type=!snowball]

数量(Count) ​

根据选择器排序规则限制选中实体数量。

@a、@p和@e按距离升序排序,@r为随机排序。@p和@r的该参数默认值为1。添加负号可反转排序顺序(随机排序不可反转)。

  • c=<数量>—选择最多<数量>个实体

示例:

清除最近五名玩家背包中的石头:

  • /clear @a[c=5] stone

对最远的两只骷髅造成伤害:

  • /damage @e[type=skeleton,c=-2] 2

位置(Position) ​

更改选择器的起始搜索位置,同时影响距离和体积参数的基准点。未定义时默认使用命令执行位置。

可使用相对坐标定义偏移量。

  • x=<值>, y=<值>, z=<值>—定义目标选择器的基准坐标

示例:

将最近玩家传送到(140,64,-200)上方十格处:

  • /teleport @p[x=140,y=64,z=-200] ~ ~10 ~

距离(Distance) ​

通过实体与选择器的球面距离筛选目标(以脚部位置计算)。

  • rm=<值>和r=<值>—分别选择最小和最大距离范围内的实体(含边界值)

示例:

清除2到6格范围内的所有鸡:

  • /kill @e[type=chicken,rm=2,r=6]

为(0,100,0)周围1格内所有玩家的手持物品附魔锋利:

  • /enchant @a[x=0,y=100,z=0,r=1] sharpness

体积(Volume) ​

将选择范围限制在特定长方体区域(碰撞箱)内或与之相交的实体。三个参数分别定义各轴向的盒子尺寸。若至少定义一个参数,未定义参数默认为0。以实体的碰撞箱为判断依据。

两坐标点间体积计算公式:

dx = x2 - x1
dy = y2 - y1
dz = z2 - z1
1
2
3
  • dx=<值>, dy=<值>, dz=<值>—选择位于给定包围盒内的实体

示例:

列出12x30x2区域内的所有实体:

  • /say @e[dx=12,dz=30,dy=2]

为(-400,0,-350)到(-150,256,50)区域内的所有玩家添加"wiki:lobby"标签:

  • /tag @a[x=-400,y=0,z=-350,dx=250,dy=256,dz=400] add wiki:lobby

为(-1.5,0,-2)到(1,0,1.5)区域内的所有实体添加"wiki:warp"标签:

  • /tag @a[x=-1.5,y=0,z=-2,dx=2.5,dz=3.5] add wiki:warp

注意:

即使实体的碰撞箱只有部分在体积范围内,仍会被选中。

图示说明:碰撞箱较大的马被选中,而站在同一点但碰撞箱较小的玩家未被选中。

若需精确检测特定Y坐标(如Y=10)的玩家(排除部分重叠情况),可使用如下命令:

  • /execute as @a at @s if entity @s[y=10,r=1] unless entity @s[y=9,r=1] run say found player

分数(Scores) ​

通过记分板分数筛选目标。参数为键值对对象,键为记分项,值为数值范围(使用范围语法)。添加感叹号可反选不符合分数范围的实体。

  • scores={<记分项>=<值>}—选择符合分数条件的实体

范围语法说明:

  • N.. 表示≥N的数值
  • ..N 表示≤N的数值
  • N..M 表示N到M之间的数值(含边界)

示例:

将"wiki:points"分数为10的玩家的"points"分数归零:

  • /scoreboard players set @p[scores={wiki:points=10}] wiki:points 0

为同时满足"wiki:started"=1且"wiki:timer"≤20的盔甲架添加"wiki:start"标签:

  • /tag @e[type=armor_stand,scores={wiki:started=1,wiki:timer=..20}] add wiki:start

名称(Name) ​

通过实体名称筛选目标。添加感叹号可反选名称不匹配的实体。

  • name=<名称>—仅包含指定名称的实体
  • name=!<名称>—排除指定名称的实体

示例:

列出所有名为Shadow的僵尸:

  • /say @e[type=zombie,name="Shadow"]

给非Steve且非Alex的玩家提升1级:

  • /xp 1L @a[name=!"Steve",name=!"Alex"]

标签(Tag) ​

通过实体标签筛选目标。可重复使用以检测多个标签(需全部匹配)。添加感叹号可反选不包含该标签的实体。

  • tag=<标签>—仅包含有该标签的实体
  • tag=!<标签>—排除有该标签的实体

示例:

清除所有带"wiki:marked"标签且不带"wiki:exempt"标签的生物:

  • /kill @e[tag=wiki:marked,tag=!wiki:exempt]

族系(Family) ​

通过实体族系类型筛选目标。可重复使用检测多个族系(需全部匹配)。添加感叹号可反选不符合族系的实体。

  • family=<族系>—仅包含该族系的实体
  • family=!<族系>—排除该族系的实体

示例:

为所有"monster"族系实体施加再生效果:

  • /effect @e[family=monster] regeneration

旋转(Rotation) ​

通过实体朝向筛选目标。分为两种旋转:

  • X旋转(垂直方向):-90(仰视)到90(俯视)

  • Y旋转(水平方向):-180到180(北方为起点,顺时针环绕)

  • rxm=<值>和rx=<值>—选择X旋转在最小最大值之间的实体(含边界)

  • rym=<值>和ry=<值>—选择Y旋转在最小最大值之间的实体(含边界)

X旋转示意图(由@SpacebarNinja提供):

Y旋转示意图(由@SpacebarNinja提供):

示例:

对水平视角及以上的玩家施加1秒失明效果:

  • /effect @a[rx=0] blindness 1(0度或更低)

对所有面朝南方的玩家造成伤害:

  • /damage @a[rym=-45, ry=45] 1

全方向对应参数:

朝向参数范围(ry,rym)
北[ry=-135,rym=135]
南[ry=45,rym=-45]
东[ry=-45,rym=-135]
西[ry=135,rym=45]
西北[ry=180,rym=90]
东北[ry=-90,rym=-180]
西南[ry=90,rym=0]
东南[ry=0,rym=-90]

等级(Level) ​

通过经验等级筛选目标(仅限玩家)。

  • lm=<数值>和l=<数值>—分别选择最小和最大等级范围内的玩家(含边界)

示例:

给9级及以下玩家金锭:

  • /give @a[lm=9] gold_ingot

给10级及以上玩家金锭:

  • /give @a[l=10] gold_ingot

给10到20级玩家钻石:

  • /give @a[lm=10, l=20] diamond

游戏模式(Game Mode) ​

通过游戏模式筛选目标(仅限玩家)。添加感叹号可反选不符合模式的玩家。

  • m=<游戏模式>—按游戏模式选择玩家

游戏模式对应值:

游戏模式有效值
生存0, s, survival
创造1, c, creative
冒险2, a, adventure
旁观spectator
默认d, default

示例:

列出所有创造模式玩家:

  • /say @a[m=creative]

将非生存且非冒险模式的玩家设为创造模式:

  • /gamemode creative @a[m=!survival,m=!adventure]

物品(Items) ​

通过物品栏内容筛选目标。参数为对象(或对象数组),可包含以下参数:

  • item=<字符串>—必填,物品标识符(支持自定义)
  • quantity=<整数>—物品数量检测(支持范围语法,可反选)
  • data=<整数>—物品数据值(默认为-1,当前不可用:MCPE-151920)
  • location=<字符串>—物品所在槽位(同/replaceitem的slotType参数)
  • slot=<整数>—配合location使用的槽位索引(支持范围语法,可反选)

示例:

检测携带下界合金剑的玩家:

  • /testfor @a[hasitem={item=netherite_sword}]

清除拥有4个及以上苹果的玩家的2个苹果:

  • /clear @a[hasitem={item=apple,quantity=4..}] apple 2

检测携带2颗钻石和2根木棒的玩家:

  • /testfor @a[hasitem=[{item=diamond,quantity=2},{item=stick,quantity=2}]]

检测没有木棒的玩家:

  • /testfor @a[hasitem=[{item=stick,quantity=0}]

贡献者

编辑 理解目标选择器

Bedrock Wiki by Bedrock OSS ,Translate by 8aka-Team

"Minecraft"是Mojang AB的注册商标。

Bedrock OSS、Bedrock Wiki以及 bedrock.dev 与Microsoft及Mojang AB不存在任何隶属关系。

  • 隐私政策
  • 加入QQ社区
  • 参与贡献指南
  • 访问代码仓库