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

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