This update is a
large internal refactor focused on NPC AI, escort behavior, dialogs, and holograms.
Many systems were rewritten to improve stability, flexibility, and performance.
⚠️ IMPORTANT – PLEASE READ BEFORE UPDATING
This update contains major internal changes.
All users are strongly advised to make a full backup before updating.
NPC AI & Pathfinding
- ✨ Added full NPC AI pathfinding system
- Escort system rewritten from scratch
- Per-player escort sessions
- Smooth movement (ProtocolLib supported)
- Route chaining (NPC can continue from current position)
- Arrival handling with timeout logic
- Improved NPC visibility handling (real NPC vs escort clone)
- Fixed multiple edge cases with escort cancelation & disconnects
Dialogue System Improvements
- Expanded dialogue system with multiple state nodes
- NPCs can now switch between multiple dialog trees (states)
- Arrival dialogs, walking dialogs, and follow-up dialogs are now cleaner and more reliable
- ❌ Removed hardcoded NPC logic (e.g. priest-only behavior)
- Cleaner separation between dialog parsing and execution logic
Hologram System (IMPORTANT)
- ❌ FancyHolograms is NO LONGER a required dependency
- Hologram handling was fully reworked
- Fixed holograms not following NPCs during escort
- Unified hologram ID logic across:
- Removed legacy / duplicated hologram code paths
- ⚙️ Holograms now correctly follow escort clones per player
Internal Refactors & Fixes
- ♻️ Large parts of the plugin were recoded
- NPC AI, escort logic, dialog flow, and holograms were decoupled
- Fixed multiple bugs related to:
- dialog state desync
- escort cleanup
- NPC visibility
- hologram duplication
- Improved performance and reliability under heavy NPC usage
⚠️ Important Notes
- This update changes internal systems — custom setups should be tested
- FancyHolograms can still be used if installed, but is no longer required
- YAML dialog files remain compatible, but new features are available