ModeledNPCS — New Escort System Update + Major Improvements
A huge update just landed for ModeledNPCS, bringing major improvements to the Escort System, fully configurable arrival behaviors, and important compatibility fixes.

Escort System — Arrival Animations (Clone NPCs)
Clone escort NPCs can now automatically play custom animations when reaching their destination.

New YAML fields:

• arrive-animation: <name>
• arrive-animation-duration: <seconds>

Features:

• Uses MEGAnimationHandler.playLoopedAnimationByName() directly on the clone
  
  
• Fully per-player — every escort session is completely isolated
  
  
• 0 duration keeps the animation playing until the clone is removed

This allows cinematic escort endings directly from configuration without additional coding.

Escort System — Arrival Commands
Clone escorts can now execute commands immediately upon arrival through YAML configuration.
New section:
Patrol:
arrival-commands:
Supported formats:

• console: <command>
• player: <command>
• No prefix → defaults to console execution

Additional features:

• Full {player} placeholder support
• Commands execute before the destination dialog opens
• Fully session-based and independent for every player

Perfect for:

• Rewards
• Teleports
• Quest progression
• Effects & cutscenes
• Dynamic story events

New Dialog YAML Fields
Added new configurable escort fields directly inside dialog trees:

FieldLocationDescription
arrive-animation Destination tree root Animation played on arrival
arrive-animation-duration Destination tree root Duration before removal
arrival-commands Under Patrol: Commands executed on arrival
priest.yml Fully Rewritten
The entire priest.yml escort configuration has been reworked.
Changes include:

• Added arrive-animation: idle
• Added arrive-animation-duration: 0
• Added arrival-commands for every patrol route and state
• All escort routes are now fully YAML-driven with zero database setup required

Patrol System Compatibility
The original /mnpcai patrol arrival system remains completely unchanged.

Existing SQLite-based features continue to work normally:

• Animations
• Wait times
• Arrival dialogs
• Commands
• Permissions

No migrstion required.

Dependency Update
Updated:

• GlowingEntities 1.4.3 → 1.4.11

Fixes:

• IllegalArgumentException: Malformed version: 26.1.2.build.60-stable
• Startup crashes caused by Paper's custom version formatting

No API changes required fully internal compatibility fix.

► Holograms (/mnpc name) not appearing near NPCs
Fixed a world-reference mismatch that caused holograms to be
immediately despawned after creation. World comparison now uses
name-based lookup instead of object equality, fixing compatibility
with Multiverse-Core and any plugin that reloads worlds.
The hologram location also now re-resolves its World reference
from Bukkit on each tick, preventing stale references after
world reloads.
► /mnpc name hologram silently skipped when name matched model ID
A check in the name reapply logic was nullifying the custom
display name if it happened to equal the NPC's internal model
name, causing the hologram to never be created. Removed.
► Color codes (&c, &l, etc.) not rendering in hologram text
TextDisplay entities were receiving raw legacy color strings
via Component.text(), which treated § as a literal character.
Now uses LegacyComponentSerializer so color and formatting
codes display correctly.
► LuxDialogues integration error on startup
"Failed to register events" console error when LuxDialogues
is not installed. The event listener is now only registered
when LuxDialogues is confirmed available, eliminating the
error entirely.

8.0​

7.9​

7.8​

7.7c​

7.7B​

7.7B​

7.7a​

7.7​