Easy NPC 更新日志 (1.20.1)

注意

此更新日志包含变更摘要。如需查看完整更新日志，请前往 [GitHub 历史记录][history]。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 请查看[升级指南][upgrade_guide]以获取更多信息。

7.9.0

• 修复了模组化的鱼类 NPC（如 Tide 2 中的）会原地旋转而不是直立游泳的问题。
• 修复了“导航：自动”对鱼类和其他水中 NPC 使用地面移动的问题。
• 修复了“导航：自动”对护卫者、溺尸和模组化水生生物使用地面移动的问题。
• 修复了“导航：自动”忽略 NPC 的水生 Easy Model Entities 模型的问题。
• 修复了“随机游泳”目标从未移动使用水生导航的 NPC 的问题。
• 修复了游泳的 NPC 在原地抖动而不是保持其游泳倾斜度的问题。
• 修复了游泳的 NPC 在无法到达下一个路径点时永远在原地转圈的问题。
• 修复了游泳的 NPC 在看着附近的玩家时上下抽搐的问题。
• 修复了游泳的 NPC 在保持其配置的游泳深度时上下抖动的问题。
• 修复了 Tide 鱼类 NPC 的游泳倾斜度在渲染时每刻闪烁回零的问题。
• 修复了掉入水中的 NPC 永远无法再出来的问题。
• 修复了“不透明度”输入框太窄而无法显示 100 的值的问题。
• 修复了“移动到”动作忽略高度差异并在到达高架目标前停止的问题。
• 修复了 NPC 当时在空中时“移动到”动作从未开始的问题。
• 修复了“返回家园”在到达位于不同高度的家园前停止的问题。
• 修复了 NPC 永远不会走回超过 32 格远的家园的问题。
• 修复了跟随的 NPC 在其目标不可达时每刻都搜索新路径的问题。
• 修复了带有 Easy Model Entities 模型的受损 NPC 从未闪现红色的问题。
• 更改了模组化水生 NPC 以水平游泳，原版水生生物保持其原有的倾斜度。
• 更改了“移动到”动作以行走最多 48 格，仅在此范围外进行传送。
• 更改了“移动到”动作，当 NPC 在三秒内没有进展时提前结束。
• 更改了“移动到”动作的超时以计算实际刻数，之前的运行时间是其两倍。
• 更改了“返回家园”尝试，当 NPC 没有进展时提前停止。
• 更改了新的“随机游泳”目标，使其优先级低于跟随、逃跑和攻击目标。 现有的 NPC 保留其存储的优先级，需要手动提高。
• 更改了带有 Easy Model Entities 模型的 NPC 的“不透明度”，由该模组自身应用。
• 将最低 Easy Model Entities 版本更改为 2.3.0，旧版本将禁用集成。
• 添加了“水面下深度”滑块，使游泳的 NPC 保持在该水位下。
• 添加了“地面上高度”滑块，使游泳的 NPC 保持在地面上方该高度处。
• 添加了日志条目，显示在世界保存时写入了多少个 NPC 文件以及花费了多长时间。
• 添加了警告，当写入单个 NPC 文件花费超过 250 毫秒时会在日志中显示。

7.8.1

• 修复 #827，通过使水中的鱼类 NPC 直立渲染，而不是总是侧躺在那里。
• 修复 #828，通过防止受损的 NPC 阻止世界保存，现在它会回退到默认值。
• 修复了恢复的 NPC 获取一个随每次保存而变化的随机预设 ID 的问题。
• 更改了 NPC 数据，仅在实际更改时才写入磁盘。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了已经站在目标位置的 NPC 以立即完成移动。
• 将“无”皮肤选项卡更改为“高级”，现在包含“禁用皮肤”和纹理字段。
• 添加了“移动到”动作，将 NPC 发送到位置、玩家、其主人或其家园。
• 添加了“移动到并等待”动作，仅在到达后运行后续动作。
• 为两个移动动作添加了到达半径、超时和可选传送。
• 添加了 0 到 100 的“不透明度”属性，使身体、盔甲和手持物品一起淡出。
• 添加了“设置不透明度”动作，可将 NPC 变为幽灵或完全隐藏它。
• 添加了“灯之幽魂”预设，一个在正方形路径上行走的幽灵，在每个角落有一条短线。
• 添加了 API 以访问移动动作和 NPC 的不透明度。
• 添加了“资源位置”皮肤类型，可渲染任何模组或资源包的纹理。
• 添加了“高级”皮肤选项卡，可在应用之前预览带有输入纹理的 NPC。

7.7.7

• 修复 #821，通过保持 64x64 皮肤的透明度，Fresh Moves 需要此功能来显示眼睛。之前 下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复 #818，通过也为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒都在切换其气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了未翻译的间隔名称，例如“执行限制”条件中的 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐）动画，它从未使用内置的坐姿。
• 修复了当玩家站得很近时，对话气泡被 NPC 的头部切断的问题。
• 更改了对话气泡以保持其屏幕大小，并在玩家靠近时向下或向一侧移动。
• 更改了对话气泡文本，使其比名称标签大 20%。
• 更改了带有“等待”动作的基于时间的动作集，以按顺序运行，而不是选择一个条目。
• 更改了对话文本以更晚换行，以便现有的对话框可以切换到更宽的屏幕布局。
• 更改了回退动作以跳过没有玩家的屏幕动作，就像常规动作一样。
• 将最低 Easy Model Entities 版本更改为 2.1.0，旧版本将禁用集成。
• 添加了“等待”动作，暂停事件的后续动作选定持续时间。
• 添加了“倒计时计时员”预设，一个从十倒数到零的对话气泡，以声音和火花结束。
• 在“实验性功能”复选框后添加了 Doppler NPC 的缩放和旋转。两者仅 影响接受它的实体的可见模型，从不影响碰撞箱。
• 添加了“声音”动作，在 NPC 处播放声音，具有声音类别、音量和音高。
• 将“每 5 分钟”和“每 15 分钟”添加到“执行限制”条件。
• 添加了“玩家闲置”条件，检查玩家未移动的时间。
• 添加了“不可移动”属性，使 NPC 在受到推动和击退时保持在原位。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了 API 以访问声音动作、暂停状态和玩家的闲置时间。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型插槽添加了纹理覆盖。
• 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
• 添加了 API 以访问 Easy Model NPC 的动画变体、纹理插槽和纹理。

7.6.0

• 修复了重复实体数据追踪器 ID 的不清楚的模组冲突错误。
• 修复了第三方血条在配置和对话屏幕的 NPC 预览上渲染的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本没有建议 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表在其输入字段上绘制的问题。
• 修复了动作编辑器的未翻译的“循环”、“当前之后”和“动作数据类型”标签。
• 修复了“概率”条件缺少的提示文本。
• 修复了长条件提示在编辑器屏幕中溢出而不是换行的问题。
• 修复了“消息”动作未对齐的帮助图标和文本按钮。
• 修复了无法保存对“设置姿势”、“播放动画”和“停止动画”动作的更改的问题。
• 修复了对话气泡文本距离其上边框比距离其下边框更近的问题。
• 更改了 NPC 建议，首先列出准星指向的 NPC，并且在没有权限时仅列出自己的 NPC。
• 更改了预设导出，仅存储与新 NPC 不同的部分，不包括位置或所有者。
• 更改了没有目标或动作的预设，以回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件，如“生成时”或“击杀时”，以检查其条件。那里 基于玩家的条件的动作（例如记分板或物品）不再运行。
• 更改了基于时间的动作，当主人在附近时，选择主人作为 @initiator。
• 更改了对话气泡，根据文本长度保持可见 5 到 18 秒。
• 更改了“设置姿势”动作，仅针对“自定义”姿势条目显示其输入字段。
• 在五个固定步骤上添加了基于时间的动作，从大约每 1 秒到大约每 15 分钟。
• 添加了“消息”动作，用于聊天、系统消息和对话气泡文本，无需命令。
• 为“消息”动作添加了文本变体、发送者名称、接收者和翻译键。
• 将对话气泡图形添加为 easy_npc:textures/gui/speech_bubble.png 供资源包使用。
• 添加了百分比形式的“概率”条件以及针对主人和派系的“关系”条件。
• 添加了生成、主人登录、状态变化、白天/夜晚、天气以及缺失的“交易时”事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加了基础预设，可用作父预设。
• 添加了“流浪同伴”预设，一个由基于时间的消息构建的话痨 NPC。
• 为其他模组添加了动作注册表、动作处理器、预设验证器和更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了带有名称、类型和距离的工具提示。
• 改进了 NPC 建议，无需输入即可出现，并且可以容忍一格的误差。

7.5.0

• 修复 #814，通过给每个 Cobblemon NPC 自己的动画状态，而不是每个物种一个。
• 修复 #813，通过让“返回家园”在任何距离工作，而不仅仅是在家园附近。
• 修复 #812，通过每会话检查一次玩家是否更改了皮肤。
• 修复 #810，通过接受资源包的 Cobblemon 外观，而不仅仅是“闪光”和“雌性”。
• 修复了 NPC 在重生或预设导入后失去其所有者、家园和“不受重力影响”设置的问题。
• 修复了目标保持已消失的目标，并在目标或模组消失时被关闭的问题。
• 修复了飞行 NPC（如 Allay、Vex 和 Ghast）在地面上移动而不是飞行的问题。
• 修复了对话框、按钮、预设、姿势和纹理名称包含重复项或特殊字符的问题。
• 修复了条件在专用服务器上不可编辑以及条件文本未翻译的问题。
• 修复了 Easy Model Entities NPC 不转动头部，并且其模型列表忽略 /reload 的问题。
• 将移动目标更改为固定顺序：逃跑、跟随、返回家园，然后漫游。因此， 具有多个移动目标的 NPC 的行为可能与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 移除了实验性用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“导航”和“悬停高度”设置，以在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性和“锻造守护者”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 格处添加了“远距离”以及当其所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第三方支持。

7.4.0

• 修复 #807，通过不再将 32 格内的每个同类型 NPC 拉入“自卫”战斗。
• 修复 #805，通过一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复 #804，通过在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和名称标签。
• 修复 #803，通过调整资源以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，它将日出算作夜晚，将日落算作白天。
• 修复了下界和终界的可见性，它使用主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在第一次断言时失败，这隐藏了后来的失败。
• 修复了“已驯服”马皮肤变体，它们从未显示马鞍。
• 更改了“对主人可见”和“对队伍可见”，也遵循白天、夜晚和游戏模式。
• 更改了没有“交叉双臂”的唤魔者、幻术师和卫道士变体，以保持其手臂向下。
• 添加了“保卫派系”目标，攻击任何伤害附近派系成员或玩家的人。
• 添加了系统消息，当派系成员互相战斗且派系置身事外时。
• 为灾厄村民添加了头部装备槽，以便可以移除或交换其队长旗帜。
• 为显示配置屏幕添加了白天和夜晚预览。
• 为可见性属性和派系防御添加了单元和游戏测试。
• 通过每次检查只读取一次显示属性来改进可见性检查性能。
• 通过用默认值完成旧版本的显示属性来改进它们。
• 通过在未设置时禁用“保护主人”和“保卫派系”来改进攻击目标屏幕。

7.3.0

• 通过将皮肤变体的数据作为类型化字段携带而不是解析变体名称来改进皮肤变体。
• 在共享常量上集中了 Cobblemon 模组 ID 和默认模型。
• 通过共享的 EnumUtils 助手减少重复的枚举代码，用于 get(String) 查找。
• 通过使用直接注册表键而不是扫描来优化村民职业和类型查找。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举助手添加了单元和游戏测试。

7.2.0

• 修复 #801，通过使用 NPC、对话框和动作 UUID 的组合来避免动作 跟踪和执行限制的冲突。

7.1.1

• 修复 #800，通过延迟加载实体类型。

7.1.0

• 修复 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复 #798，通过将控制台、命令和命令块视为可信的命令源。
• 修复了严重的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当几个 NPC 同时请求相同皮肤时的重复下载。
• 修复了皮肤查找在错误后失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在 后台运行。
• 添加了新的世界生成器方块，它在整个世界（所有维度）限制 NPC 预设； 现有的组生成器目前按维度计数，因此遥远的 NPC 不再阻止它。
• 通过严格的大小限制和安全的重定向处理来加强远程皮肤下载，以防止 因过大或恶意的皮肤 URL 导致崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC，按维度分组， 来改进服务器性能。

7.0.0

• 修复 #791，通过添加流浪商人 NPC 类型。
• 修复 #788，通过将 AI 安全措施扩展到史诗战斗和原始 NPC 变体（猪灵、村民、 末影人、苦力怕、劫持者和女巫）。
• 修复 #787、#531、#237 和 #184，通过添加带有 /easy_npc faction 命令的派系系统、 每 NPC 派系分配和自动记分板队伍同步。
• 修复 #787、#771 和 #572，通过添加新的 target 目标选项卡，以攻击敌对派系或 按玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复 #786，通过为 Cobblemon NPC 添加性别和闪光模型变体，可通过模型选择中的 female 或 shiny 进行搜索。
• 通过添加新的“可被派系攻击”战斗属性，修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度进行缩放，修复了超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表排序以及在派系颜色或删除更改后刷新加载的 NPC 记分板分配，修复了派系管理边缘情况。
• 通过按皮肤模型加载和清除纹理缓存而不是总是重建完整的自定义纹理缓存，修复了自定义皮肤重新加载。
• 改进了“可被玩家/怪物/派系攻击”战斗属性，使其独立于 无敌 工作，每个都为自己的攻击者群体打开一个有针对性的漏洞。
• 通过将大型处理程序拆分为更小、更集中的导入、导出和特定于功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，以创建、着色和删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的“杂项”属性选项卡，作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标目标和 Cobblemon 模型变体添加了额外的单元和游戏测试。

6.25.0

• 修复 #780，通过为远程纹理下载添加额外的缓存和优化。
• 修复 #767，通过保护属性滑块免受来自其他模组的天文数字般值的影响。
• 修复 #754，通过为带有动作和条件的 NPC 添加自定义数据物品匹配。
• 修复纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复动作条件的空 UUID 问题导致意外行为。
• 修复动作的执行限制重置。
• 添加了纹理注册队列，以避免在同一刻内多次同时下载。
• 添加了 NPC 硬币、钥匙和红色代币作为带有动作和条件的 NPC 的消耗品。
• 添加了 欢迎币商人 作为示例 NPC 预设，带有自定义硬币、钥匙和红色代币作为示例 物品以及用于动作和条件的新物品数据。
• 添加了针对来自其他模组的天文数字般值的属性的一般保护措施。
• 将回退最大生命值从 1024 增加到 4096，以允许更复杂的 NPC。
• 改进了纹理管理器并消除了重复的纹理检查和注册。

6.24.0

• 修复 #459、#775，通过添加阻止与隐形 NPC 交互的选项。
• 修复 #774 与可选的史诗战斗和 Cobblemon 实体类型映射相关的启动崩溃。
• 修复 #773，通过在基础刻期间和打开交易屏幕之前检查定时交易重置。
• 通过正确增加内部刻计数器来修复交易重置时机。
• 为 #459 添加了一天中的时间和天气条件。
• 为交易重置、刻处理和实体属性添加了额外的单元和游戏测试。
• 添加了 天空守望侦察兵 作为示例 NPC 预设，带有一天中的时间和天气条件。

6.23.0

• 修复 #772，通过调整 403 和 404 错误的纹理重试并降低日志记录。
• 修复 #770

... [内容过长已截断]

Easy NPC 更新日志 (1.20.1)

注意

此更新日志包含变更摘要。如需查看完整更新日志，请前往 [GitHub 历史记录][history]。

注意：更新到新版本前请务必备份你的世界 / NPC！ 查看[升级指南][upgrade_guide]以获取更多信息。

7.9.0

• 修复了模组鱼类 NPC（如 Tide 2 中的）旋转游动而非直立游动的问题。
• 修复了“导航：自动”对鱼类和其他水生 NPC 使用地面移动的问题。
• 修复了“导航：自动”对护卫者、溺尸和模组水生生物使用地面移动的问题。
• 修复了“导航：自动”忽略 NPC 的水生 Easy Model Entities 模型的问题。
• 修复了“随机游泳”目标从未移动使用水生导航的 NPC 的问题。
• 修复了游泳的 NPC 在原地颤抖而不是保持其游泳倾斜度的问题。
• 修复了游泳的 NPC 在无法到达下一个路径点时永远转圈的问题。
• 修复了游泳的 NPC 在看向附近的玩家时上下抽搐的问题。
• 修复了游泳的 NPC 在保持其配置的游泳深度时上下抖动的问题。
• 修复了 Tide 鱼 NPC 的游泳倾斜度在渲染时每帧闪烁回零的问题。
• 修复了掉入水中的 NPC 永远无法再出来的问题。
• 修复了“不透明度”输入框太窄而无法显示 100 的值的问题。
• 修复了“移动到”动作忽略高度差异并在到达高处的目标前停止的问题。
• 修复了 NPC 在空中时“移动到”动作从未开始的问题。
• 修复了“返回家”在到达位于不同高度的家之前停止的问题。
• 修复了 NPC 永远不会走回超过 32 格远的家的问题。
• 修复了跟随的 NPC 在其目标不可达时每刻都搜索新路径的问题。
• 修复了带有 Easy Model Entities 模型的受损 NPC 从不闪烁红色的问题。
• 更改了模组水生 NPC 以水平游泳，原版水生生物保持其以前的倾斜度。
• 更改了“移动到”动作以步行最多 48 格，并且仅在此范围之外传送。
• 更改了“移动到”动作，当 NPC 在三秒钟内没有任何进展时提前结束。
• 更改了“移动到”动作的超时以计算实际刻数，以前运行的时间是两倍。
• 更改了“返回家”尝试，当 NPC 没有任何进展时提前停止。
• 更改了新的“随机游泳”目标，其优先级低于跟随、逃跑和攻击目标。 现有的 NPC 保留其存储的优先级，需要手动提高。
• 更改了带有 Easy Model Entities 模型的 NPC 的“不透明度”，由该模组本身应用。
• 更改了最低 Easy Model Entities 版本为 2.3.0，旧版本禁用集成。
• 添加了“水面下深度”滑块，它使游泳的 NPC 保持在水面下该距离处。
• 添加了“地面上高度”滑块，它使游泳的 NPC 保持在地面之上该距离处。
• 添加了日志条目，显示在世界保存时写入了多少 NPC 文件以及花费了多长时间。
• 添加了当写入单个 NPC 文件花费超过 250 毫秒时向日志发送警告。

7.8.1

• 修复 #827，通过在水中直立渲染鱼类 NPC，而不是总是侧身扑腾。
• 修复 #828，通过防止受损的 NPC 阻止世界保存，现在它回退到默认值。
• 修复了恢复的 NPC 获取一个随每次保存而更改的随机预设 ID 的问题。
• 更改了 NPC 数据，仅在实际更改时才写入磁盘。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了已经站在其目标位置的 NPC 以立即完成移动。
• 将“无”皮肤选项卡更改为“高级”，现在包含“禁用皮肤”和纹理字段。
• 添加了“移动到”动作，它将 NPC 发送到一个位置、玩家、其所有者或其家。
• 添加了“移动到并等待”动作，它仅在到达后运行后续动作。
• 为两个移动动作添加了到达半径、超时和可选传送。
• 添加了 0 到 100 的“不透明度”属性，它使身体、盔甲和手持物品一起淡出。
• 添加了“设置不透明度”动作，它将 NPC 变成幽灵或完全隐藏它。
• 添加了“灯之幽魂”预设，一个在每个角落有一条短线的方形行走的幽灵。
• 添加了对移动动作和 NPC 不透明度的 API 访问。
• 添加了“资源位置”皮肤类型，它渲染任何模组或资源包的纹理。
• 添加了“高级”皮肤选项卡，它在应用之前使用输入的纹理预览 NPC。

7.7.7

• 修复 #821，通过保持 64x64 皮肤的透明度，Fresh Moves 需要它来显示眼睛。之前 下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复 #818，通过也为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒切换其对话气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载的问题。
• 修复了未翻译的间隔名称，如“执行限制”条件中的 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐）动画，它从未使用内置的坐姿。
• 修复了当玩家站得离 NPC 很近时，对话气泡被 NPC 的头部切断的问题。
• 更改了对话气泡以保持其屏幕大小，并在玩家靠近时向下或向侧面移动。
• 更改了对话气泡文本，使其比名称标签大 20%。
• 更改了带有“等待”动作的基于时间的动作集，以按顺序运行，而不是选择一个条目。
• 更改了对话框文本以更晚换行，以便现有对话框可以切换到更宽的屏幕布局。
• 更改了回退动作以跳过没有玩家的屏幕动作，就像常规动作一样。
• 更改了最低 Easy Model Entities 版本为 2.1.0，旧版本禁用集成。
• 添加了“等待”动作，它暂停事件的后续动作一段选定的时间。
• 添加了“倒计时计时员”预设，一个数到十并以声音和火花结束的对话气泡计数。
• 在“实验性功能”复选框后添加了 Doppler NPC 的缩放和旋转。两者 仅影响接受它的实体的可见模型，而从不影响碰撞箱。
• 添加了“声音”动作，它以声音类别、音量和音高在 NPC 处播放声音。
• 向“执行限制”条件添加了“每 5 分钟”和“每 15 分钟”。
• 添加了“玩家待机”条件，它检查玩家多久没有移动。
• 添加了“不可移动”属性，它使 NPC 在推动和击退下保持原位。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了对声音动作、暂停状态和玩家待机时间的 API 访问。
• 通过 /easy_npc render texture 为 Easy Model NPC 每个模型槽添加了纹理覆盖。
• 向“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
• 添加了对 Easy Model NPC 的动画变体、纹理槽和纹理的 API 访问。

7.6.0

• 修复了重复实体数据追踪器 ID 的不清楚的模组冲突错误。
• 修复了第三方血条在配置和对话屏幕中的 NPC 预览上渲染的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本没有建议 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表绘制在其输入字段之上。
• 修复了动作编辑器的未翻译的“循环”、“当前之后”和“动作数据类型”标签。
• 修复了“机会”条件缺少的提示文本。
• 修复了长条件提示用完编辑器屏幕而不是换行的问题。
• 修复了“消息”动作的未对齐的帮助图标和文本按钮。
• 修复了对“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
• 修复了对话气泡文本比其下边缘更靠近其上边缘的问题。
• 更改了 NPC 建议，首先列出准星 NPC，并且没有权限时仅列出自己的 NPC。
• 更改了预设导出以仅存储与新 NPC 不同的部分，没有位置或所有者。
• 更改了没有目标或动作的预设以回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件，如“生成时”或“击杀时”，以检查其条件。那里 具有基于玩家的条件的动作（例如记分板或物品）不再运行。
• 更改了基于时间的动作，以便在所有者附近时选择所有者作为 @initiator。
• 更改了对话气泡以保持可见 5 到 18 秒，具体取决于文本长度。
• 更改了“设置姿势”动作，仅针对“自定义”姿势条目显示其输入字段。
• 在五个固定步骤上添加了基于时间的动作，从每约 1 秒到每约 15 分钟。
• 添加了“消息”动作，用于聊天、系统消息和对话气泡文本，无需命令。
• 向“消息”动作添加了文本变体、发送者名称、收件人和翻译键。
• 为资源包添加了对话气泡图形，作为 easy_npc:textures/gui/speech_bubble.png。
• 添加了以百分比表示的“机会”条件和针对所有者和派系的“关系”条件。
• 添加了生成、所有者登录、状态更改、白天/黑夜、天气和缺失的“交易时”事件。
• 在 easy_npc:api/preset/base/ 下添加了每个 NPC 类型的基本预设，可用作父预设。
• 添加了“流浪同伴”预设，一个由基于时间的消息构建的健谈 NPC。
• 添加了动作注册表、动作处理程序、预设验证器以及用于模组的更丰富的事件数据。
• 向 /easy_npc 命令的每个 NPC 建议添加了带有名称、类型和距离的工具提示。
• 改进了 NPC 建议，它们无需输入即可出现，并容忍一个方块的误差。

7.5.0

• 修复 #814，通过给每个 Cobblemon NPC 自己的动画状态，而不是每个物种一个。
• 修复 #813，通过让“返回家”在任何距离工作，而不仅仅是在其家附近。
• 修复 #812，通过每会话检查一次玩家是否更改了皮肤。
• 修复 #810，通过接受资源包的 Cobblemon 方面，而不仅仅是“shiny”（闪光）和“female”（雌性）。
• 修复了 NPC 在重生或预设导入后失去其所有者、家和“无重力”设置的问题。
• 修复了目标消失时目标保持消失并被关闭的目标。
• 修复了飞行 NPC，如 Allay（悦灵）、Vex（恼鬼）和 Ghast（恶魂），在地面移动而不是飞行。
• 修复了带有重复项或特殊字符的对话框、按钮、预设、姿势和纹理名称。
• 修复了条件在专用服务器上不可编辑和未翻译的条件文本。
• 修复了 Easy Model Entities NPC 不转动头部及其模型列表忽略 /reload 的问题。
• 将移动目标更改为固定顺序：逃跑、跟随、返回家，然后闲逛。具有 多个移动目标的 NPC 可能因此表现得与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 移除了实验性用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“导航”和“悬停高度”设置，以在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性和“Forge Keeper”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 格处添加了“远距离”，以及当其所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第三方支持。

7.4.0

• 修复 #807，不再将 32 格内的每个相同类型 NPC 拉入“自卫”战斗。
• 修复 #805，通过一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复 #804，通过在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和名称标签。
• 修复 #803，通过调整资产以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，它将日出算作夜晚，日落算作白天。
• 修复了在下界和末地中的可见性，它使用了主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在其第一次断言时失败，这隐藏了后来的失败。
• 修复了“已驯服”马皮肤变体，它们从未显示马鞍。
• 更改了“对所有者可见”和“对团队可见”，也遵循白天、黑夜和游戏模式。
• 更改了没有“交叉双臂”的唤魔者、幻术师和卫道士变体，以保持其手臂放下。
• 添加了“保卫派系”目标，它攻击任何伤害附近派系成员或玩家的人。
• 添加了系统消息，当派系成员互相战斗且派系置身事外时。
• 为灾厄村民添加了头部装备槽，以便移除或交换其队长旗帜。
• 向显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单元和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过用默认值补全来改进来自旧版本的显示属性。
• 通过在未设置时禁用“保护所有者”和“保卫派系”来改进攻击目标屏幕。

7.3.0

• 通过将变体数据作为类型化字段携带而不是解析变体名称来改进皮肤变体。
• 在共享常量上集中了 Cobblemon 模组 ID 和默认模型。
• 通过共享的 EnumUtils 助手减少重复的枚举代码，用于 get(String) 查找。
• 通过使用直接注册表键而不是扫描来优化村民职业和类型查找。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举助手添加了单元和游戏测试。

7.2.0

• 修复 #801，通过使用 NPC、对话框和动作 UUID 的组合来避免动作 跟踪和执行限制的冲突。

7.1.1

• 修复 #800，通过延迟加载实体类型。

7.1.0

• 修复 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复 #798，通过将控制台、命令和命令块视为受信任的命令源。
• 修复了严重的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当几个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在 后台运行。
• 添加了新的世界生成器方块，它在整个世界（所有维度）限制 NPC 预设； 现有的组生成器目前按维度计算，因此遥远的 NPC 不再阻止它。
• 通过严格的大小限制和安全的重定向处理来加强远程皮肤下载，以防止 因过大或恶意的皮肤 URL 而崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来改进服务器性能。

7.0.0

• 修复 #791，通过添加流浪商人 NPC 类型。
• 修复 #788，通过将 AI 安全保护扩展到史诗战斗和原始 NPC 变体（猪灵、村民、 末影人、苦力怕、劫持者和女巫）。
• 修复 #787、#531、#237 和 #184，通过添加带有 /easy_npc faction 命令的派系系统、 每个 NPC 的派系分配和自动记分板团队同步。
• 修复 #787、#771 和 #572，通过添加新的 target（目标）目标选项卡，以攻击敌对派系或 通过玩家名称、团队、实体标签或 UUID 攻击特定目标。
• 修复 #786，通过为 Cobblemon NPC 添加性别和闪光模型变体，可通过模型选择中的 female 或 shiny 进行搜索。
• 通过添加新的“可被派系攻击”战斗属性来修复无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的 配置文件缩放而不是碰撞箱高度来修复超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表进行排序和 在派系颜色或删除更改后刷新加载的 NPC 记分板分配来修复派系管理边缘情况。
• 通过按皮肤模型加载和清除纹理缓存而不是总是 重建完整的自定义纹理缓存来修复自定义皮肤重新加载。
• 改进了“可被玩家/怪物/派系攻击”战斗属性，以独立于 “无敌”工作，每个都为其自己的攻击者群体打开一个针对性的漏洞。
• 通过将大型处理程序拆分为更小的、专注于 导入、导出和特定功能的组件来改进预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，以创建、着色和删除派系并管理 敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的“杂项”属性选项卡，作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标和 Cobblemon 模型变体添加了额外的单元和游戏测试。

6.25.0

• 修复 #780，通过为远程纹理下载添加额外的缓存和优化。
• 修复 #767，通过保护属性滑块免受来自其他模组的巨大值的影响。
• 修复 #754，通过为带有动作和条件的 NPC 添加自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁的问题。
• 修复了动作条件的空 UUID 导致意外行为的问题。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列，以避免在同一刻内多次同时下载。
• 添加了 NPC 硬币、钥匙和红色代币作为带有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader 作为示例 NPC 预设，带有自定义硬币、钥匙和红色代币作为示例 物品以及用于动作和条件的新物品数据。
• 添加了针对来自其他模组的巨大值的属性通用保护。
• 将回退最大生命值从 1024 增加到 4096，以允许更复杂的 NPC。
• 改进了纹理管理器并消除了重复的纹理检查和注册。

6.24.0

• 修复 #459、#775，通过添加选项以阻止与隐形 NPC 的交互。
• 修复 #774 与可选的史诗战斗和 Cobblemon 实体类型映射相关的启动崩溃。
• 修复 #773，通过在基础刻期间和打开交易屏幕之前检查基于时间的交易重置。
• 通过正确增加内部刻度器来修复交易重置时机。
• 为 #459 添加了一天中的时间和天气条件。
• 为交易重置、刻度器处理和实体属性添加了额外的单元和游戏测试。
• 添加了 Skywatch Scout 作为示例 NPC 预设，带有一天中的时间和天气条件。

6.23.0

• 修复 #772，通过调整带有 403 和 404 错误的纹理重试并降低

... [内容过长已截断]

Easy NPC: 核心 (1.21.1) 更新日志

注意

此更新日志包含变更摘要。如需查看完整的更新日志，请前往 [GitHub 历史记录][history]。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 查看[升级指南][upgrade_guide]以获取更多信息。

7.8.1

• 修复了 #827，现在水中的鱼类 NPC 将直立渲染，而不是总是侧身扑腾。
• 修复了 #828，损坏的 NPC 不再阻止世界保存，现在会回退到默认值。
• 修复了恢复的 NPC 会选取一个随每次保存而变化的随机预设 ID 的问题。
• 更改了 NPC 数据，使其仅在实际更改时才写入磁盘。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了已经站在目标位置的 NPC 的行为，使其立即完成移动。
• 将“无”皮肤选项卡更改为“高级”，其中现在包含“禁用皮肤”和纹理字段。
• 添加了“移动到”动作，该动作会将 NPC 发送到一个位置、一个玩家、其所有者或其家园。
• 添加了“移动到并等待”动作，该动作仅在到达后运行后续动作。
• 为两个移动动作添加了到达半径、超时和可选的传送。
• 添加了 0 到 100 的“不透明度”属性，该属性会使身体、盔甲和手持物品一起淡出。
• 添加了“设置不透明度”动作，该动作可将 NPC 变为幽灵或将其完全隐藏。
• 添加了“灯之幽魂”预设，这是一个在正方形路径上行走的幽灵，在每个角落有一条短线。
• 添加了用于移动动作和 NPC 不透明度的 API 访问。
• 添加了“资源位置”皮肤类型，该类型可渲染任何模组或资源包的纹理。
• 添加了“高级”皮肤选项卡，该选项卡可在应用纹理之前预览带有输入纹理的 NPC。

7.7.7

• 修复了 #821，保持了 64x64 皮肤的透明度，Fresh Moves 需要此透明度来显示眼睛。之前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复了 #818，现在也会为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒都会切换其聊天气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了“执行限制”条件中未翻译的间隔名称，例如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐）动画，该动画从未使用内置的坐姿。
• 修复了当玩家靠近时，聊天气泡被 NPC 的头部截断的问题。
• 更改了聊天气泡，使其保持屏幕尺寸，并在玩家靠近时向下或向侧面移动。
• 更改了聊天气泡文本，使其比命名牌的文本大 20%。
• 更改了带有“等待”动作的基于时间的动作集，使其按顺序运行，而不是选择一个条目。
• 更改了对话框文本，使其更晚换行，以便现有的对话框可以切换到更宽的屏幕布局。
• 更改了回退动作，使其像常规动作一样跳过没有玩家的屏幕动作。
• 更改了最低 Easy Model Entities 版本为 2.1.0，旧版本将禁用集成。
• 添加了“等待”动作，该动作会暂停事件的后续动作一段选定的时间。
• 添加了“倒计时计时员”预设，这是一个数到十的聊天气泡计数，以声音和火花结束。
• 在“实验性功能”复选框后添加了 Doppler NPC 的缩放和旋转功能。两者仅影响接受它的实体的可见模型，绝不会影响碰撞箱。
• 添加了“声音”动作，该动作会在 NPC 处播放声音，并带有声音类别、音量和音高。
• 在“执行限制”条件中添加了“每 5 分钟”和“每 15 分钟”。
• 添加了“玩家待机”条件，该条件会检查玩家未移动的时间。
• 添加了“不可移动”属性，该属性可防止 NPC 因推动和击退而移动。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停在服务器关闭时结束。
• 添加了用于声音动作、暂停状态和玩家待机时间的 API 访问。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型插槽添加了纹理覆盖。
• 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
• 添加了用于 Easy Model NPC 的动画变体、纹理插槽和纹理的 API 访问。

7.6.0

• 修复了针对重复实体数据追踪器 ID 的不明确的模组冲突错误。
• 修复了第三方血条在配置和对话屏幕上渲染在 NPC 预览上方的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本不提示任何 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表绘制在其输入字段上方的问题。
• 修复了动作编辑器中未翻译的“循环”、“当前之后”和“动作数据类型”标签。
• 修复了“几率”条件缺失的提示文本。
• 修复了长条件提示在编辑器屏幕中溢出而不是换行的问题。
• 修复了“消息”动作未对齐的帮助图标和文本按钮。
• 修复了对“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
• 修复了聊天气泡文本距离其上边框比距离其下边框更近的问题。
• 更改了 NPC 建议，以首先列出准星指向的 NPC，并且在没有权限的情况下仅列出自己的 NPC。
• 更改了预设导出，使其仅存储与新 NPC 不同的内容，不包含位置或所有者。
• 更改了没有目标或动作的预设，使其回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件（如“生成时”或“击杀时”）以检查其条件。那里具有基于玩家的条件（例如计分板或物品）的动作将不再运行。
• 更改了基于时间的动作，以便在所有者附近时将所有者选择为 @initiator。
• 更改了聊天气泡，使其根据文本长度保持可见 5 到 18 秒。
• 更改了“设置姿势”动作，使其仅针对“自定义”姿势条目显示其输入字段。
• 添加了基于五个固定步骤的基于时间的动作，从大约每 1 秒到大约每 15 分钟。
• 添加了“消息”动作，用于聊天、系统消息和聊天气泡文本，无需命令。
• 为“消息”动作添加了文本变体、发送者名称、接收者和翻译键。
• 为资源包添加了聊天气泡图形，位于 easy_npc:textures/gui/speech_bubble.png。
• 添加了以百分比表示的“几率”条件以及针对所有者和派系的“关系”条件。
• 添加了生成、所有者登录、状态更改、白天/黑夜、天气以及缺失的“交易时”事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加了基础预设，可用作父预设。
• 添加了“流浪伙伴”预设，这是一个由基于时间的消息构建的健谈 NPC。
• 为模组添加了动作注册表、动作处理程序、预设验证器以及更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。
• 改进了 NPC 建议，它们无需输入即可出现，并且可以容忍一个方块内的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供了自己的动画状态，而不是每个物种一个。
• 修复了 #813，使“移回家园”可以在任何距离工作，而不仅仅是在其家园附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 外观，而不仅仅是“闪亮”和“雌性”。
• 修复了 NPC 在重生或预设导入后失去其所有者、家园和“无重力”设置的问题。
• 修复了目标保持已消失的目标并在目标或模组消失时被关闭的目标。
• 修复了飞行 NPC（如 Allay、Vex 和 Ghast）在地面上移动而不是飞行的问题。
• 修复了带有重复项或特殊字符的对话、按钮、预设、姿势和纹理名称。
• 修复了条件在专用服务器上不可编辑以及条件文本未翻译的问题。
• 修复了 Easy Model Entities NPC 不转头并且其模型列表忽略 /reload 的问题。
• 修复了为新创建的 NPC 出现“旧版 Easy NPC 数据”警告的问题。
• 修复了旧 64x32 皮肤缺失的透明度更正，这些皮肤显示了图层伪影。
• 修复了在查找玩家名称时玩家皮肤屏幕冻结片刻的问题。
• 修复了“重置注视于...”目标标签，该标签在某些语言中读作“重视战利品于...”。
• 修复了 Fabric 游戏测试，由于开发辅助模组，它们在启动时崩溃。
• 修复了从未在 Fabric 上运行的 NPC 数据隔离和交易持久性游戏测试。
• 修复了 Doppler NPC 和第三方模型的行走动画。
• 将移动目标更改为固定顺序：逃亡、跟随、返回家园，然后巡游。因此，具有多个移动目标的 NPC 的行为可能与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 移除了实验性用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“航行”和“悬停高度”设置，用于在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性以及“锻造守护者”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 方块处添加了“远距离”以及在所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第三方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个同类型 NPC 拉入“自卫”战斗。
• 修复了 #805，一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复了 #804，在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和命名牌。
• 修复了 #803，调整资源以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，该检测将日出算作夜晚，将日落算作白天。
• 修复了下界和末地中的可见性，该可见性使用主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在其第一次断言时失败，这隐藏了后来的失败。
• 修复了“已驯服”马皮肤变体，这些变体从未显示鞍。
• 更改了“对所有者可见”和“对队伍可见”，使其也遵循白天、黑夜和游戏模式。
• 更改了没有“双臂交叉”的唤魔者、幻术师和卫道士变体，使其保持双臂向下。
• 添加了“保卫派系”目标，该目标会攻击任何伤害附近派系成员或玩家的人。
• 添加了派系成员互相战斗且派系置身事外时的系统消息。
• 为灾厄村民添加了头部装备槽，以便可以移除或交换其队长旗帜。
• 向显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单位和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过使用默认值补全旧版本的显示属性来改进它们。
• 通过在未设置时禁用“保护所有者”和“保卫派系”来改进攻击目标屏幕。

7.3.0

• 通过将变体数据作为类型字段携带而不是解析变体名称来改进皮肤变体。
• 将 Cobblemon 模组 ID 和默认模型集中在共享常量上。
• 通过共享 EnumUtils 辅助工具进行 get(String) 查找来减少重复的枚举代码。
• 优化了村民职业和类型查找，以使用直接注册表键而不是扫描。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举辅助工具添加了单位和游戏测试。

7.2.0

• 修复了 #801，通过使用 NPC、对话和动作 UUID 的组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。
• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，通过将控制台、命令和命令方块视为可信的命令源。
• 修复了一个严重的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了一个新的世界刷怪笼方块，该方块限制整个世界（所有维度）的 NPC 预设，现有的组刷怪笼目前按维度计数，因此遥远的 NPC 不再阻止它。
• 通过严格的大小限制和安全的重定向处理来加强远程皮肤下载，以防止因过大或恶意的皮肤 URL 而崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来提高服务器性能。

7.0.0

• 修复了 #791，添加了流浪商人 NPC 类型。
• 修复了 #788，将 AI 安全保障扩展到 Epic Fight 和原始 NPC 变体（猪灵、村民、末影人、苦力怕、劫持者和女巫）。
• 修复了 #787、#531、#237 和 #184，添加了带有 /easy_npc faction 命令的派系系统、每个 NPC 的派系分配以及自动计分板队伍同步。
• 修复了 #787、#771 和 #572，添加了新的 target 目标选项卡，用于攻击敌对派系或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复了 #786，为 Cobblemon NPC 添加了性别和闪亮模型变体，可在模型选择中通过 female 或 shiny 进行搜索。
• 通过添加新的“可被派系攻击”战斗属性，修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度进行缩放，修复了过大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表进行排序以及在派系颜色或删除更改后刷新已加载的 NPC 计分板分配，修复了派系管理边缘情况。
• 通过按皮肤模型而不是始终重建完整的自定义纹理缓存来加载和清除纹理缓存，修复了自定义皮肤重新加载。
• 改进了“可被玩家/怪物/派系攻击”战斗属性，使其独立于“无敌”工作，每个属性都为其自己的攻击者群体打开一个有针对性的漏洞。
• 通过将大型处理程序拆分为更小的、专注于导入、导出和特定功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，用于创建、着色和删除派系以及管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的“杂项”属性选项卡，作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标目标和 Cobblemon 模型变体添加了额外的单位和游戏测试。

6.25.0

• 修复了 #782、#636、#622，在验证期间保留数据组件。
• 修复了 #780，通过缓存远程纹理下载并减少重复注册。
• 修复了 #767，通过将属性滑块限制在来自其他模组的极端值之外。
• 修复了 #754，为带有动作和条件的 NPC 添加了自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 处理。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列以避免在同一刻内多次同时下载。
• 添加了 NPC 硬币、钥匙和红色令牌作为带有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader 作为示例 NPC 预设，其中包含自定义硬币、钥匙和红色令牌物品数据。
• 添加了针对来自其他模组的极端值的属性保障。
• 将回退最大生命值从 1024 增加到 4096，以适应高生命值 NPC。
• 通过减少重复的纹理检查和注册来改进纹理管理器。

6.24.0

• 修复了 #459、#775，添加了阻止与隐形 NPC 交互的选项。
• 修复了 #774 与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的启动崩溃。
• 修复了 #773，通过在基础刻期间和打开交易屏幕之前检查基于时间的交易重置。
• 通过正确增加内部计时器来修复交易重置时机。
• 为 #459 添加了一天中的时间和天气条件。
• 为交易重置、计时器处理和实体属性添加了额外的单位和游戏测试。
• 添加了 Skywatch Scout 作为示例 NPC 预设，其中包含一天中的时间和天气条件。

6.23.0

• 修复了 #772，通过调整带有 403 和 404 错误的纹理重试并降低日志记录。
• 修复了 #770 Epic Fight NPC（唤魔者、掠夺者、卫道士和人形皮肤）的物品渲染。
• 修复了 #769 NPC 不可靠地打开或关闭门时的门循环。
• 修复了 #760，通过添加对话框选项和配置设置（buttonConditionMode: LOCK 或 HIDE）来锁定或隐藏不可用的条件对话框按钮。
• 修复了 #709，通过添加颜色选择器弹出窗口，用于带有 32 种颜色和/或手动 RGB/十六进制值的名称。
• 通过保留现有的名称颜色，修复了在没有指定颜色的情况下重命名时重置 NPC 名称颜色的问题。
• 改进了门移动属性，以便在“开门”或“关门”处于活动状态时自动启用“通过门”。

6.22.0

• 修复了 #766，通过将完整的服务器玩家上下文传递给命令执行，以更好地与依赖特定玩家数据的第三方模组和插件兼容。
• 修复了 #764，通过添加实体生命值、npc 生命值条件和 NPC 预设 Grukk, the Sparring Post 作为使用这些条件的示例。
• 修复了 #763，确保现在记录对话框按钮执行限制。
• 修复了 #758，提供了一个名为 One Wish Companion 的示例 NPC 预设。
• 修复了与第三方村民 AI 相关的崩溃，这些 AI 试图在 Easy NPC 村民上读取未注册的大脑记忆（例如 PoiCompetitorScan / job_site）#756。
• 修复了对话框按钮未锁定服务器端数据，作为 #760 和 #644 的准备工作。
• 修复了 #628，通过添加条件对话框打开支持 / 命令，以便更好地控制何时向玩家显示对话框。
• 为猪灵和猪灵蛮兵 NPC 添加了大脑 AI，并注册了完整的原版大脑记忆集。
• 为 #757 向枪支标签添

... [内容过长已截断]

Easy NPC: 核心 (1.21.1) 更新日志

注意

此更新日志包含变更摘要。如需完整的更新日志，请前往 [GitHub 历史][history] 查看。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 查看[升级指南][upgrade_guide]以获取更多信息。

7.8.1

• 修复了 #827，现在水中的鱼类 NPC 会直立渲染，而不是总是侧身扑腾。
• 修复了 #828，受损的 NPC 不会再阻止世界保存，现在会回退到默认值。
• 修复了一个已恢复的 NPC 会选取一个随保存而变化的随机预设 ID 的问题。
• 更改了 NPC 数据，使其仅在实际更改时才写入磁盘。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了已经站在目标位置的 NPC 的行为，使其立即完成移动。
• 将“None（无）”皮肤选项卡更改为“Advanced（高级）”，其中现在包含“Disable Skin（禁用皮肤）”和纹理字段。
• 添加了“Move to（移动到）”动作，该动作会将 NPC 发送到一个位置、一个玩家、其所有者或其家。
• 添加了“Move to and Wait（移动到并等待）”动作，该动作仅在到达后运行后续动作。
• 为两个移动动作添加了到达半径、超时和可选传送。
• 添加了 0 到 100 的“Opacity（不透明度）”属性，该属性会同时淡化身体、盔甲和手持物品。
• 添加了“Set Opacity（设置不透明度）”动作，该动作可以将 NPC 变成幽灵或将其完全隐藏。
• 添加了“Lantern Wraith（灯之幽魂）”预设，这是一个在每个角落带有短线的方形行走的幽灵。
• 添加了对移动动作和 NPC 不透明度的 API 访问。
• 添加了“Resource Location（资源位置）”皮肤类型，该类型可以渲染任何模组或资源包的纹理。
• 添加了“Advanced（高级）”皮肤选项卡，该选项卡会在应用纹理之前预览带有输入纹理的 NPC。

7.7.7

• 修复了 #821，保留了 64x64 皮肤的透明度，Fresh Moves 需要此功能来显示眼睛。之前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复了 #818，现在也会为村民和流浪商人 NPC 运行交易动作。
• 修复了一个具有多个文本变体的对话框每秒都在切换其聊天气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了“Execution Limit（执行限制）”条件的未翻译间隔名称，例如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐下）动画，该动画从未使用内置的坐姿。
• 修复了当玩家站在 NPC 附近时，聊天气泡被 NPC 的头部切断的问题。
• 更改了聊天气泡，使其保持屏幕大小，并在玩家靠近时向下或向侧面移动。
• 更改了聊天气泡文本，使其比命名牌大 20%。
• 更改了带有“Wait（等待）”动作的基于时间的动作集，使其按顺序运行，而不是选择一个条目。
• 更改了对话框文本以延迟换行，以便现有对话框可以切换到更宽的屏幕布局。
• 更改了回退动作，以跳过没有玩家的屏幕动作，就像常规动作那样。
• 将最低 Easy Model Entities 版本更改为 2.1.0，旧版本将禁用集成。
• 添加了“Wait（等待）”动作，该动作会暂停事件的后续动作一段选定的时间。
• 添加了“Countdown Timekeeper”预设，这是一个倒数到十并以声音和火花结束的聊天气泡。
• 在“Experimental Features（实验性功能）”复选框后面为 Doppler NPC 添加了缩放和旋转。两者仅影响接受它的实体的可见模型，而从不影响碰撞箱。
• 添加了“Sound（声波）”动作，该动作会在 NPC 处播放带有声音类别、音量和音高的声音。
• 在“Execution Limit（执行限制）”条件中添加了“Every 5 Minutes（每 5 分钟）”和“Every 15 Minutes（每 15 分钟）”。
• 添加了“Player Idle（玩家待机）”条件，该条件检查玩家未移动的时间。
• 添加了“Immovable（无法移动）”属性，该属性使 NPC 在受到推动和击退时保持在原位。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了 API 访问声音动作、暂停状态和玩家的空闲时间。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型槽位添加了纹理覆盖。
• 为“Play Animation（播放动画）”动作添加了带有计数和时间限制的“Repeat（计时器）”播放模式。
• 添加了 API 访问 Easy Model NPC 的动画变体、纹理槽位和纹理。

7.6.0

• 修复了重复实体数据追踪器 ID 的不明确模组冲突错误。
• 修复了第三方生命条在配置和对话框屏幕上渲染在 NPC 预览上方的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本没有建议 NPC UUID 的问题。
• 修复了“Set Pose（设置姿势）”动作的姿势列表绘制在其输入字段上方的问题。
• 修复了动作编辑器的未翻译“Loop（计时器）”、“After current（当前之后）”和“Action Data Type（动作数据类型）”标签。
• 修复了“Chance（概率）”条件缺失的提示文本。
• 修复了长条件提示在编辑器屏幕中溢出而不是换行的问题。
• 修复了“Message（消息）”动作的对齐错误的帮助图标和文本按钮。
• 修复了“Set Pose（设置姿势）”、“Play Animation（播放动画）”和“Stop Animation（停止动画）”动作的更改无法保存的问题。
• 修复了聊天气泡文本距离其上边框比距离其下边框更近的问题。
• 更改了 NPC 建议，首先列出准星指向的 NPC，并且仅在没有权限时列出自己的 NPC。
• 更改了预设导出，仅存储与新 NPC 不同的内容，不包括位置或所有者。
• 更改了没有目标或动作的预设，以回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件（例如“On Spawn（生成时）”或“On Kill（击杀时）”）以检查其条件。那里具有基于玩家的条件（例如计分板或物品）的动作不再运行。
• 更改了基于时间的动作，每当所有者在附近时，选择所有者作为 @initiator。
• 更改了聊天气泡，根据文本长度保持可见 5 到 18 秒。
• 更改了“Set Pose（设置姿势）”动作，仅针对“custom（自定义）”姿势条目显示其输入字段。
• 添加了五个固定步骤的基于时间的动作，从每约 1 秒到每约 15 分钟。
• 添加了“Message（消息）”动作，用于聊天、系统消息和聊天气泡文本，无需命令。
• 为“Message（消息）”动作添加了文本变体、发送者名称、接收者和翻译键。
• 为资源包添加了聊天气泡图形 easy_npc:textures/gui/speech_bubble.png。
• 添加了以百分比为单位的“Chance（概率）”条件和针对所有者和派系的“Relationship（关系）”条件。
• 添加了生成、所有者登录、状态更改、白天/黑夜、天气以及缺失的“On Trade（交易时）”事件。
• 在 easy_npc:api/preset/base/ 下添加了每种 NPC 类型的基本预设，可用作父预设。
• 添加了“Wandering Companion（流浪同伴）”预设，这是一个由基于时间的消息构建的健谈 NPC。
• 为模组添加了动作注册表、动作处理程序、预设验证器和更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。
• 改进了 NPC 建议，它们无需输入即可出现，并且可以容忍一个方块的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供了自己的动画状态，而不是每个物种一个。
• 修复了 #813，让“Move back to Home（移回老家）”在任何距离下工作，而不仅仅是在家附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 方面，而不仅仅是“shiny（闪光）”和“female（雌性）”。
• 修复了 NPC 在重生或预设导入后失去其所有者、家和“No Gravity（无重力）”设置的问题。
• 修复了目标保持已消失的目标并在目标或模组消失时被关闭的目标。
• 修复了像 Allay、Vex 和 Ghast 这样的飞行 NPC 在地面上移动而不是飞行的问题。
• 修复了带有重复项或特殊字符的对话框、按钮、预设、姿势和纹理名称。
• 修复了条件在专用服务器上不可编辑和未翻译的条件文本。
• 修复了 Easy Model Entities NPC 不转动头部并且其模型列表忽略 /reload 的问题。
• 修复了新创建的 NPC 出现“Legacy Easy NPC Data（旧版 Easy NPC 数据）”警告的问题。
• 修复了旧 64x32 皮肤缺失的透明度更正，这些皮肤显示了图层伪影。
• 修复了在查找玩家名称时玩家皮肤屏幕冻结片刻的问题。
• 修复了“Reset look at ...（重置看向...）”目标标签，在某些语言中读作“Reset loot at ...（重置战利于...）”。
• 修复了 Fabric 游戏测试，由于开发助手模组，它们在启动时崩溃。
• 修复了 NPC 数据隔离和交易持久性游戏测试，它们从未在 Fabric 上运行。
• 修复了 Doppler NPC 和第三方模型的行走动画。
• 将移动目标更改为固定顺序：逃亡、跟随、回家，然后漫步。因此，具有多个移动目标的 NPC 的行为可能与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 移除了实验性的用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“Navigation（航行）”和“Hover height（悬停高度）”设置，用于在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性和“Forge Keeper”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 方块处添加了“On Far Distance（远距离）”以及当其所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第三方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个同类型 NPC 拉入“Defend Self（自卫）”战斗。
• 修复了 #805，通过一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复了 #804，保留了 Doppler NPC 上的自定义名称，用于基于名称的纹理和命名牌。
• 修复了 #803，调整了资源以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，该检测将日出算作夜晚，将日落算作白天。
• 修复了下界和末地中的可见性，该可见性使用了主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在第一次断言时失败，这隐藏了后来的失败。
• 修复了“Saddled（已上鞍）”马皮肤变体，它们从未显示马鞍。
• 更改了“Visible to Owner（对所有者可见）”和“Visible to Team（对团队可见）”以也遵循白天、黑夜和游戏模式。
• 更改了没有“Crossed Arms（交叉双臂）”的 Evoker、Illusioner 和 Vindicator 变体，以保持双臂向下。
• 添加了“Defend Faction（保卫派系）”目标，该目标会攻击任何伤害附近派系成员或玩家的人。
• 添加了当派系成员互相争斗且派系置身事外时的系统消息。
• 为 Illagers 添加了头部装备槽，以便可以移除或交换其队长旗帜。
• 向显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单位和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过使用其默认值完成旧版本的显示属性来改进它们。
• 通过在未设置时禁用“Protect Owner（保护所有者）”和“Defend Faction（保卫派系）”来改进攻击目标屏幕。

7.3.0

• 通过将皮肤变体数据作为类型字段携带而不是解析变体名称来改进皮肤变体。
• 在共享常量上集中了 Cobblemon 模组 id 和默认模型。
• 通过共享的 EnumUtils 助手减少了重复的枚举代码，用于 get(String) 查找。
• 通过使用直接注册表键而不是扫描来优化村民职业和类型查找。
• 通过在构造时缓存标签名称、id 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举助手添加了单位和游戏测试。

7.2.0

• 修复了 #801，通过使用 NPC、对话框和动作 UUID 的组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。
• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，通过将控制台、命令和命令块视为可信的命令源。
• 修复了一个严重的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了一个新的 World Spawner 方块，它限制了整个世界（所有维度）的 NPC 预设，现有的 Group Spawner 现在按维度计算，因此遥远的 NPC 不再阻止它。
• 通过严格的限制大小和安全的重定向处理来加强远程皮肤下载，以防止因过大或恶意的皮肤 URL 而崩溃；添加了一个可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来改进服务器性能。

7.0.0

• 修复了 #791，通过添加流浪商人 NPC 类型。
• 修复了 #788，通过将 AI 安全保障扩展到 Epic Fight 和原始 NPC 变体（Piglin、Villager、Enderman、Creeper、Raider 和 Witch）。
• 修复了 #787、#531、#237 和 #184，通过添加带有 /easy_npc faction 命令的派系系统、每 NPC 派系分配和自动计分板团队同步。
• 修复了 #787、#771 和 #572，通过添加新的 target（目标） 目标选项卡以攻击敌对派系或通过玩家名称、团队、实体标签或 UUID 攻击特定目标。
• 修复了 #786，通过为 Cobblemon NPC 添加性别和闪光模型变体，可在模型选择中通过 female 或 shiny 进行搜索。
• 通过添加新的 Attackable by Factions（可被派系攻击） 战斗属性，修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度进行缩放，修复了超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、排序派系列表以及在派系颜色或删除更改后刷新已加载的 NPC 计分板分配，修复了派系管理边缘情况。
• 修复了自定义皮肤重新加载，通过每个皮肤模型加载和清除纹理缓存，而不是总是重建完整的自定义纹理缓存。
• 改进了 Attackable by Players/Monsters/Factions（可被玩家/怪物/派系攻击） 战斗属性，使其独立于 Invulnerable（无敌） 工作，每个属性都为其自己的攻击者群体打开一个有针对性的漏洞。
• 通过将大型处理程序拆分为更小的、专注于导入、导出和特定功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，用于创建、着色和删除派系以及管理敌对关系，受到新的 FACTION_MANAGEMENT 安全功能的保护。
• 添加了新的 Misc（杂项） 属性选项卡，作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标和 Cobblemon 模型变体添加了额外的单位和游戏测试。

6.25.0

• 修复了 #782、#636、#622，通过在验证期间保留数据组件。
• 修复了 #780，通过缓存远程纹理下载并减少重复注册。
• 修复了 #767，通过将属性滑块限制在来自其他模组的极端值。
• 修复了 #754，通过为带有动作和条件的 NPC 添加自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 处理。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列以避免同一刻中的多次同时下载。
• 添加了 NPC 硬币、钥匙和红色令牌作为带有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader 作为示例 NPC 预设，带有自定义硬币、钥匙和红色令牌物品数据。
• 添加了属性保护措施，以防止来自其他模组的极端值。
• 将回退最大生命值从 1024 增加到 4096，以适应高生命值 NPC。
• 通过减少重复的纹理检查和注册来改进纹理管理器。

6.24.0

• 修复了 #459、#775，通过添加阻止与隐形 NPC 交互的选项。
• 修复了与可选 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
• 修复了 #773，通过在基础刻期间和打开交易屏幕之前检查基于时间的交易重置。
• 修复了交易重置时机，通过正确增加内部刻计数器。
• 为 #459 添加了一天

... [内容过长已截断]

Easy NPC 更新日志 (1.20.1)

注意

此更新日志包含变更摘要。如需查看完整的更新日志，请前往 [GitHub 历史][history]。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 查看[升级指南][upgrade_guide]以获取更多信息。

7.8.1

• 修复了 #827，现在水中的鱼类 NPC 会直立渲染，而不会总是侧身扑腾。
• 修复了 #828，防止受损的 NPC 阻止世界保存，现在会回退到默认值。
• 修复了恢复的 NPC 会选取一个随每次保存而变化的随机预设 ID 的问题。
• 更改了 NPC 数据，使其仅在实际更改时才写入磁盘。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了 NPC 的行为，如果已站在目标位置，将立即完成移动。
• 将“无”皮肤选项卡更改为“高级”，现在包含“禁用皮肤”和纹理字段。
• 添加了“移动到”动作，可将 NPC 发送到一个位置、玩家、其所有者或其家。
• 添加了“移动到并等待”动作，仅在到达后执行后续动作。
• 为两个移动动作添加了到达半径、超时和可选的传送。
• 添加了 0 到 100 的“不透明度”属性，使身体、盔甲和手持物品一起淡出。
• 添加了“设置不透明度”动作，可将 NPC 变为幽灵或完全隐藏。
• 添加了“灯之幽魂”预设，一个在每个角落都有一条短线的方形行走的幽灵。
• 添加了对移动动作和 NPC 不透明度的 API 访问。
• 添加了“资源位置”皮肤类型，可渲染任何模组或资源包的纹理。
• 添加了“高级”皮肤选项卡，可在应用之前预览输入纹理的 NPC。

7.7.7

• 修复了 #821，保持了 64x64 皮肤的透明度，Fresh Moves 需要它来显示眼睛。之前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复了 #818，现在也为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒都在切换其聊天气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了“执行限制”条件中未翻译的间隔名称，如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐）动画，该动画从未使用内置的坐姿。
• 修复了当玩家靠近时，聊天气泡被 NPC 的头部切断的问题。
• 更改了聊天气泡，使其保持屏幕大小，并在玩家靠近时向下或向侧面移动。
• 更改了聊天气泡文本，使其比命名牌大 20%。
• 更改了带有“等待”动作的基于时间的动作集，使其按顺序运行，而不是选择一个条目。
• 更改了对话框文本以延迟换行，以便现有对话框可以切换到更宽的屏幕布局。
• 更改了回退动作，以跳过没有玩家的屏幕动作，就像常规动作一样。
• 将最低 Easy Model Entities 版本更改为 2.1.0，旧版本将禁用集成。
• 添加了“等待”动作，暂停事件的后续动作一段选定的时间。
• 添加了“倒数计时员”预设，一个聊天气泡数到十并以声音和火花结束。
• 在“实验性功能”复选框后添加了 Doppler NPC 的缩放和旋转。两者仅影响接受它的实体的可见模型，而从不影响碰撞箱。
• 添加了“声音”动作，以声音类别、音量和音高在 NPC 处播放声音。
• 向“执行限制”条件添加了“每 5 分钟”和“每 15 分钟”。
• 添加了“玩家待机”条件，检查玩家多久没有移动了。
• 添加了“无法移动”属性，使 NPC 在受到推挤和击退时保持原地不动。
• 添加了 /easy_npc pause 来暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了 API 访问声音动作、暂停状态和玩家的待机时间。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型槽添加了纹理覆盖。
• 为“播放动画”动作添加了带有计数和时间限制的“循环”播放模式。
• 添加了 API 访问 Easy Model NPC 的动画变体、纹理槽和纹理。

7.6.0

• 修复了重复实体数据追踪器 ID 的不明确模组冲突错误。
• 修复了第三方生命条在配置和对话框屏幕上渲染在 NPC 预览上方的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本没有建议 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表绘制在其输入字段上方的问题。
• 修复了动作编辑器中未翻译的“循环”、“当前之后”和“动作数据类型”标签。
• 修复了“概率”条件缺失的提示文本。
• 修复了冗长的条件提示超出编辑器屏幕而不是换行的问题。
• 修复了“消息”动作未对齐的帮助图标和文本按钮。
• 修复了对“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
• 修复了聊天气泡文本距离其上边框比下边框更近的问题。
• 更改了 NPC 建议，首先列出准星 NPC，并且在没有权限的情况下仅列出自己的 NPC。
• 更改了预设导出，仅存储与新 NPC 不同的内容，不包含位置或所有者。
• 更改了没有目标或动作的预设，回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件（如“生成时”或“击杀时”）以检查其条件。那里具有基于玩家的条件（例如计分板或物品）的动作不再运行。
• 更改了基于时间的动作，每当所有者在附近时，选择所有者作为 @initiator。
• 更改了聊天气泡，根据文本长度保持可见 5 到 18 秒。
• 更改了“设置姿势”动作，仅针对“自定义”姿势条目显示其输入字段。
• 在五个固定步骤上添加了基于时间的动作，从每约 1 秒到每约 15 分钟。
• 添加了用于聊天、系统消息和聊天气泡文本的“消息”动作，无需命令。
• 为“消息”动作添加了文本变体、发送者名称、收件人和翻译键。
• 为资源包添加了聊天气泡图形 easy_npc:textures/gui/speech_bubble.png。
• 添加了百分比形式的“概率”条件以及针对所有者和派系的“关系”条件。
• 添加了生成、所有者登录、状态更改、日/夜、天气以及缺失的“交易时”事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加了基础预设，可用作父预设。
• 添加了“流浪同伴”预设，一个由基于时间的消息构建的健谈 NPC。
• 添加了动作注册表、动作处理程序、预设验证器以及用于模组的更丰富事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。
• 改进了 NPC 建议，无需输入即可出现，并且可以容忍一个方块以内的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供自己的动画状态，而不是每个物种一个。
• 修复了 #813，让“返回家园”在任何距离下都能工作，而不仅仅是在家附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 方面，而不仅仅是“闪亮”和“雌性”。
• 修复了 NPC 在重生或预设导入后失去其所有者、家和“无重力”设置的问题。
• 修复了目标保持已消失的目标并在目标或模组消失时被关闭的目标。
• 修复了飞行 NPC（如悦灵、恼鬼和恶魂）在地面上移动而不是飞行。
• 修复了具有重复项或特殊字符的对话框、按钮、预设、姿势和纹理名称。
• 修复了条件在专用服务器上不可编辑以及未翻译的条件文本。
• 修复了 Easy Model Entities NPC 不转动头部及其模型列表忽略 /reload 的问题。
• 将移动目标更改为固定顺序：逃亡、跟随、回家，然后漫步。因此，具有多个移动目标的 NPC 的行为可能与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 删除了实验性用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“航行”和“悬停高度”设置，可在地面和飞行之间切换任何 NPC。
• 添加了父预设、来自其他模组的预设、预设可见性以及“锻造炉守护者”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 方块处添加了“远距离”事件，以及在所有者登录时再次生成 NPC 的选项。
• 通过预设 API 和自有目标改进了飞行导航和第三方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个同类型 NPC 都拉入“自卫”战斗。
• 修复了 #805，一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复了 #804，在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和命名牌。
• 修复了 #803，调整资产以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了昼夜检测，它将日出算作夜晚，日落算作白天。
• 修复了下界和末地中的可见性，它们使用主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在第一次断言时失败，从而隐藏了后续失败。
• 修复了“已驯服”马皮肤变体从未显示马鞍的问题。
• 更改了“所有者可见”和“队伍可见”，也遵循白天、夜晚和游戏模式。
• 更改了没有“交叉双臂”的唤魔者、幻术师和卫道士变体，使其手臂保持向下。
• 添加了“保卫派系”目标，攻击任何伤害附近派系成员或玩家的人。
• 添加了派系成员互相战斗且派系置身事外时的系统消息。
• 为灾厄村民添加了头部装备槽，以便可以移除或交换其队长旗帜。
• 向显示配置屏幕添加了昼夜预览。
• 为可见性属性和派系防御添加了单元和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过使用默认值补全来改进来自旧版本的显示属性。
• 通过在未设置时禁用“保护主人”和“保卫派系”来改进攻击目标屏幕。

7.3.0

• 通过将变体数据作为类型化字段携带而不是解析变体名称来改进皮肤变体。
• 在共享常量上集中了 Cobblemon 模组 ID 和默认模型。
• 通过共享 EnumUtils 辅助工具减少了重复的枚举代码，用于 get(String) 查找。
• 优化了村民职业和类型查找，以使用直接注册表键而不是扫描。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举辅助工具添加了单元和游戏测试。

7.2.0

• 修复了 #801，通过使用 NPC、对话框和动作 UUID 的组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。

7.1.0

• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，将控制台、命令和命令方块视为受信任的命令源。
• 修复了一个严重的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了新的世界刷怪笼方块，它限制整个世界（所有维度）的 NPC 预设；现有的组刷怪笼现在按维度计算，因此遥远的 NPC 不再阻止它。
• 通过严格的大小限制和安全的重定向处理来加强远程皮肤下载，以防止过大或恶意的皮肤 URL 导致崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来改进服务器性能。

7.0.0

• 修复了 #791，添加了流浪商人 NPC 类型。
• 修复了 #788，将 AI 安全防护扩展到史诗战斗和原始 NPC 变体（猪灵、村民、末影人、苦力怕、劫持者和女巫）。
• 修复了 #787、#531、#237 和 #184，添加了带有 /easy_npc faction 命令的派系系统、每个 NPC 的派系分配以及自动计分板队伍同步。
• 修复了 #787、#771 和 #572，添加了新的“目标”目标选项卡，以攻击敌对派系或按玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复了 #786，为 Cobblemon NPC 添加了性别和闪亮模型变体，可在模型选择中通过 female 或 shiny 进行搜索。
• 通过添加新的“派系可攻击”战斗属性修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度来缩放，修复了过大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表进行排序以及在派系颜色或删除更改后刷新加载的 NPC 计分板分配，修复了派系管理边缘情况。
• 通过按皮肤模型加载和清除纹理缓存而不是总是重建完整的自定义纹理缓存来修复自定义皮肤重新加载。
• 改进了“玩家/怪物/派系可攻击”战斗属性，使其独立于“无敌”工作，每个属性都为其自己的攻击者群体打开一个针对性的漏洞。
• 通过将大型处理程序拆分为更小的、专注的导入、导出和特定功能组件来改进预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，以创建、着色和删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的“杂项”属性选项卡，作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标和 Cobblemon 模型变体添加了额外的单元和游戏测试。

6.25.0

• 修复了 #780，为远程纹理下载添加了额外的缓存和优化。
• 修复了 #767，保护属性滑块免受来自其他模组的巨大值影响。
• 修复了 #754，为带有动作和条件的 NPC 添加了自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 问题导致意外行为。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列，以避免在同一刻内多次同时下载。
• 添加了 NPC 硬币、钥匙和红色代币作为带有动作和条件的 NPC 的消耗品。
• 添加了 欢迎硬币商人 作为示例 NPC 预设，以自定义硬币、钥匙和红色代币作为示例物品以及用于动作和条件的新物品数据。
• 添加了针对来自其他模组的巨大值的属性通用保护。
• 将回退最大生命值从 1024 增加到 4096，以允许更复杂的 NPC。
• 改进了纹理管理器并消除了重复的纹理检查和注册。

6.24.0

• 修复了 #459、#775，添加了阻止与隐形 NPC 交互的选项。
• 修复了与可选史诗战斗和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
• 修复了 #773，在基础刻期间和打开交易屏幕之前检查定时交易重置。
• 通过正确增加内部刻度器来修复交易重置计时。
• 为 #459 添加了时间和天气条件。
• 为交易重置、刻度器处理和实体属性添加了额外的单元和游戏测试。
• 添加了 天空守望侦察兵 作为示例 NPC 预设，具有时间和天气条件。

6.23.0

• 修复了 #772，通过调整带有 403 和 404 错误的纹理重试并降低日志记录。
• 修复了 #770 史诗战斗 NPC（唤魔者、掠夺者、卫道士和人形皮肤）的物品渲染。
• 修复了 #769 NPC 门循环，无法可靠地打开或关闭门。
• 修复了 #760，通过添加对话框选项和配置设置（buttonConditionMode: LOCK 或 HIDE）来锁定或隐藏不可用的条件对话框按钮。
• 修复了 #709，添加了带有 32 种颜色和/或手动 RGB/十六进制值的名称颜色选择器弹出窗口。
• 通过保留现有名称颜色，修复了在没有指定颜色的情况下重命名时 NPC 名称颜色被重置的问题。
• 改进了门移动属性，以便在“开门”或“关门”处于活动状态时自动启用“穿过门”。

6.22.0

• 修复了 #766，通过将完整的服务器玩家上下文传递给命令执行，以便更好地与依赖特定玩家数据的第三方模组和插件兼容。
• 修复了 #764，通过添加实体生命值、NPC 生命值条件和 NPC 预设 格鲁克，陪练桩 作为使用这些条件的示例。
• 修复了 #763，确保现在记录对话框按钮执行限制。
• 修复了 #758，提供了一个名为 许愿同伴 的示例 NPC 预设。
• 修复了与第三方村民 AI 相关的崩溃，这些 AI 在 Easy NPC 村民上读取未注册的大脑记忆（例如 PoiCompetitorScan / job_site）#756。
• 修复了对话框按钮未锁定服务端数据，为 #760 和 #644 做准备。
• 修复了 #628，通过添加条件对话框打开支持 / 命令，以便更好地控制何时向玩家显示对话框。
• 为猪灵和猪灵蛮兵 NPC 添加了大脑 AI，并注册了完整的原版大脑记忆集。
• 为 #757 向枪械标签添加了额外的枪。
• 添加了新的“打开对话框（条件）”动作，仅在满足其条件时打开命名对话框，而现有的“打开对话框”动作保持无条件打开对话框。
• 为动作、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
• 为了与其他 NPC 保持一致，添加了猪灵、猪灵蛮兵和僵尸猪灵 NPC 的无敌状态。
• 添加了新的“击退免疫”战斗属性，防止 NPC 被近战或弹射物攻击击退。
• 添加了新的“爆炸免疫”战斗属性，使 NPC 免受爆炸伤害和位移（例如 TNT、苦力怕、末影水晶）。
• 将“弹射物碰撞”属性移动到战斗属性屏幕，这在主题上更合适（之前在能力屏幕上）。

6.21.0

• 修复了双臂交叉姿势的灾厄村民的物品附件。
• 修复了损坏的灾厄村民弩攻击目标。
• 修复了与无法作为手持物品渲染的第三方物品相关的崩溃 #756。
• 修复了与试图访问不存在的模型部件的第三方 Mixin 相关的崩溃 #756。
• 通过减少日志详细程度并为自定义模型部件添加额外检查来修复 log.info 垃圾消息。
• 改进了 EasyNPCModelManager 性能。
• 重构了 NPC 渲染器，以删除默认手持物品层。

6.20.0

• 修

... [内容过长已截断]

Easy NPC 更新日志 (1.20.1)

注意

此更新日志包含变更摘要。如需查看完整的更新日志，请前往 [GitHub 历史][history]。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 查看[升级指南][upgrade_guide]以获取更多信息。

7.8.1

• 修复了 #827，现在鱼形 NPC 在水中渲染为直立状态，而不是总是侧身拍打。
• 修复了 #828，防止损坏的 NPC 阻止世界保存，现在会回退到默认值。
• 修复了恢复后的 NPC 会选取一个随每次保存而变化的随机预设 ID 的问题。
• 更改了 NPC 数据，使其仅在实际更改时才写入磁盘。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了已经站在目标位置的 NPC 的行为，使其立即完成移动。
• 将 "None"（无）皮肤选项卡更改为 "Advanced"（高级），现在包含 "Disable Skin"（禁用皮肤）和纹理字段。
• 添加了 "Move to"（移动到）动作，将 NPC 发送到一个位置、玩家、其所有者或其家园。
• 添加了 "Move to and Wait"（移动并等待）动作，仅在到达后执行后续动作。
• 为两个移动动作添加了到达半径、超时和可选传送。
• 添加了 "Opacity"（不透明度）属性，范围为 0 到 100，可以同时淡化身体、盔甲和手持物品。
• 添加了 "Set Opacity"（设置不透明度）动作，可以将 NPC 变为幽灵状态或完全隐藏它。
• 添加了 "Lantern Wraith"（灯之幽魂）预设，一个在角落带有短线的方形行走的幽灵。
• 添加了 API 以访问移动动作和 NPC 的不透明度。
• 添加了 "Resource Location"（资源位置）皮肤类型，可以渲染任何模组或资源包的纹理。
• 添加了 "Advanced"（高级）皮肤选项卡，在应用之前预览输入纹理的 NPC。

7.7.7

• 修复了 #821，保持 64x64 皮肤的透明度，Fresh Moves 需要它来显示眼睛。之前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复了 #818，现在也会为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒切换其对话气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了 "Execution Limit"（执行限制）条件中未翻译的间隔名称，例如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐下）动画，它从未使用内置的坐姿。
• 修复了当玩家靠近时，对话气泡被 NPC 的头部切断的问题。
• 更改了对话气泡，使其保持屏幕大小，并在玩家靠近时向下或向侧面移动。
• 更改了对话气泡文本，使其比名称标签大 20%。
• 更改了带有 "Wait"（等待）动作的基于时间的动作集，使其按顺序运行，而不是选择一个条目。
• 更改了对话文本，使其更晚换行，以便现有对话框可以切换到更宽的屏幕布局。
• 更改了回退动作，以跳过没有玩家的屏幕动作，就像常规动作一样。
• 更改了最低 Easy Model Entities 版本为 2.1.0，旧版本将禁用集成。
• 添加了 "Wait"（等待）动作，暂停事件的后续动作一段选定的时间。
• 添加了 "Countdown Timekeeper"（倒计时计时员）预设，一个对话气泡数到十并以声音和火花结束。
• 在 "Experimental Features"（实验性功能）复选框后面添加了 Doppler NPC 的缩放和旋转。两者仅影响接受它的实体的可见模型，而不会影响判定箱。
• 添加了 "Sound"（声波）动作，在 NPC 处播放声音，带有声音类别、音量和音高。
• 在 "Execution Limit"（执行限制）条件中添加了 "Every 5 Minutes"（每 5 分钟）和 "Every 15 Minutes"（每 15 分钟）。
• 添加了 "Player Idle"（玩家待机）条件，检查玩家未移动的时间。
• 添加了 "Immovable"（不可移动）属性，使 NPC 在推动和击退时保持在原位。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了 API 以访问声音动作、暂停状态和玩家的空闲时间。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型槽位添加了纹理覆盖。
• 为 "Play Animation"（播放动画）动作添加了带有计数和时间限制的 "Repeat"（循环）播放模式。
• 添加了 API 以访问 Easy Model NPC 的动画变体、纹理槽位和纹理。

7.6.0

• 修复了重复实体数据追踪器 ID 的不明确模组冲突错误。
• 修复了第三方生命条在配置和对话屏幕中的 NPC 预览上渲染的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认判定箱而不是其模型大小的问题。
• 修复了服务器上 /easy_npc 命令完全没有建议 NPC UUID 的问题。
• 修复了 "Set Pose"（设置姿势）动作的姿势列表绘制在其输入字段上方的问题。
• 修复了动作编辑器中未翻译的 "Loop"（循环）、"After current"（当前之后）和 "Action Data Type"（动作数据类型）标签。
• 修复了 "Chance"（概率）条件缺少提示文本的问题。
• 修复了长条件提示超出编辑器屏幕而不是换行的问题。
• 修复了 "Message"（消息）动作的未对齐帮助图标和文本按钮。
• 修复了对 "Set Pose"（设置姿势）、"Play Animation"（播放动画）和 "Stop Animation"（停止动画）动作的更改无法保存的问题。
• 修复了对话气泡文本比其下边界更靠近其上边界的问题。
• 更改了 NPC 建议，首先列出准星指向的 NPC，并且在没有权限的情况下仅列出自己的 NPC。
• 更改了预设导出，仅存储与新 NPC 不同的部分，不包含位置或所有者。
• 更改了没有目标或动作的预设，以回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件，如 "On Spawn"（生成时）或 "On Kill"（击杀时），以检查其条件。那里具有基于玩家的条件的动作（例如计分板或物品）不再运行。
• 更改了基于时间的动作，每当所有者在附近时，将所有者选为 @initiator。
• 更改了对话气泡，根据文本长度保持可见 5 到 18 秒。
• 更改了 "Set Pose"（设置姿势）动作，仅针对 "custom"（自定义）姿势条目显示其输入字段。
• 添加了基于时间的动作，分为五个固定步骤，从每约 1 秒到每约 15 分钟。
• 添加了 "Message"（消息）动作，用于聊天、系统消息和对话气泡文本，无需命令。
• 向 "Message"（消息）动作添加了文本变体、发件人名称、收件人和翻译键。
• 为资源包添加了对话气泡图形 easy_npc:textures/gui/speech_bubble.png。
• 添加了百分比形式的 "Chance"（概率）条件以及针对所有者和派系的 "Relationship"（关系）条件。
• 添加了生成、所有者登录、状态更改、白天 / 黑夜、天气以及缺失的 "On Trade"（交易时）事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加了基础预设，可用作父预设。
• 添加了 "Wandering Companion"（流浪伴侣）预设，一个由基于时间的消息构建的健谈 NPC。
• 为模组添加了动作注册表、动作处理程序、预设验证器和更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。
• 改进了 NPC 建议，它们无需输入即可出现，并且可以容忍一个方块内的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供自己的动画状态，而不是每个物种一个。
• 修复了 #813，使 "Move back to Home"（移回家园）在任何距离下工作，而不仅仅是在其家园附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 外观，而不仅仅是 "shiny"（闪光）和 "female"（雌性）。
• 修复了 NPC 在重生或预设导入后失去其所有者、家园和 "No Gravity"（无重力）设置的问题。
• 修复了目标保持消失的目标，并且在其目标或模组消失时被关闭的问题。
• 修复了飞行 NPC（如 Allay、Vex 和 Ghast）在地面上移动而不是飞行的问题。
• 修复了带有重复项或特殊字符的对话、按钮、预设、姿势和纹理名称。
• 修复了条件在专用服务器上不可编辑以及未翻译条件文本的问题。
• 修复了 Easy Model Entities NPC 不转动头部并且其模型列表忽略 /reload 的问题。
• 将移动目标更改为固定顺序：逃亡、跟随、返回家园，然后漫步。因此，具有多个移动目标的 NPC 的行为可能与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 删除了实验性用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了 "Navigation"（航行）和 "Hover height"（悬停高度）设置，以便在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性以及 "Forge Keeper" 预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 方块处添加了 "On Far Distance"（远距离），以及在所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第三方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个同类型 NPC 拉入 "Defend Self"（自卫）战斗。
• 修复了 #805，通过评估所有可见性设置而不是在第一个设置处停止。
• 修复了 #804，在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和名称标签。
• 修复了 #803，调整资产以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，它将日出算作夜晚，将日落算作白天。
• 修复了下界和末地中的可见性，它使用了主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在其第一次断言时失败，这隐藏了后来的失败。
• 修复了 "Saddled"（已上鞍）马皮肤变体，它们从未显示马鞍。
• 更改了 "Visible to Owner"（对所有者可见）和 "Visible to Team"（对队伍可见），也遵循白天、黑夜和游戏模式。
• 更改了没有 "Crossed Arms"（交叉双臂）的唤魔者、幻术师和卫道士变体，使其双臂保持向下。
• 添加了 "Defend Faction"（保卫派系）目标，它会攻击任何伤害附近派系成员或玩家的人。
• 添加了当派系成员互相战斗时系统消息，并且派系置身事外。
• 为灾厄村民添加了头部装备槽，以便可以移除或交换其队长旗帜。
• 向显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单位和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过使用默认值完成它们来改进来自旧版本的显示属性。
• 通过在未设置时禁用 "Protect Owner"（保护所有者）和 "Defend Faction"（保卫派系）来改进攻击目标屏幕。

7.3.0

• 通过将变体数据作为类型化字段携带而不是解析变体名称来改进皮肤变体。
• 在共享常量上集中了 Cobblemon 模组 ID 和默认模型。
• 通过共享的 EnumUtils 助手减少了重复的枚举代码，用于 get(String) 查找。
• 通过使用直接注册表键而不是扫描来优化村民职业和类型查找。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举助手添加了单位和游戏测试。

7.2.0

• 修复了 #801，通过使用 NPC、对话框和动作 UUID 的组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。

7.1.0

• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，通过将控制台、命令和命令块视为可信的命令源。
• 修复了一个严重的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了一个新的世界生成器方块，它在整个世界（所有维度）限制 NPC 预设；现有的组生成器现在按维度计算，因此遥远的 NPC 不再阻止它。
• 通过严格的大小限制和安全的重定向处理来加强远程皮肤下载，以防止过大或恶意的皮肤 URL 导致崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来改进服务器性能。

7.0.0

• 修复了 #791，添加了流浪商人 NPC 类型。
• 修复了 #788，通过将 AI 安全保障扩展到史诗战斗和原始 NPC 变体（猪灵、村民、末影人、苦力怕、劫持者和女巫）。
• 修复了 #787、#531、#237 和 #184，添加了带有 /easy_npc faction 命令的派系系统、每 NPC 派系分配和自动计分板队伍同步。
• 修复了 #787、#771 和 #572，添加了新的 target（目标）选项卡，以攻击敌对派系或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复了 #786，为 Cobblemon NPC 添加了性别和闪光模型变体，可在模型选择中通过 female 或 shiny 搜索。
• 通过添加新的 Attackable by Factions（可被派系攻击）战斗属性，修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是判定箱高度进行缩放，修复了超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表进行排序以及在派系颜色或删除更改后刷新加载的 NPC 计分板分配，修复了派系管理边缘情况。
• 通过按皮肤模型加载和清除纹理缓存而不是始终重建完整的自定义纹理缓存，修复了自定义皮肤重新加载。
• 改进了 Attackable by Players/Monsters/Factions（可被玩家/怪物/派系攻击）战斗属性，使其独立于 Invulnerable（无敌），每个属性都为其自己的攻击者群体打开一个有针对性的漏洞。
• 通过将大型处理程序拆分为更小的、专注于导入、导出和特定功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，以创建、着色和删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的 Misc（杂项）属性选项卡，作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标和 Cobblemon 模型变体添加了额外的单位和游戏测试。

6.25.0

• 修复了 #780，为远程纹理下载添加了额外的缓存和优化。
• 修复了 #767，防止属性滑块受到来自其他模组的巨大值的影响。
• 修复了 #754，为带有动作和条件的 NPC 添加了自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 问题导致意外行为。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列以避免同一刻中的多次同时下载。
• 添加了 NPC 硬币、钥匙和红色令牌，作为带有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader 作为示例 NPC 预设，带有自定义硬币、钥匙和红色令牌作为示例物品，以及用于动作和条件的新物品数据。
• 添加了针对来自其他模组的巨大值的属性常规保护措施。
• 将回退最大生命值从 1024 增加到 4096，以允许更复杂的 NPC。
• 改进了纹理管理器并消除了重复的纹理检查和注册。

6.24.0

• 修复了 #459、#775，添加了阻止与不可见 NPC 交互的选项。
• 修复了 #774 与可选史诗战斗和 Cobblemon 实体类型映射相关的启动崩溃。
• 修复了 #773，通过在基础刻期间和打开交易屏幕之前检查基于时间的交易重置。
• 通过正确增加内部刻度器来修复交易重置时机。
• 为 #459 添加了时间和天气条件。
• 为交易重置、刻度器处理和实体属性添加了额外的单位和游戏测试。
• 添加了 Skywatch Scout 作为示例 NPC 预设，带有时间和天气条件。

6.23.0

• 修复了 #772，通过调整 403 和 404 错误的纹理重试并降低日志记录。
• 修复了 #770 史诗战斗 NPC（唤魔者、掠夺者、卫道士和人形皮肤）的物品渲染。
• 修复了 #769 NPC 不可靠地打开或关闭门时的门循环。
• 修复了 #760，添加了对话框选项和配置设置（buttonConditionMode: LOCK 或 HIDE），以锁定或隐藏不可用的条件对话框按钮。
• 修复了 #709，添加了带有 32 种颜色和/或手动 RGB/十六进制值的名称颜色选择器弹出窗口。
• 通过保留现有名称颜色，修复了在没有指定颜色的情况下重命名时 NPC 名称颜色被重置的问题。
• 改进了门移动属性，以便在 "Open Door"（开门）或 "Clos

... [内容过长已截断]

Easy NPC: 核心 (1.21.1) 更新日志

注意

此更新日志包含变更摘要。如需完整的更新日志，请前往 [GitHub 历史][history] 查看。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 查看 [升级指南][upgrade_guide] 以获取更多信息。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了 NPC 的行为，使其在到达目标位置时立即结束移动。
• 将 "None"（无）皮肤选项卡更改为 "Advanced"（高级），现在包含 "Disable Skin"（禁用皮肤）和纹理字段。
• 添加了 "Move to"（移动到）动作，可将 NPC 发送到位置、玩家、其所有者或其家园。
• 添加了 "Move to and Wait"（移动并等待）动作，仅在到达后执行后续动作。
• 为两个移动动作添加了到达半径、超时和可选传送。
• 添加了 "Opacity"（不透明度）属性，范围从 0 到 100，可同时淡化身体、盔甲和手持物品。
• 添加了 "Set Opacity"（设置不透明度）动作，可将 NPC 变为幽灵或完全隐藏。
• 添加了 "Lantern Wraith"（灯之幽魂）预设，这是一个在每个角落都有短线的方形行走的幽灵。
• 添加了对移动动作和 NPC 不透明度的 API 访问。
• 添加了 "Resource Location"（资源位置）皮肤类型，可渲染任何模组或资源包的纹理。
• 添加了 "Advanced"（高级）皮肤选项卡，可在应用纹理之前预览 NPC。

7.7.7

• 修复了 #821，保留了 64x64 皮肤的透明度，Fresh Moves 需要它来显示眼睛。之前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复了 #818，现在也会为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒都会切换其聊天气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了 "Execution Limit"（执行限制）条件中未翻译的间隔名称，例如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐）动画，它从未使用内置的坐姿。
• 修复了当玩家靠近时，聊天气泡被 NPC 的头部切断的问题。
• 更改了聊天气泡，使其保持屏幕大小，并在玩家靠近时向下或向侧面移动。
• 更改了聊天气泡文本，使其比命名牌大 20%。
• 更改了带有 "Wait"（等待）动作的基于时间的动作集，使其按顺序运行，而不是选择一个条目。
• 更改了对话框文本，使其更晚换行，以便现有对话框可以切换到更宽的屏幕布局。
• 更改了后备动作，以跳过没有玩家的屏幕动作，就像常规动作一样。
• 将最低 Easy Model Entities 版本更改为 2.1.0，旧版本将禁用集成。
• 添加了 "Wait"（等待）动作，该动作会在选定的持续时间内暂停事件的后续动作。
• 添加了 "Countdown Timekeeper"（倒计时计时员）预设，这是一个数到十的聊天气泡计数，并以声音和火花结束。
• 在 "Experimental Features"（实验性功能）复选框后添加了 Doppler NPC 的缩放和旋转。两者仅影响接受它的实体的可见模型，而从不影响碰撞箱。
• 添加了 "Sound"（声音）动作，该动作会在 NPC 处播放声音，带有声音类别、音量和音高。
• 在 "Execution Limit"（执行限制）条件中添加了 "Every 5 Minutes"（每 5 分钟）和 "Every 15 Minutes"（每 15 分钟）。
• 添加了 "Player Idle"（玩家待机）条件，该条件检查玩家未移动的时间。
• 添加了 "Immovable"（不可移动）属性，该属性使 NPC 在推动和击退下保持原位。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了对声音动作、暂停状态和玩家待机时间的 API 访问。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型槽位添加了纹理覆盖。
• 为 "Play Animation"（播放动画）动作添加了带有计数和时间限制的 "Repeat"（循环）播放模式。
• 添加了对 Easy Model NPC 的动画变体、纹理槽位和纹理的 API 访问。

7.6.0

• 修复了针对重复实体数据追踪器 ID 的不清楚的模组冲突错误。
• 修复了第三方生命条在配置和对话框屏幕中渲染在 NPC 预览上方的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本没有建议 NPC UUID 的问题。
• 修复了 "Set Pose"（设置姿势）动作的姿势列表绘制在其输入字段上方的问题。
• 修复了动作编辑器中未翻译的 "Loop"（循环）、"After current"（当前之后）和 "Action Data Type"（动作数据类型）标签。
• 修复了 "Chance"（概率）条件缺少的提示文本。
• 修复了长条件提示超出编辑器屏幕而不是换行的问题。
• 修复了 "Message"（消息）动作的帮助图标和文本按钮未对齐的问题。
• 修复了对 "Set Pose"（设置姿势）、"Play Animation"（播放动画）和 "Stop Animation"（停止动画）动作的更改无法保存的问题。
• 修复了聊天气泡文本距离其上边框比距离其下边框更近的问题。
• 更改了 NPC 建议，首先列出准星指向的 NPC，并且在没有权限的情况下仅列出自己的 NPC。
• 更改了预设导出，仅存储与新 NPC 不同的内容，不包含位置或所有者。
• 更改了没有目标或动作的预设，以回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件，例如 "On Spawn"（生成时）或 "On Kill"（击杀时），以检查其条件。那里的具有基于玩家的条件的动作（例如计分板或物品）不再运行。
• 更改了基于时间的动作，只要所有者在附近，就会选择所有者作为 @initiator。
• 更改了聊天气泡，根据文本长度保持 5 到 18 秒的可见性。
• 更改了 "Set Pose"（设置姿势）动作，仅针对 "custom"（自定义）姿势条目显示其输入字段。
• 添加了基于时间的动作，分为五个固定步骤，从每约 1 秒到每约 15 分钟。
• 添加了 "Message"（消息）动作，用于聊天、系统消息和聊天气泡文本，无需命令。
• 为 "Message"（消息）动作添加了文本变体、发送者名称、接收者和翻译键。
• 将聊天气泡图形添加为 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 添加了以百分比表示的 "Chance"（概率）条件以及针对所有者和派系的 "Relationship"（关系）条件。
• 添加了生成、所有者登录、状态更改、白天 / 黑夜、天气以及缺失的 "On Trade"（交易时）事件。
• 在 easy_npc:api/preset/base/ 下添加了每种 NPC 类型的基本预设，可用作父预设。
• 添加了 "Wandering Companion"（流浪伙伴）预设，这是一个由基于时间的消息构建的健谈 NPC。
• 为模组添加了动作注册表、动作处理程序、预设验证器和更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了带有名称、类型和距离的工具提示。
• 改进了 NPC 建议，它们无需输入即可出现，并且可以容忍一个方块的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供了自己的动画状态，而不是每个物种一个。
• 修复了 #813，使 "Move back to Home"（返回家园）可以在任何距离工作，而不仅仅是在其家园附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 方面，而不仅仅是 "shiny"（闪亮）和 "female"（雌性）。
• 修复了 NPC 在重生或预设导入后失去所有者、家园和 "No Gravity"（无重力）设置的问题。
• 修复了目标保持消失的目标，并且在其目标或模组消失时被关闭的目标。
• 修复了像 Allay（悦灵）、Vex（恼鬼）和 Ghast（恶魂）这样的飞行 NPC 在地面上移动而不是飞行的问题。
• 修复了对话框、按钮、预设、姿势和纹理名称具有重复项或特殊字符的问题。
• 修复了条件在专用服务器上不可编辑以及条件文本未翻译的问题。
• 修复了 Easy Model Entities NPC 不转动头部并且其模型列表忽略 /reload 的问题。
• 修复了为新创建的 NPC 出现 "Legacy Easy NPC Data"（旧版 Easy NPC 数据）警告的问题。
• 修复了旧版 64x32 皮肤缺少透明度更正的问题，这些问题显示了图层伪影。
• 修复了在查找玩家名称时玩家皮肤屏幕冻结片刻的问题。
• 修复了 "Reset look at ..."（重置看向...）目标标签，它在某些语言中读作 "Reset loot at ..."（重置战利品于...）。
• 修复了 Fabric 游戏测试，它们由于开发辅助模组而在启动时崩溃。
• 修复了 NPC 数据隔离和交易持久性游戏测试，它们从未在 Fabric 上运行。
• 修复了 Doppler NPC 和第 3 方模型的行走动画。
• 更改了移动目标为固定顺序：逃亡、跟随、返回家园，然后巡游。具有多个移动目标的 NPC 因此可能与以前的行为不同。
• 更改了数据包预设为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 更改了所需的 Easy Model Entities 版本为 1.7.0，浮动模型现在默认悬停。
• 移除了实验性用户定义的 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了 "Navigation"（航行）和 "Hover height"（悬停高度）设置，以在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性和 "Forge Keeper"（锻造守护者）预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 添加了 32 方块处的 "On Far Distance"（远距离）以及在所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第 3 方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个相同类型的 NPC 拉入 "Defend Self"（自卫）战斗。
• 修复了 #805，通过一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复了 #804，保留了 Doppler NPC 上的自定义名称，用于基于名称的纹理和命名牌。
• 修复了 #803，调整了资源以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，它将日出算作黑夜，将日落算作白天。
• 修复了下界和末地中的可见性，它使用了主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在第一次断言时失败，这隐藏了后来的失败。
• 修复了 "Saddled"（已装备鞍）马皮肤变体，它们从未显示鞍。
• 更改了 "Visible to Owner"（对所有者可见）和 "Visible to Team"（对队伍可见），使其也遵循白天、黑夜和游戏模式。
• 更改了没有 "Crossed Arms"（双臂交叉）的 Evoker（唤魔者）、Illusioner（幻术师）和 Vindicator（卫道士）变体，使其保持双臂下垂。
• 添加了 "Defend Faction"（保卫派系）目标，该目标攻击任何伤害附近派系成员或玩家的人。
• 添加了系统消息，当派系成员互相战斗且派系置身事外时。
• 为灾厄村民添加了头部装备槽，以便可以移除或交换他们的队长旗帜。
• 为显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单元和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过用默认值完成它们来改进来自旧版本的显示属性。
• 通过在未设置时禁用 "Protect Owner"（保护所有者）和 "Defend Faction"（保卫派系）来改进攻击目标屏幕。

7.3.0

• 通过将皮肤变体的数据作为类型字段携带而不是解析变体名称来改进皮肤变体。
• 将 Cobblemon 模组 id 和默认模型集中在共享常量上。
• 通过共享的 EnumUtils 辅助工具减少了重复的枚举代码，用于 get(String) 查找。
• 优化了村民职业和类型查找，以使用直接注册表键而不是扫描。
• 通过在构造时缓存标签名称、id 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举辅助工具添加了单元和游戏测试。

7.2.0

• 修复了 #801，通过对 NPC、对话框和动作 UUID 使用组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。
• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，通过将控制台、命令和命令块视为可信的命令源。
• 修复了一个关键的单人 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了一个新的世界刷怪笼方块，它限制整个世界（所有维度）的 NPC 预设，现有的群体刷怪笼现在按维度计算，因此远处的 NPC 不再阻止它。
• 通过严格的大小限制和安全的重定向处理来加强远程皮肤下载，以防止因过大或恶意的皮肤 URL 而崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来改进服务器性能。

7.0.0

• 修复了 #791，添加了流浪商人 NPC 类型。
• 修复了 #788，将 AI 安全保障扩展到 Epic Fight（史诗战斗）和原始 NPC 变体（猪灵、村民、末影人、苦力怕、劫掠者和女巫）。
• 修复了 #787、#531、#237 和 #184，添加了带有 /easy_npc faction 命令的派系系统、每个 NPC 的派系分配以及自动计分板队伍同步。
• 修复了 #787、#771 和 #572，添加了新的 target（目标）目标选项卡，以攻击敌对派系或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复了 #786，为 Cobblemon NPC 添加了性别和闪亮模型变体，可在模型选择中通过 female 或 shiny 进行搜索。
• 通过添加新的 Attackable by Factions（可被派系攻击）战斗属性，修复了无法受到伤害的 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度来缩放，从而修复了超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、排序派系列表以及在派系颜色或删除更改后刷新加载的 NPC 计分板分配，修复了派系管理边缘情况。
• 修复了自定义皮肤重新加载，通过每个皮肤模型加载和清除纹理缓存，而不是总是重建完整的自定义纹理缓存。
• 改进了 Attackable by Players/Monsters/Factions（可被玩家/怪物/派系攻击）战斗属性，使其独立于 Invulnerable（无法受到伤害）工作，每个都为其自己的攻击者群体打开一个有针对性的漏洞。
• 通过将大型处理程序拆分为更小的、专注于导入、导出和特定功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，以创建、着色和删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的 Misc（杂项）属性选项卡作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标目标和 Cobblemon 模型变体添加了额外的单元和游戏测试。

6.25.0

• 修复了 #782、#636、#622，在验证期间保留了数据组件。
• 修复了 #780，通过缓存远程纹理下载并减少重复注册。
• 修复了 #767，通过将属性滑块限制在其他模组的极端值之外。
• 修复了 #754，为带有动作和条件的 NPC 添加了自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 处理。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列以避免同一刻中的多次同时下载。
• 添加了 NPC 硬币、钥匙和红色令牌作为带有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader（欢迎硬币交易者）作为示例 NPC 预设，带有自定义硬币、钥匙和红色令牌物品数据。
• 添加了针对来自其他模组的极端值的属性保护。
• 将高血量 NPC 的回退最大生命值从 1024 增加到 4096。
• 通过减少重复的纹理检查和注册来改进纹理管理器。

6.24.0

• 修复了 #459、#775，添加了阻止与不可见 NPC 交互的选项。
• 修复了与可选 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
• 修复了 #773，通过在基础刻期间和打开交易屏幕之前检查定时交易重置。
• 通过正确增加内部计时器来修复交易重置时机。
• 为 #459 添加了一天中的时间和天气条件。
• 为交易重置、计时器处理和实体属性添加了额外的单元和游戏测试。
• 添加了 Skywatch Scout（天际侦察兵）作为示例 NPC 预设，带有一天中的时间和天气条件。

6.23.0

• 修复了 #772，通过

... [内容过长已截断]

Easy NPC (1.20.1) 更新日志

说明

此更新日志包含变更摘要。如需完整的更新日志，请前往 [GitHub 历史记录][history]。

注意：在更新到新版本之前，请务必备份你的世界 / NPC！ 查看[升级指南][upgrade_guide]以获取更多信息。

7.8.0

• 修复了较小的文本和 UI 问题。
• 更改了 NPC 的行为：如果已经站在目标位置，将立即完成移动。
• 将“None（无）”皮肤选项卡更改为“Advanced（高级）”，现在包含“Disable Skin（禁用皮肤）”和纹理字段。
• 添加了“Move to（移动到）”动作，可将 NPC 发送到某个位置、玩家、其所有者或其家。
• 添加了“Move to and Wait（移动并等待）”动作，仅在到达后执行后续动作。
• 为两个移动动作添加了到达半径、超时时间和可选传送。
• 添加了“Opacity（不透明度）”属性，范围从 0 到 100，可同时淡化身体、盔甲和手持物品。
• 添加了“Set Opacity（设置不透明度）”动作，可将 NPC 变为幽灵状态或完全隐藏它。
• 添加了“Lantern Wraith（灯之幽魂）”预设，这是一个在每个角落停留片刻的方形路径幽灵。
• 添加了移动动作和 NPC 不透明度的 API 访问。
• 添加了“Resource Location（资源位置）”皮肤类型，可渲染任何模组或资源包的纹理。
• 添加了“Advanced（高级）”皮肤选项卡，在应用纹理之前预览 NPC。

7.7.7

• 修复了 #821，保持 64x64 皮肤的透明度，Fresh Moves 需要此功能来显示眼睛。之前下载的皮肤需要通过玩家皮肤界面中的按钮重新加载。
• 修复了 #818，现在也会为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒都在切换其聊天气泡大小的问题。
• 修复了皮肤缓存存储处理后图像而不是原始下载图像的问题。
• 修复了“Execution Limit（执行限制）”条件中未翻译的间隔名称，例如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐） 动画，该动画从未使用内置的坐姿。
• 修复了当玩家靠近时，聊天气泡被 NPC 头部切断的问题。
• 更改了聊天气泡，使其保持屏幕尺寸，并在玩家靠近时向下或向侧面移动。
• 更改了聊天气泡文本，使其比命名牌的文本大 20%。
• 更改了带有“Wait（等待）”动作的基于时间的动作集，使其按顺序运行，而不是选择一个条目。
• 更改了对话文本以延迟换行，以便现有对话可以切换到更宽的屏幕布局。
• 更改了回退动作，使其像常规动作一样跳过没有玩家的屏幕动作。
• 更改了最低 Easy Model Entities 版本为 2.1.0，旧版本将禁用集成。
• 添加了“Wait（等待）”动作，该动作暂停事件的后续动作，持续选定的时间。
• 添加了“Countdown Timekeeper（圣诞节日历）”预设，这是一个数到十的聊天气泡，以声音和火花结束。
• 在“Experimental Features（实验性功能）”复选框后添加了 Doppler NPC 的缩放和旋转。两者仅影响接受它的实体的可见模型，而从不影响碰撞箱。
• 添加了“Sound（声波）”动作，该动作在 NPC 处播放声音，具有声音类别、音量和音高。
• 在“Execution Limit（执行限制）”条件中添加了“Every 5 Minutes（每 5 分钟）”和“Every 15 Minutes（每 15 分钟）”。
• 添加了“Player Idle（待机）”条件，该条件检查玩家未移动的时间。
• 添加了“Immovable（不可移动）”属性，该属性使 NPC 在面对推动和击退时保持在原地。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停随服务器结束。
• 添加了 API 访问声音动作、暂停状态和玩家的空闲时间。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型槽添加了纹理覆盖。
• 为“Play Animation（播放动画）”动作添加了带有计数和时间限制的“Repeat（计时器）”播放模式。
• 添加了 Easy Model NPC 的动画变体、纹理槽和纹理的 API 访问。

7.6.0

• 修复了重复实体数据跟踪器 ID 的不明确模组冲突错误。
• 修复了第三方血条在配置和对话屏幕的 NPC 预览上渲染的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了服务器上 /easy_npc 命令根本没有建议 NPC UUID 的问题。
• 修复了“Set Pose（设置姿势）”动作的姿势列表绘制在其输入字段之上。
• 修复了动作编辑器中未翻译的“Loop（循环）”、“After current（当前之后）”和“Action Data Type（动作数据类型）”标签。
• 修复了“Chance（概率）”条件缺少提示文本的问题。
• 修复了长条件提示在编辑器屏幕中溢出而不是换行的问题。
• 修复了“Message（消息）”动作的帮助图标和文本按钮未对齐的问题。
• 修复了“Set Pose（设置姿势）”、“Play Animation（播放动画）”和“Stop Animation（停止动画）”动作的更改无法保存的问题。
• 修复了聊天气泡文本距离其上边框比距离其下边框更近的问题。
• 更改了 NPC 建议，首先列出准星指向的 NPC，并且在没有权限的情况下仅列出自己的 NPC。
• 更改了预设导出，仅存储与新 NPC 不同的内容，不包含位置或所有者。
• 更改了没有目标或动作的预设，以回退到其 NPC 类型的默认值。
• 更改了没有玩家的事件（例如“On Spawn（生成时）”或“On Kill（击杀时）”）以检查其条件。那里具有基于玩家的条件（例如计分板或物品）的动作不再运行。
• 更改了基于时间的动作，只要所有者在附近，就选择所有者作为 @initiator。
• 更改了聊天气泡，根据文本长度保持可见 5 到 18 秒。
• 更改了“Set Pose（设置姿势）”动作，仅针对“custom（自定义）”姿势条目显示其输入字段。
• 在五个固定步骤上添加了基于时间的动作，从每约 1 秒到每约 15 分钟。
• 添加了“Message（消息）”动作，用于聊天、系统消息和聊天气泡文本，无需命令。
• 为“Message（消息）”动作添加了文本变体、发送者名称、收件人和翻译键。
• 为资源包添加了聊天气泡图形 easy_npc:textures/gui/speech_bubble.png。
• 添加了以百分比为单位的“Chance（概率）”条件和针对所有者和派系的“Relationship（关系）”条件。
• 添加了生成、所有者登录、状态更改、白天/黑夜、天气以及缺失的“On Trade（交易时）”事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加了基础预设，可用作父预设。
• 添加了“Wandering Companion（流浪武士）”预设，这是一个由基于时间的消息构建的话唠 NPC。
• 添加了动作注册表、动作处理程序、预设验证器以及供模组使用的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。
• 改进了 NPC 建议，无需输入即可出现，并且可以容忍一个方块的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供了自己的动画状态，而不是每个物种一个。
• 修复了 #813，让“Move back to Home（返回家中）”可以在任何距离工作，而不仅仅是在家附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 方面，而不仅仅是“shiny（闪亮）”和“female（雌性）”。
• 修复了 NPC 在重生或预设导入后失去其所有者、家和“No Gravity（无重力）”设置。
• 修复了目标保持已消失的目标，并在目标或模组消失时被关闭。
• 修复了飞行 NPC（如 Allay、Vex 和 Ghast）在地面上移动而不是飞行。
• 修复了对话、按钮、预设、姿势和纹理名称包含重复项或特殊字符。
• 修复了条件在专用服务器上不可编辑以及条件文本未翻译的问题。
• 修复了 Easy Model Entities NPC 不转动头部及其模型列表忽略 /reload 的问题。
• 更改了移动目标为固定顺序：逃亡、跟随、回家，然后漫游。具有多个移动目标的 NPC 的行为可能与以前不同。
• 更改了数据包预设为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 更改了所需的 Easy Model Entities 版本为 1.7.0，浮动模型现在默认悬停。
• 移除了实验性的用户定义 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了带有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“Navigation（航行）”和“Hover height（高度偏移）”设置，以在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性和“Forge Keeper”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 方块处添加了“On Far Distance（远距离）”，以及在所有者登录时再次生成 NPC 的选项。
• 通过预设和自有目标的 API 改进了飞行导航和第三方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个同类型 NPC 拉入“Defend Self（自卫）”战斗。
• 修复了 #805，一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复了 #804，在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和命名牌。
• 修复了 #803，调整资产以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，该检测将日出算作夜晚，将日落算作白天。
• 修复了下界和末地中的可见性，该可见性使用主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在其第一次断言时失败，从而隐藏了后来的失败。
• 修复了“Saddled（已驯服）”马皮肤变体，该变体从未显示马鞍。
• 更改了“Visible to Owner（仅所有者可见）”和“Visible to Team（仅队伍可见）”以也遵循白天、黑夜和游戏模式。
• 更改了没有“Crossed Arms（双臂交叉）”的 Evoker、Illusioner 和 Vindicator 变体，使其手臂保持向下。
• 添加了“Defend Faction（攻击敌对阵营）”目标，该目标攻击任何伤害附近派系成员或玩家的人。
• 添加了当派系成员互相战斗且派系置身事外时的系统消息。
• 为 Illagers 添加了头部装备槽，以便可以移除或交换其队长旗帜。
• 为显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单位和游戏测试。
• 通过每次检查仅读取一次显示属性来改进可见性检查性能。
• 通过使用默认值补全来改进来自旧版本的显示属性。
• 通过在未设置时禁用“Protect Owner（保护所有者）”和“Defend Faction（攻击敌对阵营）”来改进攻击目标屏幕。

7.3.0

• 通过将变体数据作为类型化字段携带而不是解析变体名称来改进皮肤变体。
• 将 Cobblemon 模组 ID 和默认模型集中在共享常量上。
• 通过共享的 EnumUtils 助手减少了重复的枚举代码，用于 get(String) 查找。
• 通过使用直接注册表键而不是扫描来优化村民职业和类型查找。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举助手添加了单位和游戏测试。

7.2.0

• 修复了 #801，通过使用 NPC、对话和动作 UUID 的组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。

7.1.0

• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，通过将控制台、命令和命令块视为受信任的命令源。
• 修复了关键的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享相同的注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了新的世界刷怪箱方块，该方块限制了整个世界（所有维度）的 NPC 预设；现有的组刷怪笼目前按维度计算，因此遥远的 NPC 不再阻止它。
• 加强了远程皮肤下载，具有严格的大小限制和安全的重定向处理，以防止因过大或恶意的皮肤 URL 而崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来改进服务器性能。

7.0.0

• 修复了 #791，添加了流浪商人 NPC 类型。
• 修复了 #788，将 AI 安全防护扩展到史诗战斗和原始 NPC 变体（猪灵、村民、末影人、苦力怕、劫持者和女巫）。
• 修复了 #787、#531、#237 和 #184，添加了带有 /easy_npc faction 命令的派系系统、每个 NPC 的派系分配以及自动计分板队伍同步。
• 修复了 #787、#771 和 #572，添加了新的“target（目标）”目标选项卡，以攻击敌对派系或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复了 #786，为 Cobblemon NPC 添加了性别和闪亮模型变体，可在模型选择中通过 female 或 shiny 搜索。
• 通过添加新的“Attackable by Factions（可被派系攻击）”战斗属性修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度来缩放，修复了超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表进行排序以及在派系颜色或删除更改后刷新加载的 NPC 计分板分配，修复了派系管理边缘情况。
• 通过加载和清除每个皮肤模型的纹理缓存而不是始终重建完整的自定义纹理缓存，修复了自定义皮肤重新加载。
• 改进了“Attackable by Players/Monsters/Factions（可被玩家/怪物/派系攻击）”战斗属性，使其独立于“Invulnerable（无懈可击）”，每个属性都为其自己的攻击者群体打开一个定向漏洞。
• 通过将大型处理程序拆分为更小的、专注于导入、导出和特定功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，以创建、着色和删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的“Misc（杂项）”属性选项卡作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标和 Cobblemon 模型变体添加了额外的单位和游戏测试。

6.25.0

• 修复了 #780，为远程纹理下载添加了额外的缓存和优化。
• 修复了 #767，保护属性滑块免受来自其他模组的巨大数值影响。
• 修复了 #754，为带有动作和条件的 NPC 添加了自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 问题导致意外行为。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列，以避免在同一刻内多次同时下载。
• 添加了 NPC 硬币、钥匙和红色令牌作为带有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader 作为示例 NPC 预设，带有自定义硬币、钥匙和红色令牌作为示例物品以及用于动作和条件的新物品数据。
• 添加了针对来自其他模组的巨大数值的属性常规保护。
• 将回退最大生命值从 1024 增加到 4096，以允许更复杂的 NPC。
• 改进了纹理管理器并消除了重复的纹理检查和注册。

6.24.0

• 修复了 #459、#775，添加了阻止与隐形 NPC 交互的选项。
• 修复了与可选史诗战斗和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
• 修复了 #773，在基础刻期间和打开交易屏幕之前检查定时交易重置。
• 通过正确增加内部刻度器来修复交易重置时机。
• 为 #459 添加了一天中的时间和天气条件。
• 为交易重置、刻度器处理和实体属性添加了额外的单位和游戏测试。
• 添加了 Skywatch Scout 作为示例 NPC 预设，带有一天中的时间和天气条件。

6.23.0

• 修复了 #772，通过调整 403 和 404 错误的纹理重试并降低日志记录。
• 修复了 #770 史诗战斗 NPC（Evoker、Pillager、Vindicator 和人形皮肤）的物品渲染。
• 修复了 #769 NPC 不可靠地打开或关闭门时的门循环。
• 修复了 #760，添加了对话选项和配置设置（buttonConditionMode: LOCK 或 HIDE）以锁定或隐藏不可用的条件对话按钮。
• 修复了 #709，添加了带有 32 种颜色和/或手动 RGB/十六进制值的名称颜色选择器弹出窗口。
• 通过保留现有名称颜色，修复了在没有指定颜色的情况下重命名时重置 NPC 名称颜色的问题。
• 改进了门移动属性，以便在“Open Door（开门）”或“Close Door（关门）”处于活动状态时自动启用“Pass Door（通过门）”。

6.22.0

• 修复了 #766，通过将完整的服务器玩家上下文传递给命令执行，以更好地依赖于特定玩家数据的第三方模组和插件兼容。
• 修复了 #764，添加了实体生命值、NPC 生命值条件和 NPC 预设 Grukk, the Sparring Post 作为使用这些条件的

... [内容过长已截断]

Easy NPC 更新日志 (1.20.1)

说明

此更新日志包含变更摘要。如需查看完整更新日志，请前往 [GitHub 历史][history]。

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

7.8.0

• 修复了较小的文本和 UI 问题。
• 修改了已站在目标位置的 NPC 的行为，使其立即完成移动。
• 将“None（无）”皮肤选项卡更改为“Advanced（高级）”，现在包含“Disable Skin（禁用皮肤）”和纹理字段。
• 添加了“Move to（移动到）”动作，可将 NPC 发送到某个位置、玩家、其主人或其家。
• 添加了“Move to and Wait（移动并等待）”动作，仅在到达后执行后续动作。
• 为两个移动动作添加了到达半径、超时时间和可选传送功能。
• 添加了 0 到 100 的“Opacity（不透明度）”属性，可同时淡化身体、盔甲和手持物品。
• 添加了“Set Opacity（设置不透明度）”动作，可将 NPC 变为幽灵或完全隐藏。
• 添加了“Lantern Wraith（灯之幽魂）”预设，这是一种在每个角落有一条短线的方形行走幽灵。
• 添加了 API 访问移动动作和 NPC 不透明度的功能。
• 添加了“Resource Location（资源位置）”皮肤类型，可渲染任何模组或资源包的纹理。
• 添加了“Advanced（高级）”皮肤选项卡，可在应用纹理前预览 NPC。

7.7.7

• 修复了 #821，通过保持 64x64 皮肤的透明度，这是 Fresh Moves 用于眼睛所需的。之前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
• 修复了 #818，现在也会为村民和流浪商人 NPC 运行交易动作。
• 修复了具有多个文本变体的对话框每秒切换其气泡大小的问题。
• 修复了皮肤缓存存储处理后的图像而不是原始下载内容的问题。
• 修复了“Execution Limit（执行限制）”条件中未翻译的间隔名称，如 PER_DAY。
• 修复了 Easy Model NPC 的 sit（坐姿）动画，该动画从未使用内置的坐姿。
• 修复了当玩家靠近时，对话气泡被 NPC 的头部截断的问题。
• 修改了对话气泡，使其保持屏幕大小，并在玩家靠近时向下或向侧面移动。
• 修改了对话气泡文本，使其比名称标记大 20%。
• 修改了基于时间的动作集，使其在使用“Wait（等待）”动作时按顺序运行，而不是选择一个条目。
• 修改了对话文本以延后换行，以便现有对话可以切换到更宽的屏幕布局。
• 修改了回退动作，使其像常规动作一样跳过没有玩家的屏幕动作。
• 将最低 Easy Model Entities 版本更改为 2.1.0，旧版本将禁用集成。
• 添加了“Wait（等待）”动作，该动作会将事件的后续动作暂停选定的持续时间。
• 添加了“Countdown Timekeeper”预设，这是一个倒数到十的对话气泡，并以声音和火花结束。
• 在“Experimental Features（实验性功能）”复选框下为 Doppler NPC 添加了缩放和旋转功能。两者仅影响接受它的实体的可见模型，而从不影响碰撞箱。
• 添加了“Sound（声音）”动作，可在 NPC 处播放声音，包含声音类别、音量和音高。
• 为“Execution Limit（执行限制）”条件添加了“Every 5 Minutes（每 5 分钟）”和“Every 15 Minutes（每 15 分钟）”。
• 添加了“Player Idle（玩家待机）”条件，用于检查玩家未移动的时间。
• 添加了“Immovable（不可移动）”属性，可防止 NPC 因推动和击退而移动。
• 添加了 /easy_npc pause 以暂停单个 NPC 或所有 NPC；全局暂停将在服务器关闭时结束。
• 添加了 API 访问声音动作、暂停状态和玩家空闲时间的功能。
• 通过 /easy_npc render texture 为 Easy Model NPC 的每个模型插槽添加了纹理覆盖。
• 为“Play Animation（播放动画）”动作添加了带有计数和时间限制的“Repeat（计时器）”播放模式。
• 添加了 API 访问 Easy Model NPC 的动画变体、纹理插槽和纹理的功能。

7.6.0

• 修复了重复实体数据跟踪器 ID 的不明确模组冲突错误。
• 修复了第三方血条在配置和对话屏幕的 NPC 预览上渲染的问题。
• 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而不是其模型大小的问题。
• 修复了 /easy_npc 命令在服务器上根本不建议任何 NPC UUID 的问题。
• 修复了“Set Pose（设置姿势）”动作的姿势列表绘制在其输入字段之上的问题。
• 修复了动作编辑器中未翻译的“Loop（循环）”、“After current（当前之后）”和“Action Data Type（动作数据类型）”标签。
• 修复了“Chance（概率）”条件缺失的提示文本。
• 修复了长条件提示在编辑器屏幕中溢出而不是换行的问题。
• 修复了“Message（消息）”动作未对齐的帮助图标和文本按钮。
• 修复了对“Set Pose（设置姿势）”、“Play Animation（播放动画）”和“Stop Animation（停止动画）”动作的更改无法保存的问题。
• 修复了对话气泡文本比其下边框更靠近其上边框的问题。
• 修改了 NPC 建议，将准星指向的 NPC 列在最前面，且在没有权限的情况下仅显示自己的 NPC。
• 修改了预设导出，使其仅存储与新 NPC 不同的内容，不包括位置或所有者。
• 修改了没有目标或动作的预设，使其回退到其 NPC 类型的默认值。
• 修改了没有玩家的事件（如“On Spawn（生成时）”或“On Kill（击杀时）”）以检查其条件。那里具有基于玩家的条件（例如记分板或物品）的动作将不再运行。
• 修改了基于时间的动作，每当所有者在附近时，选择所有者作为 @initiator（发起端）。
• 修改了对话气泡，根据文本长度保持可见 5 到 18 秒。
• 修改了“Set Pose（设置姿势）”动作，使其仅显示“custom（自定义）”姿势条目的输入字段。
• 添加了基于时间的动作，分为五个固定步骤，从每约 1 秒到每约 15 分钟。
• 添加了“Message（消息）”动作，用于聊天、系统消息和对话气泡文本，无需命令。
• 为“Message（消息）”动作添加了文本变体、发送者名称、接收者和翻译键。
• 将对话气泡图形添加为 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 添加了以百分比为单位的“Chance（概率）”条件以及针对所有者和派系的“Relationship（关系）”条件。
• 添加了生成、所有者登录、状态更改、白天/黑夜、天气以及缺失的“On Trade（交易时）”事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加了基础预设，可用作父预设。
• 添加了“Wandering Companion（流浪同伴）”预设，这是一个由基于时间的消息构建的健谈 NPC。
• 添加了动作注册表、动作处理程序、预设验证器以及供模组使用的更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。
• 改进了 NPC 建议，无需输入即可出现，并可容忍一个方块以内的误差。

7.5.0

• 修复了 #814，为每个 Cobblemon NPC 提供了自己的动画状态，而不是每个物种一个。
• 修复了 #813，使“Move back to Home（移回老家）”可以在任何距离工作，而不仅仅是在家附近。
• 修复了 #812，每会话检查一次玩家是否更改了皮肤。
• 修复了 #810，接受资源包的 Cobblemon 外观，而不仅仅是“shiny（闪亮）”和“female（雌性）”。
• 修复了 NPC 在重生或导入预设后丢失其所有者、家和“No Gravity（不受重力影响）”设置的问题。
• 修复了目标保持消失的目标，并在目标或模组消失时被关闭的问题。
• 修复了飞行 NPC（如 Allay、Vex 和 Ghast）在地面上移动而不是飞行的问题。
• 修复了对话、按钮、预设、姿势和纹理名称包含重复项或特殊字符的问题。
• 修复了条件在专用服务器上不可编辑和条件文本未翻译的问题。
• 修复了 Easy Model Entities NPC 不转头及其模型列表忽略 /reload 的问题。
• 将移动目标更改为固定顺序：逃亡、跟随、回家，然后漫步。因此，具有多个移动目标的 NPC 的行为可能与以前不同。
• 将数据包预设更改为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将所需的 Easy Model Entities 版本更改为 1.7.0，浮动模型现在默认悬停。
• 删除了实验性的用户定义 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 添加了具有数字、是/否和文本值的 NPC 状态，可用作条件、动作和命令。
• 添加了“Navigation（航行）”和“Hover height（悬停高度）”设置，用于在任何 NPC 之间切换地面和飞行。
• 添加了父预设、来自其他模组的预设、预设可见性和“Forge Keeper”预设。
• 为其他模组添加了自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 方块处添加了“On Far Distance（远距离）”事件，以及当所有者登录时再次生成 NPC 的选项。
• 通过预设 API 和自己的目标改进了飞行导航和第三方支持。

7.4.0

• 修复了 #807，不再将 32 方块内的每个同类型 NPC 拉入“Defend Self（自卫）”战斗。
• 修复了 #805，一起评估所有可见性设置，而不是在第一个设置处停止。
• 修复了 #804，在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和名称标记。
• 修复了 #803，调整资产以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复了白天和黑夜检测，该检测将日出算作夜晚，日落算作白天。
• 修复了下界和终末之地的可见性，该可见性使用主世界时间。
• 修复了时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复了游戏测试只能在其第一次断言时失败，这隐藏了后来的失败。
• 修复了“Saddled（已驯服）”马皮肤变体，它们从未显示马鞍。
• 修改了“Visible to Owner（对所有者可见）”和“Visible to Team（对队伍可见）”，使其也遵循白天、黑夜和游戏模式。
• 修改了没有“Crossed Arms（交叉双臂）”的唤魔者、幻术师和卫道士变体，使其保持双臂放下。
• 添加了“Defend Faction（保卫派系）”目标，该目标会攻击伤害附近派系成员或玩家的任何人。
• 添加了系统消息，当派系成员互相战斗且派系置身事外时。
• 为灾厄村民添加了头部装备槽，以便移除或交换其队长旗帜。
• 为显示配置屏幕添加了白天和黑夜预览。
• 为可见性属性和派系防御添加了单元和游戏测试。
• 通过每次检查只读取一次显示属性来提高可见性检查性能。
• 通过使用默认值完成旧版本的显示属性来改进它们。
• 通过在未设置时禁用“Protect Owner（保护主人）”和“Defend Faction（保卫派系）”来改进攻击目标屏幕。

7.3.0

• 通过将变体数据作为类型字段携带而不是解析变体名称来改进皮肤变体。
• 将 Cobblemon 模组 ID 和默认模型集中在共享常量上。
• 通过共享 EnumUtils 助手为 get(String) 查找减少了重复的枚举代码。
• 优化了村民职业和类型查找，以使用直接注册表键而不是扫描。
• 通过在构造时缓存标签名称、ID 和键来优化枚举名称查找。
• 为皮肤变体、村民解析和枚举助手添加了单元和游戏测试。

7.2.0

• 修复了 #801，通过使用 NPC、对话和动作 UUID 的组合来避免动作跟踪和执行限制的冲突。

7.1.1

• 修复了 #800，通过延迟加载实体类型。

7.1.0

• 修复了 #799，通过修复边缘情况并添加额外的文档和更好的日志消息。
• 修复了 #798，通过将控制台、命令和命令块视为可信命令源。
• 修复了关键的单人游戏 / LAN 问题，其中客户端和服务器 NPC 共享同一个注册表。
• 修复了配置菜单处理中的内存泄漏，并添加了超时和断开连接清理。
• 修复了当多个 NPC 同时请求相同皮肤时的重复下载。
• 修复了错误后皮肤查找失败，因此慢速服务器不再冻结游戏。
• 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏；检查现在在后台运行。
• 添加了新的 World Spawner（世界生成器）方块，它限制了整个世界（所有维度）的 NPC 预设；现有的 Group Spawner（群组生成器）目前按维度计算，因此遥远的 NPC 不再阻止它。
• 加强了远程皮肤下载，具有严格的大小限制和安全的重定向处理，以防止因过大或恶意的皮肤 URL 而崩溃；添加了可选的 blockPrivateAddresses 设置。
• 通过仅将实体和玩家加载事件发送给实际使用它们的 NPC（按维度分组）来提高服务器性能。

7.0.0

• 修复了 #791，添加了流浪商人 NPC 类型。
• 修复了 #788，将 AI 安全措施扩展到 Epic Fight 和原始 NPC 变体（猪灵、村民、末影人、苦力怕、袭击者和女巫）。
• 修复了 #787、#531、#237 和 #184，添加了带有 /easy_npc faction 命令的派系系统、每个 NPC 的派系分配以及自动记分板队伍同步。
• 修复了 #787、#771 和 #572，添加了新的 target（目标）目标选项卡，以攻击敌对派系或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复了 #786，为 Cobblemon NPC 添加了性别和闪亮模型变体，可在模型选择中通过 female 或 shiny 搜索。
• 通过添加新的 Attackable by Factions（可被派系攻击） 战斗属性，修复了无敌 NPC 之间的派系战斗。
• 通过使用 Cobblemon 自己的配置文件缩放而不是碰撞箱高度来缩放，修复了超大物种的 Cobblemon 模型选择预览。
• 通过验证派系名称、对派系列表进行排序以及在派系颜色或删除更改后刷新加载的 NPC 记分板分配，修复了派系管理边缘情况。
• 通过按皮肤模型加载和清除纹理缓存而不是始终重建完整的自定义纹理缓存，修复了自定义皮肤重新加载。
• 改进了 Attackable by Players/Monsters/Factions（可被玩家/怪物/派系攻击） 战斗属性，使其独立于 Invulnerable（存续） 工作，每个属性都为其自己的攻击者群体打开一个定向漏洞。
• 通过将大型处理程序拆分为更小的、专注于导入、导出和特定功能的组件，改进了预设命令和网络处理。
• 添加了 Easy Model Entities 支持。
• 添加了派系管理器和派系编辑器屏幕，用于创建、着色和删除派系以及管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 添加了新的 Misc（杂项） 属性选项卡作为 NPC 派系分配的所在地。
• 添加了可重用的警告和帮助图标组件，用于带有工具提示的内联提示。
• 为派系、目标和 Cobblemon 模型变体添加了额外的单元和游戏测试。

6.25.0

• 修复了 #780，为远程纹理下载添加了额外的缓存和优化。
• 修复了 #767，防止属性滑块受到来自其他模组的巨大数值的影响。
• 修复了 #754，为具有动作和条件的 NPC 添加了自定义数据物品匹配。
• 修复了纹理管理器在错误的线程中运行可能会导致 >= 1.21.x 中的崩溃和死锁。
• 修复了动作条件的空 UUID 问题导致意外行为。
• 修复了动作的执行限制重置。
• 添加了纹理注册队列以避免在同一刻内多次同时下载。
• 添加了 NPC 硬币、钥匙和红色代币作为具有动作和条件的 NPC 的消耗品。
• 添加了 Welcome Coin Trader 作为示例 NPC 预设，其中包含自定义硬币、钥匙和红色代币作为示例物品，以及用于动作和条件的新物品数据。
• 添加了针对来自其他模组的巨大数值的属性通用保护措施。
• 将回退最大生命值从 1024 增加到 4096，以允许更复杂的 NPC。
• 改进了纹理管理器并消除了重复的纹理检查和注册。

6.24.0

• 修复了 #459、#775，添加了阻止与不可见 NPC 交互的选项。
• 修复了与可选 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
• 修复了 #773，通过在基础刻期间和打开交易屏幕之前检查基于时间的交易重置。
• 通过正确增加内部刻度器来修复交易重置时机。
• 为 #459 添加了时间和天气条件。
• 为交易重置、刻度器处理和实体属性添加了额外的单元和游戏测试。
• 添加了 Skywatch Scout 作为示例 NPC 预设，其中包含时间和天气条件。

6.23.0

• 修复了 #772，通过调整 403 和 404 错误的纹理重试并降低日志记录。
• 修复了 #770 Epic Fight NPC（唤魔者、掠夺者、卫道士和人形皮肤）的物品渲染。
• 修复了 #769 NPC 不可靠地打开或关闭门的门循环。
• 修复了 #760，通过添加对话选项和配置设置（buttonConditionMode: LOCK 或 HIDE）来锁定或隐藏不可用的条件对话按钮。
• 修复了 #709，添加了带有 32 种颜色的名称颜色选择器弹出窗口和/或手动 RGB/十六进制值。
• 通过保留现有名称颜色，修复了在没有指定颜色的情况下重命名时重置 NPC 名称颜色的问题。
• 改进了门移动属性，以便在“Open Door（开门）”或“Close Door（关门）”处于活动状态时自动启用“Pass Door（穿门）”。

6.22.0

• 修复了 #766，通过将完整的服务器玩家上下文传递给命令执行，以更好地与依赖特定玩家数据的第三方模组和插件兼容。
• 修复了 #764，通过添加实体生命值、NPC 生命值条件和

... [内容过长已截断]

Easy NPC: Core（26.1.2）更新日志

注意

本更新日志包含变更摘要。如需完整更新日志，请前往[GitHub 历史记录][history]。

注意：更新到新版本前，请务必备份你的世界/NPC！更多信息请参阅[升级指南][upgrade_guide]。

7.7.7

• 修复 #821：保留 64x64 皮肤的透明度，这是 Fresh Moves 的眼睛所需。之前下载的皮肤需要在玩家皮肤界面点击按钮重新加载。
• 修复 #818：让交易动作也能作用于村民和流浪商人 NPC。
• 修复了具有多种文本变体的对话框每隔一秒切换一次气泡大小的问题。
• 修复皮肤缓存存储处理后的图像而非原始下载内容的问题。
• 修复未翻译的间隔名称，例如“执行限制”条件中的 PER_DAY。
• 修复 Easy Model NPC 的 sit 动画，该动画从未使用内置的坐姿。
• 修复当玩家靠近时，NPC 的头部会遮挡对话气泡的问题。
• 更改对话气泡，保持其屏幕尺寸不变，并在玩家靠近时向下移动或移到一侧。
• 更改对话气泡文本的渲染大小，比名牌大 20%。
• 更改包含“等待”动作的基于时间的动作集，使其按顺序执行而不是随机选取一项。
• 更改对话文本的换行位置，使现有对话可以切换到更宽的屏幕布局。
• 更改后备动作，使其像常规动作一样在没有玩家时跳过屏幕动作。
• 将 Easy Model Entities 的最低版本改为 2.1.0，旧版本会禁用集成。
• 添加“等待”动作，该动作会暂停事件的后续动作一段选定时间。
• 添加“倒计时计时员”预设，气泡从十倒数到零，以声音和火花结束。
• 在“实验性功能”复选框后面为 Doppler NPC 添加缩放和旋转。两者都只影响接受该功能的实体的可见模型，绝不会影响碰撞箱。
• 添加“声音”动作，该动作以声音类别、音量和音调在 NPC 处播放声音。
• 在“执行限制”条件中添加“每 5 分钟”和“每 15 分钟”选项。
• 添加“玩家空闲”条件，检查玩家多久没有移动。
• 添加“不可移动”属性，使 NPC 抵抗推动和击退并保持原位。
• 添加 /easy_npc pause 命令以暂停单个 NPC 或所有 NPC；全局暂停会随服务器结束。
• 为声音动作、暂停状态和玩家空闲时间添加 API 访问。
• 为 Easy Model NPC 添加 /easy_npc render texture 命令，可按模型槽位覆盖纹理。
• 为“播放动画”动作添加带次数和时间限制的“重复”播放模式。
• 为 Easy Model NPC 的动画变体、纹理槽和纹理添加 API 访问。

7.6.0

• 修复重复实体数据跟踪器 ID 导致的模糊模组冲突错误。
• 修复配置和对话框界面中第三方血条呈现在 NPC 预览之上的问题。
• 修复 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而非其模型尺寸的问题。
• 修复服务器上 /easy_npc 命令完全不提示 NPC UUID 的问题。
• 修复“设置姿势”动作的姿势列表绘制到其输入字段之上的问题。
• 修复动作编辑器中未翻译的“循环”、“当前之后”和“动作数据类型”标签。
• 修复“概率”条件缺失提示文本的问题。
• 修复长条件提示信息溢出编辑器界面而不换行的问题。
• 修复“消息”动作中帮助图标和文本按钮错位的问题。
• 修复对“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
• 修复对话气泡文本更靠近上边框而非下边框的问题。
• 更改 NPC 建议，优先列出准星指向的 NPC，且仅列出无权限时可操作自己的 NPC。
• 更改预设导出，仅存储与新 NPC 不同的内容，不包含位置或所有者。
• 更改没有目标或动作的预设，回退到其 NPC 类型的默认值。
• 更改没有玩家的事件（如“生成时”或“击杀时”），现在会检查其条件。其中基于玩家条件的动作（例如计分板或物品）不再执行。
• 更改基于时间的动作，当主人靠近时，选择主人作为 @initiator。
• 更改对话气泡的显示时间，根据文本长度在 5 到 18 秒之间。
• 更改“设置姿势”动作，仅对“自定义”姿势条目显示输入字段。
• 添加五个固定步骤的基于时间的动作，从约每 1 秒到约每 15 分钟。
• 添加“消息”动作，无需命令即可发送聊天、系统消息和对话气泡文本。
• 为“消息”动作添加文本变体、发送者名称、接收者和翻译键。
• 添加对话气泡图形文件 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 添加“概率”条件（百分比）和“关系”条件（用于主人和派系）。
• 添加生成、主人登录、状态改变、昼夜、天气以及缺失的“交易时”事件。
• 在 easy_npc:api/preset/base/ 下为每种 NPC 类型添加基础预设，可用作父预设。
• 添加“流浪伙伴”预设，一个由基于时间的消息构建的健谈 NPC。
• 为模组添加动作注册表、动作处理器、预设验证器和更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议添加名称、类型和距离的工具提示。
• 改进 NPC 建议，现在无需输入即可显示，并允许一格的近似匹配。

7.5.0

• 修复 NPC 的“家”位置始终显示为未设置的问题，这导致配置界面中“家”被隐藏、保存时跳过该选项，并使“返回家园”和“在家附近漫步”失效。
• 修复从预设、预设浏览器或重生生成的 NPC 从未获得家位置的问题。
• 修复从预设浏览器生成的 NPC 保留导出预设世界的家位置，而不是使用其生成位置的问题。
• 修复 NPC 在配置、皮肤和预设界面中被 Easy NPC 魔杖高亮时，以带阴影的白色剪影显示的问题。
• 修复 #814：为每个 Cobblemon NPC 提供独立的动画状态，而不是每个物种共享一个。
• 修复 #813：允许“返回家园”在任何距离生效，而不仅限于家附近。
• 修复 #812：每次会话只检查一次玩家是否更改了皮肤。
• 修复 #810：接受资源包中的 Cobblemon 外观，而不仅仅包括“闪光”和“雌性”。
• 修复带有“引诱”目标的 NPC 在触发目标时导致服务器崩溃的问题。
• 修复单个或 BOSS 刷怪笼在没有存储 NPC 的预设时无限制生成的问题。
• 修复新建 NPC 时出现“旧版 Easy NPC 数据”警告的问题。
• 修复旧版 64x32 皮肤缺少透明度校正，导致图层伪影的问题。
• 修复玩家皮肤界面在查找玩家名称时短暂冻结的问题。
• 修复“重置注视……”目标的标签，在某些语言中显示为“重置掉落物……”。
• 修复预设导入后“无重力”属性被忽略，导致 NPC 下坠的问题。
• 修复 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
• 修复 NPC 消失后再次生成时丢失主人的问题。
• 修复启动时提供目标的模组缺失导致 NPC 目标被删除的问题。
• 修复导入没有存储 ID 的预设时，生成的 NPC 没有主人和家的问题。
• 修复“跟随主人”和“注视主人”在主人变更后仍保留旧目标的问题。
• 修复目标实体消失后，攻击目标仍保留在 NPC 上的问题。
• 修复“注视物品”目标，该目标虽可存储但从未生效的问题。
• 修复 Doppler NPC 和第三方模型的行走动画。
• 修复 Forge 从未运行服务器启动步骤，导致整个会话中 NPC 跟踪、派系和自定义标识符索引为空的问题。
• 修复 Forge 开发模式启动时没有 mixin，导致原版实体调整被禁用，并在生成狐狸 NPC 时崩溃的问题。
• 更改移动目标为固定顺序：逃跑、跟随、回家，然后漫步。具有多个移动目标的 NPC 因此可能行为与之前不同。
• 更改将预设插入原版怪物刷怪笼时保留其延迟、数量和作用范围。
• 更改没有指定目标的“跟随主人”和“注视主人”将跟随 NPC 的主人。
• 将数据包预设移动到 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 更改预设浏览器，使其始终按相同顺序列出条目。
• 移除实验性的用户定义 NPC；额外的配置文件不再读取或创建。
• 移除未使用的 SERVER_SKIN 皮肤类型。
• 新增游戏测试结构以支持 1.21.11 及以上版本的游戏测试。
• 为玩家皮肤界面的每个条目添加重新加载按钮，以单独重新获取皮肤。
• 每当 NPC 被移除时都会在日志中添加原因，以便追踪意外的消失。
• 为 /easy_npc render set species 添加建议。
• 添加对其他模组预设的支持，无需再使用 easy_npc 命名空间。
• 添加预设可见性，可将预设从预设浏览器和 NPC 界面隐藏。
• 为跟随目标添加传送距离和休息点偏移。
• 为“跟随物品”添加物品标签、“可被吓到”选项和“仅无主人时”选项。
• 为注视目标添加物品字段，使 NPC 可以观看选定的掉落物品。
• 为每个 NPC 添加标识符，以便模组重新找到自己的 NPC。
• 添加一个选项，当主人登录时重新生成 NPC。
• 为 NeoForge 添加游戏测试（之前没有），并恢复 1.21.11 更新期间丢失的刷怪蛋、对话框界面、数据隔离和冒烟测试。
• 为每个配置和编辑器界面添加游戏测试，覆盖全部三个模组加载器。
• 为家位置添加游戏测试，覆盖生成默认值、存储值和重新加载。
• 改进模型名称解析，之前会将结尾为 _shiny 的物种误认为是变体。
• 改进飞行 NPC 的跟随行为，现在在没有空中路径时直接转向。
• 通过提供预设、自定义目标和目标配置的 API 改进第三方支持。

7.4.0

• 修复 #807：不再将 32 格范围内的所有同类 NPC 拉入“自卫”战斗。
• 修复 #805：不再在第一个可见性设置处停止，而是全部一起评估。
• 修复 #804：在 Doppler NPC 上保留自定义名称，以支持基于名称的纹理和名牌。
• 修复 #803：调整资源以匹配典型的 Minecraft 风格，而不是通用 UI 风格。
• 修复昼夜检测问题，之前将日出计为夜晚，日落计为白天。
• 修复下界和末地的可见性，之前使用的是主世界时间。
• 修复时间和游戏模式可见性复选框顺序随机的问题。
• 修复游戏测试只能在第一次断言时失败，导致后续失败被忽略的问题。
• 修复“带鞍”的马皮肤变体从未显示马鞍的问题。
• 更改“对主人可见”和“对队伍可见”也遵循昼夜和游戏模式。
• 更改没有“交叉手臂”的唤魔者、幻术师和卫道士变体，让手臂保持下垂。
• 添加“防御派系”目标，攻击任何伤害附近派系成员或玩家的人。
• 添加派系成员互相战斗而派系不介入时发送系统消息的功能。
• 为 Illager 添加头部装备槽，以便移除或更换队长旗帜。
• 在显示配置界面中添加昼夜预览。
• 为可见性属性和派系防御添加单元测试和游戏测试。
• 改进可见性检查性能，每次检查只读取一次显示属性。
• 改进旧版本的显示属性，自动补全默认值。
• 改进攻击目标界面，未设置“保护主人”和“防御派系”时禁用它们。

7.3.0

• 改进皮肤变体，将数据作为类型化字段承载，而不是解析变体名称。
• 将 Cobblemon 模组 ID 和默认模型集中到共享常量。
• 使用共享的 EnumUtils 辅助类简化 get(String) 查找，减少重复枚举代码。
• 优化村民职业和类型查找，改用直接注册表键而非扫描。
• 通过在构造时缓存标记名称、ID 和键，优化枚举名称查找。
• 为皮肤变体、村民解析和枚举辅助类添加单元测试和游戏测试。

7.1.2

• 修复 #801：使用组合方法生成 NPC、对话框和动作的 UUID，以避免动作跟踪和执行限制的冲突。

7.1.1

• 修复 #800：延迟加载实体类型。
• 修复 #799：修复边界情况，并添加额外文档和更好的日志消息。
• 修复 #798：将控制台、命令和命令方块视为可信的命令来源。
• 修复单人或局域网严重问题：客户端和服务器 NPC 共享同一个注册表。
• 修复配置菜单处理中的内存泄漏，并添加超时和断开连接清理。
• 修复多个 NPC 同时请求同一皮肤时重复下载的问题。
• 修复错误后皮肤查找失败，导致慢速服务器不再使游戏冻结的问题。
• 修复 URL 皮肤界面在检查远程图像时冻结游戏的问题；该检查现在在后台运行。
• 添加新方块“世界生成器”，可在整个世界（所有维度）范围内限制 NPC 预设；现有的“群体生成器”现在按维度计数，以免远处 NPC 阻塞它。
• 强化远程皮肤下载，增加严格大小限制和安全重定向处理，以防止超大或恶意皮肤 URL 导致的崩溃；添加可选的 blockPrivateAddresses 设置。
• 改进服务器性能，仅向实际使用实体和玩家加载事件的 NPC 发送这些事件，并按维度分组。

7.0.0

• 修复 #794：使用预期的类型进行 NPC 渲染。
• 修复缩放屏幕预览，将实体脚部固定到缩放标尺的 0 线上，使 NPC 从底部向上缩放而非从中心，并且不再在边界框更新后向下偏移。
• 修复 #791：添加流浪商人 NPC 类型。
• 修复 #788：将 AI 保护扩展到 Epic Fight 和原始 NPC 变体（猪灵、村民、末影人、苦力怕、袭击者和女巫）。
• 修复 #787、#531、#237 和 #184：添加派系系统，包含 /easy_npc faction 命令、每 NPC 派系分配和自动计分板队伍同步。
• 修复 #787、#771 和 #572：添加新的“目标”选项卡，可攻击敌对派系或按玩家名、队伍、实体标签或 UUID 指定的目标。
• 修复 #786：为 Cobblemon NPC 添加性别和闪光模型变体，可在模型选择中搜索 female 或 shiny。
• 修复无敌 NPC 之间的派系战斗：添加新的“可被派系攻击”战斗属性。
• 修复 Cobblemon 模型选择预览对超大物种的显示，改为使用 Cobblemon 自身的档案缩放而非碰撞箱高度。
• 修复派系管理的边界情况：验证派系名称、排序派系列表，并在派系颜色或删除变更后刷新已加载 NPC 的计分板分配。
• 修复自定义皮肤重新加载，现在按皮肤模型加载和清除纹理缓存，而不是总是重建整个自定义纹理缓存。
• 改进“可被玩家/怪物/派系攻击”战斗属性，使其独立于“无敌”工作，每个属性为自身的攻击者群体打开一个针对性漏洞。
• 改进预设命令和网络处理，将大型处理器拆分为更小、更专注的导入、导出和功能特定组件。
• 添加 Easy Model Entities 支持。
• 添加派系管理器和派系编辑界面，可创建、着色和删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全特性保护。
• 添加新的“杂项”属性选项卡，作为 NPC 派系分配的家园。
• 添加可复用的警告和帮助图标组件，用于带工具提示的内联提示。
• 为派系、目标对象和 Cobblemon 模型变体添加额外的单元测试和游戏测试。

6.25.0

• 修复 #782、#636、#622：在验证期间保留数据组件。
• 修复 #780：缓存远程纹理下载，减少重复注册。
• 修复 #767：将属性滑块限制在来自其他模组的极端值范围内。
• 修复 #754：为带动作和条件的 NPC 添加自定义数据物品匹配。
• 修复纹理管理器在错误的线程中运行，可能在 ≥ 1.21.x 中导致崩溃和死锁的问题。
• 修复动作条件的空 UUID 处理。
• 修复动作的执行限制重置。
• 添加纹理注册队列，以避免同一 tick 内同时多次下载。
• 添加 NPC 硬币、钥匙和红色代币作为可消耗物品，供带动作和条件的 NPC 使用。
• 添加“欢迎硬币商人”作为示例 NPC 预设，带有自定义硬币、钥匙和红色代币物品数据。
• 添加属性保护，防止来自其他模组的极端值。
• 将高生命 NPC 的回退最大生命值从 1024 提高到 4096。
• 改进纹理管理器，减少重复纹理检查和注册。

6.24.0

• 修复 #459、#775：添加选项以阻止与隐形 NPC 的交互。
• 修复 #774：与可选 Epic Fight 和 Cobblemon 实体类型图相关的启动崩溃。
• 修复 #773：在基础 tick 期间和打开交易界面之前检查定时交易重置。
• 通过正确增加内部 ticker 修复交易重置时机。
• 为 #459 添加时间、天气条件。
• 为交易重置、ticker 处理和实体属性添加额外的单元测试和游戏测试。
• 添加“天空守望者”作为示例 NPC 预设，带有时、天气条件。

6.23.0

• 修复 #774：将 isSunBurnTick 错误迁移到 26.x。
• 修复 #772：调整 403 和 404 错误的纹理重试，并降低日志级别。
• 修复 #770：Epic Fight NPC（唤魔者、掠夺者、卫道士和人形皮肤）的物品渲染。
• 修复 #769：NPC 不能可靠地开合门的问题。
• 修复 #760：添加对话框选项和配置设置（buttonConditionMode：LOCK 或 HIDE），可锁定或隐藏不可用的条件对话框按钮。
• 修复 #709：为名称添加 32 种颜色和/或手动 RGB/十六进制值的颜色选择器弹窗。
• 修复重命名未指定颜色时 NPC 名称颜色被重置的问题，现在保留现有名称颜色。
• 改进门移动属性，使“开门”或“关门”激活时自动启用“通过门”。

6.22.0

• 修复 #766：向命令执行传递完整的服务器玩家上下文，以便更好地兼容依赖特定玩家数据的第三方模组和插件。
• 修复 #764：添加实体生命、NPC 生命条件，并添加 NPC 预设“格雷克，训练桩”作为使用这些条件的示例。
• 修复 #763：确保对话框按钮的执行限制现在会被记录。
• 修复 #758：提供名为“许愿伙伴”的示例 NPC 预设。
• 修复与第三方村民 AI 读取 Easy NPC 村民上未注册的大脑记忆（如 PoiCompetitorScan / job_site）相关的崩溃 #756。
• 修复对话框按钮对服务器端数据未锁定，为 #760 和 #644 做准备。
• 修复 #628：添加条件对话框打开支持/命令，以更好地控制何时向玩家显示对话框。
• 为猪灵和猪灵蛮兵 NPC 添加大脑 AI，并注册完整的原版大脑记忆集合。
• 为 #757 向枪标签添加额外的枪。
• 添加新的“打开对话框（条件）”动作，仅当条件满足时打开指定对话框；现有的“打开对话框”动作保持无条件打开。
• 为动作、对话框和对话框按钮添加新的实体生命和 NPC 生命条件。
• 添加猪灵、猪灵蛮兵和僵尸猪灵 NPC 的无敌特性，以与其他 NPC

... [内容过长已截断]

Easy NPC 更新日志 (1.20.1)

说明

本更新日志包含变更摘要。如需查看完整更新日志，请前往 [GitHub 历史记录][history]。

注意：更新到新版本前，请务必备份你的世界/NPC！更多信息请参阅[升级指南][upgrade_guide]。

7.7.7

• 修复 #821：保留 64x64 皮肤的透明通道，这是 Fresh Moves 眼部效果所需的。此前下载的皮肤需要通过玩家皮肤界面中的按钮重新加载。
• 修复 #818：村民和流浪商人NPC现在也会执行交易动作。
• 修复：包含多个文本变体的对话框每秒切换其说话气泡大小的问题。
• 修复：皮肤缓存存储处理后的图像而非原始下载内容的问题。
• 修复："执行限制"条件中未翻译的间隔名称（如 PER_DAY）。
• 修复：Easy Model NPC 的 sit 动画从不使用内置坐姿的问题。
• 修复：玩家靠近NPC时，说话气泡被NPC头部遮挡的问题。
• 调整：说话气泡保持屏幕尺寸不变，并在玩家靠近时向下或向一旁移动。
• 调整：说话气泡文字的渲染尺寸比名称标签大 20%。
• 调整：带有"等待"动作的定时动作集现在按顺序执行，而不是随机选择一条执行。
• 调整：对话框文本的换行时机延后，使现有对话框可以切换到更宽的屏幕布局。
• 调整：后备动作现在会跳过没有玩家在场的界面动作，与常规动作一致。
• 调整：Easy Model Entities 的最低版本要求提升至 2.1.0，旧版本将禁用集成。
• 新增："等待"动作：在指定时长内暂停事件后续动作的执行。
• 新增："倒计时计时员"预设：一个数到十的说话气泡，结束时播放音效并迸发火花。
• 新增："实验性功能"复选框后的多普勒NPC缩放与旋转功能。两者仅影响接受该功能的实体的可见模型，绝不影响碰撞箱。
• 新增："声音"动作：在NPC处播放声音，支持声音类别、音量和音调。
• 新增："每 5 分钟"和"每 15 分钟"选项至"执行限制"条件。
• 新增："玩家待机"条件：检查玩家多长时间没有移动。
• 新增："无法移动"属性：使NPC免受推动和击退，保持原位。
• 新增：/easy_npc pause 命令，可暂停单个或所有NPC；全局暂停会随服务器结束而停止。
• 新增：API 可访问声音动作、暂停状态和玩家的待机时间。
• 新增：通过 /easy_npc render texture 为 Easy Model NPC 的各模型槽位提供纹理覆盖。
• 新增："播放动画"动作的"重复"播放模式，支持次数和时间限制。
• 新增：API 可访问 Easy Model NPC 的动画变体、纹理槽位和纹理。

7.6.0

• 修复：实体数据跟踪器 ID 重复导致的模糊模组冲突错误。
• 修复：在配置和对话框界面中，第三方生命值条渲染在NPC预览上方的问题。
• 修复：多普勒和 Easy Model Entities NPC 使用默认碰撞箱而非其模型尺寸的问题。
• 修复：在服务器上 /easy_npc 命令不提示任何 NPC UUID 的问题。
• 修复："设置姿势"动作的姿势列表绘制在其输入框上方的问题。
• 修复：动作编辑器中未翻译的"循环"、"当前之后"和"动作数据类型"标签。
• 修复："概率"条件缺少提示文本的问题。
• 修复：长条件提示超出编辑器屏幕而不换行的问题。
• 修复："消息"动作的帮助图标和文本按钮未对齐的问题。
• 修复："设置姿势"、"播放动画"和"停止动画"动作的更改无法保存的问题。
• 修复：说话气泡文本距离上边界比下边界更近的问题。
• 调整：NPC建议列表现在将准星所指NPC排在首位；无权限时仅显示自己的NPC。
• 调整：预设导出现在仅存储与新建NPC不同的内容，不包含位置或所有者。
• 调整：没有目标或动作的预设现在回退到其NPC类型的默认值。
• 调整："生成时"或"击杀时"等没有玩家参与的事件现在会检查其条件。其中带有基于玩家条件的动作（例如记分板或物品）将不再执行。
• 调整：定时动作在所有者附近时，将以所有者作为 @initiator。
• 调整：说话气泡的可见时间根据文本长度从 5 秒到 18 秒不等。
• 调整："设置姿势"动作现在仅对"自定义"姿势条目显示输入框。
• 新增：五个固定间隔的定时动作，从每约 1 秒到每约 15 分钟。
• 新增："消息"动作：无需命令即可发送聊天、系统消息和说话气泡文本。
• 新增："消息"动作的文本变体、发送者名称、接收者和翻译键。
• 新增：说话气泡图像，路径为 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 新增：百分比"概率"条件，以及用于所有者和派系的"关系"条件。
• 新增：生成、所有者登录、状态改变、昼夜、天气以及缺失的"交易时"事件。
• 新增：每个NPC类型的基类预设，位于 easy_npc:api/preset/base/ 下，可用作父级预设。
• 新增："流浪伙伴"预设：一个由定时消息构建的健谈NPC。
• 新增：动作注册表、动作处理器、预设验证器以及更丰富的事件数据，供模组使用。
• 新增：/easy_npc 命令的每个NPC建议均附带包含名称、类型和距离的提示框。
• 改进：NPC建议现在无需输入即可显示，并允许一个方块的近似误差。

7.5.0

• 修复 #814：为每个方块宝可梦NPC提供独立的动画状态，而不是每个种类共享一个。
• 修复 #813："返回家园"现在可以在任意距离生效，而不仅仅在家园附近。
• 修复 #812：每个会话检查一次玩家是否更换了皮肤。
• 修复 #810：接受资源包中方块宝可梦的特性，而不仅仅是"闪光"和"雌性"。
• 修复：NPC 在重生或导入预设后丢失所有者、家园和"不受重力影响"设置的问题。
• 修复：目标保留已消失的目标，并在其目标或模组消失时被关闭的问题。
• 修复：悦灵、恼鬼和恶魂等飞行NPC在地面移动而不是飞行的问题。
• 修复：包含重复或特殊字符的对话框、按钮、预设、姿势和纹理名称的问题。
• 修复：专用服务器上条件无法编辑以及条件文本未翻译的问题。
• 修复：Easy Model Entities NPC 不转头及其模型列表忽略 /reload 的问题。
• 调整：移动目标现在按固定顺序执行：逃跑、跟随、返回家园、然后闲逛。因此具有多个移动目标的NPC行为可能与之前不同。
• 调整：数据包预设路径改为 easy_npc/preset/，旧文件夹仍然有效，但仅限 easy_npc。
• 调整：Easy Model Entities 的最低版本要求提升至 1.7.0，悬浮模型现在默认悬停。
• 移除：实验性的用户自定义NPC和未使用的 SERVER_SKIN 皮肤类型。
• 新增：NPC状态，支持数字、是/否和文本值，可用作条件、动作和命令。
• 新增："航行"和"悬停高度"设置，可在任何NPC的地面与飞行模式之间切换。
• 新增：父级预设、其他模组的预设、预设可见性，以及"锻造守护者"预设。
• 新增：自定义条件、事件、NPC标识符，以及更多供其他模组使用的目标选项。
• 新增：32 格距离的"远距离时"事件，以及所有者在登录时再次生成NPC的选项。
• 改进：飞行航行，并通过API为预设和自定义目标提供第三方支持。

7.4.0

• 修复 #807：不再将 32 格内所有同类型NPC卷入"自卫"战斗。
• 修复 #805：综合评估所有可见性设置，而不是在第一个设置处停止。
• 修复 #804：在多普勒NPC上保留自定义名称，使基于名称的纹理和名称标签正常工作。
• 修复 #803：调整资源以符合典型 Minecraft 风格，而非通用 UI 风格。
• 修复：昼夜检测将日出计为夜晚、日落计为白天的问题。
• 修复：下界和末地的可见性使用主世界时间的问题。
• 修复：时间和游戏模式可见性复选框以随机顺序出现的问题。
• 修复：游戏测试只能在第一个断言处失败，从而隐藏后续失败的问题。
• 修复："鞍装"马匹皮肤变体从不显示马鞍的问题。
• 调整："对所有者可见"和"对队伍可见"现在也遵循昼夜和游戏模式。
• 调整：没有"交叉手臂"的唤魔者、幻术师和卫道士变体现在保持手臂下垂。
• 新增："保护派系"目标：攻击任何伤害附近派系成员或玩家的人。
• 新增：当派系成员互相战斗且派系不介入时，显示系统消息。
• 新增：灾厄村民的头部装备槽，使其队长旗帜可以被移除或替换。
• 新增：显示配置界面中的昼夜预览。
• 新增：可见性属性和派系防御的单元测试与游戏测试。
• 改进：可见性检查性能，每次检查仅读取一次显示属性。
• 改进：旧版本的显示属性将使用默认值补全。
• 改进：攻击目标界面，在"保护主人"和"保护派系"未设置时将其禁用。

7.3.0

• 改进：皮肤变体以类型化字段携带数据，而不是解析变体名称。
• 集中：将方块宝可梦模组ID和默认模型统一到共享常量。
• 减少：使用共享的 EnumUtils 辅助类进行 get(String) 查找，减少重复的枚举代码。
• 优化：村民职业和类型的查找使用直接注册表键，而非扫描。
• 优化：枚举名称查找，在构造时一次性缓存标签名、ID和键。
• 新增：皮肤变体、村民解析和枚举辅助类的单元测试与游戏测试。

7.2.0

• 修复 #801：NPC、对话框和动作的 UUID 采用组合方式，避免动作跟踪和执行限制的冲突。

7.1.1

• 修复 #800：实体类型采用懒加载。

7.1.0

• 修复 #799：修复边界情况，补充文档和更完善的日志信息。
• 修复 #798：将控制台、命令和命令方块视为可信命令来源。
• 修复：单人/局域网模式中客户端与服务器NPC共享同一注册表的关键问题。
• 修复：配置菜单处理中的内存泄漏，并增加超时和断线清理。
• 修复：多个NPC同时请求同一皮肤时的重复下载问题。
• 修复：出错后皮肤查找失败的问题，慢速服务器不再卡死游戏。
• 修复：URL 皮肤界面检查远程图像时卡死游戏的问题；检查现在在后台运行。
• 新增："世界生成器"方块，可在整个世界（所有维度）范围内限制某个NPC预设的数量；现有的"分组生成器"现在按维度计数，远处的NPC不再阻塞它。
• 强化：远程皮肤下载的严格大小限制和安全重定向处理，防止超大或恶意皮肤URL导致崩溃；新增可选的 blockPrivateAddresses 设置。
• 改进：服务器性能，仅将实体和玩家加载事件发送给实际使用这些事件的NPC，并按维度分组。

7.0.0

• 修复 #791：新增流浪商人NPC类型。
• 修复 #788：将AI安全保护扩展到史诗战斗和原始NPC变体（猪灵、村民、末影人、苦力怕、劫持者和女巫）。
• 修复 #787、#531、#237 和 #184：新增派系系统，包括 /easy_npc faction 命令、每个NPC的派系分配和自动记分板队伍同步。
• 修复 #787、#771 和 #572：新增"目标"选项卡，可按玩家名称、队伍、实体标签或UUID攻击敌对派系或特定目标。
• 修复 #786：为方块宝可梦NPC新增性别和闪光模型变体，可在模型选择中通过 female 或 shiny 搜索。
• 修复：无敌NPC之间的派系战斗，新增"可被派系攻击"战斗属性。
• 修复：方块宝可梦模型选择中大型种类的预览，使用方块宝可梦自身的轮廓比例而非碰撞箱高度进行缩放。
• 修复：派系管理的边界情况，包括验证派系名称、排序派系列表，以及在派系颜色或删除更改后刷新已加载NPC的记分板分配。
• 修复：自定义皮肤重新加载，按皮肤模型加载和清除纹理缓存，而不是总是重建完整的自定义纹理缓存。
• 改进："可被玩家/怪物/派系攻击"战斗属性现在独立于"无敌"工作，各自为对应的攻击者群体打开一个定向缺口。
• 改进：预设命令和网络处理，将大型处理器拆分为更小、更专注的导入、导出和特定功能组件。
• 新增：Easy Model Entities 支持。
• 新增：派系管理和派系编辑器界面，可创建、着色、删除派系并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 新增："杂项"属性选项卡，作为NPC派系分配的所在位置。
• 新增：可复用的警告和帮助图标组件，用于带提示框的行内提示。
• 新增：派系、目标目标和方块宝可梦模型变体的额外单元测试与游戏测试。

6.25.0

• 修复 #780：为远程纹理下载增加额外的缓存和优化。
• 修复 #767：保护属性滑块免受其他模组天文数字般数值的影响。
• 修复 #754：为带动作和条件的NPC新增自定义数据物品匹配。
• 修复：纹理管理器在错误线程中运行可能导致 1.21.x+ 崩溃和死锁的问题。
• 修复：动作条件使用空 UUID 导致意外行为的问题。
• 修复：动作执行限制重置的问题。
• 新增：纹理注册队列，避免同一游戏刻内多个同时下载。
• 新增：NPC硬币、钥匙和红色令牌作为消耗品，供带动作和条件的NPC使用。
• 新增："欢迎硬币商人"作为示例NPC预设，配有自定义硬币、钥匙和红色令牌作为示例物品，以及用于动作和条件的新物品数据。
• 新增：针对来自其他模组的天文数字般属性值的通用保护。
• 提升：后备最大生命值从 1024 提高到 4096，以支持更复杂的NPC。
• 改进：纹理管理器，消除重复的纹理检查和注册。

6.24.0

• 修复 #459、#775：新增阻止与隐形NPC交互的选项。
• 修复 #774：与可选的史诗战斗和方块宝可梦实体类型映射相关的启动崩溃。
• 修复 #773：在基础游戏刻期间以及打开交易界面前检查定时交易重置。
• 修复：交易重置时机，正确增加内部计数器。
• 新增 #459：时间段和天气条件。
• 新增：交易重置、计数器处理和实体属性的额外单元测试与游戏测试。
• 新增："观天斥候"作为示例NPC预设，包含时间段和天气条件。

6.23.0

• 修复 #772：调整 403 和 404 错误的纹理重试策略，并降低日志记录

Easy NPC 更新日志（1.20.1）

说明

本更新日志包含简要变更摘要。完整更新日志请前往 [GitHub 历史记录][history] 查看。

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

7.7.7

• 修复 #821，保留 64x64 皮肤透明度，Fresh Moves 需要透明部分来显示眼睛。此前下载的皮肤需通过玩家皮肤界面中的按钮重新加载。
• 修复 #818，村民和流浪商人 NPC 现在也能执行交易动作。
• 修复包含多个文本变体的对话每秒钟切换一次气泡尺寸的问题。
• 修复皮肤缓存存储处理后的图像而非原始下载文件的问题。
• 修复“执行限制”条件中未翻译的间隔名称，如 PER_DAY。
• 修复 Easy Model NPC 的 sit 动画，此前从未使用内置坐姿。
• 修复玩家靠近 NPC 时，对话气泡被 NPC 头部遮挡的问题。
• 修改对话气泡，使其保持屏幕尺寸，并在玩家靠近时向下或向侧面移动。
• 修改对话气泡文字，使其比名称标签大 20%。
• 修改基于时间且包含“等待”动作的动作组，改为按顺序执行，而非随机选择一项。
• 修改对话文本换行时机，使现有对话可切换至更宽的屏幕布局。
• 修改后备动作，与常规动作一致，在没有玩家时跳过屏幕动作。
• 将 Easy Model Entities 最低版本要求提升至 2.1.0，旧版本将禁用集成功能。
• 新增“等待”动作，可暂停事件后续动作一段指定时长。
• 新增“倒计时计时员”预设，通过对话气泡倒数至十，并以音效和火花收尾。
• 为“实验性功能”复选框后的 Doppler NPC 新增缩放和旋转功能。两者仅影响接受该功能的实体的可见模型，不影响碰撞箱。
• 新增“音效”动作，可在 NPC 位置播放带有音效类别、音量和音高的声音。
• 在“执行限制”条件中新增“每 5 分钟”和“每 15 分钟”选项。
• 新增“玩家待机”条件，用于检测玩家多久没有移动。
• 新增“不可移动”属性，使 NPC 不受推动和击退影响。
• 新增 /easy_npc pause 命令，可暂停单个或所有 NPC；全局暂停在服务器关闭时结束。
• 为 API 新增音效动作、暂停状态和玩家待机时间的访问接口。
• 为 Easy Model NPC 新增每个模型槽位的纹理覆盖功能，可通过 /easy_npc render texture 使用。
• 在“播放动画”动作中新增带次数和时间限制的“重复”播放模式。
• 为 API 新增 Easy Model NPC 的动画变体、纹理槽位和纹理访问接口。

7.6.0

• 修复因重复实体数据跟踪器 ID 导致的模糊模组冲突错误。
• 修复第三方血条渲染在配置和对话界面上覆盖 NPC 预览的问题。
• 修复 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而非模型尺寸的问题。
• 修复服务器上 /easy_npc 命令不提示任何 NPC UUID 的问题。
• 修复“设置姿势”动作的姿势列表覆盖其输入框的问题。
• 修复动作编辑器中未翻译的“循环”“当前之后”和“动作数据类型”标签。
• 修复“几率”条件缺失提示文字的问题。
• 修复长条件提示文字超出编辑界面而非换行的问题。
• 修复“消息”动作中对齐错误的帮助图标和文本按钮。
• 修复“设置姿势”“播放动画”和“停止动画”动作的修改无法保存的问题。
• 修复对话气泡文字更靠近上边框而非下边框的问题。
• 修改 NPC 建议列表，将准星指向的 NPC 排在首位，且在无权限时只显示自己的 NPC。
• 修改预设导出，仅存储与新 NPC 不同的内容，不包含位置或所有者。
• 修改没有目标或动作的预设，使其回退到该 NPC 类型的默认值。
• 修改没有玩家的事件（如“生成时”或“击杀时”），现在会检查其条件。带有基于玩家的条件（例如计分板或物品）的动作将不再执行。
• 修改基于时间的动作，当所有者附近时，将所有者选为 @initiator。
• 修改对话气泡的显示时长，根据文本长度在 5 至 18 秒之间。
• 修改“设置姿势”动作，仅对“自定义”姿势条目显示输入框。
• 新增五个固定步骤的基于时间的动作，从约每 1 秒到每 15 分钟。
• 新增“消息”动作，可在不使用命令的情况下发送聊天、系统消息和对话气泡文本。
• 为“消息”动作新增文本变体、发送者名称、接收者和翻译键。
• 新增对话气泡图形，路径为 easy_npc:textures/gui/speech_bubble.png，可供资源包使用。
• 新增“几率”条件（百分比）和“关系”条件（用于所有者与派系）。
• 新增生成、所有者登录、状态变化、昼夜、天气和缺失的“交易时”事件。
• 为每种 NPC 类型新增基础预设，路径为 easy_npc:api/preset/base/，可用作父预设。
• 新增“漫游伙伴”预设，一个基于时间消息构建的健谈 NPC。
• 为模组新增动作注册表、动作处理器、预设验证器和更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议新增包含名称、类型和距离的提示信息。
• 改进 NPC 建议，无需输入即可显示，并允许一个方块内的近似匹配。

7.5.0

• 修复 #814，为每个 Cobblemon NPC 分配独立的动画状态，而非每个物种共享一个。
• 修复 #813，使“返回家园”可在任意距离生效，而非仅在家园附近。
• 修复 #812，每个会话仅检查一次玩家是否更换皮肤。
• 修复 #810，接受资源包中的 Cobblemon 特征，而非仅支持“闪光”和“雌性”。
• 修复 NPC 在重生或导入预设后丢失所有者、家园和“无重力”设置的问题。
• 修复目标消失后仍保留目标，以及在目标或模组消失时目标被关闭的问题。
• 修复悦灵、恼鬼和恶魂等飞行 NPC 在地面移动而非飞行的问题。
• 修复对话、按钮、预设、姿势和纹理名称存在重复或特殊字符的问题。
• 修复条件在专用服务器上无法编辑以及条件文本未翻译的问题。
• 修复 Easy Model Entities NPC 不转头，以及模型列表忽略 /reload 的问题。
• 修改移动目标为固定顺序：逃跑、跟随、返回家园，然后漫步。因此拥有多个移动目标的 NPC 的行为可能与此前不同。
• 修改数据包预设路径为 easy_npc/preset/，旧文件夹仍然有效，但仅适用于 easy_npc。
• 将 Easy Model Entities 最低版本要求提升至 1.7.0，浮动模型现在默认悬停。
• 移除实验性的用户自定义 NPC 和未使用的 SERVER_SKIN 皮肤类型。
• 新增 NPC 状态（数字、是/否和文本值），可用作条件、动作和命令。
• 新增“导航”和“悬停高度”设置，可在任意 NPC 的地面与飞行模式之间切换。
• 新增父预设、其他模组的预设、预设可见性以及“锻造守护者”预设。
• 为其他模组新增自定义条件、事件、NPC 标识符和更多目标选项。
• 在 32 格距离处新增“远距离时”事件，以及当所有者登录时再次生成 NPC 的选项。
• 改进飞行导航和第三方支持，提供预设和自定义目标的 API。

7.4.0

• 修复 #807，不再将 32 格范围内的所有同类型 NPC 拉入“自卫”战斗。
• 修复 #805，将所有可见性设置一起评估，而非在第一个设置处停止。
• 修复 #804，在 Doppler NPC 上保留自定义名称，用于基于名称的纹理和名称标签。
• 修复 #803，调整资源以符合典型 Minecraft 风格，而非通用 UI 风格。
• 修复昼夜检测，此前将日出计为夜晚，日落计为白天。
• 修复下界和末地的可见性检测，此前使用的是主世界时间。
• 修复时间和游戏模式可见性复选框的顺序随机问题。
• 修复游戏测试只能在第一次断言时失败，导致后续失败被隐藏的问题。
• 修复“鞍”马皮肤变体从未显示鞍的问题。
• 修改“仅所有者可见”和“仅队伍可见”现在也遵循昼夜和游戏模式。
• 修改没有“交叉双臂”的唤魔者、幻术师和卫道士变体保持手臂下垂。
• 新增“守卫派系”目标，攻击任何伤害附近派系成员或玩家的人。
• 新增派系成员互相攻击时派系保持中立的系统消息。
• 为灾厄村民新增头部装备槽位，以便移除或替换队长的旗帜。
• 在显示配置界面新增昼夜预览。
• 为可见性属性和派系防御新增单元测试和游戏测试。
• 改进可见性检查性能，每次检查仅读取一次显示属性。
• 改进旧版本的显示属性，以默认值补全。
• 改进攻击目标界面，在未设置“保护所有者”和“守卫派系”时禁用对应选项。

7.3.0

• 改进皮肤变体，以类型化字段承载数据，而非解析变体名称。
• 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
• 通过共享的 EnumUtils 辅助方法来减少重复的枚举代码，用于 get(String) 查找。
• 优化村民职业和类型查找，直接使用注册表键而非扫描。
• 优化枚举名称查找，在构造时缓存标签名称、ID 和键。
• 为皮肤变体、村民解析和枚举辅助方法新增单元测试和游戏测试。

7.2.0

• 修复 #801，使用组合方式生成 NPC、对话和动作的 UUID，避免动作跟踪和执行限制中的冲突。

7.1.1

• 修复 #800，采用懒加载实体类型。

7.1.0

• 修复 #799，修复边缘情况并补充文档和更好的日志信息。
• 修复 #798，将控制台、命令和命令方块视为可信命令来源。
• 修复单人游戏 / LAN 模式中的严重问题，即客户端和服务器 NPC 共享同一注册表。
• 修复配置菜单处理中的内存泄漏，并增加超时和断开连接清理。
• 修复多个 NPC 同时请求相同皮肤时重复下载的问题。
• 修复皮肤查找出错后无法恢复，导致服务器缓慢时游戏冻结的问题。
• 修复 URL 皮肤界面在检查远程图像时冻结游戏的问题；检查现在在后台进行。
• 新增世界生成方块（World Spawner），可在整个世界（所有维度）中限制 NPC 预设；现有的分组生成器（Group Spawner）现在按维度计数，远距离 NPC 不再阻塞它。
• 加强远程皮肤下载，设置严格的大小限制和安全的重定向处理，防止超大或恶意皮肤 URL 导致崩溃；新增可选的 blockPrivateAddresses 设置。
• 改进服务器性能，仅向实际使用实体和玩家加载事件的 NPC 发送相关事件，并按维度分组。

7.0.0

• 修复 #791，新增流浪商人 NPC 类型。
• 修复 #788，将 AI 安全防护扩展到 Epic Fight 和原始 NPC 变体（猪灵、村民、末影人、苦力怕、劫持者和女巫）。
• 修复 #787、#531、#237 和 #184，新增派系系统，包含 /easy_npc faction 命令、每个 NPC 的派系分配和自动计分板队伍同步。
• 修复 #787、#771 和 #572，新增“目标”目标选项卡，可攻击敌对派系或按玩家名称、队伍、实体标签或 UUID 攻击特定目标。
• 修复 #786，为 Cobblemon NPC 新增性别和闪光模型变体，可在模型选择中通过“female”或“shiny”搜索。
• 修复无敌 NPC 之间的派系战斗，新增“可被派系攻击”战斗属性。
• 修复 Cobblemon 模型选择对超大型物种的预览，改用 Cobblemon 自身的轮廓缩放而非碰撞箱高度。
• 修复派系管理的边缘情况，包括验证派系名称、排序派系列表以及在派系颜色或删除更改后刷新已加载的 NPC 计分板分配。
• 修复自定义皮肤重新加载，改为按皮肤模型加载和清除纹理缓存，而非总是重建完整的自定义纹理缓存。
• 改进“可被玩家/怪物/派系攻击”战斗属性，使其独立于“无敌”工作，每个属性为各自的攻击者群体开放针对性的缺口。
• 改进预设命令和网络处理，将大型处理器拆分为更小的专项导入、导出和功能特定组件。
• 新增 Easy Model Entities 支持。
• 新增派系管理器和派系编辑器界面，可创建、着色和删除派系，并管理敌对关系，受新的 FACTION_MANAGEMENT 安全功能保护。
• 新增“杂项”属性选项卡，作为 NPC 派系分配的主页。
• 新增可复用的警告和帮助图标组件，用于带提示的内联说明。
• 为派系、目标目标和 Cobblemon 模型变体新增额外的单元测试和游戏测试。

6.25.0

• 修复 #780，为远程纹理下载增加额外缓存和优化。
• 修复 #767，为属性滑块增加防护，防止其他模组设置天文数字般的数值。
• 修复 #754，新增带动作和条件的 NPC 的自定义数据物品匹配。
• 修复纹理管理器在错误线程中运行可能导致崩溃和死锁的问题（>= 1.21.x）。
• 修复动作条件为空 UUID 导致意外行为的问题。
• 修复动作执行限制重置问题。
• 新增纹理注册队列，避免同一 tick 内多次同时下载。
• 新增 NPC 硬币、钥匙和红色令牌作为可消耗物品，供带动作和条件的 NPC 使用。
• 新增“欢迎硬币商人”示例 NPC 预设，使用自定义硬币、钥匙和红色令牌作为示例物品，并为动作和条件提供新的物品数据。
• 为属性新增通用防护，防止其他模组设置天文数字般的数值。
• 将后备最大生命值从 1024 提高到 4096，以支持更复杂的 NPC。
• 改进纹理管理器，消除重复的纹理检查和注册。

6.24.0

• 修复 #459、#775，新增阻止与隐形 NPC 交互的选项。
• 修复 #774，与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的启动崩溃。
• 修复 #773，在基础 tick 期间和打开交易界面之前检查定时交易重置。
• 修复交易重置计时，正确增加内部 ticker。
• 为 #459 新增时间（昼夜）和天气条件。
• 为交易重置、ticker 处理和实体属性新增额外的单元测试和游戏测试。
• 新增“望天侦察兵”示例 NPC 预设，包含时间和天气条件。

6.23.0

• 修复 #772，调整 403 和 404 错误下的纹理重试，并降低日志级别。
• 修复 #770，Epic Fight NPC（唤魔者、掠夺者、卫道士和人形皮肤）的物品渲染问题。
• 修复 #769，NPC 反复开关门的问题。
• 修复 #760，新增对话选项和配置设置（buttonConditionMode: LOCK 或 HIDE），可锁定或隐藏不可用的条件对话按钮。
• 修复 #709，为名称新增 32 色颜色选择器弹出窗口，支持手动输入 RGB/十六进制值。
• 修复重命名时未指定颜色导致 NPC 名称颜色重置的问题，现在会保留原有名称颜色。
• 改进门的移动属性，使“开门”或“关门”激活时自动启用“通过门”。

6.22.0

• 修复 #766，将完整的服务器玩家上下文传递给命令执行，以更好地兼容依赖特定玩家数据的第三方模组和插件。
• 修复 #764，新增实体生命值、NPC 生命值条件，并提供 NPC 预设 木桩陪练格鲁克 作为使用这些条件的示例。
• 修复 #763，确保对话按钮的执行限制现在被记录。
• 修复 #758，提供名为 一个愿望伙伴 的示例 NPC 预设。
• 修复与第三方村民 AI 读取 Easy NPC 村民上未注册的大脑记忆相关的崩溃（例如 PoiCompetitorScan / job_site）#756。
• 修复对话按钮未为服务器端数据锁定，为 #760 和 #644 做准备。
• 修复 #628，新增条件对话打开支持 / 命令，以更好地控制对话向玩家显示的时间。
• 为猪灵和猪灵蛮兵 NPC 新增大脑 AI，并注册完整的原版大脑记忆集。
• 为 #757 在枪标签中新增额外枪械。
• 新增“打开对话（条件）”动作，仅在其条件满足时打开指定对话；现有的“打开对话”动作继续无条件打开对话。
• 为动作、对话和对话按钮新增实体生命值和 NPC 生命值条件。
• 新增猪灵、猪灵蛮兵和僵尸猪灵 NPC 的无敌状态，与其他 NPC 保持一致。
• 新增“击退免疫”战斗属性，防止 NPC 被近战或弹射物攻击击退。
• 新增“爆炸免疫”战斗属性，使 NPC 免疫爆炸伤害和位移（例如 TNT、苦力怕、末影水晶）。
• 将“弹射物碰撞”属性移至战斗属性界面，在主题上更合适（此前位于能力界面）。

6.21.0

• 修复灾厄村民交叉手臂姿势下的物品附着问题。
• 修复灾厄村民弩攻击目标损坏的问题。
• 修复与第三方物品相关的崩溃，这些物品无法作为手持物品渲染 #756。
• 修复与第三方 mixin 尝试访问不存在的模型部件相关的崩溃 #756。
• 修复 log.info 垃圾信息，降低日志详细程度并为自定义模型部件增加额外检查。
• 改进 EasyNPCModelManager 性能。
• 重构 NPC 渲染器，移除默认手持物品层。

6.20.0

• 修复与第三方模组尝试访问不存在的 NPC 目标相关的崩溃。

6.19.0

注意：本次更新将对话背景图像调整了 10x6 像素，使用自定义对话背景的用户可能需要调整其自定义背景。

• 修复 #752、#130，新增对话按钮条件支持，可禁用按钮。
• 修复 #683、#215，为对话文本新增打字机效果支持。
• 修复 #690、#309，允许为对话、对话按钮和交互设置条件。
• 修复对话界面布局和背景的较小 UI 问题。
• 重构对话背景图像，每边调整 10x6 像素。
• 重构对话界面布局，以更好地适应新的背景尺寸并改善外观。
• 为对话文本新增打字机效果和客户端配置。
• 新增条件符号，用于指示对话、按钮和交互的条件状态。
• 新增物品条件的数量字段，可检查特定数量的物品。
• 新增 阈值守卫 示例 NPC 预设，包含各种条件和动作。
• 新增与对话条件和按钮状态相关的较小修复和优化。

6.18.0

注意：本次更新更改了条件和动作的内部数据格式，可能重置 / 移除没有存储 ID 的旧版执行限制条目。

• 修复 #745，为动作新增条件，允许更复杂和动态的行为。
• 修复 #652，为较长文本的对话按钮新增提示信息。
• 修复 #687，新增命令值提示信息以显示完整值。
• 新增经验等级条件。
• 新增游戏模式条件。
• 新增物品栏中拥有物品的条件。
• 新增手持物品的条件（支持主手和副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增 金湖矿工 示例 NPC 预设，包含各种条件和动作。
• 新增否定条件支持，允许对条件取反以实现更复杂的逻辑。
• 移除 `Acti

... [内容过长已截断]

Easy NPC：核心（26.1.2）更新日志

注意事项

本更新日志仅包含变更摘要。完整更新日志请前往 [GitHub 提交历史][history] 查看。

注意：更新至新版本前，请务必备份你的世界/NPC 数据！
更多详情请查阅 [升级指南][upgrade_guide]。

7.7.0

• 修复了重复实体数据追踪器 ID 导致的模组冲突错误提示不明确的问题。
• 修复了第三方生命条在配置和对话界面中覆盖 NPC 预览的问题。
• 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非模型实际尺寸的问题。
• 修复了服务器上 /easy_npc 命令完全不建议任何 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表覆盖其输入框的问题。
• 修复了动作编辑器中“循环”、“当前之后”和“动作数据类型”标签未翻译的问题。
• 修复了“概率”条件缺少提示文本的问题。
• 修复了过长的条件提示超出编辑器屏幕而不自动换行的问题。
• 修复了“消息”动作的帮助图标与文本按钮错位的问题。
• 修复了对“设置姿势”、“播放动画”和“停止动画”动作的修改无法保存的问题。
• 修复了对话气泡文字距离上边缘比下边缘更近的问题。
• 调整 NPC 建议列表，优先显示准星所指的 NPC，并且仅显示无权限限制的自有 NPC。
• 调整预设导出逻辑，仅存储与新建 NPC 不同的部分，不再包含位置或所有者信息。
• 调整不含目标或动作的预设，回退至其 NPC 类型的默认值。
• 调整无玩家参与的事件（如“生成时”或“被击杀时”）现在会检查其条件。若其中的动作包含基于玩家的条件（例如计分板或物品），则不再执行。
• 调整基于时间的动作，当所有者在附近时，将其设为 @initiator。
• 调整对话气泡可见时间为 5 至 18 秒，具体取决于文本长度。
• 调整“设置姿势”动作，仅在选择“自定义”姿势时才显示输入框。
• 将所需的 Easy Model Entities 版本提升至 2.0.1。
• 将所需的 Forge 版本提升至 64.1.0。
• 新增五种固定间隔的基于时间的动作，从约每 1 秒到约每 15 分钟。
• 新增“消息”动作，支持聊天、系统消息和对话气泡文本，无需命令。
• 为“消息”动作新增文本变体、发送者名称、接收者和翻译键。
• 新增对话气泡图像资源 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 新增“概率”条件（百分比）和“关系”条件（针对所有者与阵营）。
• 新增生成、所有者登录、状态变更、昼夜、天气以及缺失的“交易时”事件。
• 为每种 NPC 类型新增基础预设，路径为 easy_npc:api/preset/base/，可用作父级预设。
• 新增“漫游伙伴”预设，该 NPC 通过基于时间的消息进行交谈。
• 为模组新增动作注册表、动作处理器、预设验证器及更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议新增包含名称、类型

Easy NPC：核心（26.1.2）更新日志

注意

此更新日志仅包含变更摘要。完整更新日志请前往 [GitHub 提交历史][history] 查看。

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

7.7.0

• 修复了重复实体数据追踪器 ID 导致的模组冲突错误提示不明确的问题。
• 修复了第三方血条在配置和对话界面中覆盖 NPC 预览的问题。
• 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非模型实际尺寸的问题。
• 修复了服务器上 /easy_npc 命令完全不建议任何 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表覆盖其输入框的问题。
• 修复了动作编辑器中“循环”、“当前之后”和“动作数据类型”标签未翻译的问题。
• 修复了“概率”条件缺少提示文本的问题。
• 修复了较长的条件提示超出编辑器屏幕范围而不自动换行的问题。
• 修复了“消息”动作的帮助图标与文字按钮错位的问题。
• 修复了对“设置姿势”、“播放动画”和“停止动画”动作的修改无法保存的问题。
• 修复了对话气泡文本距离上边框比下边框更近的问题。
• 将 NPC 建议列表调整为优先显示准星所指的 NPC，且仅显示无权限限制的自有 NPC。
• 修改预设导出逻辑，仅存储与新建 NPC 不同的部分，不再包含位置或所有者信息。
• 修改无目标或动作的预设会回退到其 NPC 类型的默认值。
• 修改无玩家参与的事件（如“生成时”或“被击杀时”）也会检查其条件。例如，若其中包含基于玩家的条件（如计分板或物品），则不会执行。
• 修改基于时间的动作在所有者靠近时会将其设为 @initiator。
• 修改对话气泡可见时间根据文本长度动态调整，范围为 5 至 18 秒。
• 修改“设置姿势”动作仅在选择“自定义”姿势时才显示输入框。
• 将所需的 Easy Model Entities 版本提升至 2.0.1。
• 将所需的 Forge 版本提升至 64.1.0。
• 新增五种固定间隔的基于时间的动作，间隔从约 1 秒至约 15 分钟。
• 新增“消息”动作，支持在不使用命令的情况下发送聊天消息、系统消息和对话气泡文本。
• 为“消息”动作新增文本变体、发送者名称、接收者和翻译键支持。
• 新增对话气泡图形资源 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 新增“概率”（百分比）条件和“关系”条件（针对所有者与阵营）。
• 新增生成、所有者登录、状态变更、昼夜、天气以及缺失的“交易时”事件。
• 为每种 NPC 类型新增基础预设，路径为 easy_npc:api/preset/base/，可用作父预设。
• 新增“漫游伙伴”预设，该 NPC 通过基于时间的消息进行交谈。
• 为其他模组新增动作注册表、动作处理器、预设验证器及更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议新增工具提示，显示名称、类型和距离。
• 改进了 NPC 建议

Easy NPC：核心（26.1.2）更新日志

注意

此更新日志仅包含变更摘要。完整更新日志请参阅 [GitHub 提交历史][history]。

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

7.7.0

• 修复了实体数据追踪器 ID 重复时模组冲突错误提示不明确的问题。
• 修复了第三方血条在配置和对话界面中覆盖 NPC 预览的问题。
• 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非模型实际尺寸的问题。
• 修复了在服务器上 /easy_npc 命令完全不建议任何 NPC UUID 的问题。
• 修复了“设置姿势”动作的姿势列表覆盖其输入框的问题。
• 修复了动作编辑器中“循环”、“当前之后”和“动作数据类型”标签未翻译的问题。
• 修复了“概率”条件缺少提示文本的问题。
• 修复了较长的条件提示超出编辑器屏幕而不自动换行的问题。
• 修复了“消息”动作的帮助图标与文字按钮错位的问题。
• 修复了对“设置姿势”、“播放动画”和“停止动画”动作的修改无法保存的问题。
• 修复了对话气泡文本距离上边框比下边框更近的问题。
• 将 NPC 建议列表调整为优先显示准星所指的 NPC，且仅显示自己拥有权限的 NPC。
• 修改预设导出逻辑，仅存储与新建 NPC 不同的部分，不再包含位置或所有者信息。
• 修改无目标或动作的预设，回退至其 NPC 类型的默认配置。
• 修改无玩家参与的事件（如“生成时”或“击杀时”）现在会检查其条件。例如，若其中包含基于玩家的条件（如记分板或物品），则不再执行。
• 修改基于时间的动作，在所有者靠近时将其设为 @initiator。
• 修改对话气泡显示时长根据文本长度动态调整，范围为 5 至 18 秒。
• 修改“设置姿势”动作，仅在选择“自定义”姿势时才显示输入框。
• 将 Easy Model Entities 的最低版本要求提升至 2.0.1。
• 将 Forge 的最低版本要求提升至 64.1.0。
• 新增五种固定间隔的基于时间的动作，间隔从约 1 秒到约 15 分钟。
• 新增“消息”动作，支持聊天、系统消息和对话气泡，无需命令。
• 为“消息”动作新增文本变体、发送者名称、接收者和翻译键支持。
• 新增对话气泡图形资源 easy_npc:textures/gui/speech_bubble.png，供资源包使用。
• 新增“概率”（百分比）条件和“关系”条件（针对所有者与阵营）。
• 新增生成、所有者登录、状态变更、昼夜、天气及缺失的“交易时”事件。
• 为每种 NPC 类型新增基础预设，路径为 easy_npc:api/preset/base/，可用作父预设。
• 新增“漫游伙伴”预设，该 NPC 通过基于时间的消息进行互动。
• 为模组新增动作注册表、动作处理器、预设验证器及更丰富的事件数据。
• 为 /easy_npc 命令的每个 NPC 建议新增工具提示，显示名称、类型和距离。
• 改进了 NPC 建议功能，即使未输入内容也会显示，

Easy NPC（1.20.1）版本更新日志

说明

本更新日志仅汇总重点变更内容。完整变更记录请参阅
[GitHub 历史记录][history]。

注意：升级至新版本前，请务必备份您的世界存档及NPC数据！
更多详情请查阅[升级指南][upgrade_guide]。

7.6.0

• 修复了因实体数据追踪器ID重复导致的模组冲突错误提示不明确的问题。
• 修复了第三方生命值条在配置界面与对话界面中覆盖NPC预览图的问题。
• 修复了多普勒雷达NPC与Easy Model Entities NPC使用默认碰撞箱而非模型实际尺寸的问题。
• 修复了服务器环境下/easy_npc命令完全不提示任何NPC UUID的问题。
• 修复了“设置姿态”动作的姿态列表遮挡其输入框的问题。
• 修复了动作编辑器中未翻译的“循环”、“当前之后”及“动作数据类型”标签。
• 修复了“概率”条件缺少提示文字的问题。
• 修复了长条件提示文字超出编辑器界面范围、未能自动换行的问题。
• 修复了“消息”动作中帮助图标与文字按钮位置错位的问题。
• 修复了对“设置姿态”、“播放动画”及“停止动画”动作的修改无法保存的问题。
• 修复了对话气泡文字距离上边界比下边界更近的问题。
• 调整NPC建议列表，优先显示准心指向的NPC，并仅显示拥有权限的自有NPC。
• 调整预设导出逻辑，仅保存与新建NPC相比存在差异的部分，不包含位置与所有者信息。
• 调整不含目标或动作的预设，使其回退至对应NPC类型的默认配置。
• 调整“生成时”或“被击杀时”等无玩家参与的事件，使其同样校验条件；
  例如含玩家相关条件（记分板或物品）的动作将不再执行。
• 调整基于时间触发的动作，在所有者靠近时自动将所有者设为@initiator。
• 调整对话气泡显示时长，根据文本长度在5至18秒之间动态变化。
• 调整“设置姿态”动作，仅当选择“自定义”姿态时才显示其输入框。
• 新增五档固定时间间隔的动作：从约每1秒一次，到约每15分钟一次。
• 新增“消息”动作，支持聊天栏消息、系统消息及对话气泡文本，无需命令。
• 为“消息”动作新增文本变体、发送者名称、接收者及本地化键名支持。
• 将对话气泡图形资源路径设为easy_npc:textures/gui/speech_bubble.png，便于资源包调用。
• 新增“概率”条件（以百分比表示）及“关系”条件（针对所有者与派系）。
• 新增生成、所有者登录、状态变更、昼夜、天气及缺失的“交易时”事件。
• 在easy_npc:api/preset/base/路径下为每种NPC类型新增基础预设，可作为父级预设使用。
• 新增“流浪伙伴”预设——一个基于定时消息构建的健谈型NPC。
• 新增动作注册表、动作处理器、预设验证器及更丰富的事件数据，便于其他模组扩展。
• 为/easy_npc命令的所有NPC建议项新增工具提示，显示名称、类型与距离。
• 改进NPC建议功能：无需输入即可触发，且允许1格范围内的微小误差。

7.5.0

• 通过为每个方块宝可梦NPC分配独立动画状态（而非每物种共用一个），修复#814。
• 通过使“返回家园”移动指令可在任意距离生效（而不仅限于家园附近），修复#813。
• 通过每会话仅检查一次玩家皮肤是否变更，修复#812。
• 通过接受资源包中除“闪光”与“雌性”外的其他方块宝可梦特性，修复#810。
• 修复NPC在重生或导入预设后丢失所有者、家园及“无重力”设置的问题。
• 修复目标已消失时目标型目标仍保留、以及目标或所属模组消失时目标被自动关闭的问题。
• 修复悦灵、恼鬼、恶魂等飞行类NPC在地面移动而非飞行的问题。
• 修复对话、按钮、预设、姿态及贴图名称存在重复或特殊字符的问题。
• 修复专用服务器下条件不可编辑及条件文本未翻译的问题。
• 修复Easy Model Entities NPC不转动头部，以及模型列表在/reload后失效的问题。
• 将移动目标的执行顺序固定为：逃离→跟随→返回家园→闲逛；
  含多个移动目标的NPC行为可能因此与之前不同。
• 将数据包预设路径调整为easy_npc/preset/；旧路径仍可使用，但仅限easy_npc模组。
• 将所需Easy Model Entities版本提升至1.7.0；浮动模型现默认悬浮。
• 移除实验性的用户自定义NPC及未使用的SERVER_SKIN皮肤类型。
• 新增NPC状态支持，可存储数字、是/否及文本值，可用于条件、动作及命令。
• 新增“导航”与“悬停高度”设置，用于切换NPC在地面行走或空中飞行。
• 新增父级预设、其他模组预设、预设可见性控制及“锻造守护者”预设。
• 为其他模组新增自定义条件、事件、NPC标识符及更多目标选项。
• 新增“远距离时”事件（32格），并新增所有者登录时重新生成NPC的选项。
• 通过提供预设与自定义目标的API，改进飞行导航及第三方支持。

7.4.0

• 修复#807：不再将32格内所有同类型NPC拉入“自卫”战斗。
• 修复#805：统一评估所有可见性设置，而非遇到首个即停止。
• 修复#804：为多普勒雷达NPC保留自定义名称，确保名称相关贴图与名称标签正常显示。
• 修复#803：调整资源以匹配典型Minecraft风格，而非通用UI风格。
• 修复昼夜检测错误：此前将日出判定为夜间、日落判定为白天。
• 修复下界与末地可见性错误：此前使用主世界时间判断。
• 修复时间与游戏模式可见性复选框随机排序问题。
• 修复游戏测试仅在首次断言失败时报告、后续失败被隐藏的问题。
• 修复“已装鞍”马匹皮肤变体始终不显示马鞍的问题。
• 调整“对所有者可见”与“对队伍可见”，使其同步遵循昼夜与游戏模式设置。
• 调整唤魔者、幻术师与卫道士变体（无“双臂交叉”）的姿态，使其手臂自然下垂。
• 新增“保卫派系”目标：攻击伤害附近派系成员或玩家的实体。
• 新增派系成员互斗时的系统消息，且派系自身不介入战斗。
• 为灾厄村民新增头部装备槽，便于移除或更换其队长旗帜。
• 新增昼夜预览功能，集成至显示配置界面。
• 新增可见性属性与派系防御功能的单元测试及游戏测试。
• 优化可见性检测性能：每次检测仅读取一次显示属性。
• 通过补全默认值，优化旧版本显示属性的兼容性。
• 优化攻击目标界面：当未启用时，禁用“保护所有者”与“保卫派系”。

7.3.0

• 优化皮肤变体：以类型化字段存储数据，而非解析变体名称字符串。
• 将方块宝可梦模组ID与默认模型集中至共享常量。
• 通过共享EnumUtils辅助类实现get(String)查找，减少枚举代码重复。
• 优化村民职业与类型查找：使用直接注册表键而非扫描。
• 优化枚举名称查找：在构造时缓存标签名、ID与键，提升性能。
• 新增皮肤变体、村民解析及枚举辅助类的单元测试与游戏测试。

7.2.0

• 修复#801：为NPC、对话及动作UUID引入组合机制，避免动作追踪与执行限制冲突。

7.1.1

• 修复#800：对实体类型采用懒加载。

7.1.0

• 修复#799：修正边界情况，并补充文档与更清晰的日志信息。
• 修复#798：将控制台、命令及命令方块视为可信命令源。
• 修复单人游戏/局域网关键问题：客户端与服务端NPC共用同一注册表。
• 修复配置菜单处理中的内存泄漏，并新增超时与断开连接清理机制。
• 修复多个NPC同时请求同一皮肤时重复下载的问题。
• 修复皮肤查找失败后游戏卡死问题（慢速服务器场景）。
• 修复URL皮肤界面在验证远程图片时冻结游戏的问题；现改为后台运行验证。
• 新增“世界生成器”方块：限制NPC预设在整个世界（所有维度）的生成数量；
  现有“群组生成器”改为按维度计数，避免远距离NPC阻塞生成。
• 强化远程皮肤下载：严格限制文件大小、安全处理重定向，防止超大或恶意皮肤URL导致崩溃；
  新增可选blockPrivateAddresses设置。
• 优化服务器性能：仅向实际使用实体与玩家加载事件的NPC发送对应事件，并按维度分组。

7.0.0

• 修复#791：新增流浪商人NPC类型。
• 修复#788：扩展AI防护机制，覆盖Epic Fight及原版NPC变体（猪灵、村民、末影人、苦力怕、劫掠者、女巫）。
• 修复#787、#531、#237与#184：新增派系系统，含/easy_npc faction命令、每NPC派系分配及自动记分板队伍同步。
• 修复#787、#771与#572：新增“目标”目标页签，支持攻击敌对派系或特定目标（玩家名、队伍、实体标签、UUID）。
• 修复#786：为方块宝可梦NPC新增性别与闪光模型变体，可在模型选择中通过female或shiny搜索。
• 修复无敌NPC间派系战斗问题：新增“派系可攻击”战斗属性。
• 修复方块宝可梦模型预览对超大体型物种适配不佳问题：改用方块宝可梦自身轮廓缩放比例，而非碰撞箱高度。
• 修复派系管理边界情况：校验派系名称、排序派系列表、在派系颜色或删除变更后刷新已加载NPC的记分板分配。
• 修复自定义皮肤重载问题：按皮肤模型分别加载与清除贴图缓存，而非重建全部自定义贴图缓存。
• 优化“玩家/怪物/派系可攻击”战斗属性：各属性独立于Invulnerable生效，分别为对应攻击者群体单独开放漏洞。
• 优化预设命令与网络处理：将大型处理器拆分为小型、聚焦于导入、导出及特定功能的组件。
• 新增Easy Model Entities支持。
• 新增派系管理器与派系编辑器界面，用于创建、着色、删除派系及管理敌对关系；受新FACTION_MANAGEMENT安全特性保护。
• 新增“杂项”属性页签，作为NPC派系分配的归属位置。
• 新增可复用警告与帮助图标组件，支持带工具提示的内联提示。
• 新增派系、目标目标及方块宝可梦模型变体的单元测试与游戏测试。

6.25.0

• 修复#780：为远程贴图下载新增额外缓存与优化。
• 修复#767：为属性滑块增加防护，防止其他模组传入天文数字。
• 修复#754：为含动作与条件的NPC新增自定义数据物品匹配支持。
• 修复贴图管理器在错误线程运行可能导致1.21.x及以上版本崩溃与死锁的问题。
• 修复动作条件中空UUID导致意外行为的问题。
• 修复动作执行限制重置问题。
• 新增贴图注册队列，避免同一刻度内多次并发下载。
• 新增NPC金币、钥匙与红令牌作为消耗品，供含动作与条件的NPC使用。
• 新增“欢迎金币商人”示例NPC预设，含自定义金币、钥匙与红令牌作为示例物品，及动作与条件的新物品数据。
• 新增通用属性防护机制，防止其他模组传入天文数字。
• 将后备最大生命值上限从1024提升至4096，以支持更复杂的NPC。
• 优化贴图管理器，消除重复的贴图检查与注册。

6.24.0

• 修复#459、#775：新增阻止与隐形NPC交互的选项。
• 修复#774：与可选Epic Fight及方块宝可梦实体类型映射相关的启动崩溃。
• 修复#773：在基础刻度及打开交易界面前检查限时交易重置。
• 修复交易重置时机：正确增加内部计时器。
• 为#459新增昼夜与天气条件。
• 新增交易重置、计时器处理及实体属性的单元测试与游戏测试。
• 新增“天穹哨兵”示例NPC预设，含昼夜与天气条件。

6.23.0

• 修复#772：调整贴图重试机制，支持403与404错误并降低日志等级。
• 修复#770：Epic Fight NPC（唤魔者、掠夺者、卫道士及拟人化皮肤）的物品渲染。
• 修复#769：NPC开门/关门循环不稳定问题。
• 修复#760：新增对话选项与配置设置（buttonConditionMode: LOCK或HIDE），支持锁定或隐藏不可用的条件对话按钮。
• 修复#709：新增名称颜色选择弹窗，支持32种预设色及手动RGB/十六进制值。
• 修复重命名时未指定颜色导致NPC名称颜色重置问题：保留现有名称颜色。
• 优化门移动属性：“通过门”在“开门”或“关门”激活时自动启用。

6.22.0

• 修复#766：向命令执行传递完整服务器玩家上下文，提升与依赖特定玩家数据的第三方模组/插件兼容性。
• 修复#764：新增实体生命值、NPC生命值条件，及示例NPC预设Grukk, the Sparring Post演示这些条件。
• 修复#763：确保对话按钮执行限制现在被正确记录。
• 修复#758：提供名为One Wish Companion的示例NPC预设。
• 修复#756：第三方村民AI（如PoiCompetitorScan / job_site）读取Easy NPC村民未注册脑部记忆导致的崩溃。
• 修复对话按钮未对服务端数据锁定，为#760与#644做准备。
• 修复#628：新增条件对话开启支持/命令，增强对对话向玩家展示时机的控制。
• 为猪灵与猪灵蛮兵NPC新增脑部AI，并注册完整原版脑部记忆集。
• 为#757新增更多枪械至枪械标签。
• 新增“开启对话（条件式）”动作：仅当满足条件时才开启指定对话；原有“开启对话”动作保持无条件开启。
• 新增实体生命值与NPC生命值条件，适用于动作、对话及对话按钮。
• 为猪灵、猪灵蛮兵与僵尸猪灵NPC新增无敌设定，与其他NPC保持一致。
• 新增“击退免疫”战斗属性：防止NPC被近战或投射物攻击击退。
• 新增“爆炸免疫”战斗属性：使NPC免疫爆炸伤害与位移（如TNT、苦力怕、末影水晶）。
• 将“投射物碰撞”属性移至战斗属性界面（原位于能力界面），主题更契合。

6.21.0

• 修复灾厄村民在双臂交叉姿态下的物品附着问题。
• 修复灾厄村民十字弓攻击目标失效问题。
• 修复#756：第三方物品无法作为手持物品渲染导致的崩溃。
• 修复#756：第三方混入尝试访问不存在模型部件导致的崩溃。
• 修复日志信息泛滥：降低日志详细程度，为自定义模型部件添加额外检查。
• 提升EasyNPCModelManager性能。
• 重构NPC渲染器，移除默认手持物品图层。

6.20.0

• 修复第三方模组尝试访问不存在NPC目标导致的崩溃。

6.19.0

注意：本次更新将对话背景图调整为每边10×6像素，若使用自定义对话背景，用户需相应调整。

• 修复#752、#130：新增对话按钮条件支持，允许禁用按钮。
• 修复#683、#215：新增对话文本打字机效果支持。
• 修复#690、#309：允许对话、对话按钮及交互添加条件。
• 修复对话界面布局与背景的小型UI问题。
• 重构对话背景图：每边调整10×6像素。
• 重构对话界面布局：适配新背景尺寸，提升外观。
• 新增对话文本打字机效果及客户端配置。
• 新增条件符号：指示对话、按钮及交互的条件状态。
• 新增物品条件的数量字段：支持检查特定数量的物品。
• 新增Threshold Warden示例NPC预设，含多种条件与动作。
• 新增小型BUG修复与对话条件、按钮状态相关优化。

6.18.0

注意：本次更新更改了条件与动作的内部数据格式，可能导致遗留的执行限制条目（无存储ID）被重置/移除。

• 修复#745：为动作新增条件支持，实现更复杂、动态的行为。
• 修复#652：为长文本对话按钮新增工具提示。
• 修复#687：为命令值新增工具提示，显示完整值。
• 新增经验等级条件。
• 新增游戏模式条件。
• 新增物品在物品栏中条件。
• 新增物品在手中条件（支持主手与副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增Goldmere示例NPC预设，含多种条件与动作。
• 新增否定条件支持：允许对条件取反，实现更复杂逻辑。
• 移除ActionDataEntry的参数伪ID，替换为随机UUID。
• 重构条件系统，支持更多条件类型。

6.17.0

• 修复#738：为“以玩家身份执行”新增额外工具提示。
• 通过降低启动及游戏中log.info消息，优化详细日志。
• 新增单元测试与游戏测试。

6.16.0

• 修复#732：提供禁用对话ESC键与关闭按钮的选项。
• 修复#723：在交易界面等特定情况下避免自动关闭。
• 新增通用对话配置选项，允许用户自定义对话行为。
• 新增对话头像缩放与位置偏移选项。
• 新增缺失的本地化键名。

6.15.0（交易、玩家头颅、Epic Fight与体验优化更新）

• 修复#731：若客户端物种列表为空，则重新同步物种数据。
• 修复#730：改进Epic Fight集成并启用实验性功能。
• 修复#729：确保交易使用次数正确存储。
• 修复#728：新增玩家头颅自定义支持。
• 修复#689：显示剩余交易次数，并支持手动与自动重置。
• 修复#218与#132：新增交易配置界面及对自定义交易的更好支持。
• 修复交易特有边界情况：在基础与普通/高级交易模式间切换。
• 修复对话按钮文本截断问题，工具提示显示完整文本。
• 修复方块宝可梦动画问题：同步动画状态至方块宝可梦动画系统。
• 新增每笔交易专属动作：允许用户在购买后触发动作。
• 新增交易重置按钮：轻松重置所有交易。
• 新增交易使用信息至交易配置界面。
• 新增实验性功能开关：允许用户手动启用实验性功能。
• 新增示例商人Griselda Grindstone，含动作。
• 清理测试文件。

6.14.0（方块宝可梦支持与对话改进）

• 修复#727：确保值变更时同步至客户端。
• 修复#726：为特定命令新增额外白名单。
• 修复#686、#389、#304、#211：新增基础方块宝可梦支持（含方块宝可梦NPC）。
• 修复对话错位与导航问题：调整对话精灵图与界面。
• 修复X与Z轴根部旋转：修正旋转逻辑与枢轴点计算。
• 新增基础方块宝可梦支持：含自定义NPC类型与测试用模型。

6.13.0（安全与权限更新）

说明：本次更新增强了多人游戏环境的安全检查与权限控制。部分服务端命令若被恶意利用可能存在风险。

本次更新将模型根部数据与逻辑从其余模型部件数据与逻辑中分离，可能导致现有NPC的根部旋转与缩放重置为默认值。

• 修复#725：将模型根部数据与逻辑与其他模型部件数据与逻辑分离。
• 修复#722：支持.sbnt文件作为本地预设。
• 修复#675：为对话与配置界面背景新增专用资源。
• 修复#605、#532、#529：新增安全检查与权限系统。
• 修复#469、#311：新增实验性API文档与自定义模型支持示例。
• 修复配置界面背景重复渲染问题：移除冗余背景渲染。
• 修复恶魂碰撞箱与名称标签位置问题：调整包围盒。
• ⚠️

... [内容过长已截断]

Easy NPC（1.20.1）更新日志

注意事项

本日志仅汇总关键变更。完整更新日志请参阅
[GitHub 历史记录][history]。

注意：更新前请务必备份您的世界存档及NPC数据！
更多详情请查阅[升级指南][upgrade_guide]。

7.6.0

• 修复了因实体数据追踪器ID重复导致的模组冲突错误提示不明确问题。
• 修复了配置界面与对话界面中，第三方血条覆盖在NPC预览图上的问题。
• 修复了多普勒雷达与Easy Model Entities类NPC使用默认碰撞箱而非模型实际尺寸的问题。
• 修复了服务器端/easy_npc命令完全不提示任何NPC UUID的问题。
• 修复了“设置姿态”动作的姿态列表遮挡其输入框的问题。
• 修复了动作编辑器中未翻译的“循环”、“当前之后”及“动作数据类型”标签。
• 修复了“概率”条件缺少提示文字的问题。
• 修复了长条件提示文字超出编辑器界面、未自动换行的问题。
• 修复了“消息”动作中帮助图标与文字按钮位置错位的问题。
• 修复了“设置姿态”、“播放动画”与“停止动画”动作的修改无法保存的问题。
• 修复了对话气泡文字距离上边界比下边界更近的问题。
• 调整NPC建议列表：优先显示准心对准的NPC，并仅显示用户拥有权限的自有NPC。
• 调整预设导出逻辑：仅保存与全新NPC不同的配置项，不包含位置与所有者信息。
• 调整无目标或动作的预设：自动回退至对应NPC类型的默认配置。
• 调整无玩家参与的事件（如“生成时”或“被击杀时”）：现在会检查其条件；若其中某动作依赖玩家（例如记分板或物品条件），则该动作不再执行。
• 调整基于时间的动作：当所有者在附近时，将自动以所有者作为@initiator。
• 调整对话气泡显示时长：根据文本长度，在5至18秒之间动态变化。
• 调整“设置姿态”动作：仅在选择“自定义”姿态时显示其输入框。
• 新增基于时间的动作，支持五档固定间隔：约每1秒、每5秒、每30秒、每5分钟及每15分钟触发一次。
• 新增“消息”动作：支持聊天栏消息、系统消息及对话气泡文本，无需命令即可发送。
• 为“消息”动作新增文本变体、发送者名称、接收者及本地化键名支持。
• 新增对话气泡图形资源路径：easy_npc:textures/gui/speech_bubble.png，供资源包调用。
• 新增“概率”条件（百分比形式）与“关系”条件（支持所有者及派系）。
• 新增生成、所有者登录、状态变更、昼夜、天气及缺失的“交易时”事件。
• 新增基础预设：每个NPC类型均配有位于easy_npc:api/preset/base/的基础预设，可作为父预设复用。
• 新增“漫游同伴”预设：一个由基于时间的消息构成的健谈型NPC。
• 新增动作注册表、动作处理器、预设校验器及更丰富的事件数据，便于其他模组扩展。
• 新增/easy_npc命令中所有NPC建议项的工具提示：显示名称、类型与距离。
• 改进NPC建议功能：无需输入即可弹出，并支持一格范围内的容错匹配。

7.5.0

• 通过为每个方块宝可梦NPC单独分配动画状态（而非同物种共用一个），修复#814。
• 通过允许“返回家园”移动目标在任意距离生效（而不仅限于家园附近），修复#813。
• 通过每次会话仅检查一次玩家皮肤是否变更，修复#812。
• 通过支持资源包中的方块宝可梦各类外观变体（而不仅限于“闪光”与“雌性”），修复#810。
• 修复NPC在重生或导入预设后丢失所有者、家园及“无重力”设置的问题。
• 修复目标已消失时目标导向的目标仍被保留，以及目标或相关模组卸载后目标被自动关闭的问题。
• 修复悦灵、恼鬼与恶魂等飞行类NPC在地面移动而非飞行的问题。
• 修复对话、按钮、预设、姿态及纹理名称存在重复或特殊字符的问题。
• 修复专用服务器上条件不可编辑及条件文本未翻译的问题。
• 修复Easy Model Entities类NPC不转动头部，及其模型列表在/reload后失效的问题。
• 将移动目标顺序调整为固定优先级：逃离→跟随→返回家园→闲逛。因此含多个移动目标的NPC行为可能与此前不同。
• 将数据包预设路径调整为easy_npc/preset/；旧路径仍可使用，但仅适用于easy_npc模组。
• 将Easy Model Entities最低版本要求提升至1.7.0；浮动模型现默认悬浮。
• 移除实验性的用户自定义NPC及未使用的SERVER_SKIN皮肤类型。
• 新增NPC状态：支持数字、是/否及文本值，可用于条件、动作及命令。
• 新增“导航”与“悬停高度”设置，使任意NPC可在地面行走与飞行间切换。
• 新增父预设、其他模组预设、预设可见性设置及“锻造守护者”预设。
• 新增自定义条件、事件、NPC标识符及更多目标选项，便于其他模组扩展。
• 新增“远距离时”事件（32格），并新增所有者登录时重新生成NPC的选项。
• 通过提供预设与自定义目标API，改进飞行导航及第三方支持。

7.4.0

• 修复#807：不再将32格内所有同类型NPC卷入“自卫”战斗。
• 修复#805：统一评估所有可见性设置，而非遇到首个即停止。
• 修复#804：为多普勒雷达NPC保留自定义名称，确保名称纹理与名称标签正常显示。
• 修复#803：调整资源以匹配典型Minecraft风格，而非通用UI风格。
• 修复昼夜检测错误：此前将日出判定为夜晚、日落判定为白天。
• 修复下界与末地可见性错误：此前使用主世界时间。
• 修复昼夜与游戏模式可见性复选框随机排列问题。
• 修复游戏测试仅能在首次断言失败时报告，导致后续失败被隐藏的问题。
• 修复“已装鞍”马匹皮肤变体始终不显示马鞍的问题。
• 调整“对所有者可见”与“对队伍可见”设置：现同步遵循昼夜与游戏模式限制。
• 调整唤魔者、幻术师与掠夺者变体：若未启用“双臂交叉”，则保持双臂自然下垂。
• 新增“保卫派系”目标：攻击伤害附近派系成员或玩家的任意实体。
• 新增派系成员互斗时的系统提示，并确保派系不介入战斗。
• 为卫道士新增头部装备槽位，使其队长旗帜可被移除或更换。
• 新增昼夜预览功能，集成至显示配置界面。
• 新增针对可见性属性与派系防卫功能的单元测试及游戏测试。
• 优化可见性检测性能：每次检测仅读取一次显示属性。
• 优化旧版本显示属性：通过补全默认值实现兼容。
• 优化攻击目标界面：当未启用时，禁用“保护所有者”与“保卫派系”。

7.3.0

• 优化皮肤变体：以类型化字段承载数据，而非解析变体名称字符串。
• 统一管理方块宝可梦模组ID与默认模型，集中定义于共享常量。
• 减少枚举代码冗余：通过共享EnumUtils辅助类实现get(String)查找。
• 优化村民职业与类型查找：使用直接注册表键而非扫描。
• 优化枚举名称查找：在构造时缓存标签名、ID与键，避免重复计算。
• 新增针对皮肤变体、村民解析及枚举辅助类的单元测试与游戏测试。

7.2.0

• 修复#801：为NPC、对话及动作UUID采用组合式生成策略，避免动作追踪与执行上限冲突。

7.1.1

• 修复#800：对实体类型采用懒加载机制。

7.1.0

• 修复#799：解决边缘情况，并补充文档说明与更清晰的日志信息。
• 修复#798：将控制台、命令及命令方块视为可信命令来源。
• 修复单人游戏/局域网关键问题：客户端与服务端NPC曾共享同一注册表。
• 修复配置菜单处理中的内存泄漏，并添加超时与断开连接清理机制。
• 修复多个NPC同时请求同一皮肤时重复下载问题。
• 修复皮肤查找失败后无法恢复的问题：慢速服务器不再导致游戏卡死。
• 修复URL皮肤界面在检查远程图片时冻结游戏：现改为后台异步执行。
• 新增世界生成器方块：限制NPC预设在整个世界（所有维度）的生成数量；现有群组生成器现按维度计数，避免远处NPC阻塞生成。
• 强化远程皮肤下载：增加严格尺寸限制与安全重定向处理，防止超大或恶意皮肤URL导致崩溃；新增可选blockPrivateAddresses设置。
• 优化服务器性能：仅向实际使用实体与玩家加载事件的NPC发送对应事件，并按维度分组。

7.0.0

• 修复#791：新增流浪商人NPC类型。
• 修复#788：将AI防护机制扩展至史诗战斗及原始NPC变体（猪灵、村民、末影人、苦力怕、劫持者与女巫）。
• 修复#787、#531、#237与#184：新增派系系统，支持/easy_npc faction命令、每NPC派系分配及自动记分板队伍同步。
• 修复#787、#771与#572：新增target目标标签页，支持攻击敌对派系或特定目标（通过玩家名、队伍、实体标签或UUID指定）。
• 修复#786：为方块宝可梦NPC新增性别与闪光模型变体，模型选择中可通过female或shiny搜索。
• 修复无敌NPC间派系战斗问题：新增派系可攻击战斗属性。
• 修复方块宝可梦模型选择预览对超大物种适配不佳问题：改用方块宝可梦自身档案缩放比例，而非碰撞箱高度。
• 修复派系管理边缘情况：验证派系名称、排序派系列表，并在派系颜色变更或删除后刷新已加载NPC的记分板分配。
• 修复自定义皮肤重载问题：按皮肤模型分别加载与清除纹理缓存，而非重建全部自定义纹理缓存。
• 优化玩家/怪物/派系可攻击战斗属性：各属性独立于无敌属性工作，为对应攻击者群体单独开放漏洞。
• 优化预设命令与网络处理：将大型处理器拆分为更小、更专注的导入、导出及功能专用组件。
• 新增Easy Model Entities支持。
• 新增派系管理器与派系编辑器界面：创建、着色、删除派系，管理敌对关系；受新FACTION_MANAGEMENT安全特性保护。
• 新增杂项属性标签页，作为NPC派系分配的归属位置。
• 新增可复用警告与帮助图标组件：支持内联提示与工具提示。
• 新增针对派系、目标目标及方块宝可梦模型变体的单元测试与游戏测试。

6.25.0

• 修复#780：为远程纹理下载新增额外缓存与优化。
• 修复#767：为属性滑块增加防护，避免其他模组传入天文数字。
• 修复#754：为带动作与条件的NPC新增自定义数据项匹配支持。
• 修复纹理管理器在错误线程运行可能导致≥1.21.x版本崩溃与死锁的问题。
• 修复动作条件为空UUID导致的意外行为。
• 修复动作执行上限重置问题。
• 新增纹理注册队列：避免同一刻度内多次并发下载。
• 新增NPC金币、钥匙与红令牌作为消耗品，供带动作与条件的NPC使用。
• 新增欢迎金币商人示例NPC预设：含自定义金币、钥匙与红令牌作为示例物品，并新增动作与条件可用的物品数据。
• 新增通用属性防护：防止其他模组传入天文数字。
• 将备用最大生命值从1024提升至4096，以支持更复杂的NPC。
• 优化纹理管理器，消除重复的纹理检查与注册。

6.24.0

• 修复#459、#775：新增选项以阻止与隐形NPC交互。
• 修复#774：与可选史诗战斗及方块宝可梦实体类型映射相关的启动崩溃。
• 修复#773：在基础刻度期间及打开交易界面前检查限时交易重置。
• 修复交易重置时机：正确递增内部计时器。
• 为#459新增昼夜与天气条件。
• 新增针对交易重置、计时器处理及实体属性的单元测试与游戏测试。
• 新增天穹哨兵示例NPC预设：含昼夜与天气条件。

6.23.0

• 修复#772：调整纹理重试机制，支持403与404错误，并降低日志等级。
• 修复#770：史诗战斗NPC（唤魔者、掠夺者、掠夺者及类人皮肤）的物品渲染问题。
• 修复#769：NPC开门/关门循环异常，无法可靠执行。
• 修复#760：新增对话选项与配置设置（buttonConditionMode: LOCK 或 HIDE），支持锁定或隐藏不可用的条件对话按钮。
• 修复#709：新增名称颜色选择弹窗，提供32种预设色及手动RGB/十六进制输入。
• 修复重命名NPC时未指定颜色导致名称颜色重置问题：现保留原有名称颜色。
• 优化门运动属性：“穿门”在“开门”或“关门”激活时自动启用。

6.22.0

• 修复#766：向命令执行传递完整的服务器玩家上下文，提升与依赖特定玩家数据的第三方模组及插件的兼容性。
• 修复#764：新增实体生命值、NPC生命值条件，并新增示例NPC预设格鲁克，陪练桩以演示这些条件。
• 修复#763：确保对话按钮执行限制现已被记录。
• 修复#758：提供名为一愿随行者的示例NPC预设。
• 修复第三方村民AI读取Easy NPC村民未注册脑部记忆（如PoiCompetitorScan / job_site）导致的崩溃#756。
• 修复对话按钮未针对服务器端数据锁定，为#760与#644做准备。
• 修复#628：新增条件对话开启支持/命令，以便更精细地控制对话向玩家展示的时机。
• 新增猪灵与猪灵蛮兵NPC的脑部AI，并注册完整原版脑部记忆集。
• 新增#757所需枪械至枪械标签。
• 新增“开启对话（条件式）”动作：仅在满足条件时开启指定对话；原有“开启对话”动作保持无条件开启。
• 新增实体生命值与NPC生命值条件，适用于动作、对话及对话按钮。
• 新增猪灵、猪灵蛮兵与僵尸猪灵NPC为无敌状态，与其他NPC保持一致。
• 新增“击退免疫”战斗属性：使NPC免受近战与投射物攻击造成的击退。
• 新增“爆炸免疫”战斗属性：使NPC免疫爆炸伤害与位移（如TNT、苦力怕、末影水晶）。
• 将“投射物碰撞”属性移至战斗属性界面（此前位于能力界面），主题更契合。

6.21.0

• 修复交叉手臂姿态下卫道士的物品附着问题。
• 修复卫道士十字弓攻击目标失效问题。
• 修复第三方物品无法作为手持物品渲染导致的崩溃#756。
• 修复第三方混入尝试访问不存在模型部件导致的崩溃#756。
• 修复log.info信息泛滥：降低日志详细程度，并为自定义模型部件添加额外检查。
• 提升EasyNPCModelManager性能。
• 重构NPC渲染器，移除默认手持物品图层。

6.20.0

• 修复第三方模组尝试访问不存在NPC目标导致的崩溃。

6.19.0

注意：本次更新将对话背景图片调整为每边10×6像素，若您使用自定义对话背景，请相应调整。

• 修复#752、#130：新增对话按钮条件支持，允许禁用按钮。
• 修复#683、#215：新增对话文字打字机效果支持。
• 修复#690、#309：允许对话、对话按钮及交互添加条件。
• 修复对话界面布局与背景的小型UI问题。
• 重构对话背景图片：每边调整10×6像素。
• 重构对话界面布局：适配新背景尺寸并提升视觉效果。
• 新增打字机效果及客户端对话文字配置。
• 新增条件符号：指示对话、按钮及交互的条件状态。
• 新增物品条件数量字段：支持检查特定数量的物品。
• 新增阈值音啸守卫示例NPC预设：含多种条件与动作。
• 新增小型BUG修复与对话条件及按钮状态优化。

6.18.0

注意：本次更新更改了条件与动作的内部数据格式，可能导致遗留的执行限制条目（无存储ID）被重置或移除。

• 修复#745：新增动作条件支持，实现更复杂、动态的行为。
• 修复#652：新增对话按钮工具提示，支持长文本显示。
• 修复#687：新增命令值工具提示，显示完整值。
• 新增经验等级条件。
• 新增游戏模式条件。
• 新增物品栏持有物品条件。
• 新增手持物品条件（支持主手与副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增金宝石矿石示例NPC预设：含多种条件与动作。
• 新增否定条件支持：允许对条件取反，实现更复杂逻辑。
• 移除ActionDataEntry的参数伪ID，替换为随机UUID。
• 重构条件系统：支持更多条件类型。

6.17.0

• 修复#738：为“以玩家身份执行”新增额外工具提示。
• 修复详细日志：降低启动及游戏内log.info消息频率。
• 新增额外单元测试与游戏测试。

6.16.0

• 修复#732：提供选项以禁用对话的ESC键与关闭按钮。
• 修复#723：避免在交易界面等特定情况下自动关闭对话。
• 新增通用对话配置选项：允许用户自定义对话行为。
• 新增头像缩放与位置偏移选项。
• 新增缺失的本地化键名。

6.15.0（交易、玩家头颅、史诗战斗与品质优化更新）

• 修复#731：若客户端物种列表为空，则重新同步物种数据。
• 修复#730：改进史诗战斗集成并启用实验性功能。
• 修复#729：确保交易使用次数正确存储。
• 修复#728：新增玩家头颅自定义支持。
• 修复#689：显示剩余交易次数，并支持手动与自动重置。
• 修复#218与#132：新增交易配置界面，并增强自定义交易支持。
• 修复交易特有边缘情况：在基础与普通/高级交易模式间智能切换。
• 修复对话按钮文字截断问题：工具提示显示完整文字。
• 修复方块宝可梦动画问题：同步动画状态至方块宝可梦动画系统。
• 新增每笔交易专属动作：允许用户在购买后触发动作。
• 新增交易重置按钮：一键重置全部交易。
• 新增交易使用信息至交易配置界面。
• 新增实验性功能开关：允许用户手动启用实验性功能。
• 新增格里塞尔达·砂轮示例商人：含动作支持。
• 清理测试文件。

6.14.0（方块宝可梦支持与对话优化）

• 修复#727：确保值变更时同步至客户端。
• 修复#726：为特定命令新增额外白名单。
• 修复#686、#389、#304、#211：新增基础方块宝可梦支持（含方块宝可梦NPC）。
• 修复对话错位与导航问题：调整对话精灵图与界面。
• 修复X与Z轴根部旋转：修正旋转逻辑与枢轴点计算。
• 新增基础方块宝可梦支持：含自定义NPC类型与模型，用于测试。

6.13.0（安全与权限更新）

注意：本次更新增强了多人游戏环境下的安全检查与权限管理。部分服务器命令若被恶意利用，可能存在风险。

本次更新将模型根部数据与逻辑与其他模型部件数据及逻辑分离，可能导致现有NPC的根部旋转与缩放重置为默认值。

• 修复#725：将模型根部数据与逻辑与其他模型部件数据及逻辑分离。
• 修复#722：支持.sbnt文件作为本地预设。
• 修复#675：为对话与配置界面背景新增专用资源。
• 修复#605、#532、#529：新增安全检查与权限系统。
• 修复#469、#311：新增实验性API文档与自定义模型支持示例。
• 修复配置界面背景重复渲染问题：移除冗余背景渲染。
• 修复恶魂碰撞箱与名称标签位置问题：调整包围盒。
• ⚠️ 新增安全检查：防范潜在漏洞，保障多人游戏环境安全使用。

... [内容过长已截断]

Easy NPC：核心版（1.21.11）更新日志

注意事项

本更新日志仅汇总关键变更。完整变更记录请参阅
[GitHub 历史记录][history]。

注意：更新至新版本前，请务必备份您的世界存档及所有自定义NPC！
更多详情请查阅[升级指南][upgrade_guide]。

7.4.0

• 修复 #807：不再强制将半径32格内所有同类型NPC卷入“自卫”战斗。
• 修复 #805：统一评估全部可见性设置，而非在首个设置处即停止判断。
• 修复 #804：为多普勒型NPC保留自定义名称，确保基于名称的贴图与名称标签正常显示。
• 修复 #803：调整资源素材风格，使其更贴近原版Minecraft UI，而非通用UI风格。
• 修复昼夜检测逻辑错误：此前将日出判定为夜间、日落判定为白天。
• 修复下界与末地的可见性判断错误：此前错误使用主世界的昼夜时间。
• 修复“时间”与“游戏模式”可见性复选框随机排列的问题。
• 修复游戏测试仅在首次断言失败时报告问题，导致后续失败被隐藏。
• 修复“已装鞍”马类皮肤变体始终不显示马鞍的问题。
• 将“对所有者可见”与“对队伍可见”两项设置扩展支持昼夜与游戏模式条件。
• 调整唤魔者、幻术师与掠夺者的非“双臂交叉”变体，使其手臂自然垂落。
• 新增“保卫派系”目标：当附近派系成员或玩家受到伤害时，自动攻击施害者。
• 新增系统消息：当派系成员彼此交战且该派系保持中立时，向玩家提示。
• 为灾厄村民新增头部装备栏位，允许移除或更换其队长旗帜。
• 在显示配置界面中新增昼夜预览功能。
• 为可见性属性与派系防御机制新增单元测试与游戏测试。
• 优化可见性检查性能：每次检查仅读取一次显示属性。
• 补全旧版本显示属性：缺失字段自动填充默认值。
• 优化攻击目标界面：当未启用相关选项时，“保护所有者”与“保卫派系”按钮自动禁用。

7.3.0

• 优化皮肤变体实现：以类型化字段存储数据，而非解析变体名称字符串。
• 统一Cobblemon模组ID与默认模型，在共享常量中集中管理。
• 通过共享EnumUtils辅助类实现get(String)枚举查找，减少重复枚举代码。
• 优化村民职业与类型查找逻辑：改用直接注册表键查询，避免遍历扫描。
• 优化枚举名称查找：在构造阶段一次性缓存标签名、ID与键值。
• 为皮肤变体、村民解析逻辑及枚举辅助类新增单元测试与游戏测试。

7.1.2

• 修复 #801：为NPC、对话与动作UUID采用组合式生成策略，避免动作追踪与执行限制发生冲突。

7.1.1

• 修复 #800：对实体类型启用延迟加载。
• 修复 #799：完善边界情况处理，并补充文档说明与更清晰的日志输出。
• 修复 #798：将控制台、命令与命令方块明确标记为可信命令来源。
• 修复单人游戏/局域网关键问题：客户端与服务端NPC共享同一注册表。
• 修复配置菜单处理中的内存泄漏，并新增超时与断开连接清理机制。
• 修复多个NPC同时请求同一皮肤时重复下载的问题。
• 修复皮肤查询因报错失败后无法重试的问题，避免慢速服务器导致游戏卡死。
• 修复URL皮肤界面在验证远程图片时冻结游戏的问题；现改为后台异步验证。

7.0.0

• 修复 #794：NPC渲染时使用预期的数据类型。
• 修复缩放界面预览：将实体脚部固定于标尺零刻度线，使NPC缩放从底部向上进行，而非从中心缩放，从而避免包围盒更新后整体下移。
• 修复 #791：新增流浪商人NPC类型。
• 修复 #788：将AI防护机制扩展至Epic Fight模组及原始NPC变体（猪灵、村民、末影人、苦力怕、袭击者与女巫）。
• 修复 #787、#531、#237 与 #184：新增派系系统，支持/easy_npc faction指令、逐个NPC分配派系、自动同步记分板队伍。
• 修复 #787、#771 与 #572：新增目标攻击目标页签，支持攻击敌对派系，或按玩家名、队伍、实体标签、UUID精准指定目标。
• 修复 #786：为Cobblemon NPC新增性别与闪光模型变体，可在模型选择中通过关键词female（雌性）或shiny（闪光）搜索。
• 修复无敌NPC间派系战斗问题：新增派系可攻击战斗属性。
• 修复Cobblemon模型选择预览对超大体型物种显示异常：改用Cobblemon自身档案缩放比例，而非包围盒高度。
• 修复派系管理边界情况：校验派系名称合法性、排序派系列表、在派系颜色变更或删除后刷新已加载NPC的记分板分配。
• 修复自定义皮肤重载问题：按皮肤模型单独加载与清除贴图缓存，而非始终重建全部自定义贴图缓存。
• 改进对玩家/怪物/派系可攻击战斗属性：各属性独立于无敌状态运行，分别为对应攻击者群体开放专属攻击通道。
• 优化预设指令与网络处理：将大型处理器拆分为小型专用组件，分别负责导入、导出与特定功能。
• 新增Easy Model Entities支持。
• 新增派系管理器与派系编辑器界面，用于创建、着色、删除派系及管理敌对关系；受全新FACTION_MANAGEMENT安全特性保护。
• 新增杂项属性页签，作为NPC派系分配的归属位置。
• 新增可复用警告图标与帮助图标组件，支持内联提示与悬浮工具提示。
• 新增针对派系、目标目标及Cobblemon模型变体的单元测试与游戏测试。

6.25.0

• 修复 #782、#636、#622：在验证过程中保留数据组件。
• 修复 #780：缓存远程贴图下载，减少重复注册。
• 修复 #767：对其他模组传入的极端属性值进行钳制处理。
• 修复 #754：为含动作与条件的NPC新增自定义数据项匹配功能。
• 修复贴图管理器在错误线程运行可能导致崩溃与死锁（≥1.21.x版本）。
• 修复空UUID在动作条件中的处理。
• 修复动作执行限制重置问题。
• 新增贴图注册队列，避免同一游戏刻内多次并发下载。
• 新增NPC金币、钥匙与红令牌作为消耗品，供含动作与条件的NPC使用。
• 新增示例NPC预设欢迎金币商人，含自定义金币、钥匙与红令牌物品数据。
• 新增属性防护机制，防范其他模组传入的极端数值。
• 将备用最大生命值上限由1024提升至4096，适配高血量NPC。
• 优化贴图管理器：减少重复贴图检查与注册。

6.24.0

• 修复 #459、#775：新增选项，禁止与不可见NPC交互。
• 修复 #774：与可选Epic Fight及Cobblemon实体类型映射相关的启动崩溃。
• 修复 #773：在基础游戏刻期间及打开交易界面前检查限时交易重置。
• 修复交易重置时机：正确递增内部计时器。
• 为 #459 新增昼夜时间与天气条件支持。
• 新增针对交易重置、计时器处理与实体属性的单元测试与游戏测试。
• 新增示例NPC预设天穹哨探，含昼夜时间与天气条件。

6.23.0

• 修复 #774：将isSunBurnTick错误迁移至26.x版本。
• 修复 #772：针对403与404错误优化贴图重试机制，并降低日志级别。
• 修复 #770：Epic Fight NPC（唤魔者、掠夺者、掠夺者及人形皮肤）的物品渲染问题。
• 修复 #769：NPC开关门行为不稳定问题。
• 修复 #760：新增对话选项与配置设定（buttonConditionMode：LOCK锁定 或 HIDE隐藏），用于锁定或隐藏不可用的条件性对话按钮。
• 修复 #709：新增姓名颜色选择弹窗，提供32种预设色及手动RGB/十六进制输入。
• 修复NPC重命名时未指定颜色导致原有姓名颜色被重置的问题，现保留当前颜色。
• 优化门移动属性：“穿门”将在“开门”或“关门”激活时自动启用。

6.22.0

• 修复 #766：向命令执行传递完整的服务器玩家上下文，提升与依赖特定玩家数据的第三方模组/插件兼容性。
• 修复 #764：新增实体生命值、NPC生命值条件，并提供示例NPC预设格鲁克——陪练桩演示其用法。
• 修复 #763：确保对话按钮执行限制现已被正确记录。
• 修复 #758：提供名为一愿伴侣的示例NPC预设。
• 修复第三方村民AI（如PoiCompetitorScan / job_site）读取Easy NPC村民未注册脑记忆导致的崩溃（#756）。
• 修复对话按钮服务端数据未锁定问题，为 #760 与 #644 做准备。
• 修复 #628：新增条件性对话开启支持/指令，实现对对话向玩家展示时机的精细控制。
• 为猪灵与猪灵蛮兵NPC新增脑AI，并注册全部原版脑记忆集合。
• 为枪械标签（gun tag）新增更多枪械（#757）。
• 新增“开启对话（条件性）”动作：仅在满足条件时开启指定对话；原有“开启对话”动作保持无条件开启。
• 新增实体生命值与NPC生命值条件，适用于动作、对话及对话按钮。
• 为猪灵、猪灵蛮兵与僵尸猪灵NPC新增无敌属性，与其他NPC保持一致。
• 新增“击退免疫”战斗属性：防止NPC被近战或投射物攻击击退。
• 新增“爆炸免疫”战斗属性：使NPC完全免疫爆炸伤害与位移（如TNT、苦力怕、末地水晶）。
• 将“投射物碰撞”属性移至战斗属性界面（此前位于能力界面），主题归类更合理。

6.21.0

• 修复灾厄村民在双臂交叉姿势下的物品附着问题。
• 修复灾厄村民弩攻击目标失效问题。
• 修复第三方物品无法作为手持物品渲染导致的崩溃（#756）。
• 修复第三方混入（Mixin）尝试访问不存在模型部件导致的崩溃（#756）。
• 修复log.info日志刷屏：降低日志冗余度，并增加自定义模型部件校验。
• 提升EasyNPCModelManager性能。
• 重构NPC渲染器，移除默认手持物品图层。

6.20.0

• 修复第三方模组尝试访问不存在NPC目标导致的崩溃。

6.19.0

注意：本次更新将对话背景图每边调整了10×6像素，若您使用自定义对话背景，请相应调整尺寸。

• 修复 #752、#130：新增对话按钮条件支持，允许禁用按钮。
• 修复 #683、#215：新增对话文字打字机效果支持。
• 修复 #690、#309：支持对话、对话按钮与交互的条件设定。
• 修复对话界面布局与背景的小型UI问题。
• 重构对话背景图：每边扩大10×6像素。
• 重构对话界面布局：适配新背景尺寸并提升视觉效果。
• 新增打字机效果及客户端配置选项。
• 新增条件符号，直观指示对话、按钮与交互的条件状态。
• 新增物品条件数量字段，支持检查特定数量的物品。
• 新增示例NPC预设阈限守望者，含多种条件与动作。
• 新增小型BUG修复与对话条件及按钮状态优化。

6.18.0

注意：本次更新更改了条件与动作的内部数据格式，可能导致旧版执行限制条目（无存储ID）被重置或删除。

• 修复 #745：新增动作条件支持，实现更复杂、动态的行为。
• 修复 #652：为长文本对话按钮新增工具提示。
• 修复 #687：为命令值新增工具提示，显示完整内容。
• 新增经验值等级条件。
• 新增游戏模式条件。
• 新增背包内有某物品条件。
• 新增手持物品条件（支持主手与副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增示例NPC预设金暮，含多种条件与动作。
• 新增否定条件支持，实现更复杂的逻辑运算。
• 移除ActionDataEntry参数伪ID，替换为随机UUID。
• 重构条件系统，支持更多条件类型。

6.17.0

• 修复 #738：为“以玩家身份执行”新增额外工具提示。
• 优化详细日志：降低启动与游戏中log.info消息频率。
• 新增单元测试与游戏测试。

6.16.0

• 修复 #732：提供选项禁用对话框的ESC键与关闭按钮。
• 修复 #723：在交易界面等特定场景下避免自动关闭。
• 新增通用对话配置选项，允许用户自定义对话行为。
• 新增对话头像缩放与位置偏移选项。
• 新增缺失的翻译键。

6.15.1

• 修复 #735：继承正确的基类。
• 修复若干26.1.2版本手动生成测试发现的问题。

6.15.0（交易、玩家头颅、Epic Fight与体验优化更新）

• 修复 #731：若客户端物种列表为空，则重新同步物种数据。
• 修复 #730：增强Epic Fight集成并启用实验性功能。
• 修复 #729：确保交易使用次数正确保存。
• 修复 #728：新增玩家头颅自定义支持。
• 修复 #689：显示剩余交易次数，并支持手动与自动重置。
• 修复 #218 与 #132：新增交易配置界面并强化自定义交易支持。
• 修复交易特定边界情况：在基础交易模式与普通/高级交易模式间切换。
• 修复对话按钮文字截断问题，完整文字通过工具提示显示。
• 修复Cobblemon动画问题：同步动画状态至Cobblemon动画系统。
• 新增逐个交易动作支持，允许在购买后触发动作。
• 新增交易重置按钮，一键重置全部交易。
• 新增交易使用信息至交易配置界面。
• 新增实验性功能开关，允许用户手动启用实验性功能。
• 新增示例商人格里塞尔达·磨石，含动作支持。
• 清理测试文件。

6.14.0

• 修复 #727：确保值变更时同步至客户端。
• 修复 #726：为特定命令新增白名单支持。
• 修复 #686、#389、#304、#211：新增基础Cobblemon支持（Cobblemon NPC）。
• 修复对话错位与导航问题：调整对话精灵图与界面。
• 修复X轴与Z轴根旋转：修正旋转逻辑与枢轴点计算。

6.13.0（安全与权限更新）

注意：本次更新强化了多人游戏环境下的安全检查与权限控制。部分服务端命令具有潜在风险，恶意使用可能造成危害。

本次更新将模型根部数据与逻辑从其余模型部件数据与逻辑中分离，可能导致现有NPC的根旋转与缩放重置为默认值。

• 修复 #725：分离模型根部数据与逻辑。
• 修复 #722：支持.sbnt文件作为本地预设。
• 修复 #675：为对话与配置界面背景新增专用资源。
• 修复 #605、#532、#529：新增安全检查与权限系统。
• 修复 #469、#311：新增实验性API文档与自定义模型支持示例。
• 修复配置界面背景重复渲染问题：移除冗余背景绘制。
• 修复恶魂与史莱姆的包围盒及名称标签位置问题：调整包围盒。
• ⚠️ 新增安全检查，防范潜在漏洞，保障多人游戏环境安全。
• 将动态对话界面背景替换为静态背景，提升性能、自定义性与兼容性。
• 将动态配置界面背景替换为静态背景，提升性能。
• 重构配置UI专用组件，并从核心模组中移除。
• 移除重复的精灵图集。
• 为未来可能的Luck Perms集成（如 #712）准备权限系统。
• 通用代码清理与配置界面渲染及资源相关优化。

6.12.0

• 修复 #714：基于原版模型，新增自定义模型部件列表校验。
• 修复 #713：降低日志冗余度：将每个NPC的INFO级日志降级为DEBUG，并合并冗余警告。
• 修复 #711：缩减启动/配置日志输出体积。
• 修复NBT验证守卫：防止生产环境中不必要的缓冲区分配。
• 在EasyNPCModelManager中新增模型部件名称常量，确保混入（Mixin）中统一使用。
• 优化RenderEntityTypeSupportConfig：增强过滤逻辑，优化数据结构以提升性能与可维护性。
• 移除大量数据结构转储的冗长调试日志。

6.11.1

• 修复 #710：改进向后兼容的可恢复交易数据解析。

6.11.0

• 修复 #703：新自定义图层系统与手持物品渲染引发的渲染问题。
• 修复 #701：为无效交易报价新增额外防护与日志记录。
• 修复智能动画在修改头部位置后失效问题。
• 修复头部追踪：将玩家检测逻辑移回服务端。
• 修复CustomLookAtPlayerGoal：更好处理边界情况，减少抖动。
• 修复多普勒型NPC持续持有手部物品问题。
• 优化PoseManager日志信息。
• 更新Logo为全新设计。

6.10.0

• 修复 #698：为第三方实体创建添加try-catch异常捕获。
• 修复 #695：切换至DEFAULT原版姿势时，清空模型部件旋转/位置。
• 修复 #695：仅当NPC处于空闲状态时应用锁定旋转与姿势动画。
• 修复 #695：修正根旋转枢轴点，使用实际包围盒高度而非固定0.5f。
• 修复多重目标注册问题：包括倒置的isTargetedPlayer检查、离开处理器中错误的UUID、加入/离开时缺少玩家目标刷新、离线目标重试等。
• 修复目标注销后仍保留目标引用问题。
• 移除加载姿势时自动锁定ROOT旋转；现由用户自主控制。
• 在高级与自定义姿势配置界面中新增锁定旋转复选框。
• 在ConfigurationMenuHandler中为默认姿势界面新增模型特定姿势键过滤。
• 新增CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior与ModelAnimationData单元测试。
• 新增NPCDataIsolationTestHelper及Fabric与Forge平台的游戏测试。
• 将最大头部偏航角度由60°提升至65°。

6.9.0

• 修复 #692、#666：新增缓存与防护机制，防止NPC实体数据更新被重复触发。
• 修复 #651、#617：为所有支持的NPC类型新增基础自定义姿势。
• 修复 #597：新增针对玩家、村民、怪物等的额外逃离目标。
• 修复姿势加载：直接从模组资源读取，而非复制文件至磁盘。
• 修复实体加入时重复调用saveNPC：先检查注册表是否存在条目。
• 新增despawn与spawn指令：通过UUID移除或重新生成NPC，并可配置移除原因。
• 新增ModelPoseAPI与EasyNPCEntityHandler公共API类，供外部模组编程控制NPC姿势与管理NPC。
• 新增所有支持NPC类型的姿势数据文件。
• 在基础姿势配置界面中新增锁定旋转复选框。
• 新增MoveToPositionGoal：在执行回调动作前，先将NPC移动至指定位置。
• 新增EasyNPCLookControl与EasyNPCBodyRotationControl：尊重锁定的根旋转。
• 新增同步的所有者变更与维度变更至NPC实体数据索引。
• 在各类实体渲染器中新增`EasyNPCItemAttachment

... [内容过长已截断]

Easy NPC：核心版（1.21.11）更新日志

注意事项

本日志仅汇总关键变更。完整变更记录请参阅
[GitHub 历史记录][history]。

注意：升级至新版本前，请务必备份您的世界存档及所有NPC数据！
更多详情请查阅 [升级指南][upgrade_guide]。

7.4.0

• 修复 #807：不再将32格范围内所有同类型NPC强制卷入“自卫”战斗。
• 修复 #805：统一评估全部可见性设置，而非在首个设置处即中止判断。
• 修复 #804：为多普勒NPC保留自定义名称，确保基于名称的贴图与名称标签正常显示。
• 修复 #803：调整资源文件以匹配标准Minecraft风格，而非通用UI风格。
• 修复昼夜检测逻辑错误——此前将日出判定为夜晚、日落判定为白天。
• 修复下界与末地的可见性逻辑错误——此前错误使用主世界时间进行判定。
• 修复昼夜与游戏模式可见性复选框随机排列的问题。
• 修复游戏测试仅能在首次断言失败时报告问题，导致后续失败被隐藏。
• 修复“已配鞍”马匹皮肤变体始终不显示马鞍的问题。
• 将“对拥有者可见”与“对队伍可见”两项设置扩展支持昼夜与游戏模式条件。
• 将唤魔者、幻术师与卫道士中未启用“双臂交叉”姿态的变体改为保持双臂自然下垂。
• 新增“保卫派系”目标：当附近派系成员或玩家遭受攻击时，自动反击施害者。
• 新增系统提示：当派系成员彼此交战且该派系选择置身事外时，向玩家发送提示。
• 为恼鬼类生物新增头部装备栏位，允许移除或更换其队长旗帜。
• 在显示配置界面中新增昼夜预览功能。
• 为可见性属性与派系防御机制新增单元测试与游戏测试。
• 优化可见性检查性能：每次检查仅读取一次显示属性。
• 完善旧版本显示属性：缺失字段将自动补全默认值。
• 优化攻击目标界面：当未设定相关选项时，“保护拥有者”与“保卫派系”按钮将自动禁用。

7.3.0

• 改进皮肤变体处理：改用强类型字段存储数据，而非解析变体名称字符串。
• 将方块宝可梦（Cobblemon）模组ID与默认模型统一为共享常量。
• 使用共享EnumUtils辅助类替代重复枚举代码，实现get(String)查找功能。
• 优化村民职业与类型查找：改用直接注册表键访问，避免遍历扫描。
• 优化枚举名称查找：在构造阶段一次性缓存标签名、ID与键值。
• 为皮肤变体、村民解析及枚举辅助工具新增单元测试与游戏测试。

7.1.2

• 修复 #801：为NPC、对话与动作的UUID采用组合生成策略，避免动作追踪与执行限制出现冲突。

7.1.1

• 修复 #800：对实体类型采用延迟加载。
• 修复 #799：完善边界情况处理，并补充详细文档与更清晰的日志信息。
• 修复 #798：将控制台、命令与命令方块明确视为可信命令来源。
• 修复单人游戏/局域网关键问题：客户端与服务端NPC共用同一注册表。
• 修复配置菜单处理中的内存泄漏，并新增超时与断开连接后的清理机制。
• 修复多个NPC同时请求同一皮肤时发生的重复下载问题。
• 修复皮肤查询失败后无法恢复的问题，防止慢速服务器导致游戏卡死。
• 修复URL皮肤界面在验证远程图片时冻结游戏的问题；现改为后台异步执行验证。

7.0.0

• 修复 #794：NPC渲染时采用预期类型。
• 修复缩放界面预览：将实体脚部固定于刻度尺零线，使NPC从底部向上缩放（而非从中心缩放），避免碰撞箱更新后整体下移。
• 修复 #791：新增流浪商人NPC类型。
• 修复 #788：将AI防护机制扩展至史诗战斗（Epic Fight）及原生NPC变体（猪灵、村民、末影人、苦力怕、劫掠者、女巫）。
• 修复 #787、#531、#237 与 #184：新增派系系统，支持/easy_npc faction指令、每NPC独立派系分配及自动记分板队伍同步。
• 修复 #787、#771 与 #572：新增目标攻击目标页签，支持按玩家名、队伍、实体标签或UUID攻击敌对阵营或特定目标。
• 修复 #786：为方块宝可梦NPC新增性别与闪光模型变体，可在模型选择中通过关键词female（雌性）或shiny（闪光）搜索。
• 修复无敌NPC间派系战斗问题：新增派系可攻击战斗属性。
• 修复方块宝可梦模型预览对超大体型物种适配不佳问题：改用方块宝可梦自身档案缩放比例，而非碰撞箱高度。
• 修复派系管理边界情况：校验派系名称、排序派系列表、并在派系颜色变更或删除后刷新已加载NPC的记分板分配。
• 修复自定义皮肤重载问题：按皮肤模型分别加载与清空贴图缓存，而非始终重建全部自定义贴图缓存。
• 优化玩家/怪物/派系可攻击战斗属性：各属性独立于存续状态运作，分别为对应攻击者群体单独开放精准攻击通道。
• 优化预设指令与网络处理：将大型处理器拆分为更小、更专注的导入、导出及特性专用组件。
• 新增Easy Model Entities支持。
• 新增派系管理器与派系编辑器界面，用于创建、着色、删除派系及管理敌对关系，并受全新FACTION_MANAGEMENT安全特性保护。
• 新增杂项属性页签，作为NPC派系分配的归属位置。
• 新增可复用警告与帮助图标组件，支持内联提示与悬停工具提示。
• 为派系、目标目标及方块宝可梦模型变体新增额外单元测试与游戏测试。

6.25.0

• 修复 #782、#636、#622：验证过程中保留数据组件。
• 修复 #780：缓存远程纹理下载并减少重复注册。
• 修复 #767：对其他模组传入的极端属性值进行钳制。
• 修复 #754：为含动作与条件的NPC添加自定义数据项匹配功能。
• 修复纹理管理器在错误线程运行可能导致≥1.21.x版本崩溃与死锁。
• 修复动作条件中空UUID处理问题。
• 修复动作执行限制重置问题。
• 新增纹理注册队列，避免同一刻内多次并发下载。
• 新增NPC金币、钥匙与红令牌作为消耗品，供含动作与条件的NPC使用。
• 新增示例NPC预设欢迎金币商人，包含自定义金币、钥匙与红令牌物品数据。
• 新增针对其他模组极端值的属性防护机制。
• 将备用最大生命值上限由1024提升至4096，适配高生命值NPC。
• 优化纹理管理器：减少重复纹理检查与注册。

6.24.0

• 修复 #459、#775：新增选项，禁止与不可见NPC交互。
• 修复 #774：与史诗战斗（Epic Fight）及方块宝可梦（Cobblemon）实体类型映射相关的启动崩溃。
• 修复 #773：在基础刻度周期及打开交易界面前检查限时交易重置。
• 修复交易重置时机：正确递增内部计时器。
• 为 #459 新增昼夜时间与天气条件支持。
• 为交易重置、计时器处理及实体属性新增额外单元测试与游戏测试。
• 新增示例NPC预设天穹哨探，支持昼夜时间与天气条件。

6.23.0

• 修复 #774：将isSunBurnTick错误迁移至26.x版本。
• 修复 #772：针对403与404错误优化纹理重试机制并降低日志级别。
• 修复 #770：史诗战斗（Epic Fight）NPC（唤魔者、掠夺者、卫道士及人形皮肤）的物品渲染问题。
• 修复 #769：NPC开门/关门循环异常，导致门无法可靠开启或关闭。
• 修复 #760：新增对话选项与配置设置（buttonConditionMode：LOCK 或 HIDE），支持锁定或隐藏不可用的条件对话按钮。
• 修复 #709：新增带32色盘及手动RGB/十六进制值输入的颜色选择弹窗。
• 修复NPC名称颜色重置问题：未指定颜色时重命名将保留原有名称颜色。
• 优化门移动属性：“穿门”将在“开门”或“关门”激活时自动启用。

6.22.0

• 修复 #766：向命令执行传递完整服务端玩家上下文，提升与依赖特定玩家数据的第三方模组/插件兼容性。
• 修复 #764：新增实体生命值、NPC生命值条件，并提供示例NPC预设格鲁克，陪练木桩演示其用法。
• 修复 #763：确保对话按钮执行限制现已被准确记录。
• 修复 #758：提供名为一愿伴侣的示例NPC预设。
• 修复第三方村民AI读取Easy NPC村民未注册脑记忆（如PoiCompetitorScan / job_site）导致的崩溃 #756。
• 修复对话按钮因服务端数据未锁定而失效问题，为 #760 与 #644 做准备。
• 修复 #628：新增条件化对话开启支持/指令，增强对对话向玩家展示时机的控制。
• 为猪灵与猪灵蛮兵NPC新增脑AI，并注册完整原版脑记忆集。
• 为 #757 新增更多枪械至枪械标签。
• 新增“条件化开启对话”动作：仅在满足条件时开启指定名称对话；现有“开启对话”动作仍无条件开启。
• 新增实体生命值与NPC生命值条件，适用于动作、对话及对话按钮。
• 为猪灵、猪灵蛮兵与僵尸猪灵NPC新增无敌属性，与其他NPC保持一致。
• 新增“击退免疫”战斗属性：防止NPC被近战或投射物攻击击退。
• 新增“爆炸免疫”战斗属性：使NPC免疫爆炸伤害与位移（如TNT、苦力怕、末地水晶）。
• 将“投射物碰撞”属性移至战斗属性界面（此前位于能力界面），主题归属更合理。

6.21.0

• 修复交叉手臂姿态下恼鬼类生物的物品附着问题。
• 修复恼鬼类生物十字弓攻击目标失效问题。
• 修复第三方物品无法作为手持物品渲染导致的崩溃 #756。
• 修复第三方混入（Mixin）尝试访问不存在模型部件导致的崩溃 #756。
• 修复log.info日志刷屏问题：降低日志冗余度，并为自定义模型部件增加额外校验。
• 提升EasyNPCModelManager性能。
• 重构NPC渲染器，移除默认手持物品图层。

6.20.0

• 修复第三方模组尝试访问不存在NPC目标导致的崩溃。

6.19.0

注意：本次更新将对话背景图尺寸调整为每边+10×6像素，若您使用自定义对话背景，请相应调整。

• 修复 #752、#130：新增对话按钮条件支持，允许禁用按钮。
• 修复 #683、#215：新增对话文字打字机效果支持。
• 修复 #690、#309：支持对话、对话按钮与交互的条件设定。
• 修复对话界面布局与背景相关的细微UI问题。
• 重构对话背景图：每边尺寸增加10×6像素。
• 重构对话界面布局：更好适配新背景尺寸并提升视觉效果。
• 新增打字机效果及客户端对话文字配置。
• 新增条件符号，用于指示对话、按钮与交互的条件状态。
• 新增物品条件数量字段，支持检查特定数量物品。
• 新增示例NPC预设阈值守卫者，含多种条件与动作。
• 新增细微BUG修复与对话条件、按钮状态相关优化。

6.18.0

注意：本次更新更改了条件与动作的内部数据格式，可能导致旧版执行限制条目（无存储ID者）被重置或移除。

• 修复 #745：为动作新增条件支持，实现更复杂、动态的行为。
• 修复 #652：为长文本对话按钮新增工具提示。
• 修复 #687：为命令值新增工具提示以显示完整值。
• 新增经验等级条件。
• 新增游戏模式条件。
• 新增物品栏持有物品条件。
• 新增手持物品条件（支持主手与副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增示例NPC预设金宝石矿石，含多种条件与动作。
• 新增否定条件支持，允许对条件取反以构建更复杂逻辑。
• 移除ActionDataEntry参数伪ID，替换为随机UUID。
• 重构条件系统以支持更多条件类型。

6.17.0

• 修复 #738：为“以玩家身份执行”新增额外工具提示。
• 修复详细日志：降低启动与游戏中log.info消息频次。
• 新增额外单元测试与游戏测试。

6.16.0

• 修复 #732：提供选项禁用对话的ESC键与关闭按钮。
• 修复 #723：在交易界面等特定场景下避免自动关闭。
• 新增通用对话配置选项，允许用户自定义对话行为。
• 新增头像缩放与位置偏移选项。
• 新增缺失翻译键。

6.15.1

• 修复 #735：继承正确的基类。
• 修复若干26.1.2版本手动生成测试中发现的问题。

6.15.0（交易、玩家头颅、史诗战斗与体验优化更新）

• 修复 #731：若客户端物种列表为空，则重新同步物种数据。
• 修复 #730：改进史诗战斗（Epic Fight）集成并启用实验性功能。
• 修复 #729：确保交易使用次数正确存储。
• 修复 #728：新增玩家头颅自定义支持。
• 修复 #689：显示剩余交易次数，并支持手动与自动重置。
• 修复 #218 与 #132：新增交易配置界面并增强对自定义交易的支持。
• 修复交易特有边界情况：在基础交易模式与普通/高级交易模式间切换。
• 修复对话按钮文字截断问题，工具提示显示完整文本。
• 修复方块宝可梦动画问题：同步动画状态至方块宝可梦动画系统。
• 新增每笔交易专属动作，允许用户在购买后触发动作。
• 新增交易重置按钮，便于一键重置全部交易。
• 新增交易使用信息至交易配置界面。
• 新增实验性功能开关，允许用户手动启用实验性功能。
• 新增示例商人格里塞尔达·磨石，含动作功能。
• 清理测试文件。

6.14.0

• 修复 #727：确保数值变更时同步至客户端。
• 修复 #726：为特定命令新增额外白名单。
• 修复 #686、#389、#304、#211：新增基础方块宝可梦（Cobblemon）支持，含Cobblemon NPC。
• 修复对话错位与导航问题：调整对话精灵图与界面。
• 修复X轴与Z轴根旋转：修正旋转逻辑与枢轴点计算。
• 新增基础方块宝可梦（Cobblemon）支持：含自定义NPC类型与模型用于测试。

6.13.0（安全与权限更新）

注意：本次更新强化了多人游戏环境下的安全检查与权限控制。部分服务端命令存在潜在风险，恶意使用可能造成危害。

本次更新将模型根部数据与逻辑与其他模型部件数据与逻辑分离，可能导致现有NPC的根部旋转与缩放重置为默认值。

• 修复 #725：分离模型根部数据与逻辑与其他模型部件数据与逻辑。
• 修复 #722：支持.sbnt文件作为本地预设。
• 修复 #675：为对话与配置界面背景新增专用资源。
• 修复 #605、#532、#529：新增安全检查与权限系统。
• 修复 #469、#311：新增实验性API文档与自定义模型支持示例。
• 修复配置界面背景重复渲染问题：移除冗余背景渲染。
• 修复恶魂与史莱姆碰撞箱及名称标签位置问题：调整碰撞箱。
• ⚠️ 新增安全检查，防止潜在漏洞利用，保障多人游戏环境安全使用。
• 将动态对话界面背景替换为静态背景，提升性能、自定义性与兼容性。
• 将动态配置界面背景替换为静态背景，提升性能。
• 重构配置UI专用组件，并从核心模组中移除。
• 移除重复精灵图集。
• 为未来可能的LuckPerms集成（如#712）准备权限系统。
• 通用代码清理与配置界面渲染及资源相关优化。

6.12.0

• 修复 #714：基于原版模型，为自定义模型部件列表新增额外校验。
• 修复 #713：降低日志冗余度：将每个NPC的INFO级消息降级为DEBUG，并合并冗余警告消息。
• 修复 #711：减少启动/配置日志输出量。
• 修复NBT验证防护：防止生产环境中不必要的缓冲区分配。
• 为EasyNPCModelManager新增模型部件名称常量，确保混入（Mixin）中一致使用。
• 通过增强过滤逻辑与优化数据结构，提升RenderEntityTypeSupportConfig性能与可维护性。
• 移除冗长调试日志（大量数据结构转储）。

6.11.1

• 修复 #710：改进可恢复交易数据的向后兼容解析。

6.11.0

• 修复 #703：新自定义图层系统与手持物品渲染引发的渲染问题。
• 修复 #701：为无效交易报价新增额外防护与日志记录。
• 修复智能动画在修改头部位置后无法正常工作问题。
• 修复头部追踪：将玩家检测移回服务端独占执行。
• 修复CustomLookAtPlayerGoal：更好处理边界情况并减少抖动。
• 修复多普勒NPC持续持有手部物品问题。
• 优化PoseManager日志消息。
• 更新Logo为新设计。

6.10.0

• 修复 #698：为第三方实体创建添加try-catch防护。
• 修复 #695：切换至DEFAULT原版姿态时清除模型部件旋转/位置。
• 修复 #695：仅当NPC处于空闲状态时应用锁定旋转与姿态动画。
• 修复 #695：修正根部旋转枢轴点，使用实际碰撞箱高度而非固定0.5f。
• 修复多重目标注册问题：包括反转的isTargetedPlayer检查、离开处理器中错误的UUID、加入/离开时缺少玩家目标刷新、离线目标重试等。
• 修复目标注销后仍保留目标引用问题。
• 移除加载姿态时自动锁定ROOT旋转；根部锁定现由用户自主控制。
• 在高级与自定义姿态配置界面新增锁定旋转复选框。
• 在ConfigurationMenuHandler中为默认姿态界面新增模型特定姿态键过滤。
• 新增CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior与ModelAnimationData单元测试。
• 新增NPCDataIsolationTestHelper及Fabric与Forge游戏测试。
• 将最大头部水平转动范围由60°提升至65°。

6.9.0

• 修复 #692、#666：新增缓存与防护机制，防止NPC实体数据更新被重复触发。
• 修复 #651、#617：为所有支持的NPC类型新增基础自定义姿态。
• 修复 #597：新增面向玩家、村民、怪物等的额外逃亡目标。
• 修复姿态加载：直接从模组资源读取，而非复制文件至磁盘。
• 修复实体加入时重复调用saveNPC：先检查是否存在已有注册项。
• 新增despawn与spawn指令：支持通过UUID移除与重生NPC，并可配置移除原因。
• 新增ModelPoseAPI与EasyNPCEntityHandler公共API类，供外部模组编程控制NPC姿态与管理NPC。
• 新增所有支持NPC类型的姿态数据文件。
• 在基础姿态配置界面新增锁定旋转复选框。
• 新增MoveToPositionGoal：在执行回调动作前，先将NPC移动至指定位置。
• 新增EasyNPCLookControl与EasyNPCBodyRotationControl：尊重锁定的根部旋转。
• 新增同步的

... [内容过长已截断]

Easy NPC：核心版（1.21.11）更新日志

注意事项

本更新日志仅汇总重点变更内容。完整变更记录请参阅
[GitHub 历史记录][history]。

注意：升级至新版本前，请务必备份您的世界存档及所有NPC数据！
更多详情请查阅[升级指南][upgrade_guide]。

7.4.0

• 修复 #807：不再将32格范围内所有同类型NPC自动拉入“自卫”战斗。
• 修复 #805：统一评估全部可见性设置，而非在首个设置处即停止判断。
• 修复 #804：为多普勒NPC保留自定义名称，确保基于名称的贴图与名称标签正常显示。
• 修复 #803：调整资源素材风格，使其更贴近原版Minecraft UI，而非通用UI风格。
• 修复昼夜检测逻辑错误：此前将日出判定为夜晚、日落判定为白天。
• 修复下界与末地的可见性判定错误：此前错误使用主世界时间进行判定。
• 修复时间与游戏模式可见性复选框随机排列的问题。
• 修复游戏测试仅能在首次断言失败时报错的问题，避免掩盖后续失败项。
• 修复“已配鞍”马匹皮肤变体始终不显示马鞍的问题。
• 将“对所有者可见”与“对队伍可见”两项设置，同步纳入昼夜与游戏模式可见性规则。
• 调整唤魔者、幻术师与卫道士变体——未启用“双臂交叉”姿态时，手臂默认保持自然下垂。
• 新增“保卫阵营”目标：当附近阵营成员或玩家受到攻击时，自动反击施害者。
• 新增系统提示：当阵营成员彼此交战且该阵营选择中立时，向玩家发送提示信息。
• 为恼鬼类生物新增头部装备栏位，支持移除或更换其队长旗帜。
• 在显示配置界面新增昼夜预览功能。
• 为可见性属性与阵营防御机制新增单元测试与游戏内测试。
• 优化可见性检测性能：每次检测仅读取一次显示属性。
• 完善旧版本显示属性：缺失字段将自动补全为默认值。
• 优化攻击目标界面：当未设定相关目标时，“保护所有者”与“保卫阵营”选项将自动禁用。

7.3.0

• 改进皮肤变体实现方式：以强类型字段承载数据，而非解析变体名称字符串。
• 统一Cobblemon模组ID与默认模型，通过共享常量集中管理。
• 使用共享EnumUtils辅助类替代重复枚举代码，简化get(String)查找逻辑。
• 优化村民职业与类型查找：改用直接注册表键查询，避免遍历扫描。
• 优化枚举名称查找：构造时一次性缓存标签名、ID与键值，提升运行效率。
• 为皮肤变体、村民解析及枚举辅助类新增单元测试与游戏内测试。

7.1.2

• 修复 #801：对NPC、对话与动作的UUID采用组合式生成策略，避免动作追踪与执行限制发生冲突。

7.1.1

• 修复 #800：采用懒加载方式加载实体类型。
• 修复 #799：完善边界情况处理，并补充详细文档说明与更清晰的日志输出。
• 修复 #798：将控制台、命令与命令方块明确列为可信命令源。
• 修复单人游戏/LAN联机关键问题：客户端与服务端NPC此前共用同一注册表。
• 修复配置菜单处理过程中的内存泄漏，并新增超时与断开连接后的清理机制。
• 修复多个NPC同时请求同一皮肤时触发重复下载的问题。
• 修复皮肤查找因错误失败后无法恢复的问题，避免慢速服务器导致游戏卡死。
• 修复URL皮肤界面在检查远程图片时冻结游戏的问题；现改为后台异步执行检查。

7.0.0

• 修复 #794：NPC渲染时使用预期的数据类型。
• 修复缩放界面预览：将实体脚部锚定于标尺零刻度线，使NPC缩放由底部向上进行（而非中心缩放），避免包围盒更新后整体下移。
• 修复 #791：新增流浪商人NPC类型。
• 修复 #788：将AI防护机制扩展至史诗战斗（Epic Fight）及原始NPC变体（猪灵、村民、末影人、苦力怕、劫掠者、女巫）。
• 修复 #787、#531、#237、#184：新增阵营系统，支持/easy_npc faction指令、每NPC独立阵营分配及自动计分板队伍同步。
• 修复 #787、#771、#572：新增“目标”攻击目标页签，支持按玩家名、队伍、实体标签或UUID攻击敌对阵营或特定目标。
• 修复 #786：为Cobblemon NPC新增性别与闪光模型变体，可在模型选择中通过关键词female（雌性）或shiny（闪光）搜索。
• 修复无敌NPC间阵营战斗失效问题：新增“可被阵营攻击”战斗属性。
• 修复Cobblemon模型选择预览对超大体型物种适配不良问题：改用Cobblemon自身档案缩放比例，而非包围盒高度。
• 修复阵营管理边界情况：校验阵营名称合法性、对阵营列表排序，并在阵营颜色变更或删除后刷新已加载NPC的计分板分配。
• 修复自定义皮肤重载问题：按皮肤模型分别加载与清空贴图缓存，而非每次都重建全部自定义贴图缓存。
• 优化“可被玩家/怪物/阵营攻击”战斗属性：各属性独立于“无敌”状态生效，分别为对应攻击者群体单独开放攻击入口。
• 优化预设指令与网络处理：将大型处理器拆分为小型、专注型组件（导入、导出、特性专用）。
• 新增Easy Model Entities支持。
• 新增阵营管理器与阵营编辑器界面，用于创建、染色、删除阵营及管理敌对关系；受全新FACTION_MANAGEMENT安全特性保护。
• 新增“杂项”属性页签，作为NPC阵营分配的归属位置。
• 新增可复用的警告与帮助图标组件，支持内联提示与悬浮工具提示。
• 新增针对阵营、目标目标及Cobblemon模型变体的单元测试与游戏内测试。

6.25.0

• 修复 #782、#636、#622：验证过程中保留数据组件。
• 修复 #780：缓存远程贴图下载，减少重复注册。
• 修复 #767：对其他模组传入的极端属性值进行钳制处理。
• 修复 #754：为含动作与条件的NPC新增自定义数据项匹配功能。
• 修复贴图管理器在错误线程运行可能导致≥1.21.x版本崩溃与死锁的问题。
• 修复动作条件中空UUID处理问题。
• 修复动作执行限制重置问题。
• 新增贴图注册队列，避免同游戏刻内多次并发下载。
• 新增NPC金币、钥匙与红令牌作为含动作与条件NPC的消耗品。
• 新增示例NPC预设Welcome Coin Trader（欢迎金币商人），含自定义金币、钥匙与红令牌物品数据。
• 新增属性防护机制，防止其他模组传入极端值。
• 将备用最大生命值上限从1024提升至4096，适配高生命值NPC。
• 优化贴图管理器：减少重复贴图校验与注册。

6.24.0

• 修复 #459、#775：新增阻止与不可见NPC交互的选项。
• 修复 #774：与史诗战斗（Epic Fight）及Cobblemon实体类型映射相关的启动崩溃问题。
• 修复 #773：在基础刻度循环中及打开交易界面前检查限时交易重置。
• 修复交易重置时机：正确增加内部计时器。
• 为 #459 新增昼夜时间与天气条件支持。
• 新增针对交易重置、计时器处理及实体属性的单元测试与游戏内测试。
• 新增示例NPC预设Skywatch Scout（天穹哨兵），支持昼夜时间与天气条件。

6.23.0

• 修复 #774：将isSunBurnTick错误迁移至26.x版本。
• 修复 #772：针对403与404错误优化贴图重试机制，并降低日志级别。
• 修复 #770：史诗战斗（Epic Fight）NPC（唤魔者、掠夺者、卫道士及人形皮肤）的物品渲染问题。
• 修复 #769：NPC开门/关门行为不稳定问题。
• 修复 #760：新增对话选项与配置设置（buttonConditionMode: LOCK 或 HIDE），支持锁定或隐藏不可用的条件对话按钮。
• 修复 #709：新增姓名颜色选择弹窗，提供32种预设色及手动RGB/十六进制输入。
• 修复NPC重命名未指定颜色时名称颜色被重置问题：保留原有名称颜色。
• 优化门移动属性：当启用“开门”或“关门”时，“穿门”自动启用。

6.22.0

• 修复 #766：向命令执行传递完整服务端玩家上下文，提升与依赖特定玩家数据的第三方模组/插件兼容性。
• 修复 #764：新增实体生命值、NPC生命值条件，并添加示例NPC预设Grukk, the Sparring Post（格鲁克，陪练桩）演示其用法。
• 修复 #763：确保对话按钮执行限制现在被准确记录。
• 修复 #758：新增示例NPC预设One Wish Companion（一愿伴侣）。
• 修复 #756：解决第三方村民AI读取Easy NPC村民未注册脑记忆（如PoiCompetitorScan / job_site）引发的崩溃。
• 修复对话按钮在服务端数据下未锁定问题，为 #760 与 #644 做准备。
• 修复 #628：新增条件化对话开启支持/指令，更精细控制对话向玩家展示的时机。
• 为猪灵与猪灵蛮兵NPC新增脑AI，并注册完整原版脑记忆集。
• 为枪械标签新增更多枪械支持（#757）。
• 新增“条件化开启对话”动作：仅当满足指定条件时才开启命名对话；原有“开启对话”动作仍保持无条件开启。
• 新增实体生命值与NPC生命值条件，适用于动作、对话及对话按钮。
• 为猪灵、猪灵蛮兵与僵尸猪灵NPC新增无敌属性，与其他NPC保持一致。
• 新增“击退免疫”战斗属性：防止NPC被近战或投射物攻击击退。
• 新增“爆炸免疫”战斗属性：使NPC免疫爆炸伤害与位移（如TNT、苦力怕、末影水晶）。
• 将“投射物碰撞”属性移至战斗属性界面（此前位于能力界面），主题更契合。

6.21.0

• 修复交叉双臂姿态下恼鬼类生物的物品附着问题。
• 修复恼鬼类生物十字弓攻击目标失效问题。
• 修复 #756：第三方物品无法作为手持物品渲染引发的崩溃。
• 修复 #756：第三方混入（Mixin）尝试访问不存在模型部件引发的崩溃。
• 修复日志信息泛滥问题：降低日志详细程度，并为自定义模型部件添加额外校验。
• 提升EasyNPCModelManager性能。
• 重构NPC渲染器，移除默认手持物品图层。

6.20.0

• 修复第三方模组尝试访问不存在NPC目标引发的崩溃。

6.19.0

注意：本次更新将对话背景图片尺寸调整为每边增加10×6像素，若用户使用自定义对话背景，可能需要相应调整。

• 修复 #752、#130：新增对话按钮条件支持，允许禁用按钮。
• 修复 #683、#215：新增对话文本打字机效果支持。
• 修复 #690、#309：支持对话、对话按钮与交互的条件判断。
• 修复对话界面布局与背景相关的细微UI问题。
• 重构对话背景图片：每边尺寸增加10×6像素。
• 重构对话界面布局：更好适配新背景尺寸并提升视觉效果。
• 新增对话文本打字机效果及客户端配置。
• 新增条件符号：直观指示对话、按钮与交互的条件状态。
• 新增物品条件数量字段：支持检查特定数量的物品。
• 新增示例NPC预设Threshold Warden（阈值守卫），包含多种条件与动作。
• 新增少量与对话条件及按钮状态相关的Bug修复与优化。

6.18.0

注意：本次更新更改了条件与动作的内部数据格式，可能导致旧版执行限制条目（无存储ID者）被重置或移除。

• 修复 #745：为动作新增条件支持，实现更复杂、动态的行为逻辑。
• 修复 #652：为长文本对话按钮新增工具提示。
• 修复 #687：为指令值新增工具提示，显示完整值内容。
• 新增经验等级条件。
• 新增游戏模式条件。
• 新增物品存在于物品栏条件。
• 新增物品存在于手中条件（支持主手与副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增示例NPC预设Goldmere（金宝石之地），包含多种条件与动作。
• 新增否定条件支持：允许对条件取反，构建更复杂逻辑。
• 移除ActionDataEntry参数伪ID，替换为随机UUID。
• 重构条件系统，支持更多条件类型。

6.17.0

• 修复 #738：为“以玩家身份执行”新增额外工具提示。
• 优化详细日志：降低启动与游戏中log.info消息频率。
• 新增额外单元测试与游戏内测试。

6.16.0

• 修复 #732：新增禁用对话ESC键与关闭按钮的选项。
• 修复 #723：在特定场景（如交易界面）下避免自动关闭。
• 新增通用对话配置选项，允许用户自定义对话行为。
• 新增头像缩放与位置偏移选项。
• 新增缺失翻译键。

6.15.1

• 修复 #735：继承正确的基类。
• 修复若干26.1.2版本特有问题（手动生成测试发现）。

6.15.0（交易、玩家头颅、史诗战斗与体验优化更新）

• 修复 #731：若客户端物种列表为空，则重新同步物种数据。
• 修复 #730：改进史诗战斗（Epic Fight）集成，启用实验性功能。
• 修复 #729：确保交易使用次数正确存储。
• 修复 #728：新增玩家头颅自定义支持。
• 修复 #689：显示剩余交易次数，并支持手动与自动重置。
• 修复 #218 与 #132：新增交易配置界面，增强自定义交易支持。
• 修复交易特定边界问题：在基础交易模式与普通/高级交易模式间切换。
• 修复对话按钮文字截断问题（完整文字通过工具提示显示）。
• 修复Cobblemon动画问题：同步动画状态至Cobblemon动画系统。
• 新增每笔交易专属动作：允许用户在购买后触发动作。
• 新增交易重置按钮：一键重置全部交易。
• 新增交易使用信息至交易配置界面。
• 新增实验性功能开关：允许用户手动启用实验性功能。
• 新增示例商人Griselda Grindstone（格里塞尔达·磨石），含动作支持。
• 清理测试文件。

6.14.0

• 修复 #727：确保数值变更后同步至客户端。
• 修复 #726：为特定指令新增额外白名单。
• 修复 #686、#389、#304、#211：新增基础Cobblemon支持（Cobblemon NPC）。
• 修复对话错位与导航问题：调整对话精灵图与界面。
• 修复X轴与Z轴根旋转：修正旋转逻辑与枢轴点计算。
• 新增基础Cobblemon支持：含自定义NPC类型与模型，供测试使用。

6.13.0（安全与权限更新）

注意：本次更新强化了多人游戏环境下的安全检查与权限控制。部分服务端指令存在潜在风险，恶意使用可能导致安全隐患。

本次更新将模型根部数据与逻辑，与其他模型部件数据与逻辑分离，可能导致现有NPC的根旋转与缩放重置为默认值。

• 修复 #725：分离模型根部数据与逻辑，与其他模型部件数据与逻辑解耦。
• 修复 #722：支持.sbnt文件作为本地预设。
• 修复 #675：为对话与配置界面背景新增专用资源。
• 修复 #605、#532、#529：新增安全检查与权限系统。
• 修复 #469、#311：新增实验性API文档与自定义模型支持示例。
• 修复配置界面背景重复渲染问题：移除冗余背景渲染。
• 修复恶魂与史莱姆的包围盒及名称标签位置问题：调整包围盒。
• ⚠️ 新增安全检查：防范潜在漏洞，保障多人游戏环境安全使用。
• 将动态对话界面背景替换为静态背景，提升性能、自定义性与兼容性。
• 将动态配置界面背景替换为静态背景，提升性能。
• 重构配置UI专用组件，并将其从核心模组中移除。
• 移除重复精灵图集。
• 为未来可能的Luck Perms集成（如 #712）做好权限系统准备。
• 通用代码清理与优化：聚焦配置界面渲染与资源管理。

6.12.0

• 修复 #714：基于原版模型，为自定义模型部件列表新增额外校验。
• 修复 #713：降低日志详细程度：将每NPC的INFO级消息降级为DEBUG，并合并冗余警告消息。
• 修复 #711：减少启动/配置日志输出量。
• 修复NBT验证防护：防止生产环境中不必要的缓冲区分配。
• 在EasyNPCModelManager中新增模型部件名称常量，确保混入（Mixin）中的一致使用。
• 优化RenderEntityTypeSupportConfig：增强过滤逻辑，优化数据结构，提升性能与可维护性。
• 移除大量数据结构转储的冗长调试日志。

6.11.1

• 修复 #710：改进可恢复交易数据的向后兼容解析。

6.11.0

• 修复 #703：新自定义图层系统与手持渲染导致的渲染问题。
• 修复 #701：为无效交易报价新增额外防护与日志记录。
• 修复智能动画在修改头部位置后无法正常工作问题。
• 修复头部追踪：将玩家检测逻辑移回服务端独占。
• 修复CustomLookAtPlayerGoal：更好处理边界情况，减少抖动。
• 修复多普勒NPC持续持有手部物品问题。
• 优化PoseManager日志消息。
• 更新Logo为新设计。

6.10.0

• 修复 #698：为第三方实体创建添加try-catch异常捕获。
• 修复 #695：切换至DEFAULT原版姿态时，清除模型部件旋转/位置。
• 修复 #695：仅当NPC处于空闲状态时，才应用旋转锁定与姿态动画。
• 修复 #695：修正根旋转枢轴点：使用实际包围盒高度，而非固定0.5f。
• 修复多目标注册问题：包括反转的isTargetedPlayer检查、离开处理器中错误的UUID、加入/离开时缺失的玩家目标刷新、离线目标重试等。
• 修复目标注销后仍保留目标引用问题。
• 移除加载姿态时自动锁定ROOT旋转；根旋转锁定现由用户控制。
• 在高级与自定义姿态配置界面新增旋转锁定复选框。
• 在ConfigurationMenuHandler中为默认姿态界面新增模型特定姿态键过滤。
• 为CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior与ModelAnimationData新增单元测试。
• 新增NPCDataIsolationTestHelper及Fabric与Forge的游戏内测试。
• 将最大头部偏航范围从60°提升至65°。

6.9.0

• 修复 #692、#666：新增缓存与防护机制，防止NPC实体数据更新被重复触发。
• 修复 #651、#617：为所有支持的NPC类型新增基础自定义姿态。
• 修复 #597：新增多种逃离目标（逃离玩家、村民、怪物等）。
• 修复姿态加载：直接从模组资源读取，而非复制文件到磁盘。
• 修复实体加入时重复调用saveNPC：先检查注册表中是否已存在条目。
• 新增despawn与spawn指令：支持通过UUID移除与重新生成NPC，并可配置移除原因。
• 新增`Mod

... [内容过长已截断]