Easy NPC（1.19.2）的变更日志

注意

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

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

4.4.0

• 修复 #159：添加了额外的标签，并支持模组化的弓和弩物品。
• 修复 #158：通过将特定的日志消息移动到调试级别。
• 修复 #155：如果所有者已更改，则自动更新跟随所有者的目标。
• 修复 #94：为未扩展原版弓或弩物品的枪支添加了基本支持。
• 修复 #72：为 Armour's Workshop Wand 添加了额外的所有者目标和检查。
• 为自定义模型添加了实验性模型覆盖支持 在 /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

• 进行了大量的代码重构，以提高客户端性能，增加渲染 fps。
• 修复了属性仅在 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 的支持。 请对这些版本使用 beta 版本 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。
• 在维基上添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 添加了调整 NPC 光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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 使用地狱门或不使用。
• 为“onHurt”和“onDeath”事件添加了对“@initator”的支持。
• 为 [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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，以允许 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.06.09

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

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

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

2023.03.11

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

2023.03.05

• 添加了 Easy NPC 魔杖，以在不直接瞄准它们的情况下选择和配置 NPC。
• 添加了位置屏幕，以更轻松地定位 NPC。

2023.03.04

• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 使用自定义数据序列化改进了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止 NPC 被意外拾取。
• 修复了 Allay 缩放渲染。

Easy NPC（1.18.2）的变更日志

注意

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

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

4.4.0

• 修复 #159：添加了额外的标签，并支持模组化的弓和弩物品。
• 修复 #158：通过将特定的日志消息移动到调试级别。
• 修复 #155：如果所有者已更改，则自动更新跟随所有者的目标。
• 修复 #94：为未扩展原版弓或弩物品的枪支添加了基本支持。
• 修复 #72：为 Armour's Workshop Wand 添加了额外的所有者目标和检查。
• 为自定义模型添加了实验性模型覆盖支持 在 /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 的类型统一了所有 NPC 的初始移动速度。

4.3.0

• 进行了大型代码重构，以提高客户端性能，增加渲染 fps。
• 修复了属性仅在 NPC 重生后才应用的问题。
• 修复了皮肤纹理未正确应用的问题。
• 修复 #86：添加了 Horse NPC 模型。
• 修复 #127：添加了 Wolf 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 的支持。 对于这些版本，请使用 beta 版本 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。
• 在维基上添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 为 NPC 添加了调整光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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。
• 添加了 Iron Golem 模型。
• 重构了对话系统，以支持更复杂的对话。
• 重构了动作系统，以支持更复杂的动作。
• 重构了动作事件系统，以支持即将到来的事件。
• 重构了 NPC 网络数据，仅向客户端发送相关数据。
• 修复了导入文件名包含大写字母的问题。
• 修复了自定义姿势的动画问题。
• 修复了与资源包（如 Stoneborn、Mythic、Creator Pack 等）的兼容性问题。
• 改进了与其他模组的兼容性。

2023.10.24

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

2023.10.10

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

2023.10.06

• 重构了模型和渲染系统，以提高性能并更轻松地支持自定义模型。
• 重构了网络协议，以适应 1.20.2 的更改并提高性能。
• 重构了数据序列化（NBT），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，允许 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.06.09

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

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

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

2023.03.18

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

2023.03.11

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

2023.03.05

• 添加了 Easy NPC 魔杖，以在不直接瞄准的情况下选择和配置 NPC。
• 添加了位置屏幕，以更轻松地定位 NPC。

2023.03.04

• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 使用自定义数据序列化改进了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止不需要的 NPC 拾取。
• 改进了文档并添加了更多示例。

Easy NPC（1.18.2）的变更日志

注意

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

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

4.3.3

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

4.3.1

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

4.3.0

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

4.2.0

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

• 改进了 NPC 渲染器性能，并改进了对自定义模型的支持。
• 每次发布时进行常规代码清理和重构。

4.1.0

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

4.0.1

• 改进了飞行 NPC 的漫步目标。
• 改进了所有 NPC 的通用导航支持。
• 修复了仙女飞行导航。
• 修复了仙女碰撞箱。
• 修复了兽人碰撞箱。

4.0.0

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

• 进行了更大规模的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“可以拴住”的能力，以允许 NPC 被拴住。
• 添加了“推动实体”的能力，以节省资源（如果已停用）并避免推动实体。
• 添加了“/easy_npc owner set <npc-uuid> <player>”命令，以更改 NPC 的所有者。
• 添加了“/easy_npc owner get <npc-uuid>”命令，以获取 NPC 的当前所有者。
• 添加了实验性的兽人模型，仍在开发中。
• 修复了 #33 和 #86：添加了额外的 NPC 模型。
• 修复了 ##95：为 NPC 名称添加了颜色支持。
• 修复了 #101：将客户端和服务器实体数据分离，以提高兼容性。
• 修复了 #79 和 #104：添加了目标“在家周围随机漫步”，以允许 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。
• 在维基上添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 为 NPC 添加了调整光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，以允许 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.06.09

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

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

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

2023.03.11

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

2023.03.05

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

2023.03.04

• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 通过使用自定义数据序列化，提高了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止不需要的 NPC 拾取。
• 改进了文档并添加了更多示例。

2023.02.22

• 添加了缩放配置。
• 用枚举替换了一些自由文本选项。

2023.02.20

• 添加了装备配置和相应的渲染支持。

2023.02.19

• 添加了无需任何对话框即可触发的交互动作。
• 添加了骷髅模型和远程皮肤支持。
• 统一了配置 UI 并添加了翻译键。
• 改进了是/否对话框按钮，以允许更长的文本。
• 改进了值验证和状态更新。
• 改进了自定义模型的纹理管理器。
• 删除了测试 NPC 生成蛋。

2023.02.

Easy NPC（1.20.1）的变更日志

注意

此变更日志包含汇总的更改。 要查看完整的变更日志，请转至 [GitHub 历史记录][history]。

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

4.3.2

• 为所有 NPC 添加了基本的交易声音。
• 通过添加特定的 Java 标记，可能修复了 #145 问题。

4.3.1

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

4.3.0

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

4.2.0

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

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

4.1.0

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

4.0.1

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

4.0.0

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

• 进行了更大规模的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“可以被拴住”的能力，以允许 NPC 被拴住。
• 添加了“推实体”的能力，以节省资源（如果未激活）并避免推实体。
• 添加了“/easy_npc owner set <npc-uuid> <player>”命令，以更改 NPC 的所有者。
• 添加了“/easy_npc owner get <npc-uuid>”命令，以获取 NPC 的当前所有者。
• 添加了实验性的兽人模型，仍在开发中。
• 修复了 #33 和 #86：添加了额外的 NPC 模型。
• 修复了 ##95：为 NPC 名称添加了颜色支持。
• 修复了 #101：将客户端和服务器实体数据分开，以提高兼容性。
• 修复了 #79 和 #104：添加了“在房屋周围随机漫步”的目标，以允许 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。
• 在维基中添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 添加了调整 NPC 光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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 使用下界传送门或不使用。
• 添加了对 [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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，以允许 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

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

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

• 添加了 Easy NPC 魔杖，以在不直接瞄准的情况下选择和配置 NPC。
• 添加了位置屏幕，以更轻松地定位 NPC。

2023.03.04

• 将代码重构为 1.19.3-44.1.21。感谢 @Narref95 提供的基础工作。
• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 通过使用自定义数据序列化，提高了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止不需要的 NPC 拾取。
• 修复了 Allay 缩放渲染。
• 改进了文档并添加了更多示例。

2023.02.22

• 添加了缩放配置。
• 用枚举替换了一些自由文本选项。

2023.02.20

Easy NPC（1.20.1）的变更日志

注意

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

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

4.3.2

• 为所有 NPC 添加了基本的交易声音。
• 通过添加特定的 Java 标记，可能修复了 #145。

4.3.1

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

4.3.0

• 进行了大型代码重构，以提高客户端性能并增加渲染 fps。
• 修复了属性仅在 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 的支持。 对于这些版本，请使用 beta 版本 4.1.0 或以前的版本。

• 改进了 NPC 渲染器性能，并改进了对自定义模型的支持。
• 每次发布时进行常规代码清理和重构。

4.1.0

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

4.0.1

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

4.0.0

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

• 进行了更大的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“可以拴住”的能力，以允许 NPC 被拴住。
• 添加了“推实体”的能力，以节省资源（如果未激活）并避免推实体。
• 添加了“/easy_npc owner set <npc-uuid> <player>”命令，以更改 NPC 的所有者。
• 添加了“/easy_npc owner get <npc-uuid>”命令，以获取 NPC 的当前所有者。
• 添加了实验性的 Orc 模型，仍在开发中。
• 修复了 #33 和 #86：添加了额外的 NPC 模型。
• 修复了 ##95：为 NPC 名称添加了颜色支持。
• 修复了 #101：将客户端和服务器实体数据分开，以提高兼容性。
• 修复了 #79 和 #104：添加了“随机在家周围漫步”的目标，以允许 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。
• 在维基上添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 添加了调整 NPC 光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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 使用地狱门或不使用。
• 添加了对 [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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了“自由落体”位置选项，以允许 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

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

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

• 添加了 Easy NPC 魔杖，以在不直接瞄准 NPC 的情况下选择和配置 NPC。
• 添加了位置屏幕，以更轻松地定位 NPC。

2023.03.04

• 将代码重构为 1.19.3-44.1.21。感谢 @Narref95 提供的基础工作。
• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 通过使用自定义数据序列化，提高了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止不需要的 NPC 拾取。
• 修复了 Allay 比例渲染。
• 改进了文档并添加了更多示例。

2023.02.22

• 添加了缩放配置。
• 用枚举替换了一些自由文本选项。

2023.02.20

• 添加了装备配置和相应的渲染支持。

Easy NPC（1.18.2）的变更日志

注意

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

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

4.3.2

• 为所有 NPC 添加了基本的交易声音。
• 通过添加特定的 Java 标记，可能修复了 #145。

4.3.1

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

4.3.0

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

4.2.0

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

• 改进了 NPC 渲染器性能，并改进了对自定义模型的支持。
• 每次发布时进行常规代码清理和重构。

4.1.0

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

4.0.1

• 改进了飞行 NPC 的漫步目标。
• 改进了所有 NPC 的通用导航支持。
• 修复了仙女飞行导航。
• 修复了仙女碰撞箱。
• 修复了兽人碰撞箱。

4.0.0

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

• 进行了更大规模的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“可以拴绳”功能，允许 NPC 被拴绳。
• 添加了“推动实体”功能，以节省资源（如果未激活）并避免推动实体。
• 添加了“/easy_npc owner set <npc-uuid> <player>”命令，以更改 NPC 的所有者。
• 添加了“/easy_npc owner get <npc-uuid>”命令，以获取 NPC 的当前所有者。
• 添加了实验性的兽人模型，仍在开发中。
• 修复了 #33 和 #86：添加了额外的 NPC 模型。
• 修复了 ##95：为 NPC 名称添加了颜色支持。
• 修复了 #101：将客户端和服务器实体数据分离，以提高兼容性。
• 修复了 #79 和 #104：添加了“随机在家周围漫步”目标，允许 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。
• 在维基上添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 添加了调整 NPC 光照水平的可能性。#45 和 #67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，允许 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.06.09

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

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

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

2023.03.11

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

2023.03.05

• 添加了 Easy NPC 魔杖，以便在不直接瞄准的情况下选择和配置 NPC。
• 添加了位置屏幕，以便更轻松地定位 NPC。

2023.03.04

• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 通过使用自定义数据序列化，提高了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止不必要的 NPC 拾取。
• 改进了文档并添加了更多示例。

2023.02.22

• 添加了缩放配置。
• 用枚举替换了一些自由文本选项。

2023.02.20

• 添加了装备配置和相应的渲染支持。

2023.02.19

• 添加了交互动作，无需任何对话框即可触发。
• 添加了骨架模型和远程皮肤支持。
• 统一了配置 UI，并添加了翻译键。
• 改进了是/否对话框按钮，以允许更长的文本。
• 改进了值验证和状态更新。
• 改进了自定义模型的纹理管理器。
• 删除了测试 NPC 生成蛋。

2

Easy NPC（1.20.1）的变更日志

注意

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

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

4.3.1

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

4.3.0

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

4.2.0

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

• 改进了 NPC 渲染器性能，并改进了对自定义模型的支持。
• 每次发布时进行常规代码清理和重构。

4.1.0

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

4.0.1

• 改进了飞行 NPC 的漫步目标。
• 改进了所有 NPC 的通用导航支持。
• 修复了仙女飞行导航。
• 修复了仙女碰撞箱。
• 修复了兽人碰撞箱。

4.0.0

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

• 进行了更大规模的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“可拴系”能力，允许 NPC 被拴系。
• 添加了“推实体”能力，以节省资源（如果已停用）并避免推实体。
• 添加了“/easy_npc owner set <npc-uuid> <player>”命令，以更改 NPC 的所有者。
• 添加了“/easy_npc owner get <npc-uuid>”命令，以获取 NPC 的当前所有者。
• 添加了实验性兽人模型，仍在开发中。
• 修复了#33 和#86：添加了额外的 NPC 模型。
• 修复了##95：为 NPC 名称添加了颜色支持。
• 修复了#101：将客户端和服务器实体数据分开，以提高兼容性。
• 修复了#79 和#104：添加了“随机在家周围漫步”目标，以允许 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。
• 在维基上添加了 Debugging.md。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 添加了调整 NPC 光照水平的可能性。#45 和#67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，允许 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

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

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。
• 重构了实体数据，以便更易于维护。
• 将文档移动到单独的维基。

2023.03.11

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

2023.03.05

• 添加了 Easy NPC 魔杖，以在不直接瞄准的情况下选择和配置 NPC。
• 添加了位置屏幕，以便更轻松地定位 NPC。

2023.03.04

• 将代码重构为 1.19.3-44.1.21。感谢 @Narref95 提供的基础工作。
• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 通过使用自定义数据序列化，提高了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止 NPC 的意外拾取。
• 修复了 Allay 缩放渲染。
• 改进了文档并添加了更多示例。

2023.02.22

• 添加了缩放配置。
• 用枚举替换了一些自由文本选项。

2023.02.20

• 添加了装备配置和相应的渲染支持。

2023.02.19

• 添加了无需任何对话框即可触发的交互动作。
• 添加了骷髅模型和远程皮肤支持。
• 统一

Easy NPC（1.18.2）的变更日志

注意

此变更日志包含汇总的更改。 要查看完整的变更日志，请转至[GitHub 历史记录][history]。

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

4.3.1

• 修复了掠夺者头部和腿部动画。
• 修复了#138：添加了额外的调试信息。
• 修复了#135：在打开新的交易屏幕之前，添加了检查 NPC 是否已经在交易，并向玩家通知这一点。
• 修复了#136：在使用爆炸声音之前，添加了对缺失声音的额外回退检查。
• 修复了#137：纠正了所有模型的物品手臂位置。
• 为大多数 NPC 添加了手持物品渲染支持，甚至包括鸡和其他。 ;)
• 通过根据模型类型跳过不可见部分的渲染，改进了 NPC 模型和 NPC 渲染器。
• 根据 NPC 的类型统一了所有 NPC 的初始移动速度。

4.3.0

• 进行了大型代码重构，以提高客户端性能并增加渲染 fps。
• 修复了属性仅在 NPC 重生后才应用的问题。
• 修复了皮肤纹理未正确应用的问题。
• 修复了#86：添加了马 NPC 模型。
• 修复了#127：添加了狼 NPC 模型。
• 添加了对带有默认声音事件的自定义声音的基本支持。
• 为 NPC 皮肤和纹理管理器添加了额外的安全检查。
• 为了更好的性能和更小的数据大小，添加了额外的数据检查。
• 添加了静音属性，允许 NPC 保持静音，不发出任何声音。
• 改进了 NPC 模型性能、动画和对自定义模型的一般支持。
• 改进了兽人 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

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

4.0.1

• 改进了飞行 NPC 的漫步目标。
• 改进了所有 NPC 的通用导航支持。
• 修复了仙女飞行导航。
• 修复了仙女碰撞箱。
• 修复了兽人碰撞箱。

4.0.0

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

• 进行了更大规模的代码重构，以改善代码库。
• 添加了对 Fabric 的实验性支持。
• 添加了“可以被拴住”的能力，以允许 NPC 被拴住。
• 添加了“推实体”的能力，以节省资源（如果已停用）并避免推实体。
• 添加了“/easy_npc owner set <npc-uuid> <player>”命令，以更改 NPC 的所有者。
• 添加了“/easy_npc owner get <npc-uuid>”命令，以获取 NPC 的当前所有者。
• 添加了实验性的兽人模型，仍在开发中。
• 修复了#33 和#86：添加了额外的 NPC 模型。
• 修复了##95：为 NPC 名称添加了颜色支持。
• 修复了#101：将客户端和服务器实体数据分开，以提高兼容性。
• 修复了#79 和#104：添加了目标“在房屋周围随机漫步”，以允许 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。
• 将 Debugging.md 添加到维基。
• 为对话文本添加了文本颜色和文本样式格式。#80
• 添加了调整 NPC 光照水平的可能性。#45 和#67
• 将简单对话和是/否对话的文本长度增加到 512 个字符。
• 将 ActionEventData 和 DialogData 移动到通用包中，以提高性能。

3.7.3

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

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

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），以支持即将到来的功能。
• 添加了猫和鸡模型。
• 添加了位置“自由落体”选项，以允许 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.06.09

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

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

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

2023.03.11

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

2023.03.05

• 添加了 Easy NPC 魔杖，以在不直接瞄准它们的情况下选择和配置 NPC。
• 添加了位置屏幕，以更轻松地定位 NPC。

2023.03.04

• 重大更改：添加了自定义数据序列化，以支持更复杂的数据类型。安装前请先备份！
• 通过使用自定义数据序列化，提高了服务器和客户端处理的性能。
• 为 Easy NPC 实体添加了基本姿势支持。

2023.02.24

• 添加了基本的 CarryOn 支持，以阻止 NPC 被意外拾取。
• 改进了文档并添加了更多示例。

2023.02.22

• 添加了缩放配置。
• 用枚举替换了一些自由文本选项。

2023.02.20

• 添加了装备配置和相应的渲染支持。

2023.02.19

• 添加了无需任何对话框即可触发的交互动作。
• 添加了骷髅模型和远程皮肤支持。
• 统一了配置 UI 并添加了翻译键。
• 改进了是/否对话框按钮，以允许更长的文本。
• 改进了值验证和状态更新。
• 改进了自定义模型的纹理管理器。
• 删除了测试 NPC 生成蛋。

2023.02.16

• 添加了具有权限级别支持的动作配置。
• 添加了权限级别 1 及以上的动作调试可能性。

未指定变更日志。

没有指定变更日志。

未指定变更日志。

无

未指定变更日志。