ModelEngineNPC | Custom Model v1.3.1

Fixed

1. CRITICAL — Normal NPC Persistence: NPC data of type NORMAL was being silently wiped on every server restart or plugin reload.
2. CRITICAL — Mass Disconnect on NPC Spawn: Corrected an invalid entity metadata index that caused an IllegalStateException, disconnecting all online players when an NPC was spawned.
3. CRITICAL — NPC Skin Not Appearing: All NPC skins were rendering as default Steve. Fixed by properly delaying PlayerInfoRemove to allow skin textures to load on the client side.
4. Interaction De-duplication: Interaction messages were triggering multiple times per click on Normal NPCs.
5. Profile Name Sanitation: Added validation on NPC profile names to prevent native protocol failures.
6. Vanilla Nametag Visibility: Default Minecraft nametags on NPCs are now properly hidden, ensuring full compatibility with FancyHolograms.

1. Mineskin API Retry Logic: Added retry-with-backoff support when Mineskin returns a timeout, with up to 3 automatic retries.
2. HTTP Request Timeout: Async threads no longer hang indefinitely when Mineskin or Mojang API is unresponsive.

Added

1. Native Packet NPC System: Completely replaced FancyNpcs with a native NPC rendering system built on PacketEvents, handling all normal NPC behavior directly at the protocol level.
2. Packet-Based Interactions: Left and right click interactions are now intercepted natively at the packet level, no longer relying on Bukkit's Entity API.
3. Per-Player Look Tracking: Normal NPCs now send head rotation packets dynamically to nearby players for smooth and efficient look tracking.
4. Background Player Tracking: Added async player distance tracking up to 48 blocks, intelligently managing NPC spawn/despawn packets per player.

1. Removed FancyNpcs Dependency: FancyNpcs has been fully stripped from the plugin, making it more reliable, isolated, and lightweight.
2. NPCManager and NPCSpawner updated to utilize the new native packet processing logic.

Added

1. 
   
2. NPC Display Name Toggle: Control the visibility of the display name hologram for normal-type NPCs via /menpc name <id> <true|false>. Defaults to hidden to prevent conflicts with custom FancyHolograms displays.
   

Changed

1. 
   
2. FancyNpcsIntegration now dynamically injects <empty> as the display name when an NPC is configured to hide its name natively.
   

Added

1. 
   
2. NPC Cloning: Deep-copy any NPC including model, skin, animations, interactions, and hologram settings via /menpc copy <source> <new-id>.
   
3. Universal LookClose System: Fully rewritten LookCloseTask now supports both MODEL_ENGINE and NORMAL NPC types natively.
   
4. NPC Type Conversion: Convert existing NPCs between model and normal types at runtime via /menpc setnpctype <id> <type>. Handles the full despawn → transition → respawn cycle automatically.
   
5. Set Skin Command: Set or change the skin of any normal-type NPC at any time via /menpc setskin <id> <player-name|url>.
   
6. Mojang API Skin Support: Normal NPCs can now use a Minecraft player name (e.g. Notch) as the skin source, fetched directly from Mojang's session server.
   
7. Smart Skin Detection: SkinManager now auto-detects input type — URLs route to Mineskin API, player names route to Mojang API.
   

Changed

1. 
   
2. Async Skin Fetching: NPCs now spawn instantly while skins load in the background, eliminating spawn delays and timeout errors.
   
3. Texture Caching: Skin textures are cached after the first fetch — subsequent spawns on reload or restart apply skins instantly with no network calls.
   
4. FancyNpcs Integration: Updated SkinVariant to use AUTO for full compatibility with FancyNpcs 2.9.x.
   

Fixed

1. 
   
2. SocketTimeoutException on NPC Creation: Skin fetching no longer blocks the spawn process.
   
3. SkinVariant Enum Error: Resolved No enum constant SkinData.SkinVariant.CLASSIC crash on FancyNpcs 2.9.x.
   
4. LookClose Not Working for Normal NPCs: Look-at-player state now correctly syncs to live NPC instances.
   

Added

1. 
   
2. Normal NPC Support: Create standard Minecraft player-type NPCs (NPCType.NORMAL) alongside ModelEngine entities.
   
3. FancyNpcs Integration: Integrated FancyNpcs API (v2.9.x) for rendering normal-type NPCs.
   
4. Mineskin API Support: SkinManager now fetches and processes skin URLs asynchronously via the Mineskin API.
   
5. Dynamic Commands: /menpc create now accepts a type parameter (normal or model) with context-aware tab completion.
   
6. Context-Aware GUI: The NPC editor GUI dynamically switches between model ID and skin URL editing based on NPC type.
   

Changed

1. 
   
2. Refactored NPCManager to properly route spawning behaviors between NPCSpawner (model) and FancyNpcsIntegration (normal).
   
3. Normal NPCs now safely bypass ModelEngine-specific checks to prevent console exceptions.
   

Added

1. 
   
2. Public Developer API: Full programmatic access to create, remove, and manage NPCs via ModelEngineNPCAPI.
   
3. Maven Repository: Plugin artifacts are now hosted on repo.minekarta.com for easy dependency management.
   
4. YAML persistence architecture via YamlNPCRepository.
   
5. Interactive clicking system with configurable interaction commands.
   
6. Hologram settings and formatting integration via FancyHolograms API.
   

Changelog:

• Fix NPC removal issue

Changelog - ModelEngineNPC v1.0.1

🚀 New Features

• [NEW] Added /menpc play <id> <anim> [loop] [speed] command.
  • Allows playing any animation on an NPC dynamically.
  • Supports loop (true/false) and speed (multiplier) parameters.
  • Includes full Tab Completion for animations based on the NPC's model.
  • Smart Reset: Automatically returns the NPC to its configured idle animation after 3 seconds if the played animation is not looping (default behavior).

✨ Improvements

• Added dynamic Tab Completion for <anim> argument in /menpc animation.
• Added tab completion support for loop and speed arguments.
• Updated messages.yml with new response messages for animation commands.

🐛 Fixes

• Fixed an issue where playing a custom animation would not properly stop the previous idle animation or return to it afterwards.