> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/enchantedmobs-zhong-wen-wen-dang/features/pi-pei-shi-ti-ge-shi-match-entity-format.md).

# 匹配实体格式（Match Entity Format）

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

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

***

### 字段总览

#### entity-types

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

```yaml
entity-types:
  - zombie
  - husk
```

***

#### entity-tag

作用：按原版 Entity Tag 匹配。

```yaml
entity-tag:
  - minecraft:undead
  - minecraft:raiders
```

***

#### entity-contains-name

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

```yaml
entity-contains-name:
  - Boss
  - 精英
```

***

#### entity-health

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

```yaml
entity-health: 10
```

***

#### ranged - 仅 Paper

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

* `true`：必须是远程
* `false`：必须不是远程

```yaml
ranged: true
```

***

#### equip

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

可用槽位：

* `main-hand`
* `off-hand`
* `helmet`
* `chestplate`
* `leggings`
* `boots`

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

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

***

#### entity-pdc

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

**字符串规则**

* 支持精确匹配
* 支持包含匹配
* 支持 `*` 通配符

```yaml
entity-pdc:
  myplugin:role: boss*
```

**数值规则**

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

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

**布尔规则**

```yaml
entity-pdc:
  myplugin:awakened: true
```

***

#### mythicmobs（需 MythicMobs）

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

```yaml
mythicmobs:
  - FireDemon
  - IceBoss
```

***

#### levelled-mobs（需 LevelledMobs）

作用：匹配 LevelledMobs 等级。

支持：

* 精确值：`10`
* 区间：`5~20`
* 比较：`>=15` / `<=30`

```yaml
levelled-mobs: ">=25"
```

***

#### any

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

**方式 1：分组 OR（推荐）**

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

**方式 2：同层 OR**

```yaml
any:
  ranged: true
  entity-health: 30
```

***

#### not

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

```yaml
not:
  entity-types:
    - villager
```

***

#### none

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

```yaml
none: true
```