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

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