Integrations

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:

plugins/SentryPremades/integration/itemsadder.yml

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.

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:

plugins/SentryPremades/integration/nexo.yml

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

- executePremadeAbility{premade=<ability-id>} @Target

Parameter Reference

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:

plugins/MythicMobs/Mobs/OverchargedBoss.yml

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:

# Reload ItemsAdder integration mappings
/premades reload "ItemsAdder Integration"

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

Overview

Core Concepts

GUI + Config Templates

Developer API

SentryWipe

SentryLore

SentrySettings

SentryPremades

Configurations

ItemsAdder Integration

Supported Interaction Triggers

Nexo Integration

MythicMobs Integration

Mechanic Syntax

Parameter Reference

Example: Custom Dungeon Boss

Reloading Integrations

​ItemsAdder Integration

​Supported Interaction Triggers

​Nexo Integration

​MythicMobs Integration

​Mechanic Syntax

​Parameter Reference

​Example: Custom Dungeon Boss

​Reloading Integrations

ItemsAdder Integration

Supported Interaction Triggers

Nexo Integration

MythicMobs Integration

Mechanic Syntax

Parameter Reference

Example: Custom Dungeon Boss

Reloading Integrations