> 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/configs/info-of-abilities/integration.md).

# Integration and Targeting Abilities

Every registered ability on this page is documented as a complete reference entry. All entries also support the common ability fields from the [Abilities](/configs/info-of-abilities.md) page.

## Registry keys on this page

* `nearby_entities`
* `summon`
* `mythic_skill`
* `send_message`
* `execute_command`

***

## `nearby_entities`

**Purpose:** Finds nearby entities and runs children with each accepted entity as the new `TARGET`.

**Context:** Default base `target`: `SOURCE`; falls back to resolved location when the entity is unavailable.

### Fields

| Field                            | Default   | Description                                      |
| -------------------------------- | --------- | ------------------------------------------------ |
| `radius`                         | `5`       | Default radius for all axes.                     |
| `radius-x / radius-y / radius-z` | `radius`  | Per-axis radii.                                  |
| `max-targets`                    | `0`       | Maximum accepted entities; zero means unlimited. |
| `include-source`                 | `false`   | Allow original source.                           |
| `include-items`                  | `false`   | Allow dropped items.                             |
| `include-non-living`             | `false`   | Allow other non-living entities.                 |
| `include-living`                 | `true`    | Allow living entities.                           |
| `match-entity`                   | match all | Match Entity rules for living candidates.        |
| `abilities`                      | required  | Nested abilities.                                |

### Example

```yaml
type: nearby_entities
target: SOURCE
radius: 8
max-targets: 3
include-source: false
match-entity:
  entity-types:
    - PLAYER
abilities:
  damage:
    type: damage_entity
    amount: 4
```

### Behavior and limits

* Candidates are ordered nearest-first.
* Child context location is updated to each selected target.

***

## `summon`

**Purpose:** Spawns one living Bukkit entity and optionally assigns EnchantedMobs powers.

**Context:** Spawn location uses the resolved ability location.

### Fields

| Field                                           | Default       | Description                                                               |
| ----------------------------------------------- | ------------- | ------------------------------------------------------------------------- |
| `entity`                                        | empty         | Single Bukkit entity type.                                                |
| `entity-type`                                   | empty         | Alias for `entity`.                                                       |
| `entities`                                      | empty         | Equal-probability entity list; takes priority.                            |
| `max-health`                                    | `-1`          | Set maximum health when positive.                                         |
| `health`                                        | `-1`          | Set current health when positive.                                         |
| `attack-damage`                                 | `-1`          | Set attack-damage base when non-negative.                                 |
| `set-target`                                    | unset         | Context entity selector assigned as target to spawned mobs.               |
| `set-none-drops`                                | `false`       | Clear loot table, disable pickup, and set equipment drop chances to zero. |
| `creeper.explosion-radius`                      | `-1`          | Creeper radius.                                                           |
| `creeper.fuse-ticks`                            | `-1`          | Creeper max fuse.                                                         |
| `creeper.powered`                               | unset         | Creeper charged state.                                                    |
| `powers / power.list`                           | empty         | Explicit power-ID list.                                                   |
| `power`                                         | empty         | One additional power ID.                                                  |
| `power-level / power.level`                     | current level | Power level, minimum 1.                                                   |
| `random-power-by-level / power.random-by-level` | `false`       | Generate random powers when no valid explicit power remains.              |

### Example

```yaml
type: summon
entities:
  - ZOMBIE
  - SKELETON
set-target: TARGET
set-none-drops: true
max-health: 30
attack-damage: 6
power-level: '{level}'
powers:
  - Hasty
```

### Behavior and limits

* The selected type must be spawnable and produce a living entity.
* Valid explicit power IDs take priority over random generation.

***

## `mythic_skill`

**Purpose:** Casts one or more MythicMobs skills.

**Context:** Caster is `SOURCE`; default `target`: `TARGET` and must exist.

### Fields

| Field    | Default | Description                               |
| -------- | ------- | ----------------------------------------- |
| `skill`  | empty   | Single skill used when `skills` is empty. |
| `skills` | empty   | Ordered skill-name list.                  |
| `power`  | `1.0`   | MythicMobs skill power multiplier.        |

### Example

```yaml
type: mythic_skill
target: TARGET
skills:
  - Fireball
  - GroundSlash
power: 1.5
```

### Behavior and limits

* Requires MythicMobs.
* Target entity and resolved location are supplied to the integration.

***

## `send_message`

**Purpose:** Sends one or more formatted messages to the source mob's current player target or nearby players.

**Context:** Target-player mode resolves the current player target of mob `SOURCE`; nearby mode searches around `SOURCE`.

### Fields

| Field      | Default         | Description                              |
| ---------- | --------------- | ---------------------------------------- |
| `mode`     | `target-player` | `target-player` or `nearby`.             |
| `radius`   | `16`            | Nearby-player radius.                    |
| `message`  | empty           | Single message when `messages` is empty. |
| `messages` | empty           | Message list.                            |

### Example

```yaml
type: send_message
mode: nearby
radius: 12
messages:
  - '<red>The elite mob is enraged!'
  - '<gray>Target: {target}'
```

### Behavior and limits

* Recipient-aware parsing supports `{player}`, `{target}`, power variables, runtime placeholders, language parsing, and PlaceholderAPI.
* Offline or dead players are skipped.

***

## `execute_command`

**Purpose:** Runs commands for the source mob's current player target or nearby players.

**Context:** Target-player mode resolves the current player target of mob `SOURCE`; nearby mode searches around `SOURCE`.

### Fields

| Field        | Default         | Description                                                     |
| ------------ | --------------- | --------------------------------------------------------------- |
| `mode`       | `target-player` | `target-player` or `nearby`.                                    |
| `radius`     | `16`            | Nearby-player search radius.                                    |
| `as-console` | `true`          | Run as console; false makes each recipient execute the command. |
| `command`    | empty           | Single command used when `commands` is empty.                   |
| `commands`   | empty           | Command list.                                                   |

### Example

```yaml
type: execute_command
mode: target-player
as-console: true
commands:
  - 'effect give {player} minecraft:slowness 5 1'
```

### Behavior and limits

* A leading slash is removed.
* Commands execute once per selected online, living player and support player/target/context placeholders.

***
