Changelog for Easy NPC (1.20.1)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.18.0

• Fixed #862 by keeping NPCs from getting lost on loading with mods like LetMeDespawn.
• Fixed NPCs with melee and a ranged attack not shooting while holding a bow, crossbow or gun.
• Fixed NPCs spinning between objectives and slime NPCs hopping the wrong way when attacking.
• Fixed the boss bar staying on screen after teleporting away or changing dimensions.
• Fixed creative pick block on an NPC not giving its spawn egg.
• Fixed "Scoreboard" conditions adding a score of 0 for players without a score.
• Fixed the Spartan Weaponry golden heavy crossbow and added the leather and copper ones.
• Fixed overlapping hints, checkbox tooltips, and missing errors and log spam in the skin screens.
• Fixed the "Custom" skin tab naming the folder skins instead of config/easy_npc/skin.
• Fixed many German translations and added the missing ones.
• Changed preset items to be used up when spawning an NPC in survival to fix #844.
• Changed stroll, home and look objectives to pause during combat and for 3 seconds after it.
• Changed NPCs with a target but no usable attack, e.g. no bow in hand, to look at their target.
• Changed the "Attack" and "Projectile Settings" screens to be simpler and added slider tooltips.
• Changed boss bar options to their own screen in "Display", with a new "Hide after" setting.
• Added per-player visibility conditions, e.g. by score, in the "Display" tab to fix #785.
• Added custom projectiles with damage, trail and impact for bows, crossbows and guns to fix #855.
• Added the "Projectile Attack" objective to shoot projectiles without a weapon, like a wizard.
• Added projectile types like bullets, fireballs or items, multiple shots, knockback and effects.
• Added the projectile, boss_bar and objective … set attack type commands and an API.
• Added a "Ranged Attack" sound and projectile explosion limits in npc_base.cfg.

7.17.1

• Refactored the build to no longer ship tests, which makes the mod files up to 20 % smaller.

7.17.0

• Fixed #858 by supporting higher attribute limits set by AttributeFix and similar mods. Needs AttributeFix or a similar mod on server and client; armor is capped at 100.
• Fixed #857 by no longer rewriting NPC files on every chunk unload when nothing changed.
• Fixed #854 by trying the next "Open Dialog (Conditional)" when the conditions of one are not met.
• Fixed "Chance" conditions on actions and dialogs being rolled twice, which lowered the chance.
• Fixed unsaved NPC changes, broken preset exports and spawn actions repeated after a crash.
• Fixed scale, rotate and position rejecting root and name clear keeping the name shown.
• Fixed dead, riding or leashed NPCs going on a shoulder and a shoulder render leak on disconnect.
• Fixed hidden heads keeping their hat layer and NPCs following targets in other dimensions.
• Fixed and improved several default presets, including "Grukk", "Forge Keeper" and "Yoga Master".
• Changed the default "Light Level" from 7 to 0 (surrounding light) and limited it to 0 to 15. Existing NPCs that kept the default switch as well; set 7 to keep the old look.
• Changed "Close Dialog" and "Fallback" actions to run when no conditional dialog opened.
• Changed "Follow Owner" NPCs with a teleport distance to follow their owner into other dimensions.
• Changed server stop to wait up to 2 minutes for NPC files that are still being written.
• Changed idle NPCs to react up to 0.5 s later to nearby players, falling or pressure plates.
• Added /easy_npc attribute, /easy_npc debug stats file_storage and storage.cfg save settings.
• Improved performance of NPC saving, backups, /easy_npc list, shoulder sync and idle NPCs.

7.16.0

• Fixed #432 by no longer running objectives twice or after removal when set more than once.
• Fixed NPCs getting lost when they could not be put down from a player's shoulder.
• Fixed "Sit on Shoulder" NPCs chasing their owner without a distance or time limit.
• Fixed Easy Model Entities NPCs from addons being invisible on a player's shoulder.
• Fixed melee NPCs ignoring "Attack Speed" and always attacking once per second.
• Fixed unlimited world and server preset exports by allowing 10 per minute, see security.cfg.
• Changed killed NPCs to need force or the new revive API to spawn again, since 7.15.0.
• Changed built-in objectives to keep a priority set by addons instead of their default.
• Changed the Iron Golem "Attack Speed" default to 1.0; existing ones keep 4.0 and attack faster.
• Changed "Sit on Shoulder" from the "Abilities" to the "Misc" attribute tab.
• Changed the optional Easy Model Entities dependency to require version 2.6.0 or newer.
• Added an API to revive killed NPCs and a remount cooldown when dismounting from a shoulder.
• Added distance, cooldown and combat settings to "Sit on Shoulder" for addons and commands.
• Added /easy_npc revive, /easy_npc shoulder and objective … priority commands.
• Added a shoulder offset per NPC, set in the "Misc" tab or with /easy_npc shoulder offset.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed ma

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

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 的问题。

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

Changelog for Easy NPC: Core (1.21.1)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.17.1

• Refactored the build to no longer ship tests, which makes the mod files up to 20 % smaller.

7.17.0

• Fixed #858 by supporting higher attribute limits set by AttributeFix and similar mods. Needs AttributeFix or a similar mod on server and client; armor is capped at 100.
• Fixed #857 by no longer rewriting NPC files on every chunk unload when nothing changed.
• Fixed #854 by trying the next "Open Dialog (Conditional)" when the conditions of one are not met.
• Fixed "Chance" conditions on actions and dialogs being rolled twice, which lowered the chance.
• Fixed unsaved NPC changes, broken preset exports and spawn actions repeated after a crash.
• Fixed scale, rotate and position rejecting root and name clear keeping the name shown.
• Fixed dead, riding or leashed NPCs going on a shoulder and a shoulder render leak on disconnect.
• Fixed hidden heads keeping their hat layer and NPCs following targets in other dimensions.
• Fixed and improved several default presets, including "Grukk", "Forge Keeper" and "Yoga Master".
• Changed the default "Light Level" from 7 to 0 (surrounding light) and limited it to 0 to 15. Existing NPCs that kept the default switch as well; set 7 to keep the old look.
• Changed "Close Dialog" and "Fallback" actions to run when no conditional dialog opened.
• Changed "Follow Owner" NPCs with a teleport distance to follow their owner into other dimensions.
• Changed server stop to wait up to 2 minutes for NPC files that are still being written.
• Changed idle NPCs to react up to 0.5 s later to nearby players, falling or pressure plates.
• Added /easy_npc attribute, /easy_npc debug stats file_storage and storage.cfg save settings.
• Improved performance of NPC saving, backups, /easy_npc list, shoulder sync and idle NPCs.

7.16.0

• Fixed #432 by no longer running objectives twice or after removal when set more than once.
• Fixed NPCs getting lost when they could not be put down from a player's shoulder.
• Fixed "Sit on Shoulder" NPCs chasing their owner without a distance or time limit.
• Fixed Easy Model Entities NPCs from addons being invisible on a player's shoulder.
• Fixed melee NPCs ignoring "Attack Speed" and always attacking once per second.
• Fixed unlimited world and server preset exports by allowing 10 per minute, see security.cfg.
• Changed killed NPCs to need force or the new revive API to spawn again, since 7.15.0.
• Changed built-in objectives to keep a priority set by addons instead of their default.
• Changed the Iron Golem "Attack Speed" default to 1.0; existing ones keep 4.0 and attack faster.
• Changed "Sit on Shoulder" from the "Abilities" to the "Misc" attribute tab.
• Changed the optional Easy Model Entities dependency to require version 2.6.0 or newer.
• Added an API to revive killed NPCs and a remount cooldown when dismounting from a shoulder.
• Added distance, cooldown and combat settings to "Sit on Shoulder" for addons and commands.
• Added /easy_npc revive, /easy_npc shoulder and objective … priority commands.
• Added a shoulder offset per NPC, set in the "Misc" tab or with /easy_npc shoulder offset.
• Updated the tested NeoForge version to 21.1.262, which fixes three network vulnerabilities.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed oversized names, lists and NPC data in network packets being read without any limit.
• Fixed invalid NPC positions, scales, attributes, names and durations from being applied.
• Changed Fairy NPCs to take up the space of their model, so they collide and can be clicked.
• Changed Skeleton, Stray and Bogged NPCs to the vanilla hitbox height, they were slightly short.
• Changed the network protocol version, so client and server must run the same mod version.

7.12.1

• Fixed #836 by always showing "Restore", including datapack presets, with a reason tooltip.
• Fixed preset import and export messages missing, wrong or not warning about replaced NPCs.
• Fixed the preset browser reloading on each keystroke, leaking NPCs and clearing the selection.
• Fixed the preset list sorting, filter order and layout clipping options in small windows.
• Fixed /easy_npc preset import data without a position importing it as a default preset.
• Fixed spawn rate limit leaks, unstable preset IDs and "Spawn New" stacking NPCs on one spot.
• Changed "Restore" to refuse instead of spawning a copy when it is not permitted.
• Added sorting, a match count, reload, auto-close, the NPC ID and tooltips for presets and skins.
• Added matching <pattern> batch imports with limits, a confirmation and a clickable position.

7.12.0

• Fixed #833 by showing Easy NPC Wand outlines only to the wand holder, owner and admins. Other players no longer see the outlines and invisible NPCs stay hidden for them.
• Fixed #834 by adding "Set Home Here" and "Reset Home" buttons to the position configuration.
• Fixed #835 by keeping the NPC ID and position in exported presets, so imports restore the same NPC.
• Fixed preset imports and spawn eggs losing the owner's list entry and owner objectives

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

Changelog for Easy NPC (1.20.1)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.17.1

• Refactored the build to no longer ship tests, which makes the mod files up to 20 % smaller.

7.17.0

• Fixed #858 by supporting higher attribute limits set by AttributeFix and similar mods. Needs AttributeFix or a similar mod on server and client; armor is capped at 100.
• Fixed #857 by no longer rewriting NPC files on every chunk unload when nothing changed.
• Fixed #854 by trying the next "Open Dialog (Conditional)" when the conditions of one are not met.
• Fixed "Chance" conditions on actions and dialogs being rolled twice, which lowered the chance.
• Fixed unsaved NPC changes, broken preset exports and spawn actions repeated after a crash.
• Fixed scale, rotate and position rejecting root and name clear keeping the name shown.
• Fixed dead, riding or leashed NPCs going on a shoulder and a shoulder render leak on disconnect.
• Fixed hidden heads keeping their hat layer and NPCs following targets in other dimensions.
• Fixed and improved several default presets, including "Grukk", "Forge Keeper" and "Yoga Master".
• Changed the default "Light Level" from 7 to 0 (surrounding light) and limited it to 0 to 15. Existing NPCs that kept the default switch as well; set 7 to keep the old look.
• Changed "Close Dialog" and "Fallback" actions to run when no conditional dialog opened.
• Changed "Follow Owner" NPCs with a teleport distance to follow their owner into other dimensions.
• Changed server stop to wait up to 2 minutes for NPC files that are still being written.
• Changed idle NPCs to react up to 0.5 s later to nearby players, falling or pressure plates.
• Added /easy_npc attribute, /easy_npc debug stats file_storage and storage.cfg save settings.
• Improved performance of NPC saving, backups, /easy_npc list, shoulder sync and idle NPCs.

7.16.0

• Fixed #432 by no longer running objectives twice or after removal when set more than once.
• Fixed NPCs getting lost when they could not be put down from a player's shoulder.
• Fixed "Sit on Shoulder" NPCs chasing their owner without a distance or time limit.
• Fixed Easy Model Entities NPCs from addons being invisible on a player's shoulder.
• Fixed melee NPCs ignoring "Attack Speed" and always attacking once per second.
• Fixed unlimited world and server preset exports by allowing 10 per minute, see security.cfg.
• Changed killed NPCs to need force or the new revive API to spawn again, since 7.15.0.
• Changed built-in objectives to keep a priority set by addons instead of their default.
• Changed the Iron Golem "Attack Speed" default to 1.0; existing ones keep 4.0 and attack faster.
• Changed "Sit on Shoulder" from the "Abilities" to the "Misc" attribute tab.
• Changed the optional Easy Model Entities dependency to require version 2.6.0 or newer.
• Added an API to revive killed NPCs and a remount cooldown when dismounting from a shoulder.
• Added distance, cooldown and combat settings to "Sit on Shoulder" for addons and commands.
• Added /easy_npc revive, /easy_npc shoulder and objective … priority commands.
• Added a shoulder offset per NPC, set in the "Misc" tab or with /easy_npc shoulder offset.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed malformed network packets disconnecting players instead of being ignored.
• Fixed invalid NPC positions, scales, attributes, names and durations from being applied.
• Changed Fairy NPCs to take up the space of their model, so they collide and can be clicked.
• Changed the network protocol version, so client and server must run the same mod version.

7.12.1

• Fixed #836 by always showing "Restore", including datapack presets, with a reason tooltip.
• Fixed preset import and export messages missing, wrong or not warning about replaced NPCs.
• Fixed the preset browser reloading on each keystroke, leaking NPCs and clearing the selection.
• Fixed the preset list sorting, filter order and layout clipping options in small windows.
• Fixed /easy_npc preset import data without a position importing it as a default preset.
• Fixed spawn rate limit leaks, unstable preset IDs and "Spawn New" stacking NPCs on one spot.
• Changed "Restore" to refuse instead of spawning a copy when it is not permitted.
• Added sorting, a match count, reload, auto-close, the NPC ID and tooltips for presets and skins.
• Added matching <pattern> batch imports with limits, a confirmation and a clickable position.

7.12.0

• Fixed #833 by showing Easy NPC Wand outlines only to the wand holder, owner and admins. Other players no longer see the outlines and invisible NPCs stay hidden for them.
• Fixed #834 by adding "Set Home Here" and "Reset Home" buttons to the position configuration.
• Fixed #835 by keeping the NPC ID and position in exported presets, so imports restore the same NPC.
• Fixed preset imports and spawn eggs losing the owner's list entry and owner objectives.
• Fixed NPCs restored from an automatic backup losing their owner and becoming ownerless.
• Fixed selection lists showing only their first six entries and hiding the rest.
• Changed importing a preset to upd

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

Changelog for Easy NPC: Core (1.21.1)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.17.0

• Fixed #857 by no longer rewriting NPC files on every chunk unload when nothing changed.
• Fixed following NPCs walking or teleporting to coordinates of a target in another dimension.
• Fixed equipment, name, inventory, dialog and objective changes not always being saved.
• Fixed preset exports being left broken when the server stopped while writing them.
• Fixed /easy_npc scale, rotate and position rejecting the root model part.
• Fixed /easy_npc name clear leaving the name visible above the NPC.
• Fixed the hat layer staying visible when the head of a humanoid NPC was hidden.
• Fixed dead, riding, ridden or leashed NPCs being put on a shoulder by commands or the API.
• Fixed shoulder NPC rendering comparing all NPC data every frame and leaking on disconnect.
• Changed the default "Light Level" from 7 to 0, which follows the surrounding light. Existing NPCs that kept the default switch as well; set 7 to keep the old look.
• Changed the light level to only accept values from 0 to 15 on the server as well.
• Changed hourly backups to skip NPCs that did not change since today's backup.
• Changed the first save after the update to rewrite and back up all loaded NPCs once.
• Changed NPC changes made outside Easy NPC to be saved hourly and at server stop.
• Changed "Follow Owner" NPCs with a teleport distance to follow their owner into other dimensions.
• Added /easy_npc attribute to set the light level, max health and other base attributes.
• Added /easy_npc debug stats file_storage and NPC file write totals to the server stop log.
• Improved /easy_npc list to no longer load every stored NPC file.
• Improved shoulder NPC sync to send only the data needed to draw them, not dialogs or trades.

7.16.0

• Fixed #432 by no longer running objectives twice or after removal when set more than once.
• Fixed NPCs getting lost when they could not be put down from a player's shoulder.
• Fixed "Sit on Shoulder" NPCs chasing their owner without a distance or time limit.
• Fixed Easy Model Entities NPCs from addons being invisible on a player's shoulder.
• Fixed melee NPCs ignoring "Attack Speed" and always attacking once per second.
• Fixed unlimited world and server preset exports by allowing 10 per minute, see security.cfg.
• Changed killed NPCs to need force or the new revive API to spawn again, since 7.15.0.
• Changed built-in objectives to keep a priority set by addons instead of their default.
• Changed the Iron Golem "Attack Speed" default to 1.0; existing ones keep 4.0 and attack faster.
• Changed "Sit on Shoulder" from the "Abilities" to the "Misc" attribute tab.
• Changed the optional Easy Model Entities dependency to require version 2.6.0 or newer.
• Added an API to revive killed NPCs and a remount cooldown when dismounting from a shoulder.
• Added distance, cooldown and combat settings to "Sit on Shoulder" for addons and commands.
• Added /easy_npc revive, /easy_npc shoulder and objective … priority commands.
• Added a shoulder offset per NPC, set in the "Misc" tab or with /easy_npc shoulder offset.
• Updated the tested NeoForge version to 21.1.262, which fixes three network vulnerabilities.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed oversized names, lists and NPC data in network packets being read without any limit.
• Fixed invalid NPC positions, scales, attributes, names and durations from being applied.
• Changed Fairy NPCs to take up the space of their model, so they collide and can be clicked.
• Changed Skeleton, Stray and Bogged NPCs to the vanilla hitbox height, they were slightly short.
• Changed the network protocol version, so client and server must run the same mod version.

7.12.1

• Fixed #836 by always showing "Restore", including datapack presets, with a reason tooltip.
• Fixed preset import and export messages missing, wrong or not warning about replaced NPCs.
• Fixed the preset browser reloading on each keystroke, leaking NPCs and clearing the selection.
• Fixed the preset list sorting, filter order and layout clipping options in small windows.
• Fixed /easy_npc preset import data without a position importing it as a default preset.
• Fixed spawn rate limit leaks, unstable preset IDs and "Spawn New" stacking NPCs on one spot.
• Changed "Restore" to refuse instead of spawning a copy when it is not permitted.
• Added sorting, a match count, reload, auto-close, the NPC ID and tooltips for presets and skins.
• Added matching <pattern> batch imports with limits, a confirmation and a clickable position.

7.12.0

• Fixed #833 by showing Easy NPC Wand outlines only to the wand holder, owner and admins. Other players no longer see the outlines and invisible NPCs stay hidden for them.
• Fixed #834 by adding "Set Home Here" and "Reset Home" buttons to the position configuration.
• Fixed #835 by keeping the NPC ID and position in exported presets, so imports restore the same NPC.
• Fixed preset imports and spawn eggs losing the owner's list entry and owner objectives.
• Fixed NPCs restored from an automatic backup losing their

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

Changelog for Easy NPC: Core (26.1.2)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.16.0

• Fixed #432 by no longer running objectives twice or after removal when set more than once.
• Fixed #852 by letting spears hit attackable NPCs.
• Fixed NPCs getting lost when they could not be put down from a player's shoulder.
• Fixed "Sit on Shoulder" NPCs chasing their owner without a distance or time limit.
• Fixed Easy Model Entities NPCs from addons being invisible on a player's shoulder.
• Fixed spawning a stored NPC by UUID failing with an invalid dimension error.
• Fixed melee NPCs ignoring "Attack Speed" and always attacking once per second.
• Fixed unlimited world and server preset exports by allowing 10 per minute, see security.cfg.
• Changed killed NPCs to need force or the new revive API to spawn again, since 7.15.0.
• Changed built-in objectives to keep a priority set by addons instead of their default.
• Changed the Iron Golem "Attack Speed" default to 1.0; existing ones keep 4.0 and attack faster.
• Changed "Sit on Shoulder" from the "Abilities" to the "Misc" attribute tab.
• Changed the optional Easy Model Entities dependency to require version 2.6.0 or newer.
• Added an API to revive killed NPCs and a remount cooldown when dismounting from a shoulder.
• Added distance, cooldown and combat settings to "Sit on Shoulder" for addons and commands.
• Added /easy_npc revive, /easy_npc shoulder and objective … priority commands.
• Added a shoulder offset per NPC, set in the "Misc" tab or with /easy_npc shoulder offset.
• Updated the tested NeoForge version to 26.1.2.120, which fixes three network vulnerabilities.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Fixed off-center inventory screens and their close button overlapping the "Custom" trading tab.
• Fixed scaled Doppler NPCs keeping the full hitbox of the mimicked entity.
• Fixed NPCs on a player's shoulder ignoring their scale and the Doppler's mimicked model.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed oversized names, lists and NPC data in network packets being read without any limit.
• Fixed invalid NPC positions, scales, attributes, names and durations from being applied.
• Changed Fairy NPCs to take up the space of their model, so they collide and can be clicked.
• Changed Skeleton, Stray and Bogged NPCs to the vanilla hitbox height, they were slightly short.
• Changed the network protocol version, so client and server must run the same mod version.

7.12.1

• Fixed #836 by always showing "Restore", including datapack presets, with a reason tooltip.
• Fixed preset import and export messages missing, wrong or not warning about replaced NPCs.
• Fixed the preset browser reloading on each keystroke, leaking NPCs and clearing the selection.
• Fixed selection box drop-down lists being covered by the checkboxes and labels behind them.
• Fixed the preset list sorting, filter order and layout clipping options in small windows.
• Fixed /easy_npc preset import data without a position importing it as a default preset.
• Fixed spawn rate limit leaks, unstable preset IDs and "Spawn New" stacking NPCs on one spot.
• Changed "Restore" to refuse instead of spawning a copy when it is not permitted.
• Added sorting, a match count, reload, auto-close, the NPC ID and tooltips for presets and skins.
• Added matching <pattern> batch imports with limits, a confirmation and a clickable position.

7.12.0

• Fixed #833 by showing Easy NPC Wand outlines only to the wand holder, owner and admins. Other players no longer see the outlines and invisible NPCs stay hidden for them.
• Fixed #834 by adding "Set Home Here" and "Reset Home" buttons to the position configuration.
• Fixed #835 by keeping the NPC ID and position in exported presets, so imports restore the same NPC.
• Fixed preset imports and spawn eggs losing the owner's list entry and owner objectives.
• Fixed NPCs restored from an automatic backup losing their owner and becoming ownerless.
• Fixed selection lists showing only their first six entries and hiding the rest.
• Changed importing a preset to update the original NPC at its stored position instead of adding a copy; use "Import as new NPC" or the preset item to create a separate NPC.
• Changed completed trades to play the "Trade completed" sound, which stayed silent before.
• Changed the API dialog call to report an unknown dialog label instead of always reporting success.
• Changed NPCs without arms to carry held items at the head or body instead of hiding them.
• Changed the optional Easy Model Entities dependency to require version 2.4.0 or newer.
• Added a "Sound" configuration with sounds for dialogs, speech, swimming, eating and fall damage.
• Added a searchable sound selection with volume and pitch sliders to the "Sound" configuration.
• Added a "Block Vehicles" option to keep NPCs out of boats, minecarts and modded chairs.
• Added the profession selection to all skin configurations and a new built-in skin per NPC type.
• Added client settings to hide name tags behind walls and highlightEnabled for wand outlines.
• Added an "Exists" condition operation and API access to NPC movement, actions and presets.

7.11.0

• Fixe

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

Changelog for Easy NPC: Core (1.21.1)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed oversized names, lists and NPC data in network packets being read without any limit.
• Fixed invalid NPC positions, scales, attributes, names and durations from being applied.
• Changed Fairy NPCs to take up the space of their model, so they collide and can be clicked.
• Changed Skeleton, Stray and Bogged NPCs to the vanilla hitbox height, they were slightly short.
• Changed the network protocol version, so client and server must run the same mod version.

7.12.1

• Fixed #836 by always showing "Restore", including datapack presets, with a reason tooltip.
• Fixed preset import and export messages missing, wrong or not warning about replaced NPCs.
• Fixed the preset browser reloading on each keystroke, leaking NPCs and clearing the selection.
• Fixed the preset list sorting, filter order and layout clipping options in small windows.
• Fixed /easy_npc preset import data without a position importing it as a default preset.
• Fixed spawn rate limit leaks, unstable preset IDs and "Spawn New" stacking NPCs on one spot.
• Changed "Restore" to refuse instead of spawning a copy when it is not permitted.
• Added sorting, a match count, reload, auto-close, the NPC ID and tooltips for presets and skins.
• Added matching <pattern> batch imports with limits, a confirmation and a clickable position.

7.12.0

• Fixed #833 by showing Easy NPC Wand outlines only to the wand holder, owner and admins. Other players no longer see the outlines and invisible NPCs stay hidden for them.
• Fixed #834 by adding "Set Home Here" and "Reset Home" buttons to the position configuration.
• Fixed #835 by keeping the NPC ID and position in exported presets, so imports restore the same NPC.
• Fixed preset imports and spawn eggs losing the owner's list entry and owner objectives.
• Fixed NPCs restored from an automatic backup losing their owner and becoming ownerless.
• Fixed selection lists showing only their first six entries and hiding the rest.
• Changed importing a preset to update the original NPC at its stored position instead of adding a copy; use "Import as new NPC" or the preset item to create a separate NPC.
• Changed completed trades to play the "Trade completed" sound, which stayed silent before.
• Changed the API dialog call to report an unknown dialog label instead of always reporting success.
• Changed NPCs without arms to carry held items at the head or body instead of hiding them.
• Changed the optional Easy Model Entities dependency to require version 2.4.0 or newer.
• Added a "Sound" configuration with sounds for dialogs, speech, swimming, eating and fall damage.
• Added a searchable sound selection with volume and pitch sliders to the "Sound" configuration.
• Added a "Block Vehicles" option to keep NPCs out of boats, minecarts and modded chairs.
• Added the profession selection to all skin configurations and a new built-in skin per NPC type.
• Added client settings to hide name tags behind walls and highlightEnabled for wand outlines.
• Added an "Exists" condition operation and API access to NPC movement, actions and presets.

7.11.0

• Fixed #828 by no longer freezing the server on logout when NPCs follow or watch the player.
• Fixed #831 by moving routine NPC removal messages to the debug log.
• Fixed #832 by making humanoid NPCs ignore custom player models, animations and poses.
• Fixed hourly NPC backups stuttering on large worlds and retaining timestamps of removed NPCs.
• Fixed owner-login restoration duplicating, repeatedly restoring, reviving or moving unloaded NPCs.
• Fixed NPC index and file synchronization issues causing lost NPCs, crashes or false warnings.
• Fixed stale NPC data after unloading, avoided redundant writes and added repeated-unload warnings.
• Fixed the preset browser failing to list custom and world presets saved in the SNBT format.
• Fixed speech bubbles losing their text and turning translucent with Iris shaders.
• Fixed text formatting and macro parsing for translated speech bubbles and mod API texts.
• Added minLightLevel to keep speech bubbles readable in dark surroundings.

7.10.0

• Fixed #829 by allowing bats and other non-walking mobs as the render entity of a Doppler NPC.
• Fixed NPCs rendered as a bat, frog or warden showing a static pose instead of their animation.
• Fixed the NPC name tag showing above the previews in the "Custom Models" configuration.
• Fixed speech bubbles being cut off by walls, doorframes and the NPC's own body.
• Fixed the previews in the "Custom Models" configuration.
• Changed the previews in the "Custom Models" configuration to stand on a common ground line.
• Changed overlapping speech bubbles to move apart and to stay visible when the NPC is off-screen.
• Changed "Navigation: Automatic" to use flying movement for NPCs rendered as a flying mob.
• Changed the render entity list to hide seats, paintings, thrown items and other non-mob entities.
• Added a "Min. hover height" slider for flying NPCs and client settings for speech bubbles.

7.9.0

• Fixed modded fish N

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

Changelog for Easy NPC (1.20.1)

Note

This change log includes the summarized changes. For the full changelog, please go to the [GitHub History][history] instead.

Note: Please always back up your world / NPCs before updating to a new version! Check the [upgrade guide][upgrade_guide] for more information.

7.15.0

• Fixed #838 by keeping preset imports silent when run through /execute or command blocks.
• Fixed #380 by applying the NPC limit to the default spawner as well.
• Fixed #849 by allowing resource pack sounds in the sound configuration.
• Fixed #349 by no longer spawning NPCs left-handed at random.
• Fixed #851 by locking dialog buttons per dialog, not across dialogs with the same label.
• Fixed deleted or duplicated NPCs returning, memory leaks and several owner and UI issues.
• Fixed the Epic Fight Wither Skeleton NPC missing its Epic Fight mob patch.
• Changed requirements: same mod version on client and server, Easy Model Entities 2.5.0+.
• Changed backups of all worlds and killed NPC data to expire after 30 days, see storage.cfg.
• Added "Jump", "Assist Owner" and "Follow Nearest Player" to fix #845, fix #310, fix #761.
• Added an NPC inventory with item pickup and death drops to fix #111, fix #197, fix #543, fix #670.
• Added "Sit on Shoulder", a boss bar and /easy_npc debug core loglevel to fix #577, fix #219.
• Added the "Hold" animation mode, a "Bank Teller" preset and new API methods for addons.

7.14.0

• Fixed #846 by keeping custom poses for players who start seeing the NPC later.
• Fixed attribute and trading settings missing for players who start seeing the NPC later.
• Fixed changed max uses, XP and trading type not shown in the trading screens until reload.
• Fixed /easy_npc sound set changes not reaching players until the NPC was reloaded.
• Added game tests that check NPC poses and settings after respawns and for new players.

7.13.0

• Fixed color and formatting tags in dialog button names showing as plain text.
• Fixed the button preview in the editor showing lowercase names as a raw translation key.
• Fixed the "Move EasyNPC" item not working for NPC owners outside of creative mode.
• Fixed /easy_npc owner set reporting success even when the owner could not be changed.
• Fixed the game crashing when the URL or player skin screen showed a skin download error.
• Fixed the preset browser search showing no results after scrolling down the list.
• Changed the network protocol version, so client and server must run the same mod version.
• Added @initiator, @npc and @score() support to dialog button names to fix #841.
• Added automatic client tests with the Client Runtime Interface Toolkit.
• Larger core refactoring and code cleanup.

7.12.2

• Fixed the Fairy hitbox being far too small, so its name tag and speech bubble sat in its body.
• Fixed scaled NPCs keeping their old hitbox and eye level, so hits, clicks and looking missed.
• Fixed malformed network packets disconnecting players instead of being ignored.
• Fixed invalid NPC positions, scales, attributes, names and durations from being applied.
• Changed Fairy NPCs to take up the space of their model, so they collide and can be clicked.
• Changed the network protocol version, so client and server must run the same mod version.

7.12.1

• Fixed #836 by always showing "Restore", including datapack presets, with a reason tooltip.
• Fixed preset import and export messages missing, wrong or not warning about replaced NPCs.
• Fixed the preset browser reloading on each keystroke, leaking NPCs and clearing the selection.
• Fixed the preset list sorting, filter order and layout clipping options in small windows.
• Fixed /easy_npc preset import data without a position importing it as a default preset.
• Fixed spawn rate limit leaks, unstable preset IDs and "Spawn New" stacking NPCs on one spot.
• Changed "Restore" to refuse instead of spawning a copy when it is not permitted.
• Added sorting, a match count, reload, auto-close, the NPC ID and tooltips for presets and skins.
• Added matching <pattern> batch imports with limits, a confirmation and a clickable position.

7.12.0

• Fixed #833 by showing Easy NPC Wand outlines only to the wand holder, owner and admins. Other players no longer see the outlines and invisible NPCs stay hidden for them.
• Fixed #834 by adding "Set Home Here" and "Reset Home" buttons to the position configuration.
• Fixed #835 by keeping the NPC ID and position in exported presets, so imports restore the same NPC.
• Fixed preset imports and spawn eggs losing the owner's list entry and owner objectives.
• Fixed NPCs restored from an automatic backup losing their owner and becoming ownerless.
• Fixed selection lists showing only their first six entries and hiding the rest.
• Changed importing a preset to update the original NPC at its stored position instead of adding a copy; use "Import as new NPC" or the preset item to create a separate NPC.
• Changed completed trades to play the "Trade completed" sound, which stayed silent before.
• Changed the API dialog call to report an unknown dialog label instead of always reporting success.
• Changed NPCs without arms to carry held items at the head or body instead of hiding them.
• Changed the optional Easy Model Entities dependency to require version 2.4.0 or newer.
• Added a "Sound" configuration with sounds for dialogs, speech, swimming, eating and fall damage.
• Added a searchable sound selection with volume and pitch sliders to the "Sound" configuration.
• Added a "Block Vehicles" option to keep NPCs out of boats, minecarts and modded chairs.
• Added the profession selection to all skin configurations and a new built-in skin per NPC type.
• Added client settings to hide name tags behind walls and highlightEnabled for wand outlines.
• Added an "Exists" condition operation and API access to NPC movement, actions and presets.

7.11.0

• Fixed #828 by no longer freezing the server on logout when NPCs follow or watch the player.
• Fixed #831 by moving routine NPC removal messages to the debug log.
• Fixed #832 by making humanoid NPCs ignore custom player models, animations and poses.
• Fixed hourly NPC backups stuttering on large worlds and retaining timestamps of removed NPCs.
• Fixed owner-login restoration duplicating, repeatedly restoring, reviving or moving unloaded NPCs.
• Fixed NPC index and file synchronization issues causing lost NPCs, crashes or false warnings.
• Fixed stale NPC data after unloading, avoided redundant writes and added repeated-unload warnings.
• Fixed the preset browser failing to list custom and world presets saved in the SNBT format.
• Fixed speech bubbles losing their text and turning translucent with Iris shaders.
• Fixed text formatting and macro parsing for translated speech bubbles and mod API texts.
• Added minLightLevel to keep speech bubbles readable in dark surroundings.

7.10.0

• Fixed #829 by allowing bats and other non-walking mobs as the render entity of a Doppler NPC.
• Fixed the NPC name tag showing above the previews in the "Custom Models" configuration.
• Fixed speech bubbles being cut off by walls, doorframes and the NPC's own body.
• Changed overlapping speech bubbles to move apart and to stay visible when the NPC is off-screen.
• Changed "Navigation: Automatic" to use flying movement for NPCs rendered as a flying mob.
• Changed the render entity list to hide seats, paintings, thrown items and other non-mob entities.
• Added a "Min. hover height" slider for flying NPCs and client settings for speech bubbles.

7.9.0

• Fixed modded fish NPCs, like the ones of Tide 2, spinning around instead of swimming upright.
• Fixed "Navigation: Automatic" using ground movement for water NPCs and aquatic model NPCs.
• Fixed the "Random Swimming" objective never moving an NPC that uses aquatic navigation.
• Fixed a swimming NPC shaking or twitching in place instead of holding its tilt and swim depth.
• Fixed a

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

Easy NPC (1.20.1) 更新日志

注意事项

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

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

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。
• 添加使用客户端运行时接口工具包（Client Runtime Interface Toolkit）的自动客户端测试。
• 进行了更大规模的核心重构与代码清理。

7.12.2

• 修复妖精（Fairy）碰撞箱过小，导致其名称标签和聊天气泡位于身体内部的问题。
• 修复缩放后的 NPC 保留旧碰撞箱和视角高度，导致攻击、点击和注视失效的问题。
• 修复格式错误的网络数据包导致玩家断开连接而非被忽略的问题。
• 修复无效的 NPC 位置、缩放、属性、名称和持续时间被应用的问题。
• 更改妖精 NPC 使其占据模型实际空间，从而可发生碰撞并被点击。
• 更改网络协议版本，客户端与服务端必须运行相同模组版本。

7.12.1

• 修复 #836：始终显示“恢复”按钮（包括数据包预设），并附带原因提示。
• 修复预设导入/导出消息缺失、错误或未警告替换 NPC 的问题。
• 修复预设浏览器每次按键都重新加载，导致 NPC 泄漏并清空选择的问题。
• 修复小窗口中预设列表排序、筛选顺序和布局裁剪选项的问题。
• 修复 /easy_npc preset import data 在未指定位置时将其作为默认预设导入的问题。
• 修复刷怪速率限制泄漏、预设 ID 不稳定以及“生成新 NPC”在同一点堆叠的问题。
• 更改“恢复”逻辑：当不允许时拒绝操作，而非生成副本。
• 为预设和皮肤添加排序、匹配数量、重载、自动关闭、NPC ID 和提示文本。
• 添加带限制、确认和可点击位置的 matching <pattern> 批量导入功能。

7.12.0

• 修复 #833：仅向魔杖持有者、所有者和管理员显示 Easy NPC 魔杖轮廓。其他玩家不再看到轮廓，且不可见 NPC 对他们

Easy NPC（1.20.1）更新日志

注意事项

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

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

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。
• 新增使用客户端运行时接口工具包（Client Runtime Interface Toolkit）的自动客户端测试。
• 进行了大规模核心重构与代码清理。

7.12.2

• 修复了妖精（Fairy）碰撞箱过小，导致其命名牌与聊天气泡位于身体内部的问题。
• 修复了缩放后的 NPC 保留旧碰撞箱与视角高度，导致攻击、点击与注视失效的问题。
• 修复了格式错误的网络数据包会断开玩家连接而非被忽略的问题。
• 修复了无效的 NPC 位置、缩放、属性、名称与持续时间被应用的问题。
• 更改妖精 NPC 以占据其模型所占空间，使其可发生碰撞并能被点击。
• 更改了网络协议版本，客户端与服务器必须运行相同模组版本。

7.12.1

• 修复了 #836：始终显示“还原”按钮（包括数据包预设），并附带原因提示。
• 修复了预设导入/导出消息缺失、错误或未警告已替换 NPC 的问题。
• 修复了预设浏览器在每次按键时重新加载，导致 NPC 泄漏并清空选择的问题。
• 修复了小窗口中预设列表的排序、过滤顺序与布局裁剪选项的问题。
• 修复了 /easy_npc preset import data 在未指定位置时将其作为默认预设导入的问题。
• 修复了刷怪速率限制泄漏、预设 ID 不稳定以及“生成新 NPC”在同一点堆叠的问题。
• 更改“还原”行为：若不允许，则拒绝操作而非生成副本。
• 为预设与皮肤新增排序、匹配数量、重载、自动关闭、NPC ID 与提示文本。
• 新增带限制、确认与可点击位置的 matching <pattern> 批量导入功能。

7.12.0

• 修复了 #8

Easy NPC（1.20.1）更新日志

注意事项

本更新日志仅包含变更摘要。完整更新日志请参阅 [GitHub 历史记录][history]。

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

7.13.0

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

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。
• 修复了预设导入和刷怪蛋丢失所有者列表条目及所有者目标的问题。

Easy NPC（1.20.1）更新日志

注意事项

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

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

7.13.0

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

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。
• 修复了预设导入和刷怪蛋丢失所有者列表条目及所有者目标的问题。
• 修复了从自动

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

注意事项

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

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

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 选项。
• 添加“存在”条件操作，以及对NPC移动、动作和预设的API访问。

7.11.0

• 修复 #828：NPC跟随或注视玩家时，登出不再冻结服务器。
• 修复 #831：将常规NPC移除消息移至调试日志。
• 修复 #832：人形NPC忽略自定义玩家模型、动画和姿势。
• 修复大型世界中每小时NPC备份卡顿，以及保留已移除NPC时间戳的问题。
• 修复所有者登录恢复时重复恢复、反复复活

Easy NPC 更新日志（1.20.1）

注意事项

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

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

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 控制魔杖轮廓高亮。
• 添加“Exists”条件操作，以及对 NPC 移动、动作和预设的 API 访问。

7.11.0

• 修复 #828：NPC 跟随或注视玩家时，登出不再卡住服务器。
• 修复 #831：将常规 NPC 移除消息移至调试日志。
• 修复 #832：人形 NPC 忽略自定义玩家模型、动画和姿势。
• 修复大型世界中每小时 NPC