ModeledNPCS Quests, Dialogues & Commands v8.4

ModeledNPCS Update VER 7.4 — Everything In-Game!,​

NEW COMMAND: /mnpcmanage <id>

Hey everyone! Today’s update makes NPC management fast, clean, and fully in-game. No more editing YAML or spamming long commands. Here’s what’s new:
Highlights :
-> 100% GUI workflow: Rename, Effects, Animations, NPC Commands
. -> Chat prompts: quick rename (supports height like Captain 2.5) and add-command
-> Instant hologram refresh: fixes “double names” without a restart. -

Auto-Look toggle: on/off; when off, NPC snaps back to its saved baseline.

Click to expand...

-> Rotation = Baseline: /mnpc rotate updates the saved facing so it persists across respawns/reloads.
-> Effects UI: looped & on-interact particles and potions via GUI.
-> Safer reloads: merges disk data into memory (no ID/UUID wipes), reapplies names/models, refreshes effects, and cleans orphaned entities.

FIXES:

VERY IMPORTANT,​

-> Regenerate the trader .yml i added offset for holograms
-> Regenerate Config.yml so you can define manually the Yaw of autolook of your model as each model has it differently
UPDATED DOCS: https://docs.oreo-studio.shop/modellednpcs/getting-started/npc-gui-management
Preview Video :

• 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

-

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

Click to expand...

PLS REGENERATE CONFIG.YML WITH THIS UPDATE !!

• Massive Performance Recode – ~10× lighter CPU usage, smarter caching, fewer allocations, faster tick handling.
• Compatibility Updates – latest Spigot, MythicMobs, ModelEngine, BetonQuest & Quests fully supported.
• New Storage System – SQLite (auto) + JSON options, safer data handling.
• Reload Overhaul –
  • /mnpc reloadname: despawn/respawn safely, reapply autoLook, restore names with delay, single hologram refresher.
  • /mnpc reload: merges disk→memory without wiping runtime fields (UUIDs, autoLook, etc.).
• NPC Interactions – configurable left/right click, smart left-click fallback (raytrace for tiny hitboxes), fully configurable cooldowns.
• Hologram System – centralized updates via HologramManager, clean removals, chunk safety, new holograms.debug_visibility toggle.
• NPC Effects – /mnpc addeffect command with tab-complete:
  • Potion effects applied to clicking players.
  • Particle effects (looped or on-interact).
  • /mnpc effect clear|remove|reset|clearall for management.
• MythicMobs Scenes Fix – only PDC-tagged NPC-<id> entities treated as ModeledNPCs, no interference with regular MythicMobs.
• QoL & Safety – null checks, warnings, effect/animation restart after respawn, generic key-based mass removal, NPC limits (max_npc_ids, per-type limits), improved dialog integration (new “command fields” mode coming next build).

ModeledNPCS (BETA v7.0)
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.

YAML:

max_npc_ids: 1000
debug: true
limit:
  adventurerNPC: 3
serializeDebug: false


npc:
  autoRegisterOrphanedNPCs: false


  interaction:
   left:  true        # run interaction on left-click/attack
   right: true        # run interaction on right-click/use
   left_fallback:
     enabled: true
     range: 5.5       # try 5.5–6.0 for bigger models
     angle_deg: 30.0  # try 25–35 for wider aim cone


  cooldowns:
   command_ms: 3000   # per-PLAYER: block re-triggering commands
   interaction_ms: 500# per-NPC: debounce double fires
   click_dedup_ms: 250# de-dupe same-tick L+R for the same player+NPC


useJsonStorage: true

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

Lots of Bug fixes
Improved stability

➤ Bug Fix: NPC Hide Functionality

• Fixed an issue where /mnpc hide <id> did not persist properly.
• NPCs marked as hidden were being respawned shortly after due to internal revalidation tasks ignoring their hidden status.
• This has been patched — hidden NPCs will now stay hidden until explicitly shown again via /mnpc show <id>.

➤ Console Optimization

• Removed excessive console warnings and debug logs such as:
  • [SpawnNPC] Could not find entity for NPC ID ...
  • [NameReapply] Entity not valid or null...
• Plugin now runs cleanly with minimal console noise, even during reloads or on large setups.

➤ Why This Matters
This update significantly improves clarity for server administrators and makes debugging or monitoring startup processes much easier.

ModeledNPCs v6.0 Update!

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.

removed spam messages