Easy NPC 更新日志 (1.20.1)

说明

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

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

7.18.0

• 修复 #862：防止 NPC 在加载时因 LetMeDespawn 等模组而丢失。
• 修复：近战兼范围攻击的 NPC 在持弓、弩或枪械时不射击的问题。
• 修复：NPC 在目标之间旋转、以及史莱姆 NPC 攻击时向错误方向跳跃的问题。
• 修复：传送离开或更改维度后 Boss 栏仍停留在屏幕上的问题。
• 修复：创造模式对 NPC 使用选取方块时无法获得其刷怪蛋的问题。
• 修复：“计分板”条件为没有分数的玩家添加 0 分的问题。
• 修复：斯巴达武器的金弩，并添加了皮革和铜制弩。
• 修复：皮肤界面中提示重叠、复选框提示、缺失的错误以及日志刷屏问题。
• 修复：“自定义”皮肤标签页将文件夹命名为 skins 而非 config/easy_npc/skin 的问题。
• 修复：大量德语翻译并补充了缺失的翻译。
• 变更：预设物品在生存模式下生成 NPC 时会被消耗，以修复 #844。
• 变更：巡游、归巢和注视目标在战斗期间及战斗结束后 3 秒内暂停。
• 变更：有目标但没有可用攻击方式（例如手中无弓）的 NPC 会注视其目标。
• 变更：“攻击”和“弹射物设置”界面更简洁，并添加了滑块提示。
• 变更：Boss 栏选项移至“显示”中的独立界面，并新增“隐藏延迟”设置。
• 新增：按玩家区分的可见性条件（例如按分数），位于“显示”标签页，以修复 #785。
• 新增：为弓、弩和枪械添加带伤害、尾迹和冲击效果的自定义弹射物，以修复 #855。
• 新增：“弹射物攻击”目标，可像巫师一样无需武器发射弹射物。
• 新增：子弹、火球或物品等弹射物类型、多重射击、击退和效果。
• 新增：projectile、boss_bar 和 objective … set attack type 命令以及 API。
• 新增：“范围攻击”音效以及 npc_base.cfg 中的弹射物爆炸限制。

7.17.1

• 重构构建流程，不再打包测试文件，使模组文件体积减小最多 20%。

7.17.0

• 修复 #858：支持属性修复 (AttributeFix) 等模组设置的更高属性上限。 需要在服务端和客户端都安装属性修复或类似模组；护甲上限为 100。
• 修复 #857：内容无变化时不再在每次区块卸载时重写 NPC 文件。
• 修复 #854：当“打开对话（有条件）”的条件不满足时，会尝试下一个。
• 修复：动作和对话上的“概率”条件被判定两次导致概率降低的问题。
• 修复：崩溃后未保存的 NPC 更改、损坏的预设导出和重复执行的生成动作。
• 修复：scale、rotate 和 position 拒绝 root，以及 name clear 仍显示名字的问题。
• 修复：死亡、骑乘或被拴住的 NPC 落到肩膀上，以及断开连接时的肩膀渲染泄漏。
• 修复：隐藏的头部保留帽子层，以及 NPC 跨维度跟随目标的问题。
• 修复并改进了多个默认预设，包括“格鲁克 (Grukk)”、“铸造守卫”和“瑜伽大师”。
• 变更：默认“亮度等级”从 7 改为 0（环境光照），并限制在 0 到 15 之间。 保留默认值的现有 NPC 也会随之切换；设置为 7 可保持原有外观。
• 变更：“关闭对话”和“回退值”动作在没有任何条件对话打开时执行。
• 变更：设置了传送距离的“跟随队长”NPC 现在可跨维度跟随其队长。
• 变更：服务器停止时会等待仍在写入中的 NPC 文件，最长 2 分钟。
• 变更：闲置 NPC 对附近玩家、坠落或压力板的反应最多延迟 0.5 秒。
• 新增：/easy_npc attribute、/easy_npc debug stats file_storage 和 storage.cfg 保存设置。
• 改进了 NPC 保存、备份、/easy_npc list、肩膀同步和闲置 NPC 的性能。

7.16.0

• 修复 #432：多次设置目标时不再重复运行或在移除后运行。
• 修复：无法从玩家肩膀上放下时 NPC 丢失的问题。
• 修复：“坐在肩膀上”的 NPC 无距离或时间限制地追逐其队长的问题。
• 修复：附加组件的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
• 修复：近战 NPC 忽略“攻击速度”并始终每秒攻击一次的问题。
• 修复：世界和服务器预设无限导出的问题，现限制每分钟 10 次，参见 security.cfg。
• 变更：自 7.15.0 起，被击杀的 NPC 需要 force 或新的复活 API 才能再次生成。
• 变更：内置目标保留由附加组件设置的优先级，而非默认值。
• 变更：铁傀儡“攻击速度”默认值改为 1.0；现有的保持 4.0 且攻击更快。
• 变更：“坐在肩膀上”从“胶兽能力”移到“杂项”属性标签页。
• 变更：可选依赖 Easy Model Entities 要求 2.6.0 或更新版本。
• 新增：复活被击杀 NPC 的 API，以及从肩膀下坐时的重新骑乘冷却。
• 新增：面向附加组件和命令的“坐在肩膀上”的距离、冷却和战斗设置。
• 新增：/easy_npc revive、/easy_npc shoulder 和 objective … priority 命令。
• 新增：每个 NPC 的肩膀偏移量，可在“杂项”标签页或用 /easy_npc shoulder offset 设置。

7.15.0

• 修复 #838：通过 /execute 或命令方块运行时预设导入保持静默。
• 修复 #380：NPC 数量限制现在也应用于默认刷怪笼。
• 修复 #849：声音配置中允许使用资源包声音。
• 修复 #349：不再随机生成左撇子 NPC。
• 修复 #851：对话按钮按每个对话单独锁定，而非跨同标签对话锁定。
• 修复：已删除或重复的 NPC 复活、内存泄漏以及多个队长和 UI 问题。
• 修复：史诗战斗的凋灵骷髅 NPC 缺少其史诗战斗生物补丁的问题。
• 变更：要求客户端和服务端使用相同模组版本，Easy Model Entities 需 2.5.0+。
• 变更：所有世界的备份和被击杀 NPC 数据在 30 天后过期，参见 storage.cfg。
• 新增：“跳跃”、“协助队长”和“跟随最近玩家”以修复 #845、#310、#761。
• 新增：带物品拾取和死亡掉落的 NPC 物品栏，以修复 #111、#197、#543、#670。
• 新增：“坐在肩膀上”、Boss 栏和 /easy_npc debug core loglevel，以修复 #577、#219。
• 新增：“按住”动画模式、“银行柜员”预设以及面向附加组件的新 API 方法。

7.14.0

• 修复 #846：为较晚才开始看到 NPC 的玩家保留自定义姿势。
• 修复：较晚才开始看到 NPC 的玩家缺少属性和交易设置的问题。
• 修复：更改后的最大使用次数、经验和交易类型在重载前不显示在交易界面中的问题。
• 修复：/easy_npc sound set 的更改在 NPC 重载前无法到达玩家的问题。
• 新增：游戏测试，检查重生后和新玩家的 NPC 姿势和设置。

7.13.0

• 修复：对话按钮名称中的颜色和格式化标签显示为纯文本的问题。
• 修复：编辑器中的按钮预览将小写名称显示为原始翻译键的问题。
• 修复：“移动 EasyNPC”物品对创造模式之外的 NPC 队长无效的问题。
• 修复：/easy_npc owner set 在队长无法更改时仍报告成功的问题。
• 修复：URL 或玩家皮肤界面显示皮肤下载错误时游戏崩溃的问题。
• 修复：预设浏览器向下滚动列表后搜索不显示结果的问题。
• 变更：网络协议版本，因此客户端和服务端必须运行相同的模组版本。
• 新增：对话按钮名称支持 @initiator、@npc 和 @score()，以修复 #841。
• 新增：使用客户端运行时接口工具包的自动客户端测试。
• 更大规模的核心重构和代码清理。

7.12.2

• 修复：妖精的碰撞箱太小，导致其名称标签和聊天气泡嵌进身体里的问题。
• 修复：缩放后的 NPC 保留旧碰撞箱和视线高度，导致攻击、点击和注视落空的问题。
• 修复：格式错误的网络数据包导致玩家断开连接而非被忽略的问题。
• 修复：应用无效的 NPC 位置、大小、属性、名称和持续时间的问题。
• 变更：妖精 NPC 占用其模型的实际空间，因此有碰撞且可被点击。
• 变更：网络协议版本，因此客户端和服务端必须运行相同的模组版本。

7.12.1

• 修复 #836：始终显示“恢复”，包括数据包预设，并带有原因提示。
• 修复：预设导入和导出消息缺失、错误或不警告被替换的 NPC 的问题。
• 修复：预设浏览器在每次按键时重载、NPC 泄漏和清除所选的问题。
• 修复：小窗口中预设列表排序、筛选顺序和布局裁剪的问题。
• 修复：/easy_npc preset import data 无位置时被导入为默认预设的问题。
• 修复：生成速率限制泄漏、不稳定的预设 ID 和“生成新 NPC”在同一地点堆叠 NPC 的问题。
• 变更：“恢复”在不被允许时拒绝执行，而非生成副本。
• 新增：排序、匹配数量、重载、自动关闭、NPC ID 以及预设和皮肤的提示。
• 新增：带限制、确认和可点击位置的 matching <pattern> 批量导入。

7.12.0

• 修复 #833：Easy NPC 魔杖轮廓仅对魔杖持有者、队长和管理员显示。 其他玩家不再看到轮廓，隐身的 NPC 对他们保持隐藏。
• 修复 #834：在位置配置中添加“此处设为家”和“重置家”按钮。
• 修复 #835：导出的预设中保留 NPC ID 和位置，导入时恢复同一个 NPC。
• 修复：预设导入和刷怪蛋丢失队长列表条目和队长目标的问题。
• 修复：从自动备份恢复的 NPC 丢失队长而变成无主的问题。
• 修复：选择列表只显示前六项而隐藏其余项的问题。
• 变更：导入预设时更新存储位置上的原始 NPC 而非添加副本； 使用“导入为新 NPC”或预设物品可创建独立的 NPC。
• 变更：完成的交易播放“交易完成”音效，此前保持静默。
• 变更：API 对话调用报告未知的对话标签，而非始终报告成功。
• 变更：无手臂的 NPC 将手持物品携带在头部或身体处，而非隐藏。
• 变更：可选依赖 Easy Model Entities 要求 2.4.0 或更新版本。
• 新增：“声音”配置，包含对话、语音、游泳、进食和摔落伤害的声音。
• 新增：可搜索的声音选择以及音量和音调滑块，位于“声音”配置中。
• 新增：“阻挡载具”选项，防止 NPC 进入船、矿车和模组椅子。
• 新增：职业选择加入所有皮肤配置，每种 NPC 类型新增一个内置皮肤。
• 新增：客户端设置，隐藏墙后的名称标签，以及魔杖轮廓的 highlightEnabled。
• 新增：“存在”条件运算，以及 API 对 NPC 移动、动作和预设的访问。

7.11.0

• 修复 #828：NPC 跟随或注视玩家时，登出不再冻结服务器。
• 修复 #831：将常规的 NPC 移除消息移至调试日志。
• 修复 #832：人形 NPC 忽略自定义玩家模型、动画和姿势。
• 修复：每小时 NPC 备份在大型世界上卡顿，以及保留已移除 NPC 时间戳的问题。
• 修复：队长登录恢复时重复、多次恢复、复活或移动未加载 NPC 的问题。
• 修复：NPC 索引和文件同步问题导致的 NPC 丢失、崩溃或错误警告。
• 修复：卸载后的过期 NPC 数据，避免冗余写入并添加重复卸载警告。
• 修复：预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
• 修复：聊天气泡在使用 Iris 光影时丢失文字并变半透明的问题。
• 修复：翻译后的聊天气泡和模组 API 文本的格式化与宏解析问题。
• 新增：minLightLevel，在黑暗环境中保持聊天气泡可读。

7.10.0

• 修复 #829：允许蝙蝠和其他非行走生物作为多普勒 NPC 的渲染实体。
• 修复：NPC 名称标签显示在“自定义模型”配置中预览上方的问题。
• 修复：聊天气泡被墙壁、门框和 NPC 自身身体遮挡的问题。
• 变更：重叠的聊天气泡会分开，且 NPC 在屏幕外时保持可见。
• 变更：以飞行生物渲染的 NPC，“导航：自动”使用飞行移动。
• 变更：渲染实体列表隐藏座位、画、投掷物品和其他非生物实体。
• 新增：飞行 NPC 的“最小悬停高度”滑块，以及聊天气泡的客户端设置。

7.9.0

• 修复：模组鱼类 NPC（如潮汐 (Tide) 2 的鱼）原地旋转而非直立游动的问题。
• 修复：“导航：自动”对水生 NPC 和水生模型 NPC 使用地面移动的问题。
• 修复：“随机游泳”目标从不移动使用水生导航的 NPC 的问题。
• 修复：游泳中的 NPC 原地抖动或抽搐，而非保持倾角和游动深度的问题。
• 修复：游泳中的 NPC 无法到达下一个路径点时永远转圈的问题。
• 修复：落入水中的 NPC 永远无法离开水的问题。
• 修复：跟随中的 NPC 在目标无法到达时每刻搜索新路径的问题。
• 修复：“移动到”动作在高处目标前提前停止，或在空中不启动的问题。
• 修复：“回到基地”忽略高度差且从 32 格之外永不返回的问题。
• 修复：“不透明度”输入框太窄无法显示 100 的值的问题。
• 修复：使用 Easy Model Entities 模型的受损 NPC 不闪红的问题。
• 变更：模组水生 NPC 水平游动，原版水生生物保持原有倾角。
• 变更：“移动到”动作最多步行 48 格，仅在超出该范围时传送。
• 变更：“移动到”和“回到基地”在 3 秒无进展后放弃。
• 变更：“移动到”动作的超时按真实刻计算，此前运行时长是两倍。
• 变更：新的“随机游泳”目标优先级低于跟随、逃跑和攻击目标。
• 变更：使用 Easy Model Entities 模型的 NPC 的“不透明度”由该模组自身应用。
• 变更：Easy Model Entities 最低版本为 2.3.0，旧版本禁用集成。
• 新增：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，旧版本禁用集成。
• 新增：“等待”动作，在选定时间内暂停事件的后续动作。
• 新增：“倒计时守时者”预设，一个以声音和火花结束的聊天气泡十秒倒计时。
• 新增：多普勒 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 预览之上的问题。
• 修复：多普勒和 Easy Model Entities NPC 使用默认碰撞箱而非模型尺寸的问题。
• 修复：服务器上 /easy_npc 命令完全不提示 NPC UUID 的问题。

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