Events

NMEntities fires plain Bukkit events that addons listen to like any other. They live in org.nexomaker.api.event.

Event	Fires when	Cancellable
`NMEntitiesMobSpawnEvent`	An NMEntities mob spawns: `/nme spawn`, the Entities menu, the `summon` mechanic, or the API. The entity is already tagged.	Yes — removes the entity before model and effects
`NpcInteractEvent`	A player right-clicks an NPC, outside select mode. Carries the npc id, instance index, base entity and player.	Yes — skips the NPC’s right-click effects
`NMEntitiesReloadedEvent`	After every load of mobs, NPCs and effects: boot and `/nme reload`. May fire async.	No

NMEntitiesMobSpawnEvent

Use it for region protection (no bosses in spawn), spawn limits, or logging. Cancelling removes the entity before its model and +onSpawn effects run.

NpcInteractEvent

The hook for NPC behaviour beyond what right-click effects cover: open a shop inventory, start a dialog, gate an interaction behind quest progress. Listen, cancel, and run your own logic.

@EventHandler
public void onNpcClick(NpcInteractEvent event) {
    if (event.getNpcId().equals("banker")) {
        event.setCancelled(true); // suppress its configured effects
        openBankUi(event.getPlayer());
    }
}

NMEntitiesReloadedEvent

Use it to refresh anything your addon derives from NMEntities’ registries, such as cached mob lists or generated content.

This one may fire asynchronously. Hop back to the main thread before touching the world from a listener.

Listening

Standard Bukkit listeners, nothing special — register them in your addon’s onEnable as usual.

Getting Started

Mobs

Spawning

Commands

Effects

Models

Compatibility

NPCs

Configuration

API

NMEntitiesMobSpawnEvent

NpcInteractEvent

NMEntitiesReloadedEvent

Listening

​NMEntitiesMobSpawnEvent

​NpcInteractEvent

​NMEntitiesReloadedEvent

​Listening

NMEntitiesMobSpawnEvent

NpcInteractEvent

NMEntitiesReloadedEvent

Listening