Easy NPC (1.20.1) 更新日志

注意

本更新日志仅包含摘要性变更。 完整更新日志请前往 GitHub 历史记录。

注意：升级新版本前，请务必备份您的世界/NPC数据！ 更多信息请参阅升级指南。

6.8.4

• 为NPC实体数据中的所有者变更和维度变更添加同步支持。

6.8.3

• 通过强制升级网络协议版本修复 #680（版本不匹配问题）。
• 通过重置命名牌的位置、旋转和大小修复 #679。
• 通过为根部旋转添加多状态滑动功能修复 #665。
• 通过添加禁用跟随鼠标光标的选项（便于摆姿势）修复 #664。
• 通过改进对X轴和Z轴根部旋转的支持修复 #663。
• 通过添加潜行时使用NPC魔杖快速旋转功能（使根部朝向玩家）修复 #661。
• 通过在交互处理器中添加移动工具检测，修复移动工具错误触发交互的问题。
• 通过在交互处理器中添加预设物品检测，修复预设物品错误触发交互的问题。
• 通过调整边界框和眼睛高度计算，修复史莱姆与恶魂的碰撞箱及命名牌位置问题。
• 通过调整偏移值修复史莱姆与恶魂的GUI位置问题。

6.8.2

• 通过扩展 SafeMerchantData 并添加 notifyTrade 方法避免崩溃，修复 #677。
• 新增基于玩家交互与行为的NPC升级进度数据支持。
• 新增全局NPC追踪系统，便于跨世界管理与调试NPC。
• 新增 OriginalModelConfig.withVariantTexture() 选项，允许原始模型使用额外纹理。

6.8.1

• 通过使用现有预设辅助方法而非自定义方法修复 #676。

6.8.0（新增API支持）

• 通过为无效网络数据包添加警告信息与额外检查修复 #667。
• 修复马刷怪蛋模型。
• 修复悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆与恼鬼的姿势支持。
• 新增NPC基础类以增强API支持。
• 新增NPC原始类以支持高级API功能。
• 新增史莱姆与恶魂NPC类型。
• 新增自定义模型API，便于与其他模组及自定义模型集成。
• 重构内部数据处理与注册逻辑，提升可维护性并为未来改进做准备。

6.7.1

• 通过为原版漏洞添加额外客户端检查修复 #657 与 #656。

6.7.0

• 通过在 setupAnim 方法中实现狼腿动画修复 #650。
• 修复 canBeHitByProjectiles 的翻译问题。
• 通过新增 allowBypassInvulnerability 配置选项，控制是否允许绕过NPC无敌状态，修复 #645。
• 修复删除按钮在窄宽度下仍显示标签的问题。
• 修复上下按钮在某些情况下定位错误的问题。
• 修复对话框与配置界面中命名牌意外显示的问题。
• 修复距离动作中多个动作未正确触发的问题。
• 修复NPC预设相关问题。
• 修复猫与狼NPC的所有者数据未正确同步的问题。
• 新增预设浏览器，便于选择常用NPC预设。
• 新增预设 .snbt（文本）导出与导入功能，便于分享NPC预设。
• 重构现有NPC预设，改用新的 .snbt 格式。
• 重构刷怪笼系统，采用新预设格式以提升可维护性并为未来改进做准备。

6.6.2

• 通过重构缩放系统修复 #643。
• 修复重启/重载后缩放未正确更新碰撞箱与命名牌位置的问题。
• 新增 MID 与 MOUSE_OVER 命名牌可见模式，精细控制NPC名称显示。
• 新增队伍基础命名牌可见性支持，兼容原版队伍系统。

6.6.1

• 通过重构显示属性的内部数据处理修复 #638。

6.6.0

• 通过实现异步材质加载（专用线程池）修复 #634。
• 修复材质加载阻塞渲染线程导致游戏卡顿的问题。
• 通过原子操作修复材质重载保护中的竞态条件。
• 修复远程材质下载时HTTP连接的资源泄漏问题。
• 修复URL验证垃圾信息，允许多个相同纹理同时下载。
• 修复远程图片验证的异常处理，防止因无效URL导致崩溃。
• 修复NPC加载时出现的 defineId called for: 警告信息。
• 重构材质加载架构，加入多层防护与速率限制。
• 重构实体数据注册逻辑，提升可维护性。
• 将数据类转换为现代Java记录类，增强不可变性与线程安全。
• 新增线程安全的会话服务器防刷机制（使用ConcurrentHashMap）。
• 新增全面错误恢复机制，失败时自动重置冷却时间。
• 改进材质加载：采用双线程池与500ms速率限制。
• 改进异常处理：为IIOException与FileNotFoundException添加专用捕获块。

6.5.2

• 修复村民职业与工作皮肤问题。
• 通过为Gradle依赖添加缓存改进GitHub工作流。
• 优化Gradle构建时间与清理任务。

6.5.1

• 通过实现ON_KILL动作类型与事件修复 #632。
• 通过优化材质处理性能、缓存与内存占用修复 #629。
• 修复击杀命令对NPC无效的问题。
• 修复材质重载保护阻止缓存被驱逐后重新加载的问题。
• 修复远程图片验证器中的WebP验证错误（缺失return语句）。
• 重构材质处理逻辑，提升可维护性并为未来改进做准备。
• 新增基于时间的重载保护（60秒），替代永久屏蔽机制。
• 新增材质处理的额外单元测试。
• 优化Gradle构建任务。

6.5.0

• ⚠️ 移除jar-in-jar捆绑方式，提升模组兼容性与API能力。
• 通过改进剪刀实现方式修复 #627，提升与其他模组的兼容性。
• 通过修复旋转或移动模型部件时的生动动画问题修复 #625。
• 修复使用缩放模型部件时默认动画被取消的问题。
• 新增智能、默认与无三种姿势动画控制选项。

6.4.1

• 通过改进不同NPC UUID的屏幕切换逻辑修复 #626，感谢 Spawnblade 的详细调查与修复建议。

6.4.0

• 通过改进对话数据验证与错误处理修复 #626。
• 通过重构渲染数据与渲染处理修复 #623。
• 通过确保自定义数据正确保存与加载修复 #622。
• 修复打开对话动作类型，允许从其他NPC打开对话。
• 通过为ConditionDataSet与ActionDataSet添加缺失的equals与hashCode方法修复哈希问题。
• 为 #622 新增自定义数据测试物品，便于测试自定义数据。
• 改进记录类并修复潜在缺失数据问题。

6.3.0

• 重构配置界面专用组件并将其从核心模组中移除。
• 通过在发送至客户端前过滤对话数据修复对话数据问题。
• 修复对话编辑器布局问题并提升可用性。
• 修复部分对话数据字段缺失默认值的问题。
• 新增对话优先级支持，控制对话执行顺序。
• 新增对话与计分板动作的条件支持。
• 新增对话频率支持，限制对话显示频率。
• 新增支持计分板与条件的新NPC预设。
• 通过移除冗余字段改进对话按钮数据格式。

6.2.0

• 修复对话内的字符串注入问题。
• 修复动作类型缺失翻译的问题。
• 新增计分板动作类型，支持增加、减少、设置计分板数值。
• 新增 @score(...) NPC宏，在对话中显示计分板数值。
• 新增额外单元测试。
• 改进旋转按钮，添加指示器并提升可用性。

6.1.2

• 通过补充缺失的关闭容器数据包修复容器与菜单同步问题。
• 修复某些情况下关闭按钮无效的问题。
• 修复屏幕切换间鼠标光标跳动的问题。
• 修复翻译文件，移除重复与已弃用条目。
• 将Easy NPC魔杖移至现有核心物品选项卡，而非新建选项卡。
• 新增猫姿势支持（除尾巴外的不同模型部件）。
• 通过在非必要时禁用发光效果，提升EasyNPCWand发光效果性能。
• 通过排除展示物、造物主、投掷物与刷怪笼等非生物实体，改进自定义实体检测。
• 改进猫品种处理。

6.1.1

• 通过重新验证实体类型修复 #612。
• 通过强制同步特定模型的帽子与头部图层修复 #610。
• 修复兽人材质。
• 通过将相关逻辑移至仅客户端，改进自定义模型支持与性能。
• 改进玩家皮肤的玩家到UUID映射缓存。
• 限制更改模型命令与逻辑仅适用于Doppler NPC。

6.1.0 ✨

此为重大版本更新。升级前请务必备份您的世界与NPC数据。 本版本包含大量改进、优化与内部变更，与早期版本不完全兼容。

⚠️ 破坏性变更

• 6.1.0之前版本的现有NPC及其配置数据可能无法正确加载，或需手动调整。
• 为支持新用例，内部数据格式与部分行为已重构。

🧩 新模块化结构

Easy NPC现拆分为三个独立模组：

• Easy NPC – 包含核心与配置界面的捆绑包，提供即插即用体验。
• Easy NPC: Core – 轻量级NPC运行时与逻辑，依赖极少。适用于服务器、整合包与开发者。
• Easy NPC: Configuration UI – 用于创建与编辑NPC的独立配置界面。可安装于需要UI的客户端。

🎯 为何如此变更？

• 允许服务器与整合包仅在服务端部署核心模组，实现更精简配置。
• 在无需UI时减少内存占用与加载时间。
• 通过分离UI与核心逻辑，加速开发与测试。