> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sentrystudios.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrations

> Hook SentryPremades into ItemsAdder, Nexo, and MythicMobs to bind abilities to custom weapons and boss mobs.

SentryPremades comes equipped with native integrations for the most popular custom content engines in the Minecraft ecosystem. You can attach combat abilities to custom weapon interactions or trigger them from custom boss mobs with clean configuration mappings.

***

## ItemsAdder Integration

Bind SentryPremades abilities to custom ItemsAdder weapons, wands, and armor sets based on user click interactions.

Configuration is handled in `plugins/SentryPremades/integration/itemsadder.yml`:

```yaml plugins/SentryPremades/integration/itemsadder.yml theme={null}
items:
  # Replace with your ItemsAdder item identifier (namespace:name)
  ruby_fire_staff:
    # Main hand triggers
    right-click: flaming-shot
    shift-right-click: flaming-shot:high-damage

  frost_dagger:
    right-click: freezing-dash

  toxic_scythe:
    left-click: poisoning-rain
```

### Supported Interaction Triggers

You can map different abilities or presets to distinct player click actions:

| Trigger Key | Description |
| :- | :- |
| `left-click` | Standard attack / left click with the item in the main hand. |
| `right-click` | Standard interaction / right click with the item in the main hand. |
| `shift-left-click` | Sneaking while left clicking in the main hand. |
| `shift-right-click` | Sneaking while right clicking in the main hand. |
| `offhand-left-click` | Left click while the item is held in the offhand slot. |
| `offhand-right-click` | Right click while the item is held in the offhand slot. |
| `offhand-shift-left-click` | Sneaking left click while item is held in the offhand. |
| `offhand-shift-right-click` | Sneaking right click while item is held in the offhand. |

> [!NOTE]
>
> **Preset Support:** You can bind specific presets to any trigger by specifying `ability-id:preset-id` (for example, `flaming-shot:default` or `freezing-dash:arena`).

***

## Nexo Integration

If your server uses **Nexo** for custom items and mechanics, SentryPremades provides first-class support.

Configuration is located at `plugins/SentryPremades/integration/nexo.yml`:

```yaml plugins/SentryPremades/integration/nexo.yml theme={null}
items:
  # Replace with your Nexo item ID
  celestial_bow:
    right-click: flaming-shot

  glacial_spear:
    shift-right-click: freezing-dash

  plague_totem:
    offhand-right-click: poisoning-rain
```

The Nexo integration supports the exact same trigger keys (`left-click`, `right-click`, `shift-` modifiers, and `offhand-` actions) as ItemsAdder.

***

## MythicMobs Integration

You can trigger SentryPremades abilities directly from custom MythicMobs entities using our registered mechanic: `executePremadeAbility`.

### Mechanic Syntax

```yaml theme={null}
- executePremadeAbility{premade=<ability-id>} @Target
```

### Parameter Reference

**premade** `string` *required*

The registered ID of the ability to cast (e.g., `flaming-shot`, `freezing-dash`, `poisoning-rain`). You can also specify presets using `ability:preset`.

*Aliases:* `premade-ability`, `ability`, `a`, `p`

***

### Example: Custom Dungeon Boss

Here is a complete MythicMobs boss example showcasing how to cast different Sentry abilities during combat phases:

```yaml plugins/MythicMobs/Mobs/OverchargedBoss.yml theme={null}
OverchargedWarlock:
  Type: WITHER_SKELETON
  Display: '&c&lOvercharged Warlock'
  Health: 350
  Damage: 12
  Options:
    AlwaysShowName: true
    MovementSpeed: 0.28
  Skills:
    # Cast Flaming Shot when attacking targets at range
    - executePremadeAbility{premade=flaming-shot} @Target ~onTimer:100 >0 0.7

    # Escape using Freezing Dash when damaged below 50% health
    - executePremadeAbility{ability=freezing-dash} @Self ~onDamaged <50% 0.5

    # Summon Poisoning Rain on players within 15 blocks every 15 seconds
    - executePremadeAbility{p=poisoning-rain} @PIR{r=15} ~onTimer:300

    # Boss message on ability cast
    - message{m="&c&lWarlock &8» &7Feel the fiery wrath of the Nether!"} @PIR{r=20} ~onTimer:100 >0 0.7
```

***

## Reloading Integrations

After editing your mapping files, you can hot-reload without restarting the server:

```shell theme={null}
# Reload ItemsAdder integration mappings
/premades reload "ItemsAdder Integration"

# Reload Nexo integration mappings
/premades reload "Nexo Integration"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.