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 错误的纹理重试策略，并降低日志记录