Changelog for Easy NPC: Core (1.21.11)

Note

This change log includes the summarized changes. For the full changelog, please go to the GitHub History instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the upgrade guide for more information.

6.10.0

• Fixed #698 by adding try and catch for 3rd party entity creation.
• Fixed #695 by clearing model part rotations/positions when switching to a DEFAULT vanilla pose.
• Fixed #695 by applying lock rotation and pose animation only when the NPC is idle.
• Fixed #695 by correcting root rotation pivot to use actual bounding box height instead of 0.5f.
• Fixed multiple objective registration issues including inverted isTargetedPlayer check, wrong UUID in leave-handler, missing player-targeted refresh on join/leave, and retry for offline targets.
• Fixed goal reference being retained after objective is unregistered.
• Removed auto-lock of ROOT rotation when loading poses; root lock is now user-controlled.
• Added lock rotation checkbox to the advanced and custom pose configuration screens.
• Added model-specific pose key filtering in ConfigurationMenuHandler for the default pose screen.
• Added unit tests for CustomPosition, CustomRotation, CustomScale, ModelPose, ModelAnimationBehavior and ModelAnimationData.
• Added NPCDataIsolationTestHelper and game tests for Fabric and Forge.
• Increased max head yaw range from 60° to 65°.

6.9.0

• Fixed #692, #666 by adding caching and safeguards to prevent redundant retriggering of NPC entity data updates.
• Fixed #651, #617 by adding basic custom poses for all supported NPC types.
• Fixed #597 by adding additional Flee goals for fleeing from players, villagers, monsters, ...
• Fixed pose loading to read directly from mod resources instead of copying files to disk.
• Fixed duplicate saveNPC calls on entity join by checking existing registry entry first.
• Added despawn and spawn commands to remove and re-spawn NPCs by UUID with configurable removal reasons.
• Added ModelPoseAPI and EasyNPCEntityHandler public API classes for controlling NPC poses and managing NPCs programmatically from external mods.
• Added pose data files for all supported NPC types.
• Added lock rotation checkbox to the basic pose configuration screen.
• Added MoveToPositionGoal to move an NPC to a position before executing a callback action.
• Added EasyNPCLookControl and EasyNPCBodyRotationControl to respect locked root rotation.
• Added synced owner change and dimension change to the NPC entity data index.
• Added EasyNPCItemAttachmentLayer into various entity renderers.
• Added dedicated Flee Objective configuration tab with objectives for fleeing creepers, monsters, mobs, players, villagers and the sun.
• Added FOLLOW_ITEM objective to the follow objectives tab to make NPCs follow item entities by resource location (e.g. minecraft:apple).
• Added LookAtEntityByUUIDGoal and enabled the look-at-entity-by-UUID and look-at-owner objectives in the look objectives screen.
• Added persistent flag to SynchedDataIndex so that transient indices (e.g. crossbow charge, model animation) no longer trigger dirty-save marking.
• Added configurable customParticlesEnabled flag to SlimeBase for API consumers.
• Added SoundType.PET and mapped CAT_PURR to the cat NPC for tamed ambient sound variety.
• Reduced log verbosity for periodic NPC save operations from INFO to DEBUG.

6.8.3

• Fixed #680 by enforcing version miss-match by upgrading network protocol version.
• Fixed #679 by resetting position, rotation and size for name tag.
• Fixed #665 by adding multi state slide for root rotations.
• Fixed #664 by adding option to disable following mouse cursor for easier posing.
• Fixed #663 by improve support for X and Z root rotations.
• Fixed #661 by adding quick rotation with NPC wand and sneaking to the NPC to rotate the root to face the player.
• Fixed move tool is wrongly triggering interactions by adding check for move tool in interaction handler.
• Fixed Preset Item is wrongly triggering interactions by adding check for preset item in interaction handler.
• Fixed Slime and Ghast hitbox and name tag position issues by adjusting bounding box and eye height calculations.
• Fixed Slime and Ghast GUI position by adjusting offset values.

6.8.2

• Fixed #677 by extending SafeMerchantData with notifyTrade to avoid crashes.
• Added progression data support for leveling up NPCs based on player interactions and actions.
• Added global NPC tracking system for better management and debugging of NPCs across the world.
• Added OriginalModelConfig.withVariantTexture() option to allow using variant textures with the original model.

6.8.1

• Fixed #676 by using existing preset helper method instead of custom one.

6.8.0 (Adding API support)

• Fixed #667 by adding warning messages and additional checks for invalid network packets.
• Fixed Horse spawn eggs model.
• Fixed pose support for allay, chicken, creeper, fox, ghast, horse, illager, iron golem, slime and vex.
• Added NPC base classes for better API support.
• Added NPC raw classes for advanced API support.
• Added Slim and Ghast NPC types.
• Added Custom Model API for easier integration with other mods and custom models.
• Refactored internal data handling and registration for better maintainability and future improvements.

6.7.1

• Fixed #657 and #656 by adding additional client side checks for vanilla bug.

6.7.0

• Fixed #650 by implementing Wolf Leg Animations in setupAnim method.
• Fixed #648 by fixing canBeHitByProjectiles translation.
• Fixed #645 by adding allowBypassInvulnerability config option to allow/deny bypassing invulnerability for NPCs.
• Fixed delete button showing label even with small width.
• Fixed up and down buttons not positioned correctly in some cases.
• Fixed name tag showing up for dialog and configuration UI.
• Fixed distance action issue were multiple actions are not properly triggered.
• Fixed issues with NPC presets.
• Fixed Cat NPC and Wolf NPC owner data not syncing properly.
• Added preset browser for easier selection of common NPC presets.
• Added preset .snbt (text) export and import functionality for sharing NPC presets.
• Refactored existing NPC presets to use new .snbt format.
• Refactored spawner system to use new preset format for better maintainability and future improvements.

6.6.2

• Fixed #643 by rework scaling system.
• Fixed scaling not properly updating hitbox and nametag position after restart / reload.
• Added MID and MOUSE_OVER name tag visibility modes for finer control over NPC name display.
• Added team-based name tag visibility support respecting vanilla Team.

6.6.1

• Fixed #638 by refactored internal data handling for display attributes.

6.6.0

• Fixed #634 by implementing asynchronous texture loading with dedicated thread pool.
• Fixed texture loading blocking render thread causing game freezes.
• Fixed race conditions in texture reload protection using atomic operations.
• Fixed resource leaks in HTTP connections during remote texture downloads.
• Fixed URL validation spam allowing multiple simultaneous downloads of the same texture.
• Fixed exception handling for remote image validation preventing crashes on invalid URLs.
• Fixed defineId called for: warning messages during NPC loading.
• Refactored texture loading architecture with multi-level defense and rate limiting.
• Refactored entity data registration logic for better maintainability.
• Converted data classes to modern Java records for better immutability and thread-safety.
• Added thread-safe session server spam protection with ConcurrentHashMap.
• Added comprehensive error recovery with automatic cooldown reset on failures.
• Improved texture loading with 2-thread pool and 500ms rate limiting.
• Improved exception handling with specific catch blocks for IIOException and FileNotFoundException.

6.5.2

• Fixed Villager profession and job skin issue.
• Improved GitHub workflows by adding cache for gradle dependencies.
• Improved Gradle build time and cleanup tasks.

6.5.1

• Fixed #632 by implementing ON_KILL action type and event.
• Fixed #629 by improving texture handling performance, caching, and memory usage.
• Fixed kill command is not working on NPCs.
• Fixed texture reload protection preventing cache reload after eviction.
• Fixed WebP validation bug in remote image validator (missing return statement).
• Refactored texture handling logic for better maintainability and future improvements.
• Added time-based reload protection (60 seconds) to replace permanent blocking mechanism.
• Added missing variant textures for chicken, pig and wolf.
• Added additional unit tests for texture handling.
• Improved gradle build tasks.

6.5.0

• ⚠️ Removed jar-in-jar bundle approach for better mod compatibility and api capabilities.
• Fixed #627 scissor implementation for better compatibility with other mods.
• Fixed #625 lively animation issues when using rotated or moved model parts.
• Fixed default animation are canceled when using scaled model parts.
• Added better pose animation control with smart, default und none options.

6.4.1

• Fixed #626 screen switching logic for different NPC UUIDs, thanks to Spawnblade for the detailed investigation and fix suggestion.

6.4.0

• Fixed #626 by improving dialog data validation and error handling.
• Fixed #623 by refactoring render data and render handling.
• Fixed #622 by making sure custom data are properly saved and loaded.
• Fixed open dialog action type to allow opening dialogs from other NPCs.
• Fixed hashing issues by adding missing equals and hashCode methods for ConditionDataSet and ActionDataSet.
• Added custom data test item for #622 and easier testing of custom data.
• Improved records and fixed potential issues with missing data.

6.3.0

• Refactored config ui specific components and removed them from the core mod.
• Fixed dialog data by filtering dialog data before sending to the client.
• Fixed dialog editor layout issues and improved usability.
• Fixed missing default values for some dialog data fields.
• Added dialog priority support to control the order of dialog execution.
• Added condition support for dialog and scoreboard actions.
• Added frequency support for dialog to limit how often an dialog can be shown.
• Added new NPC preset to for scoreboard and condition support.
• Improved dialog button data format by removing redundant fields.

6.2.0

• Fixed legacy custom name parsing.
• Fixed string injection within dialogs.
• Fixed missing translation for action types.
• Added scoreboard action type to increase, decrease, set scoreboard values.
• Added @score(...) NPC macro to display scoreboard values in the dialog.
• Added additional unit tests.
• Improved spin button with indicators and better usability.

6.1.2

• Fixed container and menu sync issues with missing close container packets.
• Fixed close button not working in some cases.
• Fixed jumping mouse cursor between screen transitions.
• Fixed translation files and removed duplicate and deprecated entries.
• Moved Easy NPC wand to existing core item tab instead of creating a new one.
• Added cat pose support for different model parts (except tail).
• Improved EasyNPCWand glowing effect performance by disabling it when not needed.
• Improved custom entity detection by excluding non-living entities like displays, makers, throwns and spawners.
• Improved cat variant handling.

6.1.1

• Fixed #615 by checking if item is equipped in one of the hands.
• Fixed #612 by re-validating entity types.
• Fixed #610 by force sync of hat and head layers for specific models.
• Fixed orc textures.
• Fixed cat variant handling for 1.21.5.
• Fixed player render by adjusting render state skin field.
• Fixed cat renderer by adjusting render state texture field.
• Fixed position, scaling and rotation preview.
• Fixed Fairy model.
• Improved custom model support and performance, by moving related logic into to client side only.
• Improved caching of player to UUID mappings for player skins.
• Limited change model commands and logic to Doppler NPCs only.
• Added renderEntityRaw method to render NPC as-it-is.

6.1.0 ✨

This is a major release. Please back up your worlds and NPC data before updating. This version contains many improvements, optimizations, and internal changes that are not fully compatible with earlier releases.

⚠️ Breaking changes

• Existing NPCs and their configuration data from versions before 6.1.0 may not load correctly or may require manual adjustments.
• Internal data formats and some behaviors have been refactored to support new use-cases.

🧩 New modular structure

Easy NPC is now split into three separate mods:

• Easy NPC – Bundle that includes both Core and Configuration UI for a plug‑and‑play experience.
• Easy NPC: Core – Lightweight runtime and logic for NPCs, with minimal dependencies. Intended for servers, modpacks, and developers.
• Easy NPC: Configuration UI – Standalone configuration interface for creating and editing NPCs. Can be installed on clients that need the UI.

🎯 Why this change?

• Allows servers and modpacks to ship only the Core mod on the server side for a leaner setup.
• Reduces memory usage and load times when the UI is not required everywhere.
• Makes development and testing faster by separating UI and core logic.