Changelog for Easy NPC (1.20.1)

Note

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

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

6.10.0

• 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.

... [内容过长已截断]