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 的翻译问题（#648）。
• 通过添加 allowBypassInvulnerability 配置选项，允许/禁止绕过 NPC 的无敌效果，修复 #645。
• 修复删除按钮在宽度较小时仍显示标签的问题。
• 修复上下按钮在某些情况下位置不正确的问题。
• 修复对话框与配置 GUI 中名称标签意外显示的问题。
• 修复距离动作触发多个动作时未能正确执行的问题。
• 修复 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。
• 新增全面的错误恢复机制，在失败时自动重置冷却时间。
• 改进材质加载，采用 2 线程池与 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 的界面切换逻辑，感谢 Spawnblade 提供详细调查与修复建议（#626）。

6.4.0

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

6.3.0

• 重构配置 UI 专用组件并将其从核心模组中移除。
• 通过在发送至客户端前过滤对话数据修复对话数据问题。
• 修复对话编辑器布局问题并提升可用性。
• 修复部分对话数据字段缺失默认值的问题。
• 新增对话优先级支持，控制对话执行顺序。
• 新增对话与计分板动作的条件支持。
• 新增对话频率支持，限制对话显示频率。
• 新增支持计分板与条件的新 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 – 包含核心与配置 UI 的捆绑包，提供即插即用体验。
• Easy NPC: Core – 轻量级 NPC 运行时与逻辑，依赖极少，适用于服务器、整合包与开发者。
• Easy NPC: Configuration UI – 独立配置界面，用于创建与编辑 NPC，可安装于需要 UI 的客户端。

🎯 为何如此变更？

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