This update will fix a issue where protocolib was spamming errors

- Fixed NPC glow effects not working correctly when other plugins (e.g. CMI) send hologram packets

Added/mnpc cleanholograms command for bugged holograms

Fix a hologram related bug

- The save now only happens once per timer tick (after the loop), only if any NPC actually needed correction, via a needsSave flag.
- The "Saving..." and "successfully saved" log lines are now gated behind debug: true in config, so they're silent in normal operation.

Improvements
- Holograms now use Display entities instead of ArmorStands better performance and compatibility
- Per-player glowing each player can see a different glow color on the same NPC
- Right-click detection improved with aim-based fallback more reliable clicking at range
- Nametag commands /mnpc now supports hide/show/reset nametag per NPC
- Manager menu updated with new options
- Escort clone movement uses smooth packet-based interpolation via ProtocolLib (configurable)

Bug Fixes
- Fixed MEGanimation not saving on server restart
- Fixed chunk handling causing NPCs to not respawn correctly
- Fixed per-player glowing breaking on certain server builds
- Fixed WorldGuard compatibility — right-clicking an NPC in a protected region no longer shows "Sorry, but you can't change that here"
- Various stability and performance fixes

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:

Field Location Description
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.

================================================================================
MODELEDNPCS — UPDATE v8.0
Date: 2026-03-30
================================================================================

This update introduces major new systems, a reworked interaction pipeline, per-NPC extended configuration, and a full public API expansion.

Every feature listed below is configurable and works with /mnpc reload.

1. NPC HOVER SYSTEM (NPCHoverManager)
A brand-new system that detects when a player aims their crosshair at a nearby NPC and reacts visually and interactively in real time.

How it works

• Every few ticks (configurable), the plugin checks every online player’s aim.
• Uses entity ray tracing first, then a cone-angle scan as fallback (covers ModelEngine marker bones that have no normal hitbox).

On hover enter

• Scales the ModelEngine model up (shared across all hovering players — only applies once when the first player starts hovering).
• Scales the player’s personal hologram up (per-player).
• Plays a configurable sound for the hovering player.
• Shows an action-bar hint message (for example: [Right-Click] Interact).
• Plays a custom hover animation on the ModelEngine model (per-NPC, configured in npc-extras.yml — see Section 4).
• Fires a cancellable NPCHoverEvent (ENTER) for API/addon use.

On hover exit

• Restores model scale when the last hovering player leaves.
• Restores idle animation.
• Restores the player’s hologram scale.
• Clears the action bar.
• Fires NPCHoverEvent (LEAVE).

Right-click while hovering
If a player right-clicks air or a block while hovering an NPC, the interaction triggers automatically — no need to physically click the entity hitbox.

Global config (config.yml → npc.hover)
Per-NPC overrides (npc-extras.yml)

• hover_enabled: true/false — enable or disable hover for this NPC
• hover_hint: "&e[Right-Click] &fShop" — override the action-bar text
• hover_animation: "wave" — ModelEngine animation to loop while hovered

Note: All hover config keys are live-reloadable via /mnpc reload.

2. RIGHT-CLICK FALLBACK (NPCListener)
Previously, right-click interaction only triggered when the player physically clicked on the entity’s hitbox (PlayerInteractEntityEvent). With ModelEngine models, hitboxes are often smaller or offset, causing missed clicks.

The new right_fallback catches RIGHT_CLICK_AIR and RIGHT_CLICK_BLOCK events, then performs the same ray-trace + cone-scan detection used by the hover system to find which NPC the player was aiming at.

How it works

• Fires on RIGHT_CLICK_AIR or RIGHT_CLICK_BLOCK (main hand only).
• Ignores the admin tool.
• Runs a ray trace along the crosshair up to range blocks.
• Falls back to cone scan if no entity is hit by the ray.
• If an NPC is found:
  • cancels the interact event,
  • plays the interact animation,
  • triggers the full NPC interaction pipeline.
• Has its own dedup guard so it never double-fires with a direct hitbox click.

Config (config.yml)
left_fallback uses the same structure and was already present.

Note: Both fallbacks are reloaded by /mnpc reload.

3. CONFIG BUG FIX — Duplicate npc: key
The config.yml had two separate top-level npc: keys. In YAML, the second key overwrites the first, which meant the entire npc.hover section was silently discarded at runtime.

Any value set in:

• npc.hover.range
• npc.hover.scale
• npc.hover.angle_deg
• etc.

had no effect — the code always used its hardcoded defaults.

Fix
The duplicate npc: key (which only held schedule_inactive_message) was merged into the first npc: block.

All hover and interaction config values now load correctly on both:

• first boot
• /mnpc reload

4. NPC-EXTRAS SYSTEM (npc-extras.yml + NPCExtrasConfig)
npc-extras.yml is a per-NPC extended config file. Each top-level key is an NPC id (integer). All fields are optional — defaults are applied if missing.

Changes take effect after /mnpc reload.

Full list of supported keys per NPC
LuxDialogues Integration

• lux_dialogue: "my_dialogue_id"
  Assigns a LuxDialogues conversation to this NPC. When the player interacts, the specified dialogue is triggered via LuxDialogues.
• lux_first_page: "1"
  The first page/node of the LuxDialogues conversation to open. Default: "1".

Particle Effects

• particle: "HEART"
  Bukkit Particle enum name. Played continuously around the NPC. Leave empty to disable.
• particle_count: 5
  Number of particles spawned per cycle.
• particle_radius: 0.6
  Radius (blocks) of the particle orbit around the NPC.
• particle_height: 1.0
  Height offset (blocks) above the NPC base for the particle orbit.

Greeting System

• greet_message: "&aHello, traveler!"
  Chat/action-bar message sent to the player when they enter greet range. Supports & color codes.
• greet_animation: "wave"
  ModelEngine animation played on the NPC when greeting a player.
• greet_range: 8.0
  Distance in blocks at which the greeting triggers. Default: 8.0.

Proximity Message

• proximity_message: "&7A merchant is nearby..."
  Message shown to the player when they are within proximity_range of this NPC. Different from greet — can be shown repeatedly, not just on first approach.
• proximity_range: 5.0
  Distance in blocks that triggers the proximity message. Default: 5.0.

Schedule System

• schedule_start: 6
  In-game hour (0–23) at which this NPC becomes active. Default: -1 (always active).
• schedule_end: 20
  In-game hour (0–23) at which this NPC becomes inactive. Default: -1 (always active).
• schedule_weather: "ANY"
  Weather condition required for the NPC to be active.
  Values: ANY, CLEAR, RAIN. Default: ANY.

When an NPC is outside its active schedule, interaction is blocked and the message from config.yml (npc.schedule_inactive_message) is shown.

Hover System Overrides

• hover_enabled: true
  Set to false to completely disable hover detection for this specific NPC.
• hover_hint: "&e[Right-Click] &fShop"
  Overrides the global hint_text from config.yml for this NPC only. Leave empty to use the global value.
• hover_animation: "wave"
  ModelEngine animation to loop while this NPC is being hovered. When hover ends, the NPC returns to its normal idle animation. Leave empty to keep the idle animation during hover.

Hologram Text Animation

• hologram_frames:
  A list of text frames cycled through on the NPC’s hologram, creating a color/text animation effect.

Example:
[*]hologram_frame_interval: 20
Ticks between each frame transition. 20 ticks = 1 second. Default: 20.
[/LIST]
NPC State System

• active_state: "default"
  The currently active state for this NPC. Persists across restarts. Changing the state swaps the animation and hologram suffix.

Can be changed via API:
Fires a cancellable NPCStateChangeEvent.

Example:
Any number of custom states can be defined.

5. PUBLIC API EXPANSION (ModeledNPCsAPI)
The public API (com.github.el211:ModeledNPCS-API:v8.0) has been expanded with the following new abstract methods.

All methods are accessible via:
Hover System
NPC States
Schedule
Hologram Animation
LuxDialogues Integration
New API Events
NPCHoverEvent — fired on hover ENTER and LEAVE. Cancellable.

• getPlayer() — the hovering player
• getNPCData() — the NPC being hovered
• getHoverAction() — HoverAction.ENTER or HoverAction.LEAVE

NPCStateChangeEvent — fired when an NPC state changes. Cancellable.

• getNPCData() — the NPC whose state is changing
• getPreviousState() — the old state name
• getNewState() — the new state name

6. /mnpc reload IMPROVEMENTS
/mnpc reload now also reloads:

• all npc.hover.* config values (range, angle, scale, sound, etc.)
• restarts the hover tick task with the new check_interval_ticks
• npc.interaction.right_fallback.* values
• npc.interaction.left_fallback.* values

Previously, hover config changes required a full server restart to take effect.

7. EXAMPLE npc-extras.yml ENTRY
Example: NPC id 5 — a merchant with full extras configured.

Fixed MANY performance issues
Updated API

Fixed an issue with API connection to glowing
QuestsAdapter.java
- getStatus() no longer returns QuestStatus.NOT_STARTED as a fallback when no adapter recognizes the quest name — it now returns null. Previously this caused every NPC to glow red even when the quest name wasn't registered in any plugin.
QuestManager.java
- questsAvailable now also checks for BetonQuest in addition to Quests. Previously BetonQuest users would never get the glow task started at all.
- updateGlow() now skips any dialog tree that has a null/empty questName, preventing a NPE/bad adapter call.
- The glow task interval now comes from the config (c.GLOW_UPDATE_INTERVAL) instead of being hardcoded at 60 ticks.
- The updateGlow() method now early-exits if c.GLOW_ENABLED is false.
- Removed unused AsyncPlayerPreLoginEvent import.
New config options in dialog_config.yml

api Updated to 7.9.1

Hey Everyone this new update will allow you guys to directly intereact with ModeledNPCS API
JAVA DOCS: Developer API | ModelledNpcs

switched to display entities hologram
fixed issues with hidenametag command

✨ New Features
Admin Tool System
Manage NPCs instantly, directly in-game.

• Right-click any NPC with a special admin tool to open the NPC Management GUI
• Fully configurable item (material, name, lore) and permission-based
• Works even if the NPC already has click actions (DeluxeMenus, commands, dialogs, etc.)
• Designed for staff efficiency and fast moderation
  

Commands:

• /mnpc admintool give – Receive the admin tool
• /mnpc admintool info – View the current admin tool configuration
  

Bulk Nametag Management
Full control over NPC nametags, individually or globally.

• /mnpc hidenametag <id|all> – Hide one or all NPC nametags
• /mnpc shownametag <id|all> – Restore original nametags
• /mnpc resetnametag <id|all> – Reset to default values
• Persistent across server restarts
• Compatible with ModelEngine and MythicMobs NPCs
• Automatic hologram cleanup when nametags are hidden

Perfect for immersive worlds, cinematic NPCs, or RPG servers.

Nametag Manager GUI
A brand-new interface to manage nametags visually.

• Accessible directly from the NPC Manager GUI
• Clear status indicator (Hidden / Visible)
• One-click actions: Hide, Show, Reset
• Live updates after each action (no reload required)

Designed for simplicity and clarity — no commands required.

⚙️ Configuration
Add the following section to your config.yml:
Everything is configurable to match your server’s style and permission system.

Fixes:
- Fixed issue with some NPC depsawning due to chunk loading on startup
- Fixed an issue with MEGAnimations not loading back after startup
- Fixed an issue with ChunkHandler

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:
  
  • spawn
    
    
  • movement
    
    
  • removal
    
• 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
  

Last update before 7.7
- Fixes: issue on meganimation making npc flicker
- compiler issues with proguard
- stability issue fixed

- **Fixed massive console spam**
`[AutoLook][Watchdog] NPC X has pitch=... resetting…` no longer floods logs.
→ Added new toggle: `autolook.watchdog-enabled` (OFF by default).
IN CONFIG.YML UNDER AUTOLOOK :
ADD watchdog-enabled: false

✅ ADDED

• PACKET AutoLook Mode (smooth face-player rotation using ProtocolLib).
  
  
• New config option:
  
  
  autolook.mode: PACKET or BUKKIT
• Yaw offsets per ModelEngine model (fixes models looking sideways).
  
  
• AutoLookService class to handle packet rotation smoothly.
  
  
• AutoLook Watchdog → prevents NPCs looking up/down randomly.
  
  
• Nearest Player Tracking for better NPC focus.
  
  
• Automatic config key updater → old configs now get missing keys auto-added.
  
  
• New NPC interaction configs (left/right click, fallback range, angle, etc.).
  
  
• New cooldown system for clicks & commands.
  
  
• New anti-piracy flag (disabled by default).
  

FIXED

• NPCs no longer look upward randomly.
  
  
• NPCs no longer shake / jitter when rotating.
  
  
• Fixed NPC rotation being too slow or stuck.
  
  
• Fixed NPCs not rotating in PACKET mode.
  
  
• Fixed Name/Hologram system causing spam & duplicates.
  
  
• Fixed holograms respawning 20+ times per second.
  
  
• Fixed AutoLook not reloading correctly after restart.
  
  
• Fixed old configs causing errors because keys were missing.
  
  
• Fixed ModelEngine NPCs facing the wrong direction.
  
  
• Fixed angle wrapping bugs (0°/360° loop causing spin).
  
  
• Fixed NPCs spinning forever when target crosses behind them.
  
  
• Fixed rotation crashing when chunks were unloaded.
  
  
• Fixed bad yaw calculation making NPCs "snap" visually.
  
  
• Fixed effects & animations initializing too early.
  
  
• Fixed orphaned NPCs not cleaning up.
  

IMPROVED

• Rotation is now ultra smooth when using PACKET mode.
  
  
• NPCs rotate faster & more naturally with angle interpolation.
  
  
• NPCs follow players more accurately with better math.
  
  
• Hologram system is more stable and updates cleanly.
  
  
• Better debug logs (clear & readable).
  
  
• Startup sequence reorganized for less errors.
  
  
• Improved AutoLook performance (less CPU).
  
  
• ModelEngine integration more reliable.
  
  
• Name re-apply happens only once (no more constant updates).
  
  
• AutoLook only runs after NPCs spawn (no null crashes).
  

CHANGED

• AutoLook tick rate configurable (period-ticks).
  
  
• AutoLook max rotation speed configurable (max-step-degrees).
  
  
• AutoLook max player distance configurable (max-distance).
  
  
• Config now includes all new features & default values.
  
  
• PACKET mode is now the recommended rotation type.
  
  
• Yaw offsets moved to config per blueprint.
  
  
• Rotations always keep pitch = 0 (unless autolook is ON).
  
  
• Debug mode now prints clean, organized messages.
  

STABILITY PASS

• Cleaner NPC spawn sequence.
  
  
• Cleaner NPC cleanup sequence.
  
  
• No more spammy logs.
  
  
• No more hologram flickering.
  
  
• NPC rotation stays stable even with dozens of NPCs.
  

Fixed an issue where /mnpc look npc was looking up

ModeledNPCS 7.5 Now focuses on safer startup and NPC stability. We fixed a startup crash caused by npcManager being accessed before it was initialized, especially in the animation system (MEGAnimationHandler). The plugin now builds managers in the correct order, so debug logging and animation loading no longer throw null pointer errors on enable. We also improved NPC recovery: looped ModelEngine animations, MythicMobs display names, AutoLook, and holograms all reapply more reliably after reload without wiping custom data.

What’s new (quality-of-life galore!)
Added /mnpcmanage <id>

> Zero manual editing: No more hand-editing meganimation.yml or typing long effect commands. It’s all GUI-driven now.

> One-click rename & commands: From the Manage GUI, you can enter the new name or add NPC commands directly in chat—no clunky syntax.

> Instant hologram refresh: Renaming updates the live nameplate/hologram immediately (no restart needed); we also sweep stray/old hologram lines.


> Effects made simple: Add looped particles or on-interact particles, or timed potion effects via GUI (and with friendly /mnpc addeffect too).



New GUIs:

> Manage GUI: Quick actions for rename, move, static, auto-look toggle, commands, effects, animations. /mnpcmanage <id>

> Effect Editor GUI (/mnpceffects or legacy /npceffects)

> Add/remove looped particles, on-interact particles, and potion effects without manual commands.

> MEG Animation GUI (/meganim)

> Select and loop ModelEngine animations; no manual file tinkering.

Hey everyone! This release is a big rework of the trader system: cleaner config, safer API usage on 1.21+, stock & limits built-in, and a shiny paginated GUI. Here’s what changed

✨ Highlights

• New Offers GUI (SmartInvs) with 6×9 layout, pagination, and Prev/Next buttons.
  
  
• Per-trader feature flags: enable or disable Offers, Stock, and Per-Player Limits per NPC.
  
  
• Stock & Restock system with automatic timers and persistent runtime file.
  
  
• Per-player purchase limits with timed resets.
  
  
• Safer 1.21+ attribute handling (uses the new AttributeModifier.Builder when available; falls back safely on older APIs).
  
  
• MiniMessage-style & & color formatting everywhere (titles, lore, messages). Optional PlaceholderAPI in player-facing text.
  
  
• Item builder overhaul: model data, enchants, attributes, PDC tags, unbreakable, lore etc.
  
  
• Vault economy support for costs/rewards, with graceful fallback if Vault isn’t present.
  
  
• Optional confirmation GUI before purchases.
  
  
• Legacy “single trade” path still supported if you don’t want per-offer GUI.
  

How players use it (examples)

• Click an NPC → see a scrollable offers menu with item previews, costs, stock, and limits.
  
  
• If enabled, they’ll get a confirmation screen before buying.
  
  
• Offers can charge money, XP levels, and items, and can give items, money, and run commands.
  
  
• Titles/lore support <green>, <bold>, <br> and classic &a, &l codes; PlaceholderAPI placeholders expand for the viewer.
  

️ New/Updated Config (trader.yml)
Top-level per-NPC

Code (YAML):

npc-1:
  display-name : "<gold><bold>Traveling Trader</bold></gold>"
  requireConfirmation : true     # show confirm GUI for any purchase (legacy & GUI)
  message : "<green>Trade complete!</green>"

  features:
    enableOffers : true           # use the GUI with per-offer config
    enableStock : true           # track stock per offer
    enablePerPlayerLimits : true # per-player limits

  # Legacy single-trade path is still supported if enableOffers=false:
  requirements:
    exp : 5
    money : 250.0
    items:
      key1:
        material : DIAMOND
        amount : 2
        modelId : 123
        fail : "<red>You need 2 custom diamonds!</red>"
  commands:
    - "console : give %player% bread 1"
 

GUI offers

Code (YAML):

npc-1:
  offers:
    speed_boots:
      title : "<yellow>Speedy Boots</yellow>"
      icon:
        material : LEATHER_BOOTS
        amount : 1
        modelId : 10
        lore :
         - "<gray>Zoom zoom.</gray>"
          - "<white>+Movement Speed</white>"
      # What it costs to buy
      cost:
        money : 500.0
        exp : 3
        items:
          - { material : FEATHER, amount : 8 }
      # What the player receives
      gives:
        items:
          - material : LEATHER_BOOTS
            amount : 1
            name : "<aqua><bold>Speedy Boots</bold></aqua>"
            lore :
             - "<gray>Run like the wind.</gray>"
            modelId : 10
            unbreakable : true
            enchants:
              minecraft:depth_strider : 3
              protection_fall : 2             # accepts namespaced or simple keys
            # attributes support amount/operation/slotGroup
            attributes:
              generic.movement_speed:
                amount : 0.05
                operation : ADD_SCALAR       # ADD_NUMBER | ADD_SCALAR | MULTIPLY_SCALAR_1
                slotGroup : FEET             # ANY/HAND/MAINHAND/OFFHAND/ARMOR/HEAD/CHEST/LEGS/FEET
            pdc:
              myplugin:rarity : "rare"       # arbitrary metadata on the item
        money : 0.0
        commands:
          - "console : playsound entity.player.levelup master %player%"
      # Stock system (only used if features.enableStock=true)
      stock:
        max : 20
        initial : 10
        restock:
          amount : 2
          interval_seconds : 900             # every 15 minutes
      # Per-player limits (only used if features.enablePerPlayerLimits=true)
      perPlayer:
        limit : 2
        reset_seconds : 86400               # resets daily
 

⚙️ Runtime persistence

• 
  The plugin writes trader_runtime.yml with current stock, last restock timestamps, and per-player counters.
  
  
• You can delete it to reset all stock & limits (server will recreate it).
  

Compatibility & Safety

• Minecraft/Spigot 1.21+: Uses AttributeModifier.Builder when available.
  
  
• Older APIs: Safe reflective fallback to the old constructor (still works, even if deprecated).
  
  
• Attributes & Enchants via Registry to avoid deprecated lookups.
  
  
• Flexible namespaced keys: minecraft:generic.attack_damage, generic.attack_damage, or GENERIC_ATTACK_DAMAGE all work.
  

Admin Checklist (after updating)

1. Back up your current trader.yml and trader_runtime.yml.
   
   
2. Update trader.yml to the new structure (see examples above).
   
   
3. If you had hardcoded NPC names/holograms: ensure you use the plugin’s formatted name so <green> etc. don’t show literally.
   
   
4. Verify Vault is installed if you use money costs/rewards.
   
   
5. Test an offer with stock and per-player limit enabled.
   
   
6. Optional: delete trader_runtime.yml to start with fresh stock/limits.
   

Fixes & Improvements

• Fixed titles showing literal <green> by consistently converting MiniMessage-style tags and & codes in both static and per-player contexts.
  
  
• Replaced deprecated attribute APIs where possible; added compatibility fallback for older servers.
  
  
• More robust parsing for EquipmentSlotGroup values (ANY, HAND, MAINHAND, OFFHAND, ARMOR, HEAD, CHEST, LEGS, FEET).
  
  
• Cleaner error handling & optional debug logs.
  

Thanks
Thanks for all the feedback and reports—this update was shaped by your suggestions. If you hit any issues, send your trader.yml and a short repro; I’ll jump on it!

Plugin is now fully compatible with 1.21.8 and latest versions of modelengines and mythicmobs !

- Fixed the rotate command it now persists
- Added the command /mnpc reloadanim you cna reload your npcs Easily
- Fixed the SqLite integration !
- Fixed lots of other issues

I’ve added dialog-only flows that can run commands at the end of a dialogue — not just start quests. Perfect for rewards, teleports, messages, etc.

✨ What’s new

• Dialogue nodes can now include a Commands: list that runs when the node is reached.
  
  
• Works even if questName is empty → pure dialogue + command!
  

Example config

Storage update (SQLite)
Added SQLite support + new config flags:


Set useJsonStorage: false to use SQLite.
useBackupFile: true keeps a safety backup of your data.

Changelog

• New: Dialogue nodes can execute Commands at end.
  
  
• New: SQLite storage option.
  
  
• New: Config keys useJsonStorage, useBackupFile.
  

Got feedback or bugs? Drop them here!

MINOR BUG FIXES

small fixes

VERSION 7.2 Fixes
New

• Potion/Particle interactions
  
  • Added a PotionInteractionListener that gives players potion effects and/or spawns “on interact” particles when they click your NPCs.
    
    
  • Two config switches:
    
    • effects.on-right-click (default true)
      
      
    • effects.on-left-click (default true)
      
• Command: /mnpc addeffect
  
  • Attach effects to an NPC:
    
    • Particles on interact:
      /mnpc addeffect <id> particle <looped|oninteract> <PARTICLE_NAME> [yOffset]
      
      
    • Potions to player:
      /mnpc addeffect <id> potion <POTION_NAME> <seconds> [amplifier]
      
  • Also supports a compact “colon” syntax:
    /mnpc addeffect <id> particle:looped:ANGRY_VILLAGER[:yOffset]
    /mnpc addeffect <id> potion:SPEED:10[:1]
    

Changed

• MythicMobs integration hardened
  
  • MythicMobsHandler#onMythicMobSpawn now only touches mobs named NPC-<id>.
    Regular MythicMobs (e.g. your skill) are left completely alone.
    
    
  • For NPC-<id> spawns we:
    
    • Tag with your PDC key (for protection/interaction)
      
      
    • Apply NPC safety flags (AI off, invulnerable, no-collide, invisible, no gravity)
      
      
    • Restore custom display names (with a short delayed re-assert to beat MM nameplate refresh)
      
• Safer NPC protection
  
  • NPCProtectionListener now cancels damage only for entities that are your NPCs (checks PDC tag and containsNPC(id)).
    
    
  • Removed self-registration in the constructor to avoid double listener registration.
    
    
  • Runs at LOW priority and respects ignoreCancelled.
    
• Effect management
  
  • /mnpc effect <clear|remove|reset|clearall> <id> wipes all stored effects (both potion & particle) for that NPC and refreshes loop tasks.
    
    
  • (Optional pattern) You can extend this to also strip already-applied potions from nearby players if desired.
    
• Name/Spawn quality-of-life
  
  • Spawner & name handling avoid duplicate bodies, close Mythic nameplates when present, and preserve previously saved values.
    
    
  • Merges on /mnpc reload keep runtime fields intact.
    

Tab-Completion

• Added rich tab-complete for /mnpc addeffect:
  
  • Step-by-step suggestions: <id> → particle|potion → looped|oninteract or potion list → particle names or durations → yOffset/amplifier.
    
• /mnpc effect now completes clear and remove, then lists NPC IDs.
  

Fixes

• Listener registration compile error: registering PotionInteractionListener now correctly passes a JavaPlugin (questDialog), e.g.
  Bukkit.getPluginManager().registerEvents(new PotionInteractionListener(npcManager), plugin);
  
  
• NPCEffect API parity: code now uses NPCEffect#getDuration() (ticks) consistently (the previous call to getDurationTicks() was corrected).
  

Data & Formats

• Stored effect format (NPCEffect)
  
  • effectType:
    
    • Bukkit potion name ("SPEED", "REGENERATION", …) or
      
      
    • Particle token: "particle:<looped|oninteract>:<PARTICLE_NAME>:<yOffset>"
      
  • duration: ticks (potion only; seconds * 20)
    
    
  • amplifier: integer level (potion only; default 0)
    
• Who receives potions?
  The player who interacts with the NPC. Particles marked as oninteract are spawned at the NPC’s head (offset).
  

Usage Examples

• Give Speed II for 10s on interact:
  /mnpc addeffect 12 potion SPEED 10 1
  
  
• Spawn happy villager particles at ~head height on interact:
  /mnpc addeffect 12 particle oninteract VILLAGER_HAPPY 1.8
  
  
• Add looped flame ring (handled by loop manager):
  /mnpc addeffect 12 particle looped FLAME 0.0
  
  
• Clear all effects from NPC 12:
  /mnpc effect clear 12
  

Compatibility & Behavior Notes

• Regular MythicMobs are unaffected. Only NPC-<id> wrappers get NPC flags and PDC tags.
  
  
• Clearing effects stops future applications/particles but does not remove potions already on players (by default). You can optionally add a small block to strip active potions nearby if you want that behavior.
  
  
• NPCListener and PotionInteractionListener coexist:
  
  • NPCListener still handles animations, command firing, and general interaction flow.
    
    
  • PotionInteractionListener focuses on giving potions and spawning “oninteract” particles, honoring effects.on-* config toggles.
    

Potions were not being counted when we chaneg the interacction type now its fixed

Added Hologram logging control:

• New toggle to silence per-player visibility spam:
  
  
  Code (YAML):

  holograms:
    debug_visibility : false   # default false

WOups I had kept default to true in default config this version changes it back to false

ModeledNPCS (BETA v7.0)
BIG UPDATE : PLS DELETE OLD MODELEDNPC FOLDER AND REGENERATE THE NEW ONE
You can now use the latest BETA build with the newest Spigot, MythicMobs, and ModelEngine.
This is a full recode focused on stability and speed in our tests it’s ~ 10× lighter. ModeledNPCS now barely sips CPU.

✨ Highlights

• Massive performance pass: less tick time, fewer allocations, smarter caching.
  
  
• Up-to-date compatibility: latest Spigot / MythicMobs / ModelEngine.
  
  
• Storage: SQLite (auto) + JSON supported.
  
  
• BetonQuest & Quests support updated to the latest.
  
  
• Fixed MythicMobs scene despawns when ModeledNPCS is present.

Reworked reloads
/mnpc reloadname

• Reloads npcdata.yml
  
  
• Safely despawns & respawns each NPC
  
  
• Re-tags autoLook after respawn
  
  
• Reapplies names after a short delay (prevents Mythic from overwriting)
  
  
• Uses one unified hologram refresher (refreshHologramsForNpc) to avoid dupes

/mnpc reload

• Merges disk → memory without nuking runtime fields (UUIDs, autoLook, etc.)
  
  
• Reloads QuestDialog + ModeledNPCS configs

Holograms, safety & QoL

• Centralized updates via HologramManager.upsertHologram(...)
  
  
• Clean mass-removal by generic keys (name/trader/dialog)
  
  
• Extra null checks & warnings when managers are absent
  
  
• Keeps chunks alive during respawn
  
  
• Restarts effects/animations after respawn

️ Click behavior + cooldowns (configurable)
Choose left-click, right-click, or both — with a smart left-click fallback (raytrace/aim cone) for tiny model hitboxes.

️ Dialogs
A new “command fields” dialog mode is ready — rolling out tomorrow (next build).

WE CHANGED OUR SUPPORT DISCORD NOW
IN ORDER TO JOIN :
https://discord.gg/xYeuK9dhfy

Fixed lots of bugs where npcs where loosing their Y position
Fixed Huge stability Bug
Fixed Model Render

Fixed Various Bugs and Stability issues

REVERT TO 6.3

Patch Notes:
➤ Fixed:

• ️ Resolved persistent name flickering for hidden NPCs with view permissions. Names now stay stable and are only shown when appropriate.
  
  
• Fixed NPC flickering on startup/reload by preventing unnecessary entity respawns when the NPC entity already exists and is valid.
  
  
• Fixed reapplyNamedataToNPC() logic to avoid full respawns unless all fallback options fail — reducing visual bugs and improving consistency.
  

➤ Improved:

• ⚡ Optimized spawnNPC() to skip spawning NPCs that are already active, reducing console noise and spawn lag.
  
  
• Smarter use of internal UUIDs and fallback metadata detection to bind NPC entities more reliably.
  
  
• Cleaned up model reapplication to avoid double-spawning ModelEngine ArmorStands.
  

Fixed – Delayed UUID Rebind & ModelEngine Entity Sync

• ✨ Improved Rebinding Logic:
  NPCs that previously failed to bind due to null or stale UUIDs now use a delayed Bukkit.getEntity() fallback that searches nearby entities using PersistentDataContainer.
  
  
• Entity Rebinding Confirmation:
  Logs now confirm entity rebinding with accurate UUID assignment:
  [SpawnNPC] Rebinding NPC ID 8 with UUID: ...
• 
  
• ModelEngine-Compatible:
  Rebinding and tag suppression for ArmorStands (ModelEngine models) now work reliably even after delayed spawn cycles.
  

Cleaned Up – Console Spam Reduction

• Removed excessive “Could not find entity” warnings by:
  
  • Avoiding rebind attempts when entity is expected to spawn later.
    
    
  • Skipping hidden or permission-restricted NPCs in rebind tasks.
    
• ✅ Result: Much cleaner logs, better performance, and no false warning spam.
  

Bug Fix: Safe Entity UUID Rebinding

• ✅ Added UUID null check during spawnNPC() to prevent crashes:
  
  java.lang.IllegalArgumentException: UUID id cannot be null
  
  
• Improved fallback logic to scan nearby entities using:
  
  World#getNearbyEntities()
  
  rather than assuming the stored UUID is always valid.
  
  
• If no entity is found, the system now logs a warning and skips gracefully, preventing plugin crashes and NPC misbehavior.
  

Summary
This patch ensures that NPCs with null or outdated UUIDs no longer cause fatal errors during spawn, and the system attempts recovery by smartly relinking to entities based on their metadata.

Highlights

• Massive lag spike FIXED during startup and periodic validation.
  
  
• Optimized NPC name reapplication and metadata lookups.
  
  
• Entity linking now uses localized getNearbyEntities instead of full world scans.
  
  
• Reduced memory usage and redundant object creation.
  
  
• New API access layer for developers (ModeledNPCsAPI).
  
  
• ❌ Resolved the "pitch not finite" crash in AutoLook teleportation.
  
  
• ️ Far more robust NPC loading, cleanup, and re-linking.

API & Developer Enhancements

• ✅ Introduced ModeledNPCsAPI singleton:
  • Access core systems: npcManager, traderManager, npcEffectManager, etc.
• ✅ Added BungeeCord support via:
  
  java
  sendPlayerToServer(Player player, String serverName);
  
  
• ✅ Improved internal plugin structure for dependency injection and plugin communication.

⚙️ Performance Optimizations
✅ Efficient Startup

• NPCLoaderHandler: Eliminated global entity scans; now uses NPC UUID + chunk location + proximity search.
  
  
• NPCManager#spawnNPC: Deferred nameplate and hologram setup to allow smooth chunk loading.
  
  
• MythicMobs/ModelEngine: Delayed model assignment and animation play via runTaskLater.

✅ Smarter Validation

• ValidationHandler#validateNPCs:
  • Reduced CPU overhead by replacing World#getEntities() with getNearbyEntities() scoped to each NPC.
    
    
  • Fewer checks, better tick efficiency, zero lag spikes.

✅ Cleaner Data Logic

• Removed:
  • Legacy PDC name sync.
    
    
  • Redundant setCustomName() / getCustomDisplayName() calls.
• Simplified:
  • NPCData string resolution.
    
    
  • UUID/entity validation logic.
• Ensured:
  • Dummy NPC creation doesn’t fail in empty worlds.

Bug Fixes

• ✅ Crash Fix:
  • IllegalArgumentException: pitch not finite when AutoLook attempted invalid rotations.
• ✅ Startup Fixes:
  • NullPointerException due to early listener registration before npcManager was ready.
• ✅ Reload Safety:
  • NPCs no longer disappear or reset on /reload due to persistent UUID mismatches.
• ✅ Command System:
  • Fixed plugin.yml error (provides must be a list) that broke command registration.
• ✅ Effect Tagging:
  • NPCs now preserve autoLook state via PDC and re-tag correctly on world load.

✨ Additional Improvements

• AutoLook now uses angle check to avoid over-rotating unnecessarily.
  
  
• Adventure API used consistently for all player-facing output.
  
  
• Scheduled validation and animation replay now happen asynchronously and in sync with server ticks.

How to Update

1. Backup your ModeledNPCS folder.
   
   
2. Replace old .jar with ModeledNPCS v6.1.
   
   
3. Restart the server – done!

‍ For Developers
Use the new ModeledNPCsAPI:

API LINK WILL BE ADDED SOON ON OUR DISCORD !!

Highlights

• Massive lag spike FIXED during startup and periodic validation.
  
  
• Optimized NPC name reapplication and metadata lookups.
  
  
• Entity linking now uses localized getNearbyEntities instead of full world scans.
  
  
• Reduced memory usage and redundant object creation.
  
  
• New API access layer for developers (ModeledNPCsAPI).
  
  
• ❌ Resolved the "pitch not finite" crash in AutoLook teleportation.
  
  
• ️ Far more robust NPC loading, cleanup, and re-linking.
  

API & Developer Enhancements

• ✅ Introduced ModeledNPCsAPI singleton:
  
  • Access core systems: npcManager, traderManager, npcEffectManager, etc.
    
• ✅ Added BungeeCord support via:
  
  java
  sendPlayerToServer(Player player, String serverName);
  
  
• ✅ Improved internal plugin structure for dependency injection and plugin communication.
  

⚙️ Performance Optimizations
✅ Efficient Startup

• NPCLoaderHandler: Eliminated global entity scans; now uses NPC UUID + chunk location + proximity search.
  
  
• NPCManager#spawnNPC: Deferred nameplate and hologram setup to allow smooth chunk loading.
  
  
• MythicMobs/ModelEngine: Delayed model assignment and animation play via runTaskLater.
  

✅ Smarter Validation

• ValidationHandler#validateNPCs:
  
  • Reduced CPU overhead by replacing World#getEntities() with getNearbyEntities() scoped to each NPC.
    
    
  • Fewer checks, better tick efficiency, zero lag spikes.
    

✅ Cleaner Data Logic

• Removed:
  
  • Legacy PDC name sync.
    
    
  • Redundant setCustomName() / getCustomDisplayName() calls.
    
• Simplified:
  
  • NPCData string resolution.
    
    
  • UUID/entity validation logic.
    
• Ensured:
  
  • Dummy NPC creation doesn’t fail in empty worlds.
    

Bug Fixes

• ✅ Crash Fix:
  
  • IllegalArgumentException: pitch not finite when AutoLook attempted invalid rotations.
    
• ✅ Startup Fixes:
  
  • NullPointerException due to early listener registration before npcManager was ready.
    
• ✅ Reload Safety:
  
  • NPCs no longer disappear or reset on /reload due to persistent UUID mismatches.
    
• ✅ Command System:
  
  • Fixed plugin.yml error (provides must be a list) that broke command registration.
    
• ✅ Effect Tagging:
  
  • NPCs now preserve autoLook state via PDC and re-tag correctly on world load.
    

✨ Additional Improvements

• AutoLook now uses angle check to avoid over-rotating unnecessarily.
  
  
• Adventure API used consistently for all player-facing output.
  
  
• Scheduled validation and animation replay now happen asynchronously and in sync with server ticks.
  

How to Update

1. Backup your ModeledNPCS folder.
   
   
2. Replace old .jar with ModeledNPCS v6.1.
   
   
3. Restart the server – done!
   

‍ For Developers
Use the new ModeledNPCsAPI:

API LINK WILL BE ADDED SOON ON OUR DISCORD !!

ModeledNPCs v6.0 Update!

Hey everyone!
We’re excited to announce the release of ModeledNPCs version 6.0 — this update brings major improvements to the plugin’s performance and stability!

However, please read carefully before updating:

⚠️ This version completely changes the saving system.
We’ve moved from YAML to JSON, which makes NPC data saving much faster and more reliable.

✅ What you need to do:

• Delete your old ModeledNPCS folder
  
  
• Remove the old .jar file
  
  
• Upload the new v6.0 jar and restart the server
  

Why this is important:
This update fixes long-standing issues, including NPCs randomly disappearing for some players. It's a clean slate, but totally worth it!

New Commands:
You can now control NPC behavior more easily:

• /mnpc look <id> – Enable auto-look (NPC looks at nearby players)
  
  
• /mnpc static <id> – Disable auto-look (NPC stays in place)
  

❗ Please note:
We are officially dropping support for all versions below 6.0.
If you’re using an older version, we strongly recommend upgrading to benefit from all the fixes and improvements.

If you choose to update to version 6.0, please note that this update changes the entire saving system. You will need to delete all your existing ModeledNPC files and the old jar file, then place the new one on your server. This version uses JSON instead of YAML for saving and storing NPCs, resulting in a much smoother and more efficient experience.

->
Added command for making npcs static so now you have
/mnpc look <id> - enable auto look
/mnpc static <id> - disable auto look

removed accidental left over debugs

Fixed some bugs and API changes

✨ New Features:

• Added bungee: command executor
  NPCs can now send players to other BungeeCord servers via plugin messaging.
  Format:
  
  bash
  /mnpc <id> addcmd bungee:<serverName>

FILE SHOULD BE 1.7MB when u unzip it

UPLOAD BUG IF YOUR VERSION IS LESS THEN 1.7MB PLS REPORT IT ON DISCORD

re upload cz some people have issues with download

Fixed a caused when updating NPC holograms before the QuestManager was fully loaded.

• Now safely checks if QuestManager and HologramManager are ready before updating.
  
  
• Improved error logging when dependencies are missing.
  

Bug Fixes:

• [✔️ NPCs Not Loading]
  Fixed a critical issue where NPCs defined in npcdata.yml were not being loaded at startup if the world (spawn) was not yet initialized.
  → NPC loading now waits for the target world to be fully available.
  
  
• [✔️ Empty NPC Load]
  Resolved an issue where the loader would silently skip loading even though npcdata.yml had valid NPCs.
  → Added clear debug logs to trace npcs section detection and entry processing.
  
  
• [✔️ UUID Binding Failure]
  Improved reliability of UUID/entity binding by deferring auto-look tagging and name application until entity is fully spawned.
  

️ Improvements:

• Added extensive debug logging
  → Includes checks for config keys, NPC section presence, per-NPC world state, and spawn success confirmation.
  
  
• Auto world loader support
  → Automatically attempts to load missing worlds before skipping NPCs.
  
  
• Better ID Pool Handling
  → Ensures clean reuse and tracking of available NPC IDs during initialization.
  

Minor Performance Bug fix

Major Fixes & Enhancements:

• AutoLook is now fully functional!
  
  • NPCs now smoothly turn to face nearby players again.
    
    
  • AutoLook is only active when configured, making it cleaner and more optimized.
    
    
  • Fixed a rare issue where some NPCs would stop tracking players after server reloads.
    
• Bug Fixes:
  
  • Fixed an issue where AutoLook randomly disabled on some NPCs (e.g., ID 0).
    
    
  • Fixed a bug where Autolook was causing HIGH MS LAG
    
    
  • NPC name and auto-look settings are now correctly restored after reloading.
  • Stability improvements for NPC spawning and removal.
    
• ⚙️ Developer Options:
  
  • Added new debug mode toggle via config.yml:
    
    • debug: true will now print NPC logs like direction, angle, and auto-look status.
      
      
    • Set to false to keep logs clean.
      

sorry

Fixed Hologgrams where not getting updated afer npc moves

Fixed a error message on NPC Listener / added null checks

✅ Bug Fixes

• Fixed looped animation (e.g. fidget) from meganimation.yml not playing correctly after spawn.
  
  
• Fixed NPC custom names & holograms not applying after server restart.
  
  
• Fixed missing name display for ModelEngine NPCs due to entity rebind on join.
  

➕ New Features

• Re-added /mnpc rotate <id> <degrees> <left|right> command to manually rotate NPCs.
  
  
• Auto-look PDC integration: rotation now persists and is detected via PersistentDataContainer.
  

Fixed issue with naming modelengine npcs does not persist after restart

✨ Highlights

• Massive stability & NPC persistence upgrade
  
  
• Holograms, names, and entities now survive crashes, reloads, and re-joins.
  -
• Added a Lang file do you can translate to any language u want

What's New
✅ Persistent NPC Identification

• All NPCs now use PersistentDataContainer (PDC) tagging instead of fragile names.
  
  
• This guarantees robust entity detection after server restarts or crashes.
  

Name & Hologram Sync

• Names and holograms are now automatically re-applied on join.
  
  
• No more needing /mnpc reloadname manually!
  
  
• Added JoinNameFixer to handle name + hologram refresh when players join.
  

Smarter Entity Tracking

• NPCs now auto re-link their entities using UUIDs, PDC, and metadata fallback.
  
  
• Ensures NPC visuals (nameplates, models, etc.) are restored reliably.
  

Proximity-Based Loading

• Nearby NPCs automatically spawn + rebind when players approach.
  
  
• Reduced load on server by skipping NPCs far from any player.
  

Improved Debugging & Logging

• All critical NPC events (rebinds, respawns, hologram updates) now log to console in debug mode.
  
  
• Easy to trace what's happening with your NPCs.
  

BUG FIXES

Fix /mnpc name not updating npc name after restart
Fix name showing after restart
Fix command /mnpc reloadname

Oups sorry i kept my debugs

FIXED NPC NAMING
FIXED MODELGNINE NPC DUPING
FIXED MODELENGIN NPC ANIMATIONS
FIXED MYTHICMOBS NPC DUPING
FIXED MYTHICMOBS NPCS NOT TAKING NAMES
REFACTORED THE ENTIRE CODE
FPLUGIN IS MUCH MORE LIGHTER
FIXED PERFORMENCE ISSUES

Fixed an issue where MythicMobs NPCS were duping and causing server Lag

Modifies meganiamtion.yml to support on intereact animation and looping animation

FIX mythimobs npc cannot be named does not persist after restart

Added /mnpc rotate command to rotate the npc

Fixed issue Holograms were not showing unless quests plugin was installed

Fixed issue if NPC is not name we had a hologram showing saying unnamed npc

Names and effects now persists for modelengine entities

Release Date: April 11, 2025

Fixed Issues with NPC Not being removed
Fixed issues with effects not being removed on npc removal
Fixed Critical Bug on sudo command
Fixed Hologram names not working
Fixed hologram not showing back up on restart
Fixed effects not showing bakc up on restart
Fixed NPC TPS Issue
Fixed error on startup
Fixed Errors on naming
Fixed error related to chat color
Added command /mnpc reloadeffect and /mnpc reloadname

- Critical Bug Fix with duo command
- Bug fix with chat color

Fix Effects Bugs sorry ^

Fixed Npc removal does not remove the effect

✨ New Features
NPC Effects System (effects.yml)

• Added support for effects.yml to define visual and sound effects for NPCs.
  
  
• Effects can be looped particles, interaction sounds, or spawn visuals.
  
  
• Example configuration:
  

Custom NPC Names via namedata.yml

• 
  
• You can now configure custom display names for each NPC:
  
  

• Names are now properly shown via holograms above NPCs on spawn and reload.
  

️ NPC Look-at-Player System

• New feature: NPCs with autoLook: true will automatically rotate to face nearby players!
  
  
• Runs every second and makes interactions feel more immersive.
  

Bug Fixes
Critical NPE Fix on Startup and Chunk Load

• Fixed:
  
  csharp
  java.lang.NullPointerException: Cannot invoke "HandlerManager.get(Class)" because "this.handlerManager" is null
  ✅ Cause: NPCs were being spawned before QuestDialog was fully initialized. ✅ Fix: NPC spawning is now delayed by 1 second on chunk load to allow full system boot.
  

Multiple Removal Logs (NPC ID Repeating)

• Issue: Repeated [INFO] Removed NPC ID: X spam in console.
  
  
• Fixed duplicate NPC entity removal and improved entity cleanup during chunk load.
  

MythicMob & ModelEngine Initialization Order

• Fixed order-sensitive issues where models or mobs wouldn't spawn due to missing blueprints/mobs during early startup.
  

Improvements

• Improved logging and debug output for all NPC spawning/hologram operations.
  
  
• Smarter hologram height fallback: DialogTree::getYHeight used if available, otherwise namedata.yml.
  
  
• Enhanced orphaned NPC detection and cleanup for smoother reloads and fewer console warnings.
  

Fixed Consol Spam When close to NPC
Added Command Cooldown for npc interactions
Added Debugs that will show only if Debug is true for holograms to !

✨ New: Custom NPC Display Names!
You can now personalize each NPC's name using a custom command:

bash
/mnpc name <id> <name> [height]

• ✅ Saves the name and hologram height to namedata.yml
  
  
• ✅ Hologram automatically updates for all online players
  
  
• ✅ Supports colored names using & codes (e.g. &eMerchant)
  
  
• ✅ Height is optional – default is 2.5 blocks above the NPC
  

Smarter Hologram Display Priority
Hologram names now prioritize in this order:

1. trader.yml display-name
   
   
2. Custom name from /mnpc name (stored in namedata.yml)
   
   
3. ❔ Fallback: Unnamed NPC #<id>
   

Other Improvements

• Holograms now follow NPCs when moved
  
  
• Fixed null error when refreshing holograms
  
  
• Improved chunk loading reliability for NPC spawn
  

Now in config.yml
we have :

you can specify how many NPC kind of that mobh you want in order to prevent unwanted dupes ane keep server as healthy as possible

Want your NPC to do an animation when a player right-clicks it?

With ModeledNPCs, you can assign a specific animation to ModelEngine NPCs that plays whenever a player interacts with them. No MythicMobs needed!

Example Configuration
Create or edit this file:


And add entries like this:

Fixed a small issue with /mnpc remove command

BEFORE DOING ANY UPDATE PLS BACKUP YOUR FILES !!
✅ BetonQuests / Traders / Sudo Commands and more!
✨ New Features

• Trader System added!
  Create fully configurable NPC traders using trader.yml.
  Supports:
  
  • EXP, money, and item requirements
    
    
  • Console/player command rewards
    
    
  • Optional confirmation system
    
• Sudo Commands
  NPCs can now execute commands as OP players!
  Use the prefix sudo: when adding commands to NPCs.
  
  
• BetonQuests Compatibility
  Built-in support to trigger BetonQuest objectives via NPC interaction (if enabled)!
  

️ Improvements & Fixes

• ✅ ModelEngine animations now play on interaction as expected
• ✅ MythicMobs NPCs properly handle player interaction and animation triggering
• ✅ Fixed interaction cooldown logic to prevent abuse
• ✅ Logging improvements for NPC interactions (debug mode)
• ✅ Fixed issue with NPCs turning into Pigs
  
• ✅ Fixed NPC Dupe Issue
  
• ✅ Optimized Plugin

Command Updates

• /mnpc <id> addcmd <player|console|sudo> <command> – now supports all 3 execution types
  
  
• Tab completion improved for all commands
  

ModelledNPC - Update Patch Notes
ALWAYS KEEP A BACKUP BEFORE UPDATING!

Version 3.0- Latest Changes & Improvements
Compatibility & Updates

• Updated to the latest ModelEngine development version. ⚙️
  • IMPORTANT: You must update ModelEngine to the latest version for compatibility.
• ✅ Added support for A NEW QUESTS PLUGIN : Quests!
  • Seamlessly integrate NPCs with quest progression.Quests [1.8-1.21] | Set up goals for players | SpigotMC - High Performance Minecraft Community

New Features

• ✨ Added NPC Hide Option for an RPG-like touch!
  • Perfect for immersive gameplay where NPCs appear/disappear dynamically.

️ Fixes & Improvements

• Lots of bug fixes! Stability and performance improvements.
• Optimized NPC rendering for better performance.
• Improved compatibility with the latest Paper/Spigot versions.
• Resolved minor sync issues with model animations.

Reminders

• Backup your data before updating to avoid any issues.
• Ensure that all dependencies are updated for smooth functionality.
• Report any bugs or issues to our support channels!

Need Help? Join our Discord or check the documentation for further assistance.

Fix a bug where it would spam errors on console when removing NPCS

Whats New:

Added Quests Support!
Added Dialgues support !
Added NPC Glows for quests !!

Bug fixes :
- Fixed bug where modelengine npcs where not registering UUID Correctly
- Fixed a bug causing memory leak

Whats New:

Added Quests Support!
Added Dialgues support !
Added NPC Glows for quests !!

Bug fixes :
- Fixed bug where modelengine npcs where not registering UUID Correctly
- Fixed a bug causing memory leak

- Removed debug messages spaming
- Fixed Bugs

MInor bug fix regarding mythicmobs NPCS