> 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/ultimatequest-zhong-wen-wen-dang/gong-gong-ge-shi/match-entity-format/logic.md).

# 逻辑规则

本页面介绍 MatchEntityFormat 的组合方式。同一层级的规则使用逻辑 AND；使用 `any` 表示多个候选条件，使用 `not` 表示排除条件。

## 本页面的规则

* `none`
* `any`
* `not`

## 默认 AND 行为

```yaml
match-entity:
  monster: true
  entity-types:
    - ZOMBIE
    - HUSK
  entity-health: 20
```

实体必须属于 Bukkit `Monster`，必须是僵尸或尸壳，并且必须满足生命值规则。

## `none`

该键出现时强制实体匹配失败。

```yaml
none: true
```

如需重新启用匹配，请移除 `none`，不要将它设为 `false`。

## `any`

平铺候选在已识别规则间 OR，数字子组在完整 AND 组间 OR。

```yaml
any:
  '1':
    entity-types:
    - ZOMBIE
    entity-health: 10
  '2':
    entity-types:
    - SKELETON
```

子键 1 选择分组模式，空 any 通过，任意具名子项不会启用分组模式。

## `not`

反转嵌套整体匹配。

```yaml
not:
  entity-types:
  - PLAYER
```

外层仍需要有效生物，not 不是缺失实体存在性判断。

## 组合 AND、OR 和 NOT

下方配置表达的逻辑为：

```
monster AND (zombie OR skeleton) AND NOT protected
```

```yaml
match-entity:
  monster: true
  any:
    '1':
      entity-types:
        - ZOMBIE
        - HUSK
        - DROWNED
    '2':
      entity-types:
        - SKELETON
        - STRAY
        - WITHER_SKELETON
  not:
    entity-contains-name:
      - Protected
```

## 一个候选条件中的多项要求

```yaml
match-entity:
  any:
    '1':
      entity-types:
        - ZOMBIE
      equip:
        main-hand:
          material-tag:
            - minecraft:swords
    '2':
      entity-types:
        - SKELETON
      ranged: true
```

每一个候选组都可以包含任意数量的 AND 规则。

## 反转单条规则

应尽量使用 `not` 包裹最小范围的匹配器：

```yaml
match-entity:
  not:
    animal: true
```

避免反转过大的配置组，否则可能意外匹配缺少数据或不支持对应数据的实体。

## 缺失实体与生物实体限制

缺少实体时不会匹配。MatchEntityFormat 专门面向 `LivingEntity`；非生物实体应由明确支持它们的条件或触发器处理。

逻辑包装器不会使缺失或非生物实体变为有效目标。例如，不应把 `not: { monster: true }` 当作安全匹配所有非怪物对象的方式。

## 可选键与开放失败行为

未知的 MatchEntityFormat 键会被忽略，因为没有已注册规则负责处理它们。以下情况尤其需要注意：

* 未加载 MythicMobs 挂钩时使用 `mythicmobs`；
* 未加载 LevelledMobs 挂钩时使用 `levelled-mobs`；
* 使用平台专属分类规则；
* 键名拼写错误。

只包含被忽略键的匹配器，实际效果可能变为不受任何限制。

对于重要筛选器：

1. 检查启动日志，确认挂钩已经注册；
2. 尽可能同时加入一个稳定的内置限制；
3. 分别使用一个确定会匹配和一个确定不会匹配的实体进行测试；
4. 缺少必要集成时，禁用依赖该集成的任务。

## 示例：自定义 Boss 或高生命值原版怪物

```yaml
match-entity:
  any:
    '1':
      mythicmobs:
        - SkeletonKing
    '2':
      monster: true
      entity-health: 100
```

## 调试嵌套匹配器

1. 将每个子项单独作为完整的 `match-entity` 配置部分进行测试。
2. 先移除 `not`，确认正向匹配组能够正常工作。
3. 确认选中的目标是生物实体。
4. 检查准确的实体类型、标签、PDC、装备和集成 ID。
5. 确认可选规则已经注册。
6. 每次只添加一个候选组。
7. 尽量减少嵌套层级，并为各组使用具有说明性的名称。

## 常见错误

* 认为顶层规则键使用 OR；
* 直接在 `any` 下放置多个互不相关的规则键，而没有建立完整子组；
* 反转的配置范围大于实际需要；
* 认为未知集成键会以关闭方式失败；
* 使用 `not` 匹配缺失或非生物实体；
* 忘记每个候选组的内部规则仍使用 AND；

另请参阅[实体身份与状态规则](/ultimatequest-zhong-wen-wen-dang/gong-gong-ge-shi/match-entity-format/identity-state.md)和[装备与集成规则](/ultimatequest-zhong-wen-wen-dang/gong-gong-ge-shi/match-entity-format/equipment-integrations.md)。