> For the complete documentation index, see [llms.txt](https://docs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.superiormc.cn/auxilor-plugins/zi-ding-yi-xiao-guo/suo-you-xiao-guo/aoe.md).

# aoe

## `aoe`

**触发效果**[**​**](https://plugins.auxilor.io/effects/all-effects/aoe#triggered-effect)

将效果作用于一定范围内的所有实体。

### 范围样式[​](https://plugins.auxilor.io/effects/all-effects/aoe#list-of-shapes) <a href="#list-of-shapes" id="list-of-shapes"></a>

| ID              | 描述                        | 参数                                                                                                                                          |
| --------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `cone`          | （触发器属性中的）坐标前面的圆锥形（类似横扫之刃） | <p><code>radius</code> 半径<br><code>angle</code> 角度</p>                                                                                      |
| `circle`        | 以（触发器属性中的）坐标为中心的圆         | `radius` 半径                                                                                                                                 |
| `offset_circle` | （触发器属性中的）坐标面前格数为中心的圆形     | <p><code>radius</code> 半径<br><code>offset</code> 玩家面前的距离</p>                                                                                |
| `scan_in_front` | 扫描你所朝方向的所有实体，直到发现第一个      | <p><code>radius</code> 距离<br><code>max\_distance</code> 最大距离</p>                                                                            |
| `beam`          | 你所朝方向的直线                  | <p><code>radius</code> 直线宽度<br><code>distance</code> 直线长度<br><code>pierce\_blocks</code> 是否穿越方块<br><code>pierce\_entities</code> 是否穿越实体</p> |

## 示例配置

```yaml
- id: aoe
  args:
    effects: # 每个实体被执行的效果
      - id: damage_victim
        args:
          damage: 2
          true-damage: true
    shape: cone # AOE模式ID
    radius: 3 # AOE模式参数（见上）
    angle: 120 # AOE模式参数（见上）
```