> ## 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.

# SentryPremades

> Trigger SentryStudio Premades via other popular plugins.

SentryPremades natively integrates with various ecosystem tools to let you attach our premium behaviors directly to your custom items and mobs.

## ItemsAdder Integration

You can map SentryStudio premades directly to your custom ItemsAdder items based on the interaction type. Configure this inside `plugins/SentryPremades/integration/itemsadder.yml`.

> **ItemsAdder Config Template**
>
> Here is a working example mapping actions on an ItemsAdder item (`icon_arrow_chest`) to the `flaming-shot` premade.
>
> ```yaml integration/itemsadder.yml theme={null}
> items:
>   icon_arrow_chest:
>     # Triggered on standard clicks
>     left-click: flaming-shot
>     right-click: flaming-shot
>     shift-left-click: flaming-shot
>     shift-right-click: flaming-shot
>
>     # Triggered when item is in the offhand
>     offhand-left-click: flaming-shot
>     offhand-right-click: flaming-shot
>     offhand-shift-left-click: flaming-shot
>     offhand-shift-right-click: flaming-shot
> ```
>
> > [!NOTE]
> >
> > **Tip:** Replace `icon_arrow_chest` with your custom item's ID, and `flaming-shot` with your desired SentryStudio premade ID. You can also specify presets using the `<premade-id>:<preset-id>` syntax (e.g., `flaming-shot:low-damage`).

## MythicMobs Integration

You can trigger SentryPremades abilities directly within your MythicMobs configurations using our custom `executePremadeAbility` mechanic.

> **MythicMobs Skill Template**
>
> This example demonstrates a MythicMobs skill that casts the `flaming-shot` premade at the target entity.
>
> ```yaml theme={null}
> FlameAttackSkill:
>   Skills:
>   - executePremadeAbility{premade=flaming-shot} @Target
> ```
>
> You can use any of the following aliases for the parameter name:
>
> * `premade-ability`
> * `ability`
> * `premade`
> * `a`
> * `p`


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