Download File

# Changelog for Easy NPC: Core (1.21.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.11.1 - Fixed #710 by improving backward-compatible parsing for recoverable trade data. ### 6.11.0 - Fixed #703 rendering issue with new custom layer system and hand renderings. - Fixed #701 by adding additional safeguards and logging for invalid trading offers. - Fixed smart animation not working properly with modified head position. - Fixed head tracking by moving player detection back to server side-only. - Fixed CustomLookAtPlayerGoal to better handle edge cases and reduce jitter. - Fixed issue with Doppler NPCs keeping their hand inventory. - Improved PoseManager logging message. - Updated logo with a new design. ### 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 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 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 #612 by re-validating entity types. - Fixed #610 by force sync of hat and head layers for specific models. - Fixed orc textures. - 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. ### 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. [history]: https://github.com/MarkusBordihn/BOs-Easy-NPC/commits/ [upgrade_guide]: https://github.com/MarkusBordihn/BOs-Easy-NPC/wiki/Upgrading