匹配实体格式（Match Entity Format）

Match Entity Format 会读取同一节点的全部规则，默认 AND 关系。

match-entity:
  entity-types:
    - zombie
  ranged: false

---

字段总览

entity-types

作用：按实体类型匹配（如 zombie / skeleton）。

entity-types:
  - zombie
  - husk

---

entity-tag

作用：按原版 Entity Tag 匹配。

entity-tag:
  - minecraft:undead
  - minecraft:raiders

---

entity-contains-name

作用：实体名称包含指定文本（忽略颜色与格式）。

entity-contains-name:
  - Boss
  - 精英

---

entity-health

作用：实体当前血量下限判断（>=）。

entity-health: 10

---

ranged - 仅 Paper

作用：是否要求“远程单位”。

• true：必须是远程

• false：必须不是远程

ranged: true

---

equip

作用：按实体装备槽位进行匹配（每个槽位内部复用 Match Item 规则）。

可用槽位：

• main-hand

• off-hand

• helmet

• chestplate

• leggings

• boots

equip:
  main-hand:
    material:
      - bow
  helmet:
    has-enchants:
      - protection

注意：当前实现是“只要任意被配置的槽位匹配成功即返回 true”。

---

entity-pdc

作用：按 PersistentDataContainer 键值匹配（支持字符串、数值、布尔）。

字符串规则

• 支持精确匹配

• 支持包含匹配

• 支持 * 通配符

entity-pdc:
  myplugin:role: boss*

数值规则

支持：5~10、>=5、<=10、>5、<10、=8 或 8

entity-pdc:
  myplugin:level: ">=20"
  myplugin:phase: "2~4"

布尔规则

entity-pdc:
  myplugin:awakened: true

---

mythicmobs（需 MythicMobs）

作用：匹配 MythicMobs 内部 mob 名称。

mythicmobs:
  - FireDemon
  - IceBoss

---

levelled-mobs（需 LevelledMobs）

作用：匹配 LevelledMobs 等级。

支持：

• 精确值：10

• 区间：5~20

• 比较：>=15 / <=30

levelled-mobs: ">=25"

---

any

作用：OR 逻辑组合（命中任意一组即可）。

方式 1：分组 OR（推荐）

any:
  1:
    entity-types:
      - zombie
  2:
    entity-tag:
      - minecraft:raiders

方式 2：同层 OR

any:
  ranged: true
  entity-health: 30

---

not

作用：取反（not 内任意规则命中则整体失败）。

not:
  entity-types:
    - villager

---

none

作用：始终不匹配（可用于占位或临时关闭规则）。

none: true