易用NPC：核心 (1.21.1) 更新日志

注意

此更新日志包含简要的更改摘要。 如需完整更新日志，请访问 GitHub 历史记录。

注意：请在更新到新版本之前始终备份您的世界/NPC！ 有关更多信息，请查看 升级指南。

6.8.0（添加API支持）

• 通过添加警告信息和额外检查修复了无效网络数据包的问题 #667。
• 修复了马生成蛋模型。
• 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿势支持。
• 添加了NPC基础类以更好地支持API。
• 添加了NPC原始类以支持高级API。
• 添加了细长型和恶魂型NPC。
• 添加了自定义模型API以便与其他模组和自定义模型更轻松地集成。
• 重构了内部数据处理和注册，以提高可维护性和未来的改进。

6.7.1

• 通过添加额外的客户端检查修复了原版bug #657 和 #656。

6.7.0

• 通过在setupAnim方法中实现狼腿动画修复了 #650。
• 通过修复canBeHitByProjectiles翻译修复了 #648。
• 通过添加allowBypassInvulnerability配置选项来允许/禁止绕过NPC的无敌状态修复了 #645。
• 修复了删除按钮在宽度较小时仍显示标签的问题。
• 修复了上下按钮在某些情况下位置不正确的问题。
• 修复了对话和配置UI中显示名称标签的问题。
• 修复了距离动作问题，多个动作未能正确触发。
• 修复了NPC预设的问题。
• 修复了猫NPC和狼NPC所有者数据不同步的问题。
• 添加了预设浏览器，以便更轻松地选择常见的NPC预设。
• 添加了预设 .snbt（文本）导出和导入功能，以便共享NPC预设。
• 重构了现有的NPC预设以使用新的 .snbt 格式。
• 重构了生成系统，以使用新的预设格式，从而提高可维护性和未来的改进。

6.6.2

• 通过重新设计缩放系统修复了 #643。
• 修复了重启/重载后缩放未正确更新碰撞箱和名称标签位置的问题。
• 添加了MID和鼠标悬停名称标签可见性模式，以更精细地控制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。
• 修复了kill命令对NPC不起作用的问题。
• 修复了纹理重载保护阻止缓存重载的问题。
• 修复了远程图像验证器中的WebP验证错误（缺少返回语句）。
• 重构了纹理处理逻辑，以提高可维护性和未来的改进。
• 添加了基于时间的重载保护（60秒），以替换永久阻塞机制。
• 添加了纹理处理的额外单元测试。
• 改进了Gradle构建任务。

6.5.0

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

6.4.1

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

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

• 修复了容器和菜单同步问题，缺少关闭容器的数据包。
• 修复了某些情况下关闭按钮不起作用的问题。
• 修复了屏幕切换时鼠标光标跳跃的问题。
• 修复了翻译文件并移除了重复和废弃的条目。
• 将易用NPC魔杖移到现有核心物品标签中，而不是创建一个新的。
• 添加了猫的不同模型部分（尾巴除外）的姿态支持。
• 通过在不需要时禁用效果来改进易用NPC魔杖发光效果性能。
• 通过排除非生物实体（如展示物、标记物、投掷物和生成器）来改进自定义实体检测。
• 改进了猫变种处理。

6.1.1

• 通过重新验证实体类型修复了 #612。
• 通过强制同步特定模型的帽子和头部层修复了 #610。
• 修复了兽人纹理。
• 通过将相关逻辑移动到客户端侧来改进自定义模型支持和性能。
• 改进了玩家到UUID映射的缓存，以支持玩家皮肤。
• 将改变模型的命令和逻辑限制为仅Doppler NPC。

6.1.0 ✨

这是一个重大版本。请在更新前备份您的世界和NPC数据。 此版本包含许多改进、优化和内部更改，与早期版本不完全兼容。

⚠️ 破坏性更改

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

🧩 新的模块化结构

易用NPC现在分为三个独立的模组：

• 易用NPC – 包含核心和配置UI的捆绑包，提供即插即用体验。
• 易用NPC：核心 – 轻量级运行时和NPC逻辑，依赖最少。适用于服务器、模组包和开发者。
• 易用NPC：配置UI – 独立的配置界面，用于创建和编辑NPC。可以安装在需要UI的客户端上。

🎯 为什么要进行这些更改？

• 允许服务器和模组包仅在服务器端部署核心模组，以实现更精简的设置。
• 当不需要UI时，减少内存使用和加载时间。
• 通过分离UI和核心逻辑，加快开发和测试速度。