Easy NPC 的变更日志（1.20.1）

注意

此变更日志包含总结的更改。 有关完整的变更日志，请转至[GitHub 历史记录][history]。

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

4.4.0

• 修复 #159：添加了额外的标签，并支持模组弓和弩物品。
• 修复 #158：通过将特定的日志消息移动到调试级别。
• 修复 #155：如果所有者已更改，则自动更新跟随所有者的目标。
• 修复 #94：为非扩展原版弓或弩物品的枪支添加了基本支持。
• 修复 #72：为 Armour's Workshop 魔杖添加了额外的所有者目标和检查。
• 添加了自定义模型的实验性模型覆盖支持 通过 /easy_npc render set <npc-uuid> <entity_type>。
• 添加了自己的同步实体数据处理程序，以提高性能并减少网络流量。

4.3.3

• 为所有 NPC 添加了基本的交易声音。
• 修复 #145：通过引用商人实例而不是实体实例。

4.3.1

• 修复了 Illager 的头部和腿部动画。
• 修复 #138：添加了额外的调试信息。
• 修复 #135：在打开新的交易屏幕之前，添加了检查 NPC 是否已经在交易，如果是则通知玩家。
• 修复 #136：在使用爆炸声音之前，添加了额外的备用检查以处理缺失的声音。
• 修复 #137：为所有模型校正了物品臂的位置。
• 为大多数 NPC 添加了手持物品渲染支持，即使是鸡和其他动物。 ;)
• 通过根据模型类型跳过不可见部分的渲染，改进了 NPC 模型和 NPC 渲染器。
• 根据 NPC 的类型统一了初始移动速度。

4.3.0

• 进行了大型代码重构，以提高客户端性能并增加渲染帧率。
• 修复了属性仅在 NPC 重生后才应用的问题。
• 修复了皮肤纹理未正确应用的问题。
• 修复 #86：添加了马 NPC 模型。
• 修复 #127：添加了狼 NPC 模型。
• 为自定义声音添加了基本支持，并使用默认声音事件。
• 为 NPC 皮肤和纹理管理器添加了额外的安全检查。
• 为了提高性能和减小数据大小，添加了额外的数据检查。
• 添加了静音属性，允许 NPC 保持静音且不发出任何声音。
• 改进了 NPC 模型性能、动画和对自定义模型的一般支持。
• 改进了 Orc NPC 纹理。
• 提高了大多数 Easy NPC 数据类型的类型安全性。
• 改进了皮肤管理器，以更好地处理不同的皮肤和样式。
• 优化了纹理管理器，以提高性能并减少文件访问。

4.2.0

注意：由于使用率低，已放弃对 Minecraft 1.19、1.19.1、1.19.3、1.19.4 和 1.20 的支持。 请为这些版本使用测试版 4.1.0 或以前的版本。

• 改进了 NPC 渲染器性能，并改进了对自定义模型的支持。
• 按版本进行了一般代码清理和重构。

4.1.0

• 将所有缓存、皮肤、模板和预设名称规范化为小写，并添加了额外的检查以处理不安全字符。
• 完成了 Orc 模型和纹理。
• 修复 #123：通过添加对 NPC 导出和导入的额外检查。
• 用实体标签替换了自定义标签，以提高与其他模组的兼容性。
• 优化了自定义和玩家纹理管理器。

4.0.1

• 改进了飞行 NPC 的漫步目标。
• 改进了所有 NPC 的一般导航支持。
• 修复了仙女飞行导航。
• 修复了仙女碰撞箱。
• 修复了 Orc 碰撞箱。

4.0.0

注意：在从 3.x 或更早版本更新之前，请备份您的世界 / NPC！ NPC 现在以新格式存储，旧格式与新版本不完全兼容。

• 进行了较大的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“Can be Leashed”能力，允许 NPC 被拴住。
• 添加了“Push entities”能力，以节省资源（如果未激活）并避免推动实体。
• 添加了 /easy_npc owner set <npc-uuid> <player> 命令，以更改 NPC 的所有者。
• 添加了 /easy_npc owner get <npc-uuid> 命令，以获取 NPC 的当前所有者。
• 添加了实验性的 Orc 模型，仍在开发中。
• 修复 #33 和 #86：添加了额外的 NPC 模型。
• 修复 ##95：为 NPC 名称添加了颜色支持。
• 修复 #101：分离了客户端和服务器实体数据，以提高兼容性。
• 修复 #79 和 #104：添加了目标“Random Stroll around Home”，允许 NPC 随机在其家园位置周围漫步。
• 修复了标准剑攻击挥击动画。
• 修复了标准傀儡攻击挥击动画。
• 更新了预设以匹配新格式。

3.11.0

• 添加了 /easy_npc trading open <npc-uuid> <player> 命令，以打开特定玩家的交易屏幕。
• 添加了 /easy_npc navigation set position <npc-uuid> <x> <y> <z> 命令，以设置 NPC 的位置。
• 修复 #97：添加了自动回家点和 /easy_npc navigation set home <npc-uuid> <x> <y> <z> 命令。
• 修复 #101：为 [Project MMO][project_mmo] 模组添加了更好的支持。
• 修复 #102：为 [Better Combat][better_combat] 武器添加了更好的支持。
• 改进了命令块支持。

3.10.0

• 重构了代码，以提高性能并便于维护。
• 为装备和交易配置屏幕添加了项目工具提示。
• 修复 #93：为装备的模组物品和盔甲添加了渲染支持。

3.9.0

• 为命令块和函数添加了 /easy_npc preset import 支持，并带有资源位置。
• 添加了 /easy_npc dialog open <npc-uuid> <player> <dialog> 命令，以打开特定 NPC 和玩家的对话屏幕（#75）。
• 修复 #87：即使是创意玩家和管理员，也忽略伤害。
• 修复 #85：为 NPC 生成器添加了消失范围选项。
• 修复 #84：文本格式代码应用于更多文本。
• 修复 #77：为 NPC 添加了禁用盔甲/装备渲染的选项。
• 修复 #76 和 #79：为 NPC 添加了回家位置和“MoveBackToHome”，以允许它们返回特定位置。

3.8.0

• 添加了 NPC 预设，以允许在游戏中更轻松地创建和使用 NPC 预设。
• 添加了 NPC 生成器，以允许生成具有特定设置和 NPC 预设的 NPC。
• 添加了调试管理器，以最小化日志记录并允许更好的调试。
• 添加了 LivingEntityManager，它将替换旧的 EntityNPCManager。
• 在 Wiki 中添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 为 NPC 添加了调整光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 MoveActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

注意：在从 6.x 或更早版本更新之前，请备份您的世界 / NPC！ 此更新包括许多更改和新功能，即使我尝试支持所有以前的数据，也可能有些与旧版本不兼容。

• 为了更好的 [Armourer's Workshop][armourers_workshop] 兼容性和其他模组支持，添加了透明的“None”皮肤选项。
• 修复了高级和自定义姿势模型渲染的问题。
• 修复了在配置屏幕中自动选择正确对话类型的问题。
• 优化了模型数据，以提高性能并减小数据大小。
• 完成了 EasyNPC 的 Wiki 文档，涵盖所有功能。

3.7.2

• 添加了 Easy NPC 位置工具，以更轻松地定位 NPC。
• 为模组集成添加了额外的 Easy NPC 生成蛋和实体类型。
• 为具有自定义模型、姿势和缩放的 NPC 修复了边界框。
• 修复了截断对话按钮文本的问题。

3.7.1

• 修复了新对话文本编辑器的对话编辑器 UI 问题。

3.7.0

• 限制了对 NPC 的编辑行为，以允许更多的用例，例如：
  • 用户在潜行并点击 NPC（仅在创造模式下）
  • 用户持有 NPC 魔杖并点击 NPC（所有模式）
• 添加了通过鼠标滚轮和箭头键调整滑块的可能性，以提高可用性。
• 添加了对话文本编辑器，以允许为同一对话添加多个对话文本变体。
• 添加了“can_use_nether_portal”属性，以允许 NPC 使用下界传送门或不使用。
• 添加了对 @initator 与 onHurt 和 onDeath 事件的支持。
• 添加了对 [Armourer's Workshop][armourers_workshop] 模组的支持。感谢 @SAGESSE-CN。
• 添加了在高级姿势编辑器中禁用模型部分的可能性。
• 分离了玩家皮肤和远程 URL 皮肤屏幕，以提高可用性。
• 修复了在某些情况下头部和身体旋转显示不正确的问题。
• 进行了代码优化和清理。

3.6.1

• 较小的错误修复和改进。

2023.11.22

• 为弓、弩和剑添加了攻击动画。
• 为测试添加了庆祝、跳舞、施法等额外动画。
• 添加了弩攻击目标。
• 添加了弓攻击目标。
• 添加了缺失的翻译。
• 改进了基础属性屏幕的可用性。
• 改进了近战攻击目标。
• 修复了较小的问题。

2023.11.20

• 为健康、攻击、盔甲、击退抗性、移动速度等添加了基础属性屏幕。
• 为一些屏幕添加了缺失的翻译。
• 修复了 UI 和对话框的较小问题。
• 改进了皮肤选择的可用性。

2023.11.18

• 添加了攻击和跟随目标。
• 在 NPC 卡住或出现故障时添加了重生按钮。
• 改进了目标验证和处理。
• 优化了 NBT 数据，以跳过默认值，提高性能并减小数据大小。

2023.11.05（NPC 焕发生机更新）

注意：在更新到此版本之前，请备份您的世界！ 此更新包括许多更改和新功能，即使我尝试支持所有以前的数据，也可能有些与旧版本不兼容。

• 添加了属性配置，如可以开门、可以关门、可以通过门、可以被伤害、可以被推动等。
• 添加了目标配置，如跟随所有者、跟随玩家、跟随实体、绕着……漫步等。
• 添加了用于更复杂对话的自定义对话框配置。
• 添加了自定义动作事件 on_hurt、on_death 和 on_button_click。
• 添加了铁傀儡模型。
• 重构了对话系统，以支持更复杂的对话。
• 重构了动作系统，以支持更复杂的动作。
• 重构了动作事件系统，以支持即将到来的事件。
• 重构了 NPC 网络数据，仅向客户端发送相关数据。
• 修复了导入文件名包含大写字母的问题。
• 修复了自定义姿势的动画问题。
• 修复了与资源包（如 Stoneborn、Mythic、Creator Pack 等）的兼容性问题。
• 改进了与其他模组的兼容性。

2023.10.24

• 为 NPC 添加了具有多个物品和价格的高级交易配置。
• 为高级和基本交易配置添加了自动重置。
• 添加了打开交易屏幕和重置交易物品的命令。
• 添加了带有交易选项的骷髅商人预设示例。
• 改进了基本交易配置。
• 修复了导入遗留预设的问题。
• 修复了高级和自定义姿势配置的问题。

2023.10.10

• 重构了 UI 和配置系统，以更轻松地支持即将到来的功能。
• 为 NPC 添加了基本（通过 UI）和自定义（通过 NBT）交易配置。
• 修复了自定义模型渲染的问题。

2023.10.06

• 重构了模型和渲染系统，以提高性能并更轻松地支持自定义模型。
• 重构了网络协议，以提高性能并适应 1.20.2 的更改。
• 重构了数据序列化（NBT），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了“freefall”位置选项，允许 NPC 掉落而不是在空中漂浮。
• 修复了远程皮肤支持，以避免皮肤下载失败。

2023.09.03

• 添加了新的 /easy_npc preset import_new <ResourceLocation> <x> <y> <z> 和 /easy_npc preset import_new <ResourceLocation> <x> <y> <z> <UUID> 命令，以允许多次导入单个预设。
• 通过将块位置和其他附加信息传递给动作，改进了动作处理。
• 改进了预设导入，以允许在特定位置导入 NPC，例如 /easy_npc preset import <ResourceLocation> <x> <y> <z>。

2023.07.09

• 添加了针对距离 NPC 16、8、4 和 1 块的新距离动作。
• 修复了允许空动作重置动作的问题。

2023.06.24

• 将代码重构为 1.20.1-47.0.19
• 将代码重构为 1.20-46.0.14

2023.05.29

• 添加了支持旋转、位置和可见性的自定义姿势编辑器，用于模型部分。
• 为自定义姿势添加了更好的模型动画支持。
• 添加了更易于编辑和更复杂数据类型的更好 NBT 格式。
• 为默认不支持此功能的模型添加了蹲伏姿势。
• 改进了 NPC 的导入和导出功能。
• 改进了文档并添加了更多示例。
• 清理了死亡代码，以提高性能。

2023.05.20

• 添加了通过本地文件进行 NPC 的自定义导出和导入功能，以更轻松地共享 NPC。
• 添加了通过世界文件进行 NPC 的世界导出和导入功能，以更轻松地打包 NPC。
• 为一些常见 NPC 添加了默认预设。
• 添加了基本的骑士皮肤。
• 改进了 UI 和对话框的可用性。
• 改进了日志记录和错误处理。
• 改进了文档并添加了更多示例。

2023.04.10

• 修复了自定义纹理皮肤的问题。
• 改进了自定义纹理屏幕的可用性。

2023.03.24

• 添加了基本权限系统的配置，以控制特定选项的使用。
• 为普通玩家添加了使用 Easy NPC 的有限选项的支持。
• 改进了菜单处理和总体性能。

2023.03.19

• 添加了新的僵尸和僵尸村民模型。
• 为地图制作者添加了单个纹理皮肤的自定义纹理支持。
• 添加了以玩家身份执行命令的可能性。
• 修复了自定义模型的锁定旋转问题，通过重置旋转来解决。
• 修复了使用无效数字进行位置设置时的崩溃问题。
• 修复了不可见 NPC 的问题。
• 改进了文档并添加了更多示例。

2023.03.18

• 为 1.19.4-45.0.9 重构了代码。
• 添加了对自定义模型旋转和锁定旋转的支持。
• 添加了禁用对话框的支持。
• 改进了网络协议，以支持更复杂的数据类型。
• 改进了 NPC 魔杖，以便更轻松地选择旋转和缩放的 NPC。
• 重构了实体数据，以便更易于维护。
• 将文档移动到单独的 Wiki。

2023.03.11

• 添加了支持自定义姿势，允许旋转头部、身体、手臂和腿部。

2023.03.05

• 添加了无需直接瞄准即可选择和配置 NPC 的 Easy NPC 魔杖。
• 添加了用于更轻松定位 NPC 的位置屏幕。

2023.03.04

• 为 1.19.3-44.1.21 重构了代码。感谢 @Narref95 的基础工作。
• **重大更改：添加了自定义数据序列化，以