? Easy NPC: Core
Easy NPC: Core 包含了 Easy NPC 模组的基础逻辑。
它提供了其他 Easy NPC 模块所依赖的核心后端系统。
? 功能说明
- ? 包含 Easy NPC 的核心功能。
- ⚙️ 提供 共享的后端逻辑与基础设施。
- ? 被以下模块依赖:
easy_npc-config-uieasy_npc-bundle
?? 适用人群
此模块最适合:
- ?️ 服务器管理员
- ? 模组开发者
- ? 整合包开发者
- ? 高级用户或多人游戏环境
如果你不需要内置的配置界面,或者希望对 Easy NPC 的集成方式拥有更精细的控制,请使用此版本。
? 普通玩家请勿使用
⚠️ 大多数玩家应使用整合版(bundled version),其中包含用户友好的配置界面。
? 获取地址:modrinth.com/mod/easy-npc
✅ 可独立运行
虽然它可以单独使用,但其主要设计是作为更复杂设置的模块化后端。
简介与概览视频(英文)
🧠 Easy NPC: Core
The Easy NPC: Core includes the foundational logic for the Easy NPC mod.
It provides the essential backend systems used by other Easy NPC modules.
🔧 What It Does
- 📦 Includes the core Easy NPC functionality.
- ⚙️ Provides shared backend logic and infrastructure.
- 🧩 Required by modules like:
easy_npc-config-uieasy_npc-bundle
👨💻 Who Should Use This?
This module is best suited for:
- 🖥️ Server owners
- 🧪 Mod developers
- 🧪 Modpack developers
- 🔧 Advanced users or multiplayer environments
Use this version if you don’t need a built-in configuration UI or want tighter control over how Easy NPC is integrated.
🙅 Not for Regular Players
⚠️ Most players should use the bundled version, which includes a user-friendly config UI.
👉 Available at: modrinth.com/mod/easy-npc
✅ Can Be Used Standalone
While it can be used on its own, it's primarily designed as a modular backend for more complex setups.
Introduction & Overview Video (English)
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
下载 Easy NPC: Core
Easy NPC: Core (26.3) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请查阅 升级指南。
7.20.0
- 修复了当 NPC 缺少皮肤 ID 时导致的崩溃问题,感谢
voidsipp在 #866 中提供的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了人形 NPC 在使用 "None" 或资源位置皮肤时显示 Steve 皮肤的问题。
- 修复了 Forge 和其他模组中,“默认皮肤” 显示相同的 NPC,且使用 NPC 名字标签设置的生物显示异常的问题。
- 修复了当其他模组中断释放过程时,骑在玩家肩上的 NPC 丢失的问题。
- 修复了 NPC 通过闪电、溺水、冰冻或僵尸攻击变成原版生物的问题。
- 修复了生成的 NPC 随机获得幼体、骑手、装备或效果,并丢失其预设装备的问题。
- 修复了没有启用 “拾取物品” 功能的 NPC(如村民、猪灵和狐狸)拾取物品的问题。
- 修复了骷髅 NPC 除了配置的攻击方式外,还使用原版弓和近战攻击的问题。
- 修复了末影人 NPC 的水下伤害和传送机制,以及史莱姆 NPC 分裂和接触伤害的问题。
- 修复了狐狸 NPC 食用手持食物、鸡 NPC 产蛋以及猫 NPC 丢失原版姿势的问题。
- 修复了闪电充能苦力怕 NPC 以及反射的火球瞬间杀死恶魂 NPC 的问题。
- 改动了敌对生物搜索并攻击 NPC 时的服务器性能。
7.19.0
- 通过防止一个 NPC 隐藏的皮肤层在其他同类型 NPC 上隐藏它们,修复了 #865。
- 修复了末影人 NPC 的自定义姿势被其默认动画覆盖的问题。
- 修复了在使用 "DEFAULT" 或 "NONE" 动画行走时,隐藏的身体部位再次显示的问题。
- 修复了 “锁定身体” 标签超出旋转屏幕范围的问题。
- 修复了投射物 “物品 ID” 字段遮挡物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后改变顺序的问题。
7.18.0
- 通过防止加载时 NPC 丢失(配合 LetMeDespawn 等模组),修复了 #862。
- 修复了拥有近战和远程攻击的 NPC 在持有弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标之间旋转以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送到其他地方或切换维度后 Boss 栏仍停留在屏幕上的问题。
- 修复了在创造模式下对 NPC 使用选择方块功能不掉落其生成蛋的问题。
- 修复了 “计分板” 条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 的金质重型弩,并添加了皮革和铜质版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了 “自定义” 皮肤选项卡将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英文 Bogged 名称以及未翻译的 “主手”/“副手” 键名。
- 更改了预设物品的行为:在生存模式下生成 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
- 通过支持 AttributeFix 等模组设置的更高属性上限,修复了 #858。 需要在服务器和客户端安装 AttributeFix 或类似模组;护甲值上限为 100。
- 通过在没有更改的情况下不再重写 NPC 文件,修复了 #857。
- 通过在一个 “打开对话框(条件)” 的条件未满足时尝试下一个,修复了 #854。
- 修复了动作和对话框上的 “概率” 条件被掷骰两次,导致概率降低的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或被拴绳的 NPC 出现在肩上,以及断开连接时的肩部渲染泄漏问题。
- 修复了隐藏头部保留帽子图层以及 NPC 跟随其他维度目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的 “光照等级” 从 7 更改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受影响;设置为 7 可保持旧外观。
- 更改了 “关闭对话框” 和 “回退” 动作的执行时机:当没有条件对话框打开时运行。
- 更改了具有传送距离的 “跟随主人” NPC 的行为:允许其跟随主人进入其他维度。
- 更改了服务器停止时的行为:最多等待 2 分钟,以便写入仍在进行的 NPC 文件。
- 更改了闲置 NPC 的反应时间:对附近的玩家、坠落或压力板的反应延迟可达 0.5 秒。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 提高了 NPC 保存、备份、
/easy_npc list、肩部同步和闲置 NPC 的性能。
7.16.0
- 修复了 #432:不再在目标被多次设置或移除后重复运行目标。
- 修复了 #852:长矛现在可以击中可攻击的 NPC。
- 修复了当玩家无法将 NPC 从肩膀卸下时,NPC 迷路的问题。
- 修复了“坐在肩膀上”的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自附加组件的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成存储的 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命令设置。 - 更新了测试用的 NeoForge 版本至 26.3.0.83,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,预设导入静默执行。 - 修复了 #380:NPC 数量限制也适用于默认刷怪箱。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左手持物的 NPC。
- 修复了 #851:对话框按钮按单个对话框锁定,而不是跨具有相同标签的对话框锁定。
- 修复了已删除或重复的 NPC 重新出现、内存泄漏以及多个所有者和 UI 问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少其 Epic Fight 生物补丁的问题。
- 修复了非居中库存界面及其关闭按钮与“自定义”交易选项卡重叠的问题。
- 修复了缩放后的 Doppler NPC 保留了被模仿实体的完整碰撞箱的问题。
- 修复了位于玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端必须安装相同版本的模组,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。 - 添加了使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行了更核心的重构和代码清理。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名字标签和对话气泡嵌入其体内的問題。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和注视失效的问题。
- 修复了在网络数据包中读取过大的名称、列表和 NPC 数据时没有任何限制的问题。
- 修复了应用无效的 NPC 位置、缩放、属性、名称和持续时间的问题。
- 更改了精灵 NPC 的行为,使其占据其模型的空间,从而产生碰撞并可被点击。
- 更改了骷髅、流浪者和沼泽尸鬼 NPC 的碰撞箱高度为标准原版高度,它们之前略矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同版本的模组。
7.12.1
- 修复了 #836:“恢复”选项始终显示,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告将被替换的 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载,导致 NPC 泄露和选择清空的问题。
- 修复了选择框下拉列表被其后方的复选框和标签覆盖的问题。
- 修复了小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了
/easy_npc preset import data在未指定位置时将预设作为默认预设导入的问题。 - 修复了刷新生率限制泄露、不稳定的预设 ID 以及“生成新”将 NPC 堆叠在同一位置的问题。
- 更改了“恢复”行为,在不允许时拒绝操作而不是生成副本。
- 添加了排序、匹配计数、重新加载、自动关闭、NPC ID 以及预设和皮肤的提示框。
- 添加了带有数量限制的批量导入
matching <pattern>,包含确认步骤和可点击的位置。
7.12.0
- 通过仅向魔杖持有者、拥有者和管理员显示简易 NPC 魔杖轮廓,修复了 #833。 其他玩家不再看到这些轮廓,不可见的 NPC 对他们保持隐藏状态。
- 通过在位置配置中添加“设置此处为家”和“重置家”按钮,修复了 #834。
- 通过在导出的预设中保留 NPC ID 和位置,使导入能恢复相同的 NPC,修复了 #835。
- 修复了预设导入和生成蛋丢失拥有者列表条目和拥有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失其拥有者并变为无主状态的问题。
- 修复了选择列表仅显示前六个条目而隐藏其余条目的问题。
- 更改了导入预设的行为:改为在原存储位置更新原始 NPC,而不是添加副本;使用“作为新 NPC 导入”或预设物品来创建单独的 NPC。
- 更改了已完成交易的音效:现在播放“交易完成”声音,此前该声音一直静音。
- 更改了 API 对话框调用:报告未知的对话框标签,而非始终报告成功。
- 更改了没有手臂的 NPC 的行为:将手持物品显示在头部或身体上,而不是隐藏它们。
- 更改了可选依赖项 Easy Model Entities 的要求版本:需 2.4.0 或更高版本。
- 添加了“声音”配置,包含用于对话框、说话、游泳、进食和坠落伤害的声音。
- 在“声音”配置中添加了可搜索的声音选择器,并配有音量和音调滑块。
- 添加了“阻挡载具”选项,以防止 NPC 进入船、矿车和模组椅子。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型添加了新的内置皮肤。
- 添加了客户端设置:隐藏墙壁后的名字标签以及
highlightEnabled(用于魔杖轮廓)。 - 添加了“存在”条件操作,并开放了对 NPC 移动、动作和预设的 API 访问权限。
7.11.0
- 通过防止 NPC 跟随或注视玩家时登出导致服务器冻结,修复了 #828。
- 通过将常规的 NPC 移除消息移至调试日志,修复了 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了 #832。
- 修复了在大型世界中每小时 NPC 备份导致的卡顿,以及保留了已删除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、拥有者和位置的问题。
- 修复了拥有者登录恢复功能重复、反复恢复、复活或移动未加载 NPC 的问题。
- 修复了因 NPC 索引和文件同步问题导致的 NPC 丢失、崩溃或虚假警告。
- 修复了卸载后残留的 NPC 数据问题,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文字丢失且变得半透明的问题。
- 修复了在有光影包激活时忽略 NPC “不透明度”设置的问题。
- 修复了翻译后的对话气泡和模组 API 文本的文本格式化和宏解析问题。
- 修复了在有光影包激活时,对话气泡及其文字隐藏在方块后面的问题。
- 添加了
minLightLevel(最小光照等级),以保持黑暗环境中对话气泡的可读性。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了 #829。
- 修复了流浪商人 NPC 渲染时缺少纹理的问题。
- 修复了渲染为蝙蝠、青蛙或监守者的 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 格,超出该范围才进行传送。
- 更改了“移动到”和“移回住所”行为:若三秒内无进展则放弃。
- 更改了“移动到”动作的超时计算:改为计算真实刻数,此前运行时间过长(两倍)。
- 更改了新的“随机游泳”目标优先级:低于跟随、逃跑和攻击目标。
- 更改了带有 Easy Model Entities 模型的 NPC 的“不透明度”应用方式:由该模组本身应用。
- 更改了最低要求的 Easy Model Entities 版本:2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳层级添加了“水面以下深度”和“地板以上高度”滑块。
- 为世界保存时写入的 NPC 文件添加了日志条目,每项耗时超过 250 毫秒时发出警告。
7.8.1
- 修复了 #827,使水中的鱼类 NPC 保持直立而非始终侧躺。
- 修复了 #828,防止损坏的 NPC 阻止世界保存,现在它将回退到默认值。
- 修复了恢复的 NPC 拾取随机预设 ID 的问题,该 ID 每次保存时都会改变。
- 更改了 NPC 数据逻辑,仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已位于目标位置的 NPC 的行为,使其立即完成移动。
- 将“无”皮肤选项卡重命名为“高级”,其中包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”动作,可将 NPC 发送至指定位置、玩家、其所有者或家园。
- 添加了“移动并等待”动作,仅在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时时间和可选传送功能。
- 添加了范围为 0 到 100 的“不透明度”属性,用于混合淡化身体、护甲和手持物品。
- 添加了“设置不透明度”动作,可使 NPC 变成幽灵或完全隐藏。
- 添加了“灯笼幽魂”预设,一个在每个角落带有短线的方形路径行走的幽灵。
- 添加了对 NPC 移动动作和不透明度的 API 访问。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,在应用前预览输入纹理下的 NPC。
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_npc render texture命令,为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 添加了对 Easy Model NPC 动画变体、纹理槽位和纹理的 API 访问。
7.6.0
- 修复了重复实体数据追踪器 ID 导致的模组冲突错误提示不清晰的问题。
- 修复了在配置和对话界面中,第三方血条渲染在 NPC 预览之上的问题。
- 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非其模型大小的问题。
- 修复了在服务器上
/easy_npc命令完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段上的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺少提示文本的问题。
- 修复了长条件提示溢出编辑器屏幕而非自动换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐不当的问题。
- 修复了“设置姿势(Set Pose)”、“播放动画(Play Animation)”和“停止动画(Stop Animation)”动作的更改无法保存的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议逻辑:优先列出准星指向的 NPC,且仅显示没有权限的玩家拥有的 NPC。
- 更改了预设导出逻辑:仅存储与新建 NPC 不同的部分,不包含位置和拥有者信息。
- 更改了不含目标或动作的预设行为:回退到其 NPC 类型的默认值。
- 更改了无玩家参与的事件(如“生成时”或“击杀时”)的条件检查机制。此类事件中包含基于玩家的条件(例如计分板或物品检查)的动作将不再执行。
- 更改了基于时间的动作:当拥有者在附近时,将其作为
@initiator(发起者)。 - 更改了气泡显示时间:根据文本长度,气泡可见时间从 5 秒调整至最多 18 秒。
- 更改了“设置姿势(Set Pose)”动作:仅在“自定义(custom)”姿势条目时显示其输入字段。
- 新增了五个固定步长的基于时间的动作,频率从每约 1 秒到每约 15 分钟不等。
- 新增了“消息(Message)”动作,支持聊天、系统消息和气泡文本,无需命令即可触发。
- 为“消息(Message)”动作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包新增了气泡图形资源
easy_npc:textures/gui/speech_bubble.png。 - 新增了按百分比计算的“几率(Chance)”条件,以及用于拥有者和阵营的“关系(Relationship)”条件。
- 新增了生成、拥有者登录、状态变更、昼夜交替、天气变化以及缺失的“交易时(On Trade)”事件。
- 新增了每种 NPC 类型的基础预设(位于
easy_npc:api/preset/base/),可用作父级预设。 - 新增了“流浪同伴(Wandering Companion)”预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 为模组新增了动作注册表、动作处理器、预设验证器以及更丰富的数据事件。
- 为
/easy_npc命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能:无需输入即可显示,并允许准星偏离一个方块距离。
7.5.0
- 通过为每个 Cobblemon NPC 分配独立的动画状态(而非按物种共享),修复了 #814。
- 通过允许“返回家园”在任何距离生效(而不仅仅是在家园附近),修复了 #813。
- 通过在每次会话中检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包中的 Cobblemon 方面(aspects)而不仅仅是 “shiny” 和 “female”,修复了 #810。
- 修复了 NPC 的家位置始终显示为未设置的问题,这会导致在配置界面隐藏 “Home”、保存时跳过该选项,并导致 “Move back to Home” 和 “Stroll around Home” 失效。
- 修复了从预设、预设浏览器或重生机制生成的 NPC 从未获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出该预设的世界的家位置,而不是使用其生成位置的问题。
- 当 Easy NPC Wand 高亮显示 NPC 时,修复了在配置、皮肤和预设界面中 NPC 被绘制成带有阴影的白色剪影的问题。
- 修复了当具有 “Tempt” 目标的 NPC 更新其目标时服务器崩溃的问题。
- 修复了单个或 Boss 刷怪笼在没有存储任何 NPC 的预设时,生成数量无限制的问题。
- 修复了新创建的 NPC 也会显示 “Legacy Easy NPC Data” 警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度修正,导致图层伪影显现的问题。
- 修复了查找玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中 “Reset look at ...” 目标标签错误显示为 “Reset loot at ...” 的问题。
- 修复了导入预设后 “No Gravity” 属性被忽略,导致 NPC 掉落的问题。
- 修复了开发辅助模组导致 Fabric 游戏测试在启动时崩溃的问题。
- 修复了 NPC 在被驱逐后重新生成时丢失所有者身份的问题。
- 修复了在游戏启动时提供这些目标的模组缺失,导致 NPC 的目标被删除的问题。
- 修复了导入没有存储 ID 的预设,导致生成的 NPC 没有所有者和家位置的问题。
- 修复了更改所有者后,“Follow owner” 和 “Look at owner” 仍保持旧目标的问题。
- 修复了攻击目标在被追踪实体消失后仍分配给 NPC 的问题。
- 修复了 “Look at Item” 目标虽然可以保存但从不执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画问题。
- 修复了 Forge 从未运行其服务器启动步骤的问题,这导致整个会话期间 NPC 跟踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发环境启动时不包含任何 mixins 的问题,这禁用了原版实体调整,并在生成 Fox NPC 时导致崩溃。
- 将移动目标改为固定顺序:逃跑 (flee)、跟随 (follow)、回家 (return home),然后是漫步 (stroll)。因此,拥有多个移动目标的 NPC 行为可能与之前不同。
- 修改了将预设插入原版怪物刷怪笼的行为,以保留其延迟、数量和范围。
- 修改了未选择目标的 “Follow owner” 和 “Look at owner” 行为,使其跟随 NPC 的所有者。
- 将数据包预设文件夹更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 修改了预设浏览器,使其始终按相同顺序列出条目。
- 移除了实验性的用户定义 NPC;不再读取或创建额外的配置文件。
- 移除了未使用的
SERVER_SKIN皮肤类型。 - 添加了一个新的游戏测试结构,以支持 1.21.11 及更高版本的游戏测试。
- 在玩家皮肤屏幕的每个条目中添加了一个重新加载按钮,以便再次获取单个皮肤。
- 每当移除一个 NPC 时,在日志中添加原因,以便追踪意外的驱逐事件。
- 为
/easy_npc render set species命令添加了建议。 - 添加了对其他模组的预设的支持,这些预设不再必须使用
easy_npc命名空间。 - 添加了预设可见性功能,可将预设从预设浏览器和 NPC 界面中隐藏。
- 为跟随目标添加了传送距离和休息点偏移量。
- 为 “Follow item” 目标添加了物品标签、“can be scared” 选项和 “only without owner” 选项。
- 为注视目标添加了物品字段,使 NPC 可以注视选定的掉落物品。
- 为每个 NPC 添加了标识符,以便模组能够再次找到其自己的 NPC。
- 添加了当所有者登录时重新生成 NPC 的选项。
- 为 NeoForge 添加了游戏测试(此前没有),并恢复了在升级到 1.21.11 时被丢弃的刷怪蛋、对话界面、数据隔离和冒烟测试。
- 为每个配置和编辑界面添加了游戏测试,涵盖所有三种模组加载器。
- 为家位置添加了游戏测试,涵盖了生成默认值、存储值和重新加载情况。
- 改进了模型名称解析逻辑,此前会将以 “_shiny” 结尾的物种误判为变种。
- 改进了对飞行 NPC 的跟随逻辑,现在如果没有空中路径,它们会直接转向。
- 通过为预设、自定义目标和目标配置提供 API,改进了第三方支持。
7.4.0
- 修复了 #807:不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805:改为同时评估所有可见性设置,而不是在遇到第一个设置时就停止。
- 修复了 #804:为 Doppler NPC 保留自定义名称,以支持基于名称的纹理和命名牌。
- 修复了 #803:调整资源以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测问题,之前会将日出计为夜晚、日落计为白天。
- 修复了下界(Nether)和末地(End)中的可见性问题,之前错误地使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一次断言失败时才会报错的问题,这会导致后续的错误被隐藏。
- 修复了“已鞍装”马匹皮肤变体从未显示马鞍的问题。
- 更改了“仅对主人可见”和“仅对队伍可见”选项,使其也遵循昼夜和游戏模式设置。
- 更改了未启用“交叉双臂”的唤魔者(Evoker)、幻影(Illusioner)和卫道士(Vindicator)变体,使其手臂保持下垂状态。
- 添加了“保卫阵营”目标,用于攻击伤害附近阵营成员或玩家的对象。
- 当阵营成员互相战斗且阵营选择不介入时,添加了一条系统消息。
- 为灾厄村民(Illagers)添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置屏幕中添加了昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全缺失项,改进了来自旧版本的显示属性。
- 改进了攻击目标屏幕,当“保护主人”和“保卫阵营”未设置时禁用相关选项。
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:添加了新的
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 指定特定目标。 - 修复了 #786:为 Cobblemon NPC 添加了性别和闪光模型变体,可通过
female或shiny在模型选择中进行搜索。 - 通过添加新的
Attackable by Factions(可被阵营攻击)战斗属性,修复了无敌 NPC 之间的阵营战斗问题。 - 修复了超大物种的 Cobblemon 模型选择预览问题,改用 Cobblemon 自身的配置文件比例进行缩放,而不是基于碰撞箱高度。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存,而不是始终重建完整的自定义纹理缓存,修复了自定义皮肤重新加载问题。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)工作,每个属性为其各自的攻击者群体打开一个针对性的漏洞。 - 通过拆分大型处理器为更小的、专注于导入、导出和功能特定的组件,改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和阵营编辑器屏幕,用于创建、着色和删除阵营,并管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性选项卡,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636 和 #622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对来自其他模组的极端值限制属性滑块范围,修复了 #767。
- 通过为带有动作和条件的 NPC 添加自定义数据物品匹配功能,修复了 #754。
- 修复了纹理管理器在错误的线程中运行可能导致 >= 1.21.x 版本崩溃和死锁的问题。
- 修复了动作条件中处理空 UUID 的问题。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 金币、钥匙和红代币作为带有动作和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的金币、钥匙和红代币物品数据。 - 添加了对抗其他模组极端值的属性保护措施。
- 将高生命值 NPC 的回退最大生命值从 1024 增加到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基础刻期间及打开交易界面之前检查定时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含昼夜时间和天气条件。
6.23.0
- 通过将 isSunBurnTick 错误迁移到 26.x,修复了 #774。
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的 #770 物品渲染问题。
- 修复了 NPC 无法可靠地打开或关闭门的 #769 门循环问题。
- 通过添加对话选项和配置设置(buttonConditionMode: LOCK 或 HIDE),分别锁定或隐藏不可用的条件对话按钮,修复了 #760。
- 通过为名称提供包含 32 种颜色的颜色选择器弹出窗口以及手动 RGB/hex 值输入,修复了 #709。
- 修复了在未指定颜色时重命名导致 NPC 名称颜色被重置的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,当“开门”或“关门”处于活动状态时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以更好地兼容依赖特定玩家数据的第三方模组和插件,修复了 #766。
- 通过添加实体健康、NPC 健康条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)因第三方村民 AI 读取未注册的大脑记忆而导致的崩溃 #756。
- 修复了对话按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做准备。
- 通过添加条件对话打开支持/命令,以便更好地控制何时向玩家显示对话,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了大脑 AI,并注册了完整的基础版大脑记忆集。
- 为 #757 添加了更多的枪械标签。
- 添加了新的“打开对话(条件性)”动作,仅在满足条件时打开命名对话,而现有的“打开对话”动作保持无条件打开。
- 为动作、对话和对话按钮添加了新的实体健康和 NPC 健康条件。
- 为了与其他 NPC 保持一致,添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的不受伤害特性。
- 添加了新的“击退免疫”战斗属性,防止 NPC 受到近战或投射物攻击的击退效果。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免受爆炸伤害和位移影响(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移动到战斗属性屏幕,使其在主题上更合适(之前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的灾厄村民的物品附着问题。
- 修复了损坏的灾厄村民弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃 #756。
- 修复了与尝试访问不存在模型部分的第三方 Mixin 相关的崩溃 #756。
- 通过减少日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 垃圾邮件消息。
- 改进了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃。
6.19.0
注意:此更新将对话背景图像调整了 10x6 像素,如果您使用自定义背景,可能需要调整它们。
- 通过添加对话按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过为对话文本添加打字机效果支持,修复了 #683 和 #215。
- 通过允许对话、对话按钮和交互的条件判断,修复了 #690 和 #309。
- 修复了对话屏幕布局和背景的较小 UI 问题。
- 重构了对话背景图像,每侧调整了 10x6 像素。
- 重构了对话屏幕布局以更好地适应新的背景尺寸并改善外观。
- 为对话文本添加了打字机效果和客户端配置。
- 添加了条件符号以指示对话、按钮和交互的状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话条件和按钮状态相关的较小错误修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置/移除未存储 ID 的旧版执行限制条目。
- 通过为操作添加条件来修复 #745,以支持更复杂和动态的行为。
- 通过为较长文本添加对话框按钮提示框来修复 #652。
- 通过添加命令值提示框以显示完整值来修复 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏持有物品的条件。
- 添加了手持物品条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,允许对条件取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并替换为随机 UUID。 - 重构了条件系统以支持更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外提示框来修复 #738。
- 通过在启动期间和游戏内减少 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项来修复 #732。
- 通过在特定情况(如交易界面)下避免自动关闭来修复 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.1
- 通过扩展正确的基类来修复 #735。
- 修复了手动生成测试中发现的几个 26.1.2 特定问题。
6.15.0 (交易、玩家头颅、Epic Fight 和 QOL 更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能来修复 #730。
- 通过确保正确存储交易使用次数来修复 #729。
- 通过为玩家头颅添加自定义头颅支持来修复 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置来修复 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持来修复 #218 和 #132。
- 修复了在基本模式和普通/高级交易模式之间切换时的交易特定边缘情况。
- 通过显示完整文本的提示框来修复对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步来修复 Cobblemon 动画问题。
- 添加了针对每笔交易的特定操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕上添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例商人。
- 清理测试文件。
6.14.0
- 通过确保更改值时同步到客户端来修复 #727。
- 通过为特定命令添加额外白名单来修复 #726。
- 通过添加基本的 Cobblemon 支持(使用 Cobblemon NPC)来修复 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕来修复对话框错位和导航问题。
- 通过更正旋转逻辑和枢轴计算来修复 x 和 z 根旋转问题。
- 添加了基本的 Cobblemon 支持,包括用于测试的自定义 NPC 类型和模型。
6.13.0 (安全和权限更新)
备注:此更新包括更好的安全检查和多player环境中的权限控制。它允许执行服务器命令,如果被恶意使用,这些命令可能具有潜在危险性。
此更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离来修复 #725。
- 通过支持 .sbnt 文件作为本地预设来修复 #722。
- 通过为对话框和配置屏幕背景添加专用素材来修复 #675。
- 通过新的安全检查及权限系统来修复 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例来修复 #469、#311。
- 通过移除冗余的背景渲染来修复配置屏幕背景的双重渲染问题。
- 通过调整边界框来修复 Ghast 和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多 player 环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、定制性和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了与配置屏幕渲染和素材相关的常规代码清理和优化。
6.12.0
- 通过基于原版模型为自定义模型部件列表添加额外检查来修复 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息来减少日志冗长度,从而修复 #713。
- 通过减少过大尺寸的启动/配置日志输出来修复 #711。
- 修复 NBT 验证守卫,以防止在生产环境中进行不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加了模型部件名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构改进了 RenderEntityTypeSupportConfig,以提高性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析来修复 #710。
6.11.0
- 修复了 #703,解决了新的自定义图层系统与手部渲染之间的渲染问题。
- 修复了 #701,通过为无效的交易报价添加额外的安全措施和日志记录来解决。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端来修复头部追踪功能。
- 优化了
CustomLookAtPlayerGoal,以更好地处理边缘情况并减少抖动。 - 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 更新了标志设计。
6.10.0
- 修复了 #698,通过为第三方实体创建添加 try-catch 块来解决。
- 修复了 #695,在切换到
DEFAULT(原版)姿态时清除模型部件的旋转/位置。 - 修复了 #695,仅在 NPC 处于空闲状态时才应用锁定旋转和姿态动画。
- 修复了 #695,修正根旋转枢轴使用实际的边界框高度而非 0.5f。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺失的玩家目标刷新,以及对离线目标的重试机制。 - 修复了目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转的功能;现在由用户控制根锁定。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 添加了
NPCDataIsolationTestHelper以及适用于 Fabric 和 Forge 的游戏测试。 - 将最大头部偏航角范围从 60° 增加到 65°。
6.9.0
- 修复了 #692 和 #666,通过添加缓存和安全措施来防止冗余地重新触发 NPC 实体数据更新。
- 修复了 #651 和 #617,为所有支持的 NPC 类型添加了基本的自定义姿态。
- 修复了 #597,添加了针对逃离玩家、村民、怪物等的额外逃跑目标。
- 修复了姿态加载方式,改为直接从模组资源读取而不是复制文件到磁盘。
- 修复了实体加入时重复调用
saveNPC的问题,通过首先检查现有注册表条目来解决。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于从外部模组控制 NPC 姿态和管理 NPC。 - 添加了所有支持 NPC 类型的姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行回调动作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引中。
- 将 EasyNPCItemAttachmentLayer 添加到各种实体渲染器中。
- 添加了专用的
Flee Objective(逃离目标)配置标签页,包含针对逃离苦力怕、怪物、生物、玩家、村民和太阳的目标。 - 在跟随目标标签页中添加了
FOLLOW_ITEM目标,使 NPC 能够根据资源位置(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看主人的目标。 - 向
SynchedDataIndex添加了persistent标志,使得临时索引(如弩充能、模型动画)不再触发脏保存标记。 - 向
SlimeBase添加了可配置的customParticlesEnabled标志,供 API 使用者使用。 - 添加了
SoundType.PET,并将CAT_PURR映射到驯服的猫 NPC,以增加环境声音的多样性。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 修复了 #680,通过升级网络协议版本强制执行版本不匹配警告。
- 修复了 #679,重置了名称标签的位置、旋转和大小。
- 修复了 #665,为根旋转添加了多状态滑动功能。
- 修复了 #664,添加了禁用跟随鼠标光标选项,以便于姿态调整。
- 修复了 #663,改进对 X 和 Z 根旋转的支持。
- 修复了 #661,添加了快速旋转功能:使用 NPC 魔杖并潜行靠近 NPC 可将根旋转至面向玩家。
- 修复了移动工具错误触发交互的问题,通过在交互处理器中添加移动工具检查来解决。
- 修复了预设物品错误触发交互的问题,通过在交互处理器中添加预设物品检查来解决。
- 修复了史莱姆和恶魂的碰撞箱及名称标签位置问题,通过调整边界框和眼睛高度计算来解决。
- 修复了史莱姆和恶魂的 GUI 位置问题,通过调整偏移值来解决。
6.8.2
- 修复了 #677,通过扩展
SafeMerchantData并添加 notifyTrade 来避免崩溃。 - 添加了基于玩家互动和行为的 NPC 升级进度数据支持。
- 添加了全局 NPC 追踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原模型中使用变体纹理。
6.8.1
- 修复了 #676,使用现有的预设辅助方法替代自定义方法。
6.8.0 (添加 API 支持)
- 修复了 #667,通过为无效网络数据包添加警告消息和额外检查来解决。
- 修复了马刷新蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和幻翼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便与其他模组和自定义模型更容易集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进空间。
6.7.1
- 修复了 #657 和 #656,通过添加额外的客户端检查来处理原版漏洞。
6.7.0
- 通过实现
setupAnim方法中的狼腿动画修复了 #650。 - 通过修复
canBeHitByProjectiles(可被投射物击中)的翻译修复了 #648。 - 通过添加
allowBypassInvulnerability(允许绕过无敌)配置选项,允许/禁止 NPC 绕过无敌状态,修复了 #645。 - 修复了删除按钮在宽度较小时仍显示标签的问题。
- 修复了在某些情况下上下按钮定位不正确的问题。
- 修复了对话框和配置 UI 中显示名称标签的问题。
- 修复了距离动作问题,该问题导致多个动作无法正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据不同步的问题。
- 添加了预设浏览器,以便更轻松地选择常用 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了刷怪笼系统以使用新的预设格式,以提高可维护性和未来改进空间。
6.6.2
- 通过重写缩放系统修复了 #643。
- 修复了重启/重载后缩放未正确更新命中盒和名称标签位置的问题。
- 添加了 MID(中间)和 MOUSE_OVER(鼠标悬停)名称标签可见性模式,以更精细地控制 NPC 名称显示。
- 添加了基于团队的名称标签可见性支持,尊重原版团队设置。
6.6.1
- 通过重构显示属性的内部数据处理修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止对同一纹理进行多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载期间的
defineId called for:警告消息。 - 使用多级防御和速率限制重构了纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 的线程安全会话服务器防垃圾邮件保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,使用 2 线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过为 Gradle 依赖项添加缓存改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL(击杀)动作类型和事件修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用修复了 #629。
- 修复了击杀命令对 NPC 无效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重载的问题。
- 修复了远程图像验证器中的 WebP 验证错误(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了鸡、猪和狼缺失的变体纹理。
- 添加了针对纹理处理的额外单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar(Jar 内打包)捆绑方式,以提高模组兼容性和 API 能力。
- 通过改进剪刀实现修复了 #627,以更好地与其他模组兼容。
- 通过修复旋转或移动模型部件时的生动动画问题修复了 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 针对不同 NPC UUID 修复了屏幕切换逻辑,感谢
Spawnblade进行的详细调查和修复建议。
6.4.0
- 通过改进对话框数据验证和错误处理修复了 #626。
- 通过重构渲染数据和渲染处理修复了 #623。
- 通过确保自定义数据正确保存和加载修复了 #622。
- 修复了打开对话框动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺少的 equals 和 hashCode 方法修复了哈希问题。
- 添加了 #622 的自定义数据测试物品,便于测试自定义数据。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了配置 UI 特定组件并将其从核心模组中移除。
- 通过在发送到客户端之前过滤对话框数据修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了部分对话框数据字段缺少默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框记分板动作添加了条件支持。
- 添加了对话框频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段改进了对话框按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的翻译缺失问题。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,以便在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了自旋按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了屏幕过渡期间鼠标光标跳动的问题。
- 修复了翻译文件,并删除了重复及已弃用的条目。
- 将 Easy NPC 魔杖移至现有的核心物品标签页,而非新建一个标签页。
- 增加了对不同模型部件(尾巴除外)的猫姿势支持。
- 通过在不必要时禁用发光效果,提升了 EasyNPCWand 发光效果的渲染性能。
- 改进了自定义实体检测,排除了如显示实体、制造器、投掷物和刷怪笼等非生物实体。
- 改进了猫变体处理逻辑。
6.1.1
- 通过检查物品是否装备在某只手中来修复 #615。
- 通过重新验证实体类型来修复 #612。
- 通过强制同步特定模型的帽子和头部图层来修复 #610。
- 修复了兽人纹理问题。
- 修复了 1.21.5 版本中的猫变体处理逻辑。
- 通过调整渲染状态
skin字段来修复玩家渲染问题。 - 通过调整渲染状态
texture字段来修复猫渲染器问题。 - 修复了位置、缩放和旋转预览功能。
- 修复了精灵(Fairy)模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型的支持与性能。
- 改进了玩家皮肤的玩家到 UUID 映射缓存机制。
- 将更改模型命令和逻辑限制为仅适用于 Doppler NPCs。
- 添加了
renderEntityRaw方法以原样渲染 NPC。
6.1.0 ✨
这是一个主要版本。请在更新前备份您的世界和 NPC 数据。此版本包含许多改进、优化和内部变更,与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要手动调整。
- 内部数据格式和部分行为已重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级运行时和逻辑模块,依赖极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可安装在需要该界面的客户端上。
🎯 为何做出此变更?
- 允许服务器和整合包仅在服务器端部署 Core 模组,从而构建更精简的环境。
- 当不需要 UI 时,可减少内存占用并缩短加载时间。
- 通过分离 UI 和核心逻辑,使开发和测试更加高效。
Easy NPC: Core (26.2) 更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请前往 GitHub 历史记录。
注意:在更新至新版本之前,请务必备份你的世界/NPC! 有关更多信息,请参阅 升级指南。
7.20.0
- 修复了缺少皮肤 ID 的 NPC 导致的崩溃,感谢
voidsipp在 #866 中的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了人形 NPC 在使用“无”或资源定位符皮肤时显示史蒂夫皮肤的问题。
- 修复了“默认皮肤”在 Forge 和其他使用 NPC 名称标签设置的生物上显示相同 NPC 的问题。
- 修复了当其他模组中断其释放过程时,玩家肩膀上的 NPC 丢失的问题。
- 修复了 NPC 通过闪电、溺水、冻结或僵尸攻击变成原版生物的问题。
- 修复了生成的 NPC 随机获得幼体、骑乘者、装备或效果,并丢失其预设装备的问题。
- 修复了未启用“拾取物品”的 NPC(如村民、猪灵和狐狸)拾取物品的问题。
- 修复了骷髅 NPC 除了配置的 attacks 外,还使用原版弓和近战攻击的问题。
- 修复了末影人 NPC 的水伤害和传送问题,以及史莱姆 NPC 分裂和接触伤害的问题。
- 修复了狐狸 NPC 食用手持食物、鸡 NPC 下蛋和猫 NPC 丢失原版姿势的问题。
- 修复了闪电充能苦力怕 NPC 以及反射火球瞬间杀死恶魂 NPC 的问题。
- 改进了敌对生物搜索攻击 NPC 时的服务器性能。
7.19.0
- 通过保持一个 NPC 的隐藏皮肤层不在同类型其他 NPC 上隐藏它们,修复了 #865。
- 修复了类僵尸和末影人 NPC 的自定义姿势被其手臂动画覆盖的问题。
- 修复了在使用“DEFAULT”或“NONE”动画行走时,隐藏的身体部位再次显示的问题。
- 修复了“锁定身体”标签在旋转屏幕外运行的问题。
- 修复了投射物“物品 ID”字段隐藏物品 ID 开头的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在每个游戏启动后改变顺序的问题。
7.18.0
- 通过防止 NPC 在与 LetMeDespawn 等模组加载时丢失,修复了 #862。
- 修复了具有近战和远程攻击的 NPC 在持有弓、弩或枪时不射击的问题。
- 修复了 NPC 在目标之间旋转以及史莱姆 NPC 在攻击时向错误方向跳跃的问题。
- 修复了传送离开或切换维度后Boss条仍停留在屏幕上的问题。
- 修复了在 Creative 模式下对 NPC 使用选择方块功能不掉落其生成卵的问题。
- 修复了“计分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 金色重型弩,并添加了皮革和铜制版本。
- 修复了皮肤屏幕上重叠的提示、复选框工具提示以及缺失的错误和日志垃圾信息。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而不是config/easy_npc/skin的问题。 - 修复了许多德语翻译、英语 Bogged 名称以及原始的“主手”/“副手”键名。
- 更改了生存模式生成 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
- 通过支持 AttributeFix 等模组设置的更高属性上限,修复了 #858。 需要服务器和客户端均安装 AttributeFix 或类似模组;护甲值上限为 100。
- 通过在没有更改时不再重写 NPC 文件,修复了 #857。
- 当一个条件的不满足时尝试下一个“打开对话框(条件)”,修复了 #854。
- 修复了动作和对话框上的“几率”条件被掷骰两次,从而降低几率的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或拴绳的 NPC 出现在肩膀上,以及断开连接时的肩膀渲染泄漏问题。
- 修复了隐藏头部保留其帽子层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受影响;设置为 7 可保持旧外观。
- 更改了“关闭对话框”和“回退”动作,使其在没有打开条件对话框时运行。
- 更改了具有传送距离的“跟随主人”NPC,使其跟随主人进入其他维度。
- 更改了服务器停止行为,等待最多 2 分钟以完成仍在写入的 NPC 文件。
- 更改了空闲 NPC 对附近玩家、坠落或压力板的反应延迟至多 0.5 秒。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令及storage.cfg保存设置。 - 改进了 NPC 保存、备份、
/easy_npc list、肩膀同步和空闲 NPC 的性能。
7.16.0
- 修复了 #432:不再重复运行目标,或在多次设置后移除时仍继续运行。
- 修复了 #852:使长矛能够击中可攻击的 NPC。
- 修复了当玩家无法从肩膀卸下 NPC 时,NPC 迷路的问题。
- 修复了“坐在肩上”模式的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自插件的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成存储的 NPC 时因维度无效而失败的问题。
- 修复了近战 NPC 忽略“攻击速度”并始终每秒攻击一次的问题。
- 修复了世界和服务器预设导出无限制的问题,改为每分钟允许 10 次,详见
security.cfg。 - 更改:自 7.15.0 版本起,被击杀的 NPC 需要
force参数或新的复活 API 才能再次生成。 - 更改:内置目标现在保留由插件设置的优先级,而非使用默认值。
- 更改:铁傀儡的“攻击速度”默认值改为 1.0;现有的铁傀儡保持 4.0 并更快攻击。
- 更改:“坐在肩上”功能从“能力”属性标签页移至“杂项”属性标签页。
- 更改:可选依赖项 Easy Model Entities 要求版本 2.6.0 或更高。
- 新增:用于复活的 API,以及在从肩膀下马时的重新上马冷却时间。
- 新增:“坐在肩上”模式为插件和命令添加了距离、冷却时间和战斗设置。
- 新增:
/easy_npc revive、/easy_npc shoulder和objective … priority命令。 - 新增:每个 NPC 的肩膀偏移量,可在“杂项”标签页中设置或使用
/easy_npc shoulder offset命令设置。 - 更新:测试通过的 NeoForge 版本至 26.2.0.93,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,预设导入保持静默。 - 修复了 #380:将 NPC 数量限制同样应用于默认生成器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左撇子 NPC。
- 修复了 #851:对话按钮按单个对话锁定,而非跨具有相同标签的不同对话锁定。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少 Epic Fight 生物补丁的问题。
- 修复了非居中库存屏幕及其关闭按钮与“自定义”交易标签页重叠的问题。
- 修复了缩放后的 Doppler NPC 保留了被模仿实体的完整碰撞箱的问题。
- 修复了位于玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改:要求客户端和服务端运行相同的模组版本,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。 - 新增:使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 核心重构和代码清理工作更大规模进行。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名字标签和对话框悬浮在其身体内的问题。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和观察落空的问题。
- 修复了在网络数据包中读取过大的名称、列表和 NPC 数据时无任何限制的问题。
- 修复了应用无效的 NPC 位置、缩放比例、属性、名称和持续时间的问题。
- 更改:精灵(Fairy)NPC 占用其模型的空间,使其产生碰撞并可被点击。
- 更改:骷髅(Skeleton)、流浪者(Stray)和沼骸(Bogged)NPC 改为原版碰撞箱高度,此前它们略矮。
- 更改:网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告关于替换的 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载,导致泄露 NPC 并清除选择的问题。
- 修复了选择框下拉列表被其后方的复选框和标签覆盖的问题。
- 修复了在小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了不带位置参数的
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”将 NPC 堆叠在同一位置的问题。
- 更改:“恢复”在未获许可时拒绝操作,而不是生成副本。
- 新增:预设和皮肤的排序、匹配计数、重新加载、自动关闭、NPC ID 及提示框。
- 新增:带有限制、确认提示和可点击位置的
matching <pattern>批量导入。
7.12.0
- 通过仅向魔杖持有者、所有者和管理员显示简易 NPC 魔杖轮廓,修复了 #833。 其他玩家不再看到这些轮廓,不可见的 NPC 对他们保持隐藏状态。
- 通过在位置配置中添加“设置此处为家”和“重置家”按钮,修复了 #834。
- 通过在导出的预设中保留 NPC ID 和位置,使导入时能恢复相同的 NPC,从而修复了 #835。
- 修复了预设导入和刷怪蛋丢失所有者列表条目及所有者目标的问题。
- 修复了从自动备份还原的 NPC 丢失其所有者并变为无主状态的问题。
- 修复了选择列表仅显示前六项条目而隐藏其余条目的问题。
- 更改了导入预设的行为:改为在原位更新原始 NPC,而不是添加副本;请使用“作为新 NPC 导入”或预设物品来创建单独的 NPC。
- 更改了已完成交易的音效:播放“交易完成”声音(此前该声音一直静音)。
- 更改了 API 对话框调用:报告未知的对话框标签,而不是一直报告成功。
- 更改了没有手臂的 NPC 的物品携带方式:将手持物品显示在头部或身体上,而不是隐藏它们。
- 更改了对可选依赖项 Easy Model Entities 的版本要求:需要 2.4.0 或更高版本。
- 添加了“声音”配置,包含用于对话、说话、游泳、进食和坠落伤害的声音。
- 在“声音”配置中添加了可搜索的声音选择功能,并配有音量和音调滑块。
- 添加了“阻挡载具”选项,以防止 NPC 进入船、矿车及模组添加的椅子。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型添加了新的内置皮肤。
- 添加了客户端设置,用于在墙壁后方隐藏名称标签以及控制魔杖轮廓的
highlightEnabled设置。 - 添加了“存在 (Exists)”条件操作,并通过 API 提供对 NPC 移动、动作和预设的访问权限。
7.11.0
- 通过当 NPC 跟随或注视玩家时不再在登出时导致服务器冻结,修复了 #828。
- 通过将常规的 NPC 移除消息移至调试日志,修复了 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了 #832。
- 修复了在大型世界中每小时进行的 NPC 备份导致的卡顿问题,以及保留了已移除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、所有者和位置的问题。
- 修复了所有者登录恢复功能重复、反复恢复、复活或移动未加载 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据问题,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文本丢失并变得半透明的问题。
- 修复了在有光影包激活时忽略 NPC “不透明度”设置的问题。
- 修复了翻译后的气泡和模组 API 文本的文本格式化和宏解析问题。
- 修复了在有光影包激活时气泡及其文本被方块遮挡而无法显示的问题。
- 添加了
minLightLevel设置,以保持黑暗环境下的气泡可读性。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了 #829。
- 修复了流浪商人 NPC 渲染时缺少纹理的问题。
- 修复了渲染为蝙蝠、青蛙或监守者的 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 格,超出此范围才进行传送。
- 更改了“移动到”和“返回家中”动作:如果在三秒内没有进展则放弃。
- 更改了“移动到”动作的超时机制:现在计算真实刻数,此前运行时间过长。
- 更改了新的“随机游泳”目标:使其优先级低于跟随、逃跑和攻击目标。
- 更改了拥有 Easy Model Entities 模型的 NPC 的“不透明度”应用方式:由该模组本身处理。
- 更改了 Easy Model Entities 的最低版本要求至 2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳层级添加了“水面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,若每项耗时超过 250 毫秒则发出警告。
7.8.1
- 通过让水中的鱼形 NPC 直立显示而非始终侧躺,修复了 #827。
- 通过防止受损的 NPC 阻止世界保存(使其回退到默认值),修复了 #828。
- 修复了恢复的 NPC 拾取随机预设 ID 并在每次保存时发生变化的问题。
- 更改为仅在 NPC 数据实际发生变化时才将其写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改逻辑:当 NPC 已站在目标位置时,立即完成移动。
- 将“None”(无)皮肤选项卡更名为“Advanced”(高级),其中现在包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”(Move to)动作,可将 NPC 发送至指定位置、玩家、其所有者或其家园。
- 添加了“移动并等待”(Move to and Wait)动作,该动作会在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时机制以及可选的传送功能。
- 添加了范围为 0 到 100 的“不透明度”(Opacity)属性,使身体、盔甲和手持物品逐渐融合淡化。
- 添加了“设置不透明度”(Set Opacity)动作,可将 NPC 变为幽灵或完全隐藏。
- 添加了“灯笼幽灵”(Lantern Wraith)预设,这是一个在正方形路径上行走的幽灵,在每个角落都会留下一条短线。
- 开放了针对移动动作和 NPC 不透明度的 API 访问权限。
- 添加了“资源位置”(Resource Location)皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”(Advanced)皮肤选项卡,可在应用前预览输入纹理下的 NPC 效果。
7.7.7
- 通过保留 64x64 皮肤的透明度(Fresh Moves 需要用于眼睛部分),修复了 #821。此前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
- 通过让村民和流浪商人类型的 NPC 也执行交易动作,修复了 #818。
- 修复了具有多个文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后图像而非原始下载图像的问题。
- 修复了未翻译的执行限制条件中的间隔名称(如
PER_DAY)。 - 修复了 Easy Model NPC 的
sit(坐下)动画,该动画从未使用内置的坐姿姿态。 - 修复了当玩家靠近时,NPC 头部遮挡对话气泡的问题。
- 更改对话气泡行为:保持屏幕尺寸不变,并在玩家靠近时向下或向侧面移动。
- 更改对话气泡文本渲染大小,比名牌大 20%。
- 更改基于时间的动作序列(配合“等待”动作)改为按顺序执行,而非随机选择一个条目。
- 更改对话框文本换行逻辑,使其更晚换行,以便现有对话框可以切换到更宽的屏幕布局。
- 更改回退动作逻辑:像常规动作一样,跳过没有玩家参与的屏幕动作。
- 将 Easy Model Entities 的最低版本要求提升至 2.1.0,旧版本将禁用集成。
- 添加了“等待”(Wait)动作,暂停事件后续动作指定的时长。
- 添加了“倒计时计时员”(Countdown Timekeeper)预设,显示从一到十的计数气泡,最后以声音和火花结束。
- 为 Doppler NPC 添加了缩放和旋转功能(位于“实验性功能”复选框后)。这两项仅影响可见模型(不接受此功能的实体不受影响),且从不影响碰撞箱。
- 添加了“声音”(Sound)动作,可在 NPC 处播放指定类别、音量和音高的声音。
- 在执行限制条件中添加了“每 5 分钟”和“每 15 分钟”。
- 添加了“玩家闲置”(Player Idle)条件,检查玩家停止移动的时间长度。
- 添加了“不可移动”(Immovable)属性,使 NPC 抵抗推力和击退。
- 添加了
/easy_npc pause命令,用于暂停单个 NPC 或所有 NPC;全局暂停随服务器关闭而结束。 - 开放了针对声音动作、暂停状态和玩家闲置时间的 API 访问权限。
- 通过
/easy_npc render texture命令,为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”(Play Animation)动作添加了带有计数和时间限制的“重复”(Repeat)播放模式。
- 开放了针对 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。 - 添加了百分比形式的“几率”条件和针对所有者及阵营的“关系”条件。
- 添加了生成、所有者登录、状态变更、昼夜交替、天气以及缺失的“交易时”事件。
- 在每个 NPC 类型下的
easy_npc:api/preset/base/添加了基础预设,可用作父预设。 - 添加了“流浪同伴”预设,这是一个由基于时间的消息构建的健谈 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器和更丰富的EventData。
- 为
/easy_npc命令的所有 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议,现在无需输入即可出现,并容忍一个方块内的接近匹配。
7.5.0
- 修复了 #814:为每个 Cobblemon NPC 提供独立的动画状态,而非按物种共享。
- 修复了 #813:“移动回主页”功能现在可在任意距离生效,而不仅限于靠近其主页时。
- 修复了 #812:每个会话仅检查一次玩家是否更改了皮肤。
- 修复了 #810:接受资源包中的 Cobblemon 方面(aspects),而不仅限于“shiny”和“female”。
- 修复了 NPC 的主页位置始终显示为未设置的问题,这会导致配置界面中隐藏“主页”选项、保存时跳过该选项,并使“移动回主页”和“在主页附近闲逛”功能失效。
- 修复了通过预设、预设浏览器或重生生成的 NPC 从未获得主页位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出预设的世界的主页位置,而非使用其生成位置的问题。
- 当 Easy NPC Wand 高亮显示 NPC 时,修复了在配置、皮肤和预设屏幕中 NPC 被渲染为带有阴影的白色剪影的问题。
- 修复了当具有“诱惑(Tempt)”目标的 NPC 更新其目标时导致服务器崩溃的问题。
- 修复了单个或首领刷怪笼在预设未存储任何 NPC 时无限生成怪物而不受限制的问题。
- 修复了新建 NPC 时出现“旧版 Easy NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度修正,导致图层伪影显示的问题。
- 修复了查询玩家名称期间玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中“重置注视 ...”目标标签误显示为“重置战利品 ...”的问题。
- 修复了导入预设后“无重力”属性被忽略,导致 NPC 掉落的问题。
- 修复了由于开发辅助模组导致 Fabric 游戏测试启动时崩溃的问题。
- 修复了 NPC 在被重新生成(先消失后再生成)后失去其所有者归属的问题。
- 修复了当提供特定目标的模组在启动时缺失,导致目标从 NPC 上被删除的问题。
- 修复了导入未存储 ID 的预设时,生成的 NPC 没有所有者和主页的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保持旧目标的问题。
- 修复了攻击目标在被盯上的实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标虽可存储但从未执行任何操作的问题。
- 修复了 Doppler NPC 及第三方模型的行走动画问题。
- 修复了 Forge 从不运行其服务器启动步骤,导致整个会话期间 NPC 追踪、派系和自定义标识符索引为空的问题。
- 修复了 Forge 开发环境启动时不包含任何 Mixin,导致原版实体调整失效并在生成 Fox 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 风格。
- 修复昼夜检测逻辑,此前会将日出计为夜晚、日落计为白天。
- 修复下界和末地的可见性逻辑,此前错误地使用了主世界的时间。
- 修复时间模式和游戏模式可见性复选框出现顺序随机的问题。
- 修复游戏测试仅在首个断言失败时才会报错的问题,这会导致后续的错误被隐藏。
- 修复“骑乘”马匹皮肤变体无法显示马鞍的问题。
- 更改“仅主人可见”和“仅队伍可见”设置,使其也遵循昼夜和游戏模式规则。
- 更改唤魔者、幻术师和卫道士变体(无“交叉双臂”姿态)的手臂保持下垂状态。
- 新增“保卫阵营”目标,攻击伤害附近阵营成员或玩家的实体。
- 当阵营成员互相战斗且阵营不介入时,添加系统消息提示。
- 为灾厄村民添加头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置界面中添加了昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升了可见性检查的性能。
- 通过用默认值补全缺失项,完善了旧版本中的显示属性。
- 改进了攻击目标界面,在未设置时禁用“保护主人”和“保卫阵营”选项。
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:新增
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 指定特定目标。 - 修复 #786:为 Cobblemon NPC 添加性别和闪光模型变体,可在模型选择中通过
female或shiny进行搜索。 - 修复无敌 NPC 之间的阵营战斗问题,通过新增
Attackable by Factions(可被阵营攻击)战斗属性实现。 - 修复大型物种的 Cobblemon 模型选择预览,改为使用 Cobblemon 自身的配置文件比例进行缩放,而不是使用碰撞箱高度。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边界情况。
- 修复自定义皮肤重载问题,改为按皮肤模型加载和清除纹理缓存,而不是始终重建完整的自定义纹理缓存。
- 改进
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)生效,为各自的攻击者群体开辟独立的攻击漏洞。 - 通过拆分大型处理器为更小的导入、导出和功能专用组件,改进了预设命令和网络处理。
- 新增 Easy Model Entities 支持。
- 新增阵营管理器和管理员编辑界面,用于创建、着色和删除阵营并管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 新增
Misc(杂项)属性选项卡,作为 NPC 阵营分配的主页。 - 新增可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636、#622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对来自其他模组的极端值限制属性滑块,修复了 #767。
- 通过为具有动作和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了纹理管理器在错误线程运行可能导致 >= 1.21.x 版本崩溃和死锁的问题。
- 修复了动作条件中处理空 UUID 的问题。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 硬币、钥匙和红代币作为具有动作和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红代币物品数据。 - 添加了对来自其他模组的极端值的属性保护机制。
- 将高生命值 NPC 的回退最大生命值从 1024 增加到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与不可见 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基本刻内检查定时交易重置以及在打开交易屏幕之前进行检查,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含昼夜时间和天气条件。
6.23.0
- 通过将 isSunBurnTick 错误迁移到 26.x,修复了 #774。
- 通过调整针对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 #770 中 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的物品渲染问题。
- 修复了 #769 中 NPC 无法可靠地打开或关闭门的门循环问题。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE),以锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的颜色选择器弹出窗口以及手动 RGB/十六进制值,修复了 #709。
- 修复了在未指定颜色时重命名会重置 NPC 名称颜色的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,当“开门”或“关门”激活时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以提高对依赖特定玩家数据的第三方模组和插件的兼容性,修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话框按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)上第三方村民 AI 读取未注册的脑记忆导致的崩溃问题 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做的准备。
- 通过添加条件对话框打开支持/命令,以便更好地控制何时向玩家显示对话框,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 添加了枪标签中的额外枪支。
- 添加了新的“打开对话框(条件)”动作,仅在满足其条件时打开命名的对话框,而现有的“打开对话框”动作则无条件打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
- 添加了 Piglin、Piglin Brute 和僵尸猪灵 NPC 的不受伤害能力,以与其他 NPC 保持一致。
- 添加了新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免受爆炸伤害和位移影响(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的劫掠者物品附着问题。
- 修复了损坏的劫掠者弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在的模型部件的第三方 Mixin 相关的崩溃问题 #756。
- 通过降低日志详细程度并为自定义模型部件添加额外检查,修复了 log.info 刷屏消息。
- 提高了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃问题。
6.19.0
注意:此更新调整了对话框背景图像的大小(每边 10x6 像素),如果您使用的是自定义背景,可能需要调整它们。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过为对话框文本添加打字机效果支持,修复了 #683 和 #215。
- 通过允许对话框、对话框按钮和交互的条件,修复了 #690 和 #309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 重构了对话框背景图像,每边调整 10x6 像素。
- 重构了对话框屏幕布局以更好地适应新的背景尺寸并改善外观。
- 为对话框文本添加了打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话框条件和按钮状态相关的较小 bug 修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或移除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件来修复 #745,以支持更复杂和动态的行为。
- 通过为对话框按钮添加长文本的工具提示来修复 #652。
- 通过为命令值添加工具提示以显示完整值来修复 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了库存中有物品的条件。
- 添加了手持物品条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以便对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的工具提示来修复 #738。
- 通过减少启动期间和游戏内的 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项来修复 #732。
- 通过在特定情况下(如交易界面)避免自动关闭来修复 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框的头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.1
- 通过扩展正确的基类来修复 #735。
- 修复了手动生成测试中出现的几个 26.1.2 版本特有的问题。
6.15.0 (交易、玩家头颅、史诗战斗和质量改进更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能来修复 #730。
- 通过确保正确存储交易使用次数来修复 #729。
- 通过为玩家头颅添加自定义头颅支持来修复 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置来修复 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持来修复 #218 和 #132。
- 在基本模式和普通/高级交易模式之间切换时,修复了特定于交易的边缘情况。
- 通过添加工具提示显示完整文本来修复对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步来修复 Cobblemon 动画问题。
- 添加了每个交易特定的操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕中添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例商人。
- 清理测试文件。
6.14.0
- 通过确保更改值时同步到客户端来修复 #727。
- 通过为特定命令添加额外的白名单来修复 #726。
- 通过添加带有 Cobblemon NPC 的基本 Cobblemon 支持来修复 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕来修复对话框错位和导航问题。
- 通过更正旋转逻辑和枢轴计算来修复 x 和 z 轴的根旋转问题。
- 添加了带有自定义 NPC 类型和模型的基本 Cobblemon 支持用于测试。
6.13.0 (安全和权限更新)
注意:此更新包括针对多人游戏环境的更好的安全检查及权限控制。它允许执行服务器命令,如果被恶意使用,这些命令可能具有潜在危险性。
此更新将模型根节点的数据和逻辑从其余模型部件的数据和逻辑中分离出来,这意味着现有 NPC 的根节点旋转和缩放可能会被重置为默认值。
- 通过将模型根节点的数据和逻辑从其余模型部件的数据和逻辑中分离出来来修复 #725。
- 通过支持 .sbnt 文件作为本地预设来修复 #722。
- 通过为对话框和配置屏幕背景添加专用资产来修复 #675。
- 通过新的安全检查及权限系统来修复 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例来修复 #469、#311。
- 通过移除冗余的背景渲染来修复配置屏幕背景的双重渲染问题。
- 通过调整边界框来修复 Ghast 和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多人游戏环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义支持和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 移除了重复的精灵图集。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了与配置屏幕渲染及资产相关的常规代码清理和优化。
6.12.0
- 通过基于原版模型添加针对自定义模型部件列表的额外检查来修复 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息来减少日志详细程度,从而修复 #713。
- 通过减少过大的启动/配置日志输出来修复 #711。
- 修复了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 向 EasyNPCModelManager 添加了模型部件名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构改进了 RenderEntityTypeSupportConfig,以提升性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改善可恢复交易数据的向后兼容解析来修复 #710。
6.11.0
- 修复了 #703,解决新自定义图层系统和手部渲染的渲染问题。
- 修复了 #701,通过为无效的交易报价添加额外保护和安全措施以及日志记录来解决。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端来修复头部追踪功能。
- 优化
CustomLookAtPlayerGoal以更好地处理边缘情况并减少抖动。 - 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 使用新设计更新了标志。
6.10.0
- 修复了 #698,通过为第三方实体创建添加 try-catch 处理来解决。
- 修复了 #695,在切换到
DEFAULT原版姿态时清除模型部分的旋转/位置。 - 修复了 #695,仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画。
- 修复了 #695,修正根旋转枢轴,使其使用实际的边界框高度而不是 0.5f。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中错误的 UUID、加入/离开时缺少针对玩家的刷新以及对离线目标的重试。 - 修复了目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转的功能;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了“锁定旋转”复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 添加了
NPCDataIsolationTestHelper以及 Fabric 和 Forge 的游戏测试。 - 将最大头部偏航角范围从 60° 增加到 65°。
6.9.0
- 修复了 #692、#666,通过添加缓存和保护措施来防止冗余地重新触发 NPC 实体数据更新。
- 修复了 #651、#617,为所有支持的 NPC 类型添加了基本自定义姿态。
- 修复了 #597,通过添加额外的逃跑目标来实现逃离玩家、村民、怪物等。
- 修复了姿态加载方式,改为直接从模组资源读取,而不是将文件复制到磁盘。
- 通过在加入时先检查现有注册表条目,修复了实体加入时重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除并重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于控制 NPC 姿态并从外部模组中以编程方式管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了“锁定旋转”复选框。
- 添加了
MoveToPositionGoal,用于在执行为回调操作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl,以尊重锁定的根旋转。 - 在 NPC 实体数据索引中添加了同步的所有者更改和维度更改。
- 在各种实体渲染器中添加了 EasyNPCItemAttachmentLayer。
- 添加了专用的“Flee Objective(逃离目标)”配置选项卡,包含逃离苦力怕、怪物、生物、玩家、村民和太阳的目标。
- 在跟随目标选项卡中添加了
FOLLOW_ITEM目标,使 NPC 能够根据资源位置(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看所有者的目标。 - 在
SynchedDataIndex中添加了persistent标志,以便瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 消费者添加了
SlimeBase中可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET并将CAT_PURR映射到猫 NPC,以增加驯服后环境声音的多样性。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 修复了 #680,通过升级网络协议版本强制执行版本不匹配检查。
- 修复了 #679,重置名称标签的位置、旋转和大小。
- 修复了 #665,为根旋转添加了多状态滑动功能。
- 修复了 #664,添加了禁用跟随鼠标光标的选项,以便于姿态调整。
- 修复了 #663,改进对 X 和 Z 轴根旋转的支持。
- 修复了 #661,添加了快速旋转功能:使用 NPC 魔杖并对 NPC 潜行即可将根旋转至面向玩家的方向。
- 修复了移动工具错误触发交互的问题,通过在交互处理器中添加对移动工具的检査来解决。
- 修复了预设物品错误触发交互的问题,通过在交互处理器中添加对预设物品的检查来解决。
- 修复了史莱姆和恶魂的碰撞箱及名称标签位置问题,通过调整边界框和眼睛高度的计算来解决。
- 修复了史莱姆和恶魂的 GUI 位置问题,通过调整偏移值来解决。
6.8.2
- 修复了 #677,通过扩展
SafeMerchantData并添加notifyTrade以避免崩溃。 - 添加了基于玩家互动和动作提升 NPC 等级的进度数据支持。
- 添加了全局 NPC 追踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在使用原始模型时使用变体纹理。
6.8.1
- 修复了 #676,通过使用现有的预设辅助方法代替自定义方法来解决。
6.8.0 (增加 API 支持)
- 修复了 #667,通过为无效的网络数据包添加警告消息和额外检查来解决。
- 修复了马刷怪蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便更轻松地与其他模组和自定义模型集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进的空间。
6.7.1
- 修复了 #657 和 #656,通过为原版漏洞添加额外的客户端检查来解决。
6.7.0
- 通过实现 Wolf Leg Animations 中的 setupAnim 方法,修复了 #650。
- 通过修正 canBeHitByProjectiles 的翻译,修复了 #648。
- 添加了
allowBypassInvulnerability配置选项,允许/禁止 NPC 绕过无敌状态,从而修复了 #645。 - 修复了删除按钮在宽度较小时仍显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置 UI 中显示名称标签的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了 Cat NPC 和 Wolf NPC 所有者数据同步不当的问题。
- 添加了预设浏览器,便于选择常见的 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了生成器系统以使用新的预设格式,以提高可维护性和未来的改进空间。
6.6.2
- 通过重写缩放系统,修复了 #643。
- 修复了重启/重载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于团队的名称标签可见性支持,尊重原版 Team 设置。
6.6.1
- 通过重构显示属性的内部数据处理,修复了 #638。
6.6.0
- 通过使用专用线程池实现异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 使用原子操作修复了纹理重载保护中的竞争条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止同一纹理的多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载期间的
defineId called for:警告消息。 - 重构了具有多层防御和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 Java 记录(records),以提高不可变性和线程安全性。
- 添加了基于 ConcurrentHashMap 的线程安全会话服务器防垃圾邮件保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用 2 线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤问题。
- 通过在 Gradle 依赖项中添加缓存,改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了 kill 命令在 NPC 上无法正常工作的问题。
- 修复了纹理重载保护阻止在驱逐后重新加载缓存的问题。
- 修复了远程图像验证器中的 WebP 验证 bug(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和未来的改进空间。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了鸡、猪和狼缺失的变体纹理。
- 添加了额外的纹理处理单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实现剪刀裁剪(scissor)以提高与其他模组的兼容性,修复了 #627。
- 通过修复旋转或移动模型部件时的生动动画问题,修复了 #625。
- 修复了使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 针对不同 NPC UUID 的屏幕切换逻辑进行了修复,感谢
Spawnblade进行的详细调查和修复建议,从而修复了 #626。
6.4.0
- 通过改进对话框数据验证和异常处理,修复了 #626。
- 通过重构渲染数据和渲染处理,修复了 #623。
- 通过确保自定义数据正确保存和加载,修复了 #622。
- 修复了打开对话框动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试过程。
- 改进了记录(records)并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件并将其从核心模组中移除。
- 通过在发送到客户端之前过滤对话框数据,修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了某些对话框数据字段缺失默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框和记分板动作添加了条件支持。
- 为对话框添加了频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段,改进了对话框按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的翻译缺失问题。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,以便在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了带有指示器的旋转按钮,提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了在某些情况下关闭按钮无法使用的问题。
- 修复了屏幕切换时鼠标光标跳动的问题。
- 修复了翻译文件,并移除了重复及已弃用的条目。
- 将 Easy NPC 魔杖移至现有的核心物品标签页,而非创建新的标签页。
- 为不同的模型部件(尾巴除外)添加了猫咪姿势支持。
- 通过在不必要时禁用发光效果,提升了 EasyNPCWand 发光效果的渲染性能。
- 改进了自定义实体检测,排除了如展示框、制造台、投掷物及刷怪笼等非生物实体。
- 改进了猫咪变体的处理逻辑。
6.1.1
- 通过检查物品是否在任一手中装备,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 针对特定模型强制同步帽子和头部图层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本的猫咪变体处理逻辑。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫咪渲染器问题。 - 修复了位置、缩放和旋转的预览功能。
- 修复了精灵(Fairy)模型。
- 通过将相关逻辑移至仅客户端运行,改进了自定义模型的支持与性能。
- 优化了玩家皮肤的玩家至 UUID 映射缓存。
- 将更改模型的命令和逻辑限制为仅限 Doppler NPC。
- 添加了
renderEntityRaw方法以按原样渲染 NPC。
6.1.0 ✨
这是一个重大版本发布。在更新之前,请备份你的世界存档和 NPC 数据。此版本包含许多改进、优化和内部变更,这些变更不兼容早期版本。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要手动调整。
- 内部数据格式和部分行为已被重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在被拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core(核心)和 Configuration UI(配置界面),提供即插即用的体验。
- Easy NPC: Core - 轻量级的运行时和 NPC 逻辑,依赖项极少。旨在用于服务器、整合包和开发者环境。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何做出此变更?
- 允许服务器和整合包仅在服务端部署 Core 模组,从而构建更精简的环境。
- 当不需要处处安装 UI 时,可减少内存占用并缩短加载时间。
- 通过将 UI 与核心逻辑分离,加快了开发与测试速度。
Easy NPC: Core 更新日志 (26.1.2)
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界/NPC! 有关更多信息,请查阅 升级指南。
7.20.0
- 修复了缺少皮肤 ID 的 NPC 导致的崩溃问题,感谢
voidsipp在 #866 中提供的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了人形 NPC 在使用“无”或资源位置皮肤时显示史蒂夫皮肤的问题。
- 修复了在 Forge 和其他使用 NPC 名称标签设置的生物上,“默认皮肤”显示相同 NPC 的问题。
- 修复了当其他模组中断释放过程时,位于玩家肩部的 NPC 丢失的问题。
- 修复了 NPC 因闪电、溺水、冻结或僵尸攻击而变成原版生物的问题。
- 修复了生成的 NPC 随机获得幼体、骑乘者、装备或效果,并丢失其预设装备的问题。
- 修复了未启用“拾取物品”功能的 NPC(如村民、猪灵和狐狸)仍然拾取物品的问题。
- 修复了骷髅 NPC 除了配置的 attacks 外,还使用原版弓和近战攻击的问题。
- 修复了末影人 NPC 的水伤害和传送问题,以及史莱姆 NPC 分裂和接触伤害的问题。
- 修复了狐狸 NPC 食用手持食物、鸡 NPC 下蛋以及猫 NPC 丢失原版姿势的问题。
- 修复了闪电充能苦力怕 NPC 以及反射火球瞬间杀死恶魂 NPC 的问题。
- 改善了敌对生物搜索并攻击 NPC 时的服务器性能。
7.19.0
- 通过保持一个 NPC 的隐藏皮肤层不在同类型其他 NPC 上隐藏它们,修复了 #865。
- 修复了类僵尸和末影人 NPC 的自定义姿势被其手臂动画覆盖的问题。
- 修复了在使用“DEFAULT”或“NONE”动画行走时,隐藏的身体部位再次显示的问题。
- 修复了“锁定身体”标签超出旋转屏幕范围的问题。
- 修复了投射物“物品 ID”字段隐藏物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在每个游戏启动后改变顺序的问题。
7.18.0
- 通过防止 NPC 在使用 LetMeDespawn 等模组加载时丢失,修复了 #862。
- 修复了拥有近战和远程攻击的 NPC 在手持弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标之间旋转以及在攻击时史莱姆 NPC 向错误方向跳跃的问题。
- 修复了传送离开或切换维度后 Boss 栏仍停留在屏幕上的问题。
- 修复了在 Creative 模式下右键点击 NPC 不掉落其生成蛋的问题。
- 修复了“计分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 金色重型弩的问题,并添加了皮革和铜制版本。
- 修复了皮肤屏幕上重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而不是config/easy_npc/skin的问题。 - 修复了大量德语翻译、英文 Bogged 名称以及原始的“主手”/“副手”键名。
- 更改了预设物品在生存模式生成 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
- 通过支持 AttributeFix 等模组设置的更高属性上限,修复了 #858。 需要在服务器和客户端安装 AttributeFix 或类似模组;护甲值上限为 100。
- 通过在不发生更改时不再重写 NPC 文件,修复了 #857。
- 通过在一个“打开对话框(条件)”的条件不满足时尝试下一个,修复了 #854。
- 修复了动作和对话框中的“几率”条件被掷骰两次的情况,这降低了实际几率。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或被拴住的 NPC 出现在肩部,以及断开连接时的肩部渲染泄漏问题。
- 修复了隐藏头部保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受影响;设置为 7 可保持旧外观。
- 更改了“关闭对话框”和“回退”动作,使其在没有打开条件对话框时运行。
- 更改了拥有传送距离的“跟随主人”NPC,使其跟随主人进入其他维度。
- 更改了服务器停止逻辑,最多等待 2 分钟以保存仍在写入的 NPC 文件。
- 更改了闲置 NPC 对附近玩家、掉落物或压力板的反应延迟至多 0.5 秒。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 提高了 NPC 保存、备份、
/easy_npc list、肩部同步和闲置 NPC 的性能。
7.16.0
- 修复了 #432:不再在设置多次时重复运行目标或在移除后运行。
- 修复了 #852:使长矛能够击中可攻击的 NPC。
- 修复了当玩家无法从肩膀卸下 NPC 时,NPC 迷路的问题。
- 修复了“坐在肩膀上”的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自插件的 Easy Model Entities 类型的 NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成存储的 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设置。 - 更新了测试通过的 NeoForge 版本至 26.1.2.120,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,预设导入保持静默。 - 修复了 #380:将 NPC 数量限制也应用于默认生成器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左手持物的 NPC。
- 修复了 #851:对话框按钮按单个对话框锁定,而非跨具有相同标签的不同对话框锁定。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少其 Epic Fight 生物补丁的问题。
- 修复了非居中库存屏幕及其关闭按钮与“自定义”交易标签页重叠的问题。
- 修复了缩放后的 Doppler NPC 保留了被模仿实体的完整碰撞箱的问题。
- 修复了位于玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端必须使用相同的模组版本,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。 - 添加了使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行了更大幅度的核心重构和代码清理。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名字标签和气泡对话框位于其身体内部的问题。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和观察失效的问题。
- 修复了在网络数据包中读取过大的名称、列表和 NPC 数据时没有限制的问题。
- 修复了应用无效的 NPC 位置、缩放比例、属性、名称和持续时间的问题。
- 更改了精灵(Fairy)NPC 占据其模型的空间,使其发生碰撞并可被点击。
- 更改了骷髅、流浪者和泥怪(Bogged)NPC 使用原版碰撞箱高度,它们之前略矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同版本的模组。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告将被替换的 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载、泄露 NPC 并清除选择的问题。
- 修复了选择框下拉列表被其后方的复选框和标签覆盖的问题。
- 修复了小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了在没有指定位置的情况下执行
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”功能在同一地点堆叠 NPC 的问题。
- 更改了“恢复”行为:当不被允许时拒绝操作,而不是生成副本。
- 添加了排序、匹配计数、重新加载、自动关闭、预设和皮肤的 NPC ID 及提示框。
- 添加了带有限制、确认提示和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 修复了 #833,现在仅向魔杖持有者、所有者和管理员显示简易 NPC 魔杖的轮廓。 其他玩家不再看到这些轮廓,隐形 NPC 对他们保持隐藏状态。
- 通过添加“设置此处为家”和“重置家园”按钮到位置配置中,修复了 #834。
- 通过在导出的预设中保留 NPC ID 和位置,确保导入时恢复相同的 NPC,从而修复了 #835。
- 修复了预设导入和刷怪蛋丢失所有者列表条目及所有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失所有者并变成无主状态的问题。
- 修复了选择列表仅显示前六项条目而隐藏其余条目的问题。
- 更改了导入预设的行为:改为在存储的位置更新原始 NPC,而不是添加副本;使用“作为新 NPC 导入”或预设物品来创建独立的 NPC。
- 更改了完成交易时的行为,播放“交易完成”音效,此前该音效一直静音。
- 更改了 API 对话框调用,使其报告未知的对话框标签,而不是一直报告成功。
- 更改了没有手臂的 NPC 携带手持物品的方式,改为在头部或身体处展示,而不是隐藏它们。
- 更改了对可选依赖项 Easy Model Entities 的版本要求,需版本 2.4.0 或更高。
- 添加了包含对话框、说话、游泳、进食和坠落伤害声音的“声音”配置。
- 在“声音”配置中添加了可搜索的声音选择功能,并配有音量和音调滑块。
- 添加了“阻挡载具”选项,以防止 NPC 进入船、矿车以及模组椅子中。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型添加了新的内置皮肤。
- 添加了客户端设置,用于让姓名标签隐藏在墙壁后面以及控制魔杖轮廓的
highlightEnabled。 - 添加了“Exists”(存在)条件操作,并提供对 NPC 移动、动作和预设的 API 访问。
7.11.0
- 通过不再在注销时因 NPC 跟随或注视玩家而导致服务器冻结,修复了 #828。
- 通过将常规的 NPC 移除消息移至调试日志,修复了 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了 #832。
- 修复了大型世界中每小时 NPC 备份导致的卡顿问题,以及保留了已移除 NPC 的时间戳问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、所有者和位置的问题。
- 修复了所有者登录恢复导致未加载的 NPC 重复、反复恢复、复活或移动的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后旧的 NPC 数据问题,避免了冗余写入,并增加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在 Iris 光影激活时,对话气泡丢失文本并变得半透明的问题。
- 修复了在使用光影包时,NPC 的“不透明度”被忽略的问题。
- 修复了翻译后的对话气泡和模组 API 文本的文本格式化和宏解析问题。
- 修复了在使用光影包时,对话气泡及其文本一直隐藏在方块后面的问题。
- 添加了
minLightLevel,以保持对话气泡在黑暗环境中可读。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了 #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 格,超出该范围才进行传送。
- 更改了“移动到”和“返回家园”,在没有任何进展的情况下,三秒后放弃。
- 更改了“移动到”动作的超时计算方式,改为计算真实刻数,此前运行时间过长一倍。
- 更改了新的“随机游泳”目标,使其优先级低于跟随、逃跑和攻击目标。
- 更改了拥有 Easy Model Entities 模型的 NPC 的“不透明度”,由其自身模组应用。
- 将最低要求的 Easy Model Entities 版本更改为 2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳层级添加了“水面以下深度”和“地板以上高度”滑块。
- 添加了关于世界保存时写入的 NPC 文件的日志条目,每项耗时超过 250 毫秒时会发出警告。
7.8.1
- 修复了 #827,使水中的鱼 NPC 直立显示,而不是总是侧躺。
- 修复了 #828,防止损坏的 NPC 阻碍世界保存,现在它会回退到默认值。
- 修复了恢复的 NPC 拾取随机预设 ID 的问题,该 ID 在每次保存时都会改变。
- 更改了 NPC 数据,仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了逻辑:如果 NPC 已经站在目标位置,则立即完成移动。
- 将“None”皮肤选项卡更名为“Advanced”,其中包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最小版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”动作,可将 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,旧版本将禁用集成。
- 添加了“等待”动作,暂停事件后续动作指定的持续时间。
- 添加了“倒计时计时员”预设,对话气泡计数至十,并以声音和火花结束。
- 添加了 Doppler 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 预览上方的问题。
- 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非模型尺寸的问题。
- 修复了在服务器上
/easy_npc命令完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段上的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕边缘而未自动换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐错位的问题。
- 修复了“设置姿势(Set Pose)”、“播放动画(Play Animation)”和“停止动画(Stop Animation)”动作的更改无法保存的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议列表,使其优先列出准星指向的 NPC,并仅列出没有权限的自有 NPC。
- 更改了预设导出功能,使其仅存储与新建 NPC 不同的部分,且不包含位置和所有者信息。
- 更改了没有目标或动作的预设,使其回退到其所属 NPC 类型的默认值。
- 更改了不包含玩家的“出生(On Spawn)”或“击杀(On Kill)”等事件,以检查其条件。其中若存在基于玩家的条件(例如计分板或物品),则不再执行相关动作。
- 更改了基于时间的动作,当所有者在附近时,将其指定为
@initiator。 - 更改了气泡显示时间,根据文本长度从 5 秒调整至最长 18 秒。
- 更改了“设置姿势(Set Pose)”动作,使其仅在“自定义(custom)”姿势条目下显示输入字段。
- 添加了五个固定步长的基于时间的动作,间隔从约 1 秒到约 15 分钟不等。
- 添加了“消息(Message)”动作,支持聊天、系统消息和气泡文本,且无需执行命令。
- 为“消息(Message)”动作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包添加了气泡图形文件:
easy_npc:textures/gui/speech_bubble.png。 - 添加了百分比形式的“几率(Chance)”条件,以及针对所有者和阵营的“关系(Relationship)”条件。
- 添加了出生、所有者登录、状态变更、昼夜交替、天气变化以及缺失的“交易(On Trade)”事件。
- 在每个 NPC 类型下的
easy_npc:api/preset/base/路径中添加了基础预设,可用作父级预设。 - 添加了“流浪同伴(Wandering Companion)”预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的数据的事件。
- 为
/easy_npc命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,使其在未输入文字时即可出现,并容忍一个方块范围内的偏差。
7.5.0
- 修复了 NPC 的家位置始终显示为未设置的问题,这导致在配置屏幕中隐藏了“家”选项、保存时跳过该选项,并使得“返回家”和“在家附近闲逛”功能失效。
- 修复了通过预设、预设浏览器或重生生成的 NPC 永远无法获得家位置的问题。
- 修复了通过预设浏览器生成的 NPC 保留了导出该预设的世界的家位置,而不是使用其生成位置的问题。
- 修复了在配置、皮肤和预设屏幕中,当 Easy NPC Wand(简易 NPC 法杖)高亮选中 NPC 时,它们显示为带有阴影的白色剪影的问题。
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非按物种共享),修复了 #814。
- 通过允许“返回家”在任何距离下生效(而不仅仅是在家附近),修复了 #813。
- 通过在每个会话期间检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包中的 Cobblemon 方面属性,而不仅仅是“闪亮”和“雌性”,修复了 #810。
- 修复了当具有“引诱”目标的 NPC 计算目标时服务器崩溃的问题。
- 修复了单个或 Boss 刷怪箱在其预设未存储任何 NPC 时无限生成的问题。
- 修复了新创建的 NPC 也会显示“旧版简易 NPC 数据”警告的问题。
- 修复了针对旧版 64x32 皮肤的透明度校正缺失问题,这会导致图层伪影。
- 修复了在查询玩家名称时,玩家皮肤屏幕会短暂冻结的问题。
- 修复了“重置注视...”目标标签在某些语言中被错误显示为“重置战利品...”的问题。
- 修复了预设导入后“无重力”属性被忽略的问题,这会导致 NPC 掉落。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在被消失后重新生成时会丢失其所有者的问题。
- 修复了在游戏启动时提供相关目标的模组缺失,导致从 NPC 身上删除目标的问题。
- 修复了导入没有存储 ID 的预设时,会生成一个没有所有者和家的 NPC 的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保留旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标虽然可以存储但从未执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画。
- 修复了 Forge 从不运行其服务器启动步骤的问题,这导致整个会话期间 NPC 追踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发环境启动时不包含任何 Mixin 的问题,这会禁用原版实体调整,并在生成 Fox NPC 时导致崩溃。
- 将移动目标的执行顺序固定为:逃跑、跟随、回家,然后是闲逛。因此,具有多个移动目标的 NPC 行为可能与之前不同。
- 修改了向原版怪物刷怪箱插入预设的逻辑,以保留其延迟、数量和范围。
- 修改了未选择目标的“跟随所有者”和“注视所有者”行为,使其跟随 NPC 的所有者。
- 将数据包预设文件夹更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc 命名空间。 - 修改了预设浏览器,使其始终以相同的顺序列出条目。
- 移除了实验性的用户自定义 NPC;不再读取或创建额外的配置文件。
- 移除了未使用的
SERVER_SKIN皮肤类型。 - 添加了新的 gametest 结构,以支持 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 风格。
- 修复昼夜检测逻辑,此前将日出计为夜晚、日落计为白天。
- 修复下界(Nether)和末地(End)中的可见性逻辑,此前错误地使用了主世界时间。
- 修复时间与游戏模式可见性复选框显示顺序随机的问题。
- 修复游戏测试仅在首个断言失败时才会报错的问题,这导致后续的错误被隐藏。
- 修复“骑乘”马匹皮肤变体,此前从未显示马鞍。
- 更改“仅主人可见”和“仅队伍可见”设置,使其也遵循昼夜和游戏模式变化。
- 更改唤魔者(Evoker)、幻影(Illusioner)和卫道士(Vindicator)变体,若没有“交叉双臂”特征,则保持手臂下垂。
- 新增“保卫阵营”目标,攻击伤害附近阵营成员或玩家的任何实体。
- 新增阵营成员互相攻击时的系统消息,表明该阵营不参与冲突。
- 为掠夺者(Illagers)添加头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置界面中添加昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升了可见性检查的性能。
- 通过用默认值补全缺失项,改善了旧版本数据的显示属性兼容性。
- 改善攻击目标界面:当未设置时,禁用“保护主人”和“保卫阵营”选项。
7.3.0
- 改进皮肤变体:将其数据作为类型化字段携带,而非解析变体名称。
- 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
- 通过共享
EnumUtils辅助类处理get(String)查找,减少重复的枚举代码。 - 优化村民职业和类型的查找:直接使用注册表键,而非扫描。
- 优化枚举名称查找:在构造时缓存标签名称、ID 和键。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.1.2
- 修复 #801:使用组合方式生成 NPC、对话和动作 UUID,以避免在动作跟踪和执行限制方面发生冲突。
7.1.1
- 修复 #800:采用惰性加载实体类型。
- 修复 #799:修复边界情况,并添加更多文档说明及更清晰的日志消息。
- 修复 #798:将控制台、命令和命令方块视为可信的命令来源。
- 修复单人/局域网关键问题:客户端和服务端 NPC 此前共享同一个注册表。
- 修复配置菜单处理中的内存泄漏,并添加超时与断开连接清理机制。
- 修复多个 NPC 同时请求相同皮肤时的重复下载问题。
- 修复出错后皮肤查找失败的问题,防止慢速服务器导致游戏卡死。
- 修复 URL 皮肤界面在检查远程图片时导致游戏卡死的问题;现在检查在后台运行。
- 新增世界刷怪箱(World Spawner)方块,限制整个世界(所有维度)内的 NPC 预设数量;现有的群组刷怪箱(Group Spawner)现在按维度计数,因此远处的 NPC 不再阻塞它。
- 强化远程皮肤下载安全性:设置严格的尺寸限制和安全重定向处理,防止因过大或恶意的皮肤 URL 导致崩溃;新增可选的
blockPrivateAddresses设置。 - 通过仅向实际使用这些事件的 NPC 发送实体和玩家加载事件(按维度分组),提升服务器性能。
7.0.0
- 修复 #794:使用预期类型进行 NPC 渲染。
- 修复缩放界面预览:将实体脚部固定在比例尺的 0 线,使 NPC 从底部向上缩放,而非从中心缩放,且在边界框更新后不再向下偏移。
- 修复 #791:新增流浪商人(Wandering Trader)NPC 类型。
- 修复 #788:将 AI 安全保护扩展至 Epic Fight 模组及原始 NPC 变体(猪灵、村民、末影人、苦力怕、袭击者和女巫)。
- 修复 #787、#531、#237 和 #184:新增阵营系统,包含
/easy_npc faction命令、单个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复 #787、#771 和 #572:新增“目标”(target)目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 指定特定目标。
- 修复 #786:为 Cobblemon NPC 添加性别和闪光模型变体,可通过模型选择中的
female或shiny进行搜索。 - 修复无敌 NPC 之间的阵营战斗问题:新增可被阵营攻击(Attackable by Factions)的战斗属性。
- 修复 Cobblemon 模型选择预览中大体型物种的显示问题:改用 Cobblemon 自身的配置文件比例进行缩放,而非基于碰撞箱高度。
- 修复阵营管理边界情况:验证阵营名称、排序阵营列表,并在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配。
- 修复自定义皮肤重载问题:改为按每个皮肤模型单独加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存。
- 改进“可被玩家/怪物/阵营攻击”战斗属性:使其独立于“无敌”状态工作,各自为其对应的攻击者群体开辟独立的攻击通道。
- 改进预设命令和网络处理:将大型处理器拆分为更小、更专注的导入、导出和功能特定组件。
- 新增 Easy Model Entities 支持。
- 新增阵营管理器和管理员编辑界面,用于创建、着色和删除阵营,并管理敌对关系;受新的
FACTION_MANAGEMENT安全特性保护。 - 新增“杂项”(Misc)属性选项卡,作为 NPC 阵营分配的归属位置。
- 新增可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636 和 #622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对属性滑块施加极端值限制(针对来自其他模组的极端值),修复了 #767。
- 为带有动作和条件的 NPC 添加自定义数据物品匹配功能,修复了 #754。
- 修复了在 >= 1.21.x 版本中,纹理管理器运行在错误线程可能导致崩溃和死锁的问题。
- 修复了动作条件中空 UUID 的处理问题。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 硬币、钥匙和红代币作为带有动作和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红代币物品数据。 - 添加了对抗来自其他模组的极端值的属性保护机制。
- 将高生命值 NPC 的回退最大生命值从 1024 增加到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基础刻检查定时交易重置并在打开交易屏幕之前进行检查,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,支持昼夜时间和天气条件。
6.23.0
- 通过将 isSunBurnTick 错误迁移到 26.x,修复了 #774。
- 通过调整纹理重试策略以处理 403 和 404 错误并降低日志记录级别,修复了 #772。
- 修复了 #770 中 Epic Fight NPC(唤魔者、掠夺者、卫道士和人类皮肤)的物品渲染问题。
- 修复了 #769 中 NPC 不可靠地打开或关闭门的门循环问题。
- 通过添加对话选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的颜色选择器弹出窗口以及手动 RGB/十六进制值输入,修复了 #709。
- 修复了在未指定颜色时重命名导致 NPC 名称颜色被重置的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,使得当“开门”或“关门”处于活动状态时,“穿过门”自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以提高对依赖特定玩家数据的第三方模组和插件的兼容性,修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及示例 NPC 预设
Grukk, the Sparring Post来展示如何使用这些条件,修复了 #764。 - 确保现在记录了对话按钮的执行限制,修复了 #763。
- 提供了名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)读取未注册的脑记忆时导致的与第三方村民 AI 相关的崩溃问题 #756。
- 修复了服务器端数据未锁定对话按钮的问题,为 #760 和 #644 做准备。
- 通过添加条件对话打开支持/命令以更好地控制向玩家显示对话框的时机,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 添加了枪标签中的额外枪支。
- 添加了新的“打开对话(条件)”动作,仅在满足其条件时打开命名的对话,而现有的“打开对话”动作则无条件打开对话。
- 为动作、对话和对话按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,使 Piglin、Piglin Brute 和 Zombified Piglin NPC 具有无敌性。
- 添加了新的“击退免疫”战斗属性,防止 NPC 受到近战或投射物攻击的击退效果。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性界面,使其在主题上更合适(此前位于能力界面)。
6.21.0
- 修复了持交叉手臂姿势的劫掠者物品附着问题。
- 修复了损坏的劫掠者弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在模型部件的第三方 Mixin 相关的崩溃问题 #756。
- 通过减少日志详细程度并为自定义模型部件添加额外检查,修复了 log.info 刷屏消息。
- 提高了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃问题。
6.19.0
注意:此更新将对话背景图像调整了 10x6 像素,如果您使用的是自定义背景,可能需要调整它们。
- 通过添加对话按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过为对话文本添加打字机效果支持,修复了 #683 和 #215。
- 通过允许对话、对话按钮和交互的条件,修复了 #690 和 #309。
- 修复了对话框布局和背景的较小 UI 问题。
- 重构了对话背景图像,每侧调整了 10x6 像素。
- 重构了对话屏幕布局以更好地适应新的背景尺寸并改善外观。
- 添加了对话文本的打字机效果和客户端配置。
- 添加了条件符号以指示对话、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话条件和按钮状态相关的较小错误修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或删除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件以允许更复杂和动态的行为,修复了 #745。
- 通过为长文本添加对话框按钮工具提示,修复了 #652。
- 通过添加命令值工具提示以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了背包物品检查条件。
- 添加了手持物品检查条件,支持(主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以允许对条件进行取反从而实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的工具提示,修复了 #738。
- 通过减少启动期间和游戏内的 log.info 消息,修复了详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项,修复了 #732。
- 通过避免在特定情况下(如交易界面)自动关闭,修复了 #723。
- 添加了通用对话框配置选项,以允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.1
- 通过扩展正确的基类,修复了 #735。
- 修复了手动生成测试中出现的几个 26.1.2 版本特有的问题。
6.15.0(交易、玩家头颅、史诗战斗及生活质量更新)
- 如果客户端物种列表为空,则重新同步物种数据,从而修复了 #731。
- 通过改进 Epic Fight 集成并启用实验性功能,修复了 #730。
- 确保交易使用次数被正确存储,从而修复了 #729。
- 通过为玩家头颅添加自定义头颅支持,修复了 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置,修复了 #689。
- 通过新的交易配置界面和对自定义交易的更好支持,修复了 #218 和 #132。
- 修复了在基本模式和普通/高级交易模式之间切换时的交易特定边缘情况。
- 通过显示完整文本的工具提示来截断对话框按钮文本的问题已修复。
- 通过将动画状态与 Cobblemon 动画系统同步,修复了 Cobblemon 动画问题。
- 添加了每个交易特定的操作,以允许用户在购买后触发操作。
- 添加了交易重置按钮以轻松重置所有交易。
- 在交易配置界面中添加了交易使用信息。
- 添加了实验性功能状态,以允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例交易者。
- 清理测试文件。
6.14.0
- 通过确保更改值时同步到客户端,修复了 #727。
- 通过为特定命令添加额外的白名单,修复了 #726。
- 通过添加基本的 Cobblemon 支持(带有 Cobblemon NPC),修复了 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕,修复了对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算,修复了 x 和 z 根旋转问题。
- 通过自定义 NPC 类型和模型,添加了基本的 Cobblemon 支持用于测试。
6.13.0(安全与权限更新)
注意:此更新包括针对多人游戏环境的更好的安全检查与权限控制。它允许执行服务器命令,如果恶意使用,这可能具有潜在危险。
此次更新将模型根数据与逻辑从其余模型部件数据和逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据与逻辑从其余模型部件数据和逻辑中分离,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查与权限系统,修复了 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例,修复了 #469、#311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景双重渲染问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多人游戏环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义能力和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 移除了重复的精灵图集。
- 为将来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 与配置屏幕渲染和资源相关的常规代码清理和优化。
6.12.0
- 通过基于原版模型添加针对自定义模型部件列表的额外检查,修复了 #714。
- 通过将每 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息,减少日志冗长度,从而修复了 #713。
- 通过减少过大的启动/配置日志输出,修复了 #711。
- 修复了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 向 EasyNPCModelManager 添加了模型部件名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构,改进了 RenderEntityTypeSupportConfig,以获得更好的性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析,修复了 #710。
6.11.0
- 修复了 #703,解决了新自定义层级系统与手部渲染导致的渲染问题。
- 通过为无效的交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端,修复了头部追踪问题。
- 优化了
CustomLookAtPlayerGoal,以更好地处理边缘情况并减少抖动。 - 修复了 Doppler NPC 保留其手持物品栏的问题。
- 改进了
PoseManager的日志消息。 - 更新了标志设计。
6.10.0
- 通过为第三方实体创建添加 try-catch 块,修复了 #698。
- 通过切换到
DEFAULT原版姿态时清除模型部件的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过将根旋转枢轴修正为使用实际包围盒高度而非 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺少针对玩家的目标刷新,以及对离线目标的重试机制。 - 修复了目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 添加了 Fabric 和 Forge 的
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加用于逃离玩家、村民、怪物等的额外逃跑目标,修复了 #597。
- 修复了姿态加载问题,改为直接从模组资源读取而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于从外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 添加了所有支持 NPC 类型的姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行回调动作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl,以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引中。
- 在各种实体渲染器中添加了 EasyNPCItemAttachmentLayer。
- 添加了专用的
Flee Objective(逃跑目标)配置标签页,包含用于躲避苦力怕、怪物、生物、玩家、村民和太阳的目标。 - 在跟随目标标签页中添加了
FOLLOW_ITEM(跟随物品)目标,使 NPC 能够跟随按资源定位符标识的物品实体(例如minecraft:apple)。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看所有者的目标。 - 为
SynchedDataIndex添加了persistent标志,使得瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 消费者在
SlimeBase中添加了可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET,并将CAT_PURR映射到驯服的猫 NPC,以增加环境声音的多样性。 - 将周期性 NPC 保存操作的日志级别从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本来强制执行版本不匹配警告,修复了 #680。
- 通过重置姓名标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动功能,修复了 #665。
- 通过添加禁用跟随鼠标光标选项以便于姿态调整,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过添加使用 NPC 魔杖并潜行靠近 NPC 以将根旋转到面向玩家的快速旋转功能,修复了 #661。
- 通过在与交互处理器中添加移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过在与交互处理器中添加预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整包围盒和眼高计算,修复了史莱姆和恶魂的碰撞箱及姓名标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置问题。
6.8.2
- 通过扩展
SafeMerchantData并添加 notifyTrade 以避免崩溃,修复了 #677。 - 添加了基于玩家互动和行为的 NPC 升级进度数据支持。
- 添加了全局 NPC 跟踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原版模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而不是自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效的网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马生蛋模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,便于与其他模组和自定义模型集成。
- 重构了内部数据处理和注册逻辑,以提高可维护性和未来改进空间。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现
setupAnim方法中的狼腿动画,修复了 #650。 - 通过修复
canBeHitByProjectiles的翻译问题,修复了 #648。 - 添加了
allowBypassInvulnerability配置选项,用于允许/禁止 NPC 绕过无敌状态,从而修复了 #645。 - 修复了删除按钮在小宽度下仍显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置 UI 中显示名称标签的问题。
- 修复了距离动作导致多个动作未能正确触发的问题。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据同步不正确的问题。
- 添加了预设浏览器,便于选择常见的 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了刷怪笼系统以使用新的预设格式,以提高可维护性和支持未来的改进。
6.6.2
- 通过重写缩放系统,修复了 #643。
- 修复了重启/重载后缩放未正确更新命中盒和名称标签位置的问题。
- 添加了 MID(中间)和 MOUSE_OVER(鼠标悬停)名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于队伍的名称标签可见性支持,尊重原版 Team 设置。
6.6.1
- 通过重构显示属性的内部数据处理,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证泛滥导致同一纹理被同时多次下载的问题。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致的崩溃。
- 修复了 NPC 加载过程中出现的
defineId called for:警告消息。 - 重构了具有多级防御和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑,以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了基于 ConcurrentHashMap 的线程安全会话服务器防垃圾邮件保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载性能,采用双线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过在 Gradle 依赖项中添加缓存,改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了 kill 命令无法对 NPC 生效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重新加载的问题。
- 修复了远程图像验证器中 WebP 验证的 Bug(缺少返回语句)。
- 重构了纹理处理逻辑,以提高可维护性和支持未来的改进。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了鸡、猪和狼缺失的变体纹理。
- 添加了针对纹理处理的额外单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实现裁剪功能,修复了 #627,以更好地与其他模组兼容。
- 修复了 #627 中使用旋转或移动模型部件时的生动动画问题。
- 修复了使用缩放模型部件时默认动画被取消的问题。
- 添加了更完善的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 修复了针对不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade进行的详细调查和修复建议。(#626)
6.4.0
- 通过改进对话数据验证和错误处理,修复了 #626。
- 通过重构渲染数据和渲染处理,修复了 #623。
- 确保自定义数据正确保存和加载,修复了 #622。
- 修复了打开对话框动作类型,以允许从其他 NPC 打开对话框。
- 为 ConditionDataSet 和 ActionDataSet 添加缺少的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,以便更容易测试自定义数据。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话数据,修复了对话数据问题。
- 修复了对话编辑器布局问题并提高了可用性。
- 修复了部分对话数据字段缺少默认值的问题。
- 添加了对话优先级支持,以控制对话的执行顺序。
- 为对话和记分板动作添加了条件支持。
- 添加了频率支持,以限制对话显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段,改进了对话按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型缺少翻译的问题。
- 添加了记分板动作类型,用于增加、减少或设置记分板数值。
- 添加了
@score(...)NPC 宏,用于在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了自旋按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了在某些情况下关闭按钮无效的问题。
- 修复了屏幕切换时鼠标光标跳动的问题。
- 修复了翻译文件,并移除了重复及已弃用的条目。
- 将 Easy NPC 法杖移至现有的核心物品标签页,而非新建一个。
- 为不同的模型部件(尾巴除外)添加了猫姿势支持。
- 通过在不必要时禁用发光效果,提升了 EasyNPCWand 发光效果的运行性能。
- 改进了自定义实体检测,排除了显示实体、制造者、投掷物以及刷怪笼等非生命实体。
- 改进了猫变种的处理逻辑。
6.1.1
- 通过检查物品是否装备在某只手中,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 通过对特定模型强制同步帽子和头部层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本的猫变种处理逻辑。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫的渲染器问题。 - 修复了位置、缩放和旋转的预览功能。
- 修复了精灵模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型的支持与性能。
- 改进了玩家皮肤的玩家到 UUID 映射的缓存机制。
- 将更改模型的命令和逻辑限制为仅限 Doppler NPC。
- 添加了 renderEntityRaw 方法,用于按原样渲染 NPC。
6.1.0 ✨
这是一个重大版本更新。在更新之前,请务必备份你的世界存档和 NPC 数据。此版本包含许多改进、优化和内部变更,这些变更不兼容早期版本。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要手动调整。
- 内部数据格式和部分行为已重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core(核心)和 Configuration UI(配置界面),提供即插即用的体验。
- Easy NPC: Core - 轻量级的 NPC 运行时和逻辑模块,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可在需要该界面的客户端上安装。
🎯 为何做出此变更?
- 允许服务器和整合包仅在服务端部署 Core 模组,从而构建更精简的环境。
- 当不需要到处使用界面时,可降低内存占用并缩短加载时间。
- 通过分离界面和核心逻辑,加快开发和测试速度。
Easy NPC: Core (1.21.11) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新至新版本之前,请务必备份你的世界/NPC! 有关更多信息,请查阅 升级指南。
7.20.0
- 修复了缺少皮肤 ID 的 NPC 导致崩溃的问题,感谢
voidsipp在 #866 中提供的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了人形 NPC 在使用“None”或资源定位符皮肤时显示 Steve 皮肤的问题。
- 修复了在 Forge 上,“默认皮肤”会显示相同的 NPC,以及使用 NPC 命名标签设置的其他生物的问题。
- 修复了当其他模组中断释放过程时,位于玩家肩膀上的 NPC 丢失的问题。
- 修复了 NPC 通过闪电、溺水、冰冻或僵尸攻击变成原版生物的问题。
- 修复了生成的 NPC 获得随机婴儿、骑乘者、装备或效果,并丢失其预设装备的问题。
- 修复了未启用“拾取物品”功能的 NPC(如村民、猪灵和狐狸)仍然拾取物品的问题。
- 修复了骷髅 NPC 除了配置的攻击方式外,还使用原版弓箭和近战攻击的问题。
- 修复了末影人 NPC 的水伤害与传送问题,以及史莱姆 NPC 分裂和接触伤害的问题。
- 修复了狐狸 NPC 食用手持食物、鸡 NPC 产蛋以及猫 NPC 丢失原版姿势的问题。
- 修复了闪电充能苦力怕 NPC 以及反射火球瞬间杀死恶魂 NPC 的问题。
- 改进了敌对生物搜索并攻击 NPC 时的服务器性能。
7.19.0
- 通过防止一个 NPC 隐藏的肤色层在其他同类型 NPC 上隐藏它们,修复了 #865。
- 修复了类僵尸和末影人 NPC 的自定义姿势被手臂动画覆盖的问题。
- 修复了在使用“DEFAULT”或“NONE”动画行走时,隐藏的身体部位重新显示的问题。
- 修复了“锁定身体”标签超出旋转屏幕范围的问题。
- 修复了投射物“Item ID”字段隐藏 Item ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生改变的问题。
7.18.0
- 通过防止 NPC 在加载模组(如 LetMeDespawn)时丢失,修复了 #862。
- 修复了拥有近战和远程攻击的 NPC 在手持弓、弩或枪时不射击的问题。
- 修复了 NPC 在目标之间旋转,以及史莱姆 NPC 在攻击时向错误方向跳跃的问题。
- 修复了传送离开或切换维度后Boss栏仍停留在屏幕上的问题。
- 修复了创造模式下对 NPC 使用快捷选取方块未掉落其生成蛋的问题。
- 修复了“记分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 的金制重型弩,并添加了皮革和铜制版本。
- 修复了皮肤屏幕上重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了许多德语翻译、英文 Bogged 名称以及原始的“主手”/“副手”键名。
- 更改了预设物品的行为,使其在生存模式下生成 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
- 通过支持 AttributeFix 及其他类似模组设置的更高属性上限,修复了 #858。 需要在服务器和客户端安装 AttributeFix 或类似模组;护甲值上限为 100。
- 通过在没有更改的情况下不再重写 NPC 文件来修复 #857。
- 通过当一个“打开对话框(条件式)”的条件未满足时尝试下一个,修复了 #854。
- 修复了动作和对话框上的“几率”条件被掷两次,从而降低几率的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或拴绳的 NPC 出现在肩膀上,以及断开连接时出现的肩膀渲染泄漏问题。
- 修复了隐藏头部仍保留帽子图层,以及 NPC 在其他维度追踪目标的问题。
- 修复并改进了多个默认预设,包括“Grukk”、“Forge Keeper”和“Yoga Master”。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保持默认开关的现有 NPC 也会受到影响;设置为 7 可保持旧外观。
- 更改了“关闭对话框”和“回退”动作的行为,使其在无条件对话框打开时运行。
- 更改了拥有传送距离的“跟随主人”NPC 的行为,使其跟随主人进入其他维度。
- 更改了服务器停止行为,最多等待 2 分钟以等待仍在写入的 NPC 文件。
- 更改了闲置 NPC 的反应延迟,使其对附近的玩家、坠落或压力板晚至 0.5 秒反应。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 改进了 NPC 保存、备份、
/easy_npc list、肩膀同步和闲置 NPC 的性能。
7.16.0
- 修复了 #432:不再在目标被多次设置或在移除后再次运行目标。
- 修复了 #852:使长矛能够击中可攻击的 NPC。
- 修复了当玩家无法从肩膀卸下 NPC 时,NPC 迷路的问题。
- 修复了“坐在肩膀上”的 NPC 在没有距离或时间限制的情况下追逐其所有者的问题。
- 修复了来自插件的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成存储的 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命令设置。 - 更新了测试通过的 NeoForge 版本至 21.11.48,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,保持预设导入静默。 - 修复了 #380:将 NPC 数量限制也应用于默认刷怪器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左撇子 NPC。
- 修复了 #851:按对话锁定对话框按钮,而不是跨具有相同标签的对话进行锁定。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少其 Epic Fight 生物补丁的问题。
- 修复了缩放后的 Doppler NPC 保留被模仿实体的完整碰撞箱的问题。
- 修复了玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端需使用相同的模组版本,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。 - 添加了使用 Client Runtime Interface Toolkit 的自动客户端测试。
- 核心重构和代码清理工作有所增加。
7.12.2
- 修复了精灵的碰撞箱过小,导致其名字标签和对话气泡位于其体内的問題。
- 修复了缩放的 NPC 保留旧的碰撞箱和视线高度,导致打击、点击和观察落空的问题。
- 修复了在网络数据包中读取过大的名称、列表和 NPC 数据时没有任何限制的问题。
- 修复了应用无效的 NPC 位置、缩放、属性、名称和持续时间的情况。
- 更改为精灵 NPC 占用其模型的空间,使其可以发生碰撞并被点击。
- 更改了骷髅、流浪者和沼泽僵尸 NPC 至原版碰撞箱高度,它们之前稍微矮了一点。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并附带原因提示。
- 修复了预设导入和导出消息缺失、错误或未警告替换了 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载、泄露 NPC 并清除选择的问题。
- 修复了小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了没有位置参数的
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及在单个位置堆叠“生成新”NPC 的问题。
- 更改为“恢复”在不被允许时拒绝操作,而不是生成副本。
- 添加了排序、匹配计数、重新加载、自动关闭、NPC ID 以及预设和皮肤的提示框。
- 添加了带有限制、确认提示和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 通过仅向魔杖持有者、所有者和管理员显示 Easy NPC Wand 轮廓,修复了 #833。 其他玩家不再看到这些轮廓,且隐形 NPC 对他们保持隐藏状态。
- 通过在位置配置中添加“设为家”和“重置家”按钮,修复了 #834。
- 通过在导出的预设中保留 NPC ID 和位置,使得导入时能恢复相同的 NPC,从而修复了 #835。
- 修复了预设导入和刷怪蛋丢失所有者列表条目及所有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失所有者并变成无主状态的问题。
- 修复了选择列表仅显示前六个条目而隐藏其余条目的问题。
- 更改了预设导入行为:改为在原存储位置更新原始 NPC,而非添加副本;如需创建独立的 NPC,请使用“作为新 NPC 导入”或预设物品。
- 更改了已完成交易的音效:播放“交易完成”声音,此前该声音一直静音。
- 更改了 API 对话框调用:报告未知的对话框标签,而非始终报告成功。
- 更改了没有手臂的 NPC 的物品携带方式:改为在头部或身体处携带手持物品,而非隐藏它们。
- 更改了对可选依赖项 Easy Model Entities 的版本要求:需版本 2.4.0 或更高。
- 添加了包含对话框、语音、游泳、进食和摔落伤害音效的“声音”配置。
- 在“声音”配置中添加了可搜索的声音选择器,并配有音量和音调滑块。
- 添加了“阻挡载具”选项,以防止 NPC 进入船、矿车及模组提供的椅子中。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型新增了一种内置皮肤。
- 添加了客户端设置,用于隐藏墙壁后的名称标签以及
highlightEnabled的魔杖轮廓。 - 添加了“存在(Exists)”条件操作,并提供了对 NPC 移动、动作和预设的 API 访问权限。
7.11.0
- 通过不再在 NPC 跟随或注视玩家时注销服务器导致服务器冻结,修复了 #828。
- 通过将常规 NPC 移除消息移至调试日志,修复了 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了 #832。
- 修复了在大型世界中每小时 NPC 备份导致的卡顿,以及保留了已删除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、所有者和位置的问题。
- 修复了登录恢复所有者时重复、反复恢复、复活或移动未加载 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后残留的 NPC 数据,避免了冗余写入,并增加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时,对话气泡丢失文本并变得半透明的问题。
- 修复了在使用光影包时,NPC 的“不透明度”被忽略的问题。
- 修复了翻译后的对话气泡和模组 API 文本的文本格式化和宏解析问题。
- 修复了在使用光影包时,对话气泡及其文本停留在方块后面的问题。
- 添加了
minLightLevel以保持对话气泡在黑暗环境中可读。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了 #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 格,超出此范围才进行传送。
- 更改了“移动到”和“返回家”行为:在三秒内无进展时放弃任务。
- 更改了“移动到”动作的超时机制:现在计算真实刻数,此前运行时间过长一倍。
- 更改了新的“随机游泳”目标优先级:低于跟随、逃跑和攻击目标。
- 更改了带有 Easy Model Entities 模型的 NPC 的“不透明度”应用方式:由该模组自身应用。
- 更改了最低要求的 Easy Model Entities 版本为 2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳层级添加了“水面下深度”和“地面上方高度”滑块。
- 添加了关于世界保存时写入的 NPC 文件的日志条目,若每项耗时超过 250 毫秒则发出警告。
7.8.1
- 通过让水中的鱼形 NPC 保持直立而非始终侧躺,修复了问题 #827。
- 通过防止受损的 NPC 阻止世界保存(现已回退至默认值),修复了问题 #828。
- 修复了恢复后的 NPC 拾取随机预设 ID 并在每次保存时发生变化的问题。
- 更改了 NPC 数据逻辑,仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已到达目标位置的 NPC 的行为,使其立即完成移动。
- 将“None”(无)皮肤选项卡重命名为“Advanced”(高级),其中现在包含“禁用皮肤”和纹理字段。
- 添加了“移动到”动作,可将 NPC 发送至指定位置、玩家、其所有者或家。
- 添加了“移动到并等待”动作,仅在抵达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时时间和可选的传送功能。
- 添加了范围为 0 到 100 的“不透明度”属性,使身体、盔甲和手持物品逐渐淡入淡出。
- 添加了“设置不透明度”动作,可将 NPC 变为幽灵或完全隐藏。
- 添加了“灯笼幽灵”预设,这是一个在正方形路径上行走、在每个角落都有短线的幽灵。
- 添加了对移动动作和 NPC 不透明度的 API 访问权限。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,可在应用前预览输入纹理下的 NPC 效果。
7.7.7
- 通过保留 64x64 皮肤的透明度(Fresh Moves 需要其眼部使用),修复了问题 #821。此前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
- 通过让村民和流浪商人 NPC 也执行交易动作,修复了问题 #818。
- 修复了包含多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后图像而非原始下载图像的问题。
- 修复了“执行限制”条件中未翻译的时间间隔名称(如
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_npc render texture命令,为 Easy Model NPC 添加了每个模型槽位的纹理覆盖功能。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 添加了对 Easy Model NPC 的动画变体、纹理槽位和纹理的 API 访问权限。
7.6.0
- 修复了重复实体数据跟踪器 ID 导致的模组冲突错误提示不明确的问题。
- 修复了在配置和对话界面中,第三方血条渲染在 NPC 预览上方的问题。
- 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而非其模型尺寸的问题。
- 修复了
/easy_npc命令在服务器上完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”(Set Pose)操作的姿势列表绘制在其输入字段上的问题。
- 修复了动作编辑器中未翻译的“循环”(Loop)、“当前之后”(After current)和“动作数据类型”(Action Data Type)标签。
- 修复了“几率”(Chance)条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕边缘而未自动换行的问题。
- 修复了“消息”(Message)操作中对齐错误的帮助图标和文本按钮。
- 修复了“设置姿势”(Set Pose)、“播放动画”(Play Animation)和“停止动画”(Stop Animation)操作的更改无法保存的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议逻辑:优先列出准星指向的 NPC,且仅列出用户无权限的其他 NPC。
- 更改了预设导出逻辑:仅存储与新 NPC 不同的部分,不包含位置或所有者信息。
- 更改了没有目标或动作的预设逻辑:回退到其 NPC 类型的默认值。
- 更改了无玩家参与的事件(如“生成时”或“击杀时”)的逻辑:检查其条件。如果其中的动作包含基于玩家的條件(例如记分板或物品),则不再执行。
- 更改了基于时间的动作逻辑:当所有者附近时,将所有者选为
@initiator。 - 更改了气泡显示时间:根据文本长度,从 5 秒到 18 秒不等。
- 更改了“设置姿势”(Set Pose)操作:仅在“自定义”(custom)姿势条目时显示其输入字段。
- 新增了五个固定间隔的基于时间的动作,频率从约每 1 秒到约每 15 分钟。
- 新增了“消息”(Message)操作:支持聊天、系统消息和气泡文本,无需命令。
- 为“消息”(Message)操作添加了文本变体、发送者名称、接收者和翻译键。
- 新增了气泡图形资源
easy_npc:textures/gui/speech_bubble.png,供资源包使用。 - 新增了百分比形式的“几率”(Chance)条件和用于所有者/阵营的“关系”(Relationship)条件。
- 新增了生成、所有者登录、状态变化、白天/夜晚、天气以及缺失的“交易时”(On Trade)事件。
- 新增了每种 NPC 类型的基础预设,位于
easy_npc:api/preset/base/下,可用作父预设。 - 新增了“流浪同伴”(Wandering Companion)预设:一个由基于时间的消息构成的健谈 NPC。
- 新增了动作注册表、动作处理器、预设验证器以及更丰富的模组事件数据。
- 为
/easy_npc命令的所有 NPC 建议添加了工具提示,显示名称、类型和距离。 - 改进了 NPC 建议功能:无需输入即可出现,并容忍单格偏差。
7.5.0
- 修复了 NPC 的家位置始终显示为未设置的问题,这会导致配置界面中的“家”选项被隐藏、保存时被跳过,并导致“返回家”和“在家附近闲逛”功能失效。
- 修复了从预设、预设浏览器或重生生成的 NPC 永远无法获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出该预设的世界的家位置,而不是使用其出生位置的问题。
- 修复了在 Easy NPC Wand 高亮时,NPC 在配置、皮肤和预设界面中显示为带有阴影的白色剪影的问题。
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非按物种共享),修复了 #814。
- 通过允许“返回家”在任何距离生效(而不仅仅是在家附近),修复了 #813。
- 通过在每次会话中检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包中的 Cobblemon 方面(而非仅限于“shiny”和“female”),修复了 #810。
- 修复了当具有“Tempt”(诱惑)目标的 NPC 更新其目标时服务器崩溃的问题。
- 修复了 Allay、Vex 和 Ghast 等飞行类 NPC 在地面上移动而不是飞行的问题。
- 修复了包含重复项或特殊字符的对话、按钮、预设、姿势和纹理名称的问题。
- 修复了专用服务器上条件不可编辑以及未翻译的条件文本的问题。
- 修复了 Easy Model Entities NPC 不转头以及模型列表忽略
/reload命令的问题。 - 修复了新建 NPC 时出现“Legacy Easy NPC Data”(旧版 Easy NPC 数据)警告的问题。
- 修复了缺少对旧版 64x32 皮肤的透明度修正,导致图层伪影显示的问题。
- 修复了在查询玩家名称时玩家皮肤界面短暂冻结的问题。
- 修复了“重置注视...”目标标签在某些语言中被错误显示为“Reset loot at...”(重置战利品于...)的问题。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在被重新生成后丢失所有者(在消失之后)的问题。
- 修复了当提供目标的模组在启动时缺失,导致 NPC 的目标被删除的问题。
- 修复了当目标实体缺失时,目标被永久关闭的问题。
- 修复了导入没有存储 ID 的预设时,会生成一个没有所有者和家的 NPC 的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保留旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标可以被存储但从未执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画问题。
- 修复了 Forge 从不运行其服务器启动步骤的问题,这导致整个会话期间 NPC 追踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发运行在不包含任何 mixins 的情况下启动的问题,这会禁用原版实体调整并在生成 Fox NPC 时导致崩溃。
- 将移动目标改为固定顺序:逃跑、跟随、回家,然后是闲逛。因此,具有多个移动目标的 NPC 行为可能与之前不同。
- 将数据包预设路径更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 更改预设浏览器以始终按相同顺序列出其条目。
- 将所需的 Easy Model Entities 版本更改为 1.7.0,浮动模型现在默认悬浮。
- 移除了实验性的用户定义 NPC;不再读取或创建额外的配置文件。
- 移除了未使用的
SERVER_SKIN皮肤类型。 - 添加了新的 gametest 结构以支持 1.21.11 及更高版本的 gametest。
- 在玩家皮肤屏幕的每个条目中添加了一个重新加载按钮,以便再次获取单个皮肤。
- 每当移除 NPC 时,在日志中添加原因,以便追溯意外的消失。
- 为
/easy_npc render set species添加了建议。 - 添加了对其他模组预设的支持,这些预设不再必须使用
easy_npc命名空间。 - 添加了预设可见性设置,可将预设从预设浏览器和 NPC 界面中隐藏。
- 在跟随目标中添加了传送距离和休息点偏移量。
- 在“跟随物品”目标中添加了物品标签、“可被吓到”选项和“仅在无主状态下”选项。
- 在注视目标中添加了物品字段,以便 NPC 可以注视选定的掉落物品。
- 为每个 NPC 添加了标识符,以便模组可以找到其自己的 NPC。
- 添加了当其所有者登录时重新生成 NPC 的选项。
- 添加了带有数值、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 添加了“导航”和“悬浮高度”设置,用于在任何 NPC 的地面行走和飞行模式之间切换。
- 添加了父预设引用,使预设可以基于另一个预设构建并仅覆盖更改。
- 添加了状态驱动的“Forge Keeper”预设。
- 为其他模组添加了自定义条件和对话、动作及状态事件。
- 添加了“远距离”作为距离动作,在 32 格距离触发。
- 为 NeoForge 添加了游戏测试(此前没有),并恢复了在更新至 1.21.11 过程中丢弃的刷怪蛋、对话界面、数据隔离和冒烟测试。
- 为每个配置和编辑器界面添加了游戏测试,涵盖所有三种模组加载器。
- 为家位置添加了游戏测试,涵盖出生默认值、存储值和重新加载。
- 改进了模型名称解析,此前会将以 "_shiny" 结尾的物种误认为是变体。
- 改进了对飞行 NPC 的跟随,现在在没有空中路径时会直接转向。
- 改进了浮动 Easy Model Entities 模型,现在会上下浮动。
- 通过为预设、自有目标和目标配置提供 API,改进第三方支持。
7.4.0
- 修复了 #807,不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805,改为同时评估所有可见性设置,而不是在遇到第一个时停止。
- 修复了 #804,为 Doppler NPC 保留自定义名称,以便基于名称的纹理和命名牌能正确显示。
- 修复了 #803,调整资产以符合典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测逻辑,之前会将日出计为夜晚、日落计为白天。
- 修复了下界(Nether)和末地(End)中的可见性问题,之前错误地使用了主世界时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一个断言失败时才会报错的问题,这会导致后续的错误被隐藏。
- 修复了“骑乘”马匹皮肤变体无法显示马鞍的问题。
- 更改了“仅对主人可见”和“仅对队伍可见”设置,使其也遵循昼夜和游戏模式的逻辑。
- 更改了唤魔者、幻术师和卫道士变体的逻辑:如果没有“交叉双臂”特征,则保持手臂下垂。
- 添加了“保卫阵营”目标,用于攻击伤害附近阵营成员或玩家的实体。
- 当阵营成员互相战斗且阵营保持中立时,添加了一条系统消息。
- 为灾厄村民添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置界面中添加了昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升了可见性检查的性能。
- 通过用默认值补全缺失部分,改进了旧版本版本的显示属性。
- 改进了攻击目标界面,在未设置时禁用“保护主人”和“保卫阵营”选项。
7.3.0
- 改进了皮肤变体,将其数据作为类型化字段携带,而不是解析变体名称。
- 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
- 使用共享的
EnumUtils辅助类进行get(String)查找,减少了重复的枚举代码。 - 优化了村民职业和类型的查找,改为直接使用注册表键而非扫描。
- 通过在构造时缓存标签名称、ID 和键,优化了枚举名称查找。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.2.0
- 修复了 #801,通过使用 NPC、对话框和动作 UUID 的组合来避免动作跟踪和执行限制方面的冲突。
7.1.1
- 修复了 #800,采用惰性加载实体类型。
- 修复了 #799,修复了边缘情况,并添加了更多文档和更好的日志消息。
- 修复了 #798,将控制台、命令和命令方块视为受信任的命令来源。
- 修复了一个严重的单人/LAN 问题,此前客户端和服务器的 NPC 共享同一个注册表。
- 修复了配置菜单处理中的内存泄漏,并添加了超时和断开连接清理机制。
- 修复了多个 NPC 同时请求相同皮肤时的重复下载问题。
- 修复了在发生错误后皮肤查找失败的问题,防止缓慢的服务器导致游戏冻结。
- 修复了 URL 皮肤屏幕在检查远程图片时导致游戏冻结的问题;现在该检查在后台运行。
- 添加了新的世界生成器方块,可限制整个世界中(所有维度)的 NPC 预设;现有的组生成器目前按维度计数,因此远处的 NPC 不再会阻止它。
- 增强了远程皮肤下载的安全性,设置了严格的尺寸限制和安全重定向处理,以防止过大或恶意的皮肤 URL 导致崩溃;添加了可选的
blockPrivateAddresses设置。 - 通过将实体和玩家加载事件仅发送给实际使用它们的 NPC(按维度分组),改善了服务器性能。
7.0.0
- 修复了 #794,使用预期类型进行 NPC 渲染。
- 修复了 #791,添加了流浪商人 NPC 类型。
- 修复了 #788,将 AI 安全保护扩展至 Epic Fight 模组和原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)。
- 修复了 #787、#531、#237 和 #184,添加了阵营系统,包含
/easy_npc faction命令、单个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复了 #787、#771 和 #572,添加了新的
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。 - 修复了 #786,为 Cobblemon NPC 添加了性别和闪光模型变体,可在模型选择中通过输入
female或shiny进行搜索。 - 修复了无敌 NPC 之间的阵营战斗问题,添加了新的
Attackable by Factions(可被阵营攻击)战斗属性。 - 修复了体型过大的物种的 Cobblemon 模型选择预览,改为使用 Cobblemon 自身的配置文件比例进行缩放,而不是碰撞箱高度。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 修复了自定义皮肤重新加载的问题,改为按每个皮肤模型加载和清除纹理缓存,而不是始终重建完整的自定义纹理缓存。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)工作,为各自的攻击者群体打开一个特定的漏洞。 - 通过拆分大型处理器为更小的专注组件(导入、导出和功能特定组件),改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和阵营编辑器界面,用于创建、着色和删除阵营,以及管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性选项卡,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验过程中保留数据组件,修复了 #782、#636 和 #622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对属性滑块进行限制以应对其他模组带来的极端值,修复了 #767。
- 为带有动作和条件的 NPC 添加了自定义数据物品匹配功能,修复了 #754。
- 修复了纹理管理器在错误线程运行可能导致 >= 1.21.x 版本崩溃和死锁的问题。
- 修复了动作条件中处理空 UUID 的问题。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 硬币、钥匙和红令牌作为带有动作和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红令牌物品数据。 - 添加了针对其他模组极端值的属性防护机制。
- 将高生命值 NPC 的回退最大生命值从 1024 增加到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃问题。
- 通过在基础刻期间和打开交易界面之前检查定时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含时间和天气条件。
6.23.0
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和类人皮肤)的物品渲染问题 #770。
- 修复了 NPC 无法可靠地打开或关闭门的门循环问题 #769。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的颜色选择器弹出窗口以及手动 RGB/十六进制值,修复了 #709。
- 通过保留现有名称颜色,修复了未指定颜色时重命名会重置 NPC 名称颜色的问题。
- 改进了门移动属性,使得当“开门”或“关门”处于活动状态时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以提高对依赖特定玩家数据的第三方模组和插件的兼容性,修复了 #766。
- 通过添加实体健康、NPC 健康条件以及示例 NPC 预设
Grukk, the Sparring Post来演示如何使用这些条件,修复了 #764。 - 确保现在记录了对话框按钮的执行限制,修复了 #763。
- 提供了名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(如 PoiCompetitorScan / job_site)因第三方村民 AI 读取未注册的脑记忆而导致的崩溃问题 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,为 #760 和 #644 做准备。
- 通过添加条件对话框打开支持/命令,以便更好地控制向玩家显示对话框的时机,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 添加了枪标签中的额外枪支。
- 添加了新的“打开对话框(条件性)”动作,仅在满足条件时打开指定名称的对话框,而现有的“打开对话框”动作则无条件打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体健康和 NPC 健康条件。
- 为了与其他 NPC 保持一致,使 Piglin、Piglin Brute 和 Zombified Piglin NPC 具有无敌特性。
- 添加了新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的劫掠者的物品附着问题。
- 修复了损坏的劫掠者弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在的模型部件的第三方 Mixin 相关的崩溃问题 #756。
- 通过降低日志详细程度并为自定义模型部件添加额外检查,修复了 log.info 垃圾信息问题。
- 改进了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品图层。
6.20.0
- 修复了第三方模组尝试访问不存在的 NPC 目标而导致的崩溃问题。
6.19.0
注意:此更新将对话框背景图像各边调整了 10x6 像素,如果您使用的是自定义对话框背景,可能需要相应进行调整。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过为对话框文本添加打字机效果支持,修复了 #683 和 #215。
- 通过允许对话框、对话框按钮和交互的条件设置,修复了 #690 和 #309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 重构了对话框背景图像,每边调整了 10x6 像素。
- 重构了对话框屏幕布局以适应新的背景尺寸并改善外观。
- 添加了对话框文本的打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话框条件和按钮状态相关的较小修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或移除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件以允许更复杂和动态的行为,修复了 #745。
- 通过为较长文本添加对话框按钮工具提示,修复了 #652。
- 通过添加命令值工具提示以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了库存中有物品的条件。
- 添加了手持物品条件,支持主手和副手。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以便对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以支持更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外工具提示,修复了 #738。
- 通过减少启动期间和游戏中的 log.info 消息,修复了详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项,修复了 #732。
- 通过在特定情况(如交易屏幕)下避免自动关闭,修复了 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 为对话框添加了头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0 (交易、玩家头颅、Epic Fight 和 QOL 更新)
- 如果客户端物种列表为空,则重新同步物种数据,修复了 #731。
- 通过改进 Epic Fight 集成并启用实验性功能,修复了 #730。
- 确保交易使用次数被正确存储,修复了 #729。
- 为玩家头颅添加了自定义头颅支持,修复了 #728。
- 显示剩余交易使用次数,并允许手动和自动重置,修复了 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持,修复了 #218 和 #132。
- 在基本模式和普通/高级交易模式之间切换时,修复了特定于交易的边缘情况。
- 通过工具提示显示完整文本来修复对话框按钮文本截断问题。
- 通过将动画状态与 Cobblemon Animation System 同步,修复了 Cobblemon 动画问题。
- 添加了每笔交易特定的操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕上添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例商人。
- 清理测试文件。
6.14.0
- 在更改值时确保更改同步到客户端,修复了 #727。
- 通过为特定命令添加额外白名单,修复了 #726。
- 通过添加基本的 Cobblemon 支持(配合 Cobblemon NPC),修复了 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕,修复了对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算,修复了 x 和 z 根旋转问题。
- 通过自定义 NPC 类型和模型,添加了基本的 Cobblemon 支持用于测试。
6.13.0 (安全和权限更新)
注意:此更新包括针对多人游戏环境的更好的安全检查和管理权限。它允许执行服务器命令,如果被恶意使用,这些命令可能会带来潜在危险。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有的 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查和管理权限系统,修复了 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例,修复了 #469、#311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景的双重渲染问题。
- 通过调整边界框,修复了 Ghast 和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多人游戏环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、定制性和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了特定于配置 UI 的组件,并将它们从核心模组中移除。
- 移除了重复的精灵图集。
- 为可能的 Luck Perms 集成做准备,例如 #712。
- 进行了常规代码清理和优化,涉及配置屏幕渲染和资源方面。
6.12.0
- 通过基于原版模型添加对自定义模型部分的额外检查,修复了 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息,减少了日志冗长度,修复了 #713。
- 通过减少过大的启动/配置日志输出,修复了 #711。
- 添加了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加了模型部分名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构,改进了 RenderEntityTypeSupportConfig,以提高性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改善可恢复交易数据的向后兼容解析,修复了 #710。
6.11.0
- 修复了 #703,解决了新的自定义层级系统与手部渲染之间的渲染问题。
- 通过为无效交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端,修复了头部追踪问题。
- 优化了 CustomLookAtPlayerGoal,以更好地处理边缘情况并减少抖动。
- 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 使用新设计更新了标志。
6.10.0
- 通过对第三方实体创建添加 try-catch 块,修复了 #698。
- 通过在切换至
DEFAULT原版姿态时清除模型部分的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过将根旋转轴心修正为使用实际包围盒高度而非 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺少针对玩家的刷新以及针对离线目标的重试。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转的功能;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加用于逃离玩家、村民、怪物等的额外逃跑目标,修复了 #597。
- 修复了姿态加载问题,改为直接从模组资源读取,而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于从外部模组控制 NPC 姿态并管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行回调操作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引。
- 将 EasyNPCItemAttachmentLayer 添加到各种实体渲染器中。
- 添加了专用的
Flee Objective(逃跑目标)配置选项卡,包含用于躲避苦力怕、怪物、生物、玩家、村民和阳光的目標。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM目标,使 NPC 能够通过资源位置(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看所有者的目标。 - 在
SynchedDataIndex中添加了persistent标志,以便瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 消费者在
SlimeBase中添加了可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET并将CAT_PURR映射到猫 NPC,以增加驯服环境声音的变化。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本强制解决版本不匹配问题,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动,修复了 #665。
- 通过添加禁用跟随鼠标光标的选项以便于摆姿势,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过在使用 NPC 法杖并潜行靠近 NPC 时将根旋转到面向玩家的方向来实现快速旋转,修复了 #661。
- 通过在交互处理器中添加对移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过在交互处理器中添加对预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整包围盒和眼睛高度的计算,修复了史莱姆和恶魂的碰撞箱和名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置。
6.8.2
- 通过扩展
SafeMerchantData以包含 notifyTrade 来避免崩溃,修复了 #677。 - 添加了基于玩家互动和动作提升 NPC 等级的进度数据支持。
- 添加了全局 NPC 跟踪系统,以便在世界范围内更好地管理和调试 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原版模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而不是自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马刷怪蛋模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便与其他模组和自定义模型更容易集成。
- 重构了内部数据处理和注册,以提高可维护性和未来的改进空间。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现 Wolf Leg Animations 在 setupAnim 方法中,修复了 #650。
- 通过修正 canBeHitByProjectiles 的翻译,修复了 #648。
- 添加了
allowBypassInvulnerability配置选项,允许/禁止 NPC 绕过无敌状态,修复了 #645。 - 修复了删除按钮在小宽度下仍显示标签的问题。
- 修复了上下按钮在某些情况下定位不正确的问题。
- 修复了对话框和配置 UI 中出现名称标签的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了 Cat NPC 和 Wolf NPC 的所有者数据同步不正确的问题。
- 添加了预设浏览器,以便更轻松地选择常见的 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了刷怪笼系统以使用新的预设格式,以提高可维护性和未来改进空间。
6.6.2
- 通过重写缩放系统,修复了 #643。
- 修复了重启/重载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称显示。
- 添加了基于团队的名称标签可见性支持,遵循原版 Team 机制。
6.6.1
- 通过重构显示属性的内部数据处理,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止同一纹理的多次同时下载。
- 修复了远程图像验证的异常处理,防止无效 URL 导致崩溃。
- 修复了 NPC 加载期间出现的
defineId called for:警告消息。 - 通过多级防御和速率限制重构了纹理加载架构。
- 重构了实体数据注册逻辑,以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 的线程安全会话服务器防垃圾信息保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 通过 2 线程池和 500ms 速率限制改进了纹理加载。
- 通过针对 IIOException 和 FileNotFoundException 的具体捕获块改进了异常处理。
6.5.2
- 修复了 Villager 职业和工作皮肤问题。
- 通过添加 Gradle 依赖缓存改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了 kill 命令对 NPC 无效的问题。
- 修复了纹理重载保护阻止缓存在被驱逐后重新加载的问题。
- 修复了远程图像验证器中 WebP 验证的 bug(缺少返回语句)。
- 重构了纹理处理逻辑,以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了鸡、猪和狼的缺失变体纹理。
- 添加了针对纹理处理的额外单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实现裁剪区域,修复了 #627,以更好地与其他模组兼容。
- 修复了 #625,在使用旋转或移动的模型部件时出现的不流畅动画问题。
- 修复了使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 修复了不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade进行的详细调查和修复建议,解决了 #626。
6.4.0
- 通过改进对话框数据验证和错误处理,修复了 #626。
- 通过重构渲染数据和渲染处理,修复了 #623。
- 通过确保自定义数据正确保存和加载,修复了 #622。
- 修复了打开对话框动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将它们从核心模组中移除。
- 通过过滤发送给客户端的对话框数据,修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了某些对话框数据字段缺失默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框和记分板动作添加了条件支持。
- 为对话框添加了频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段改进了对话框按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的翻译缺失问题。
- 添加了记分板动作类型,用于增加、减少或设置记分板数值。
- 添加了
@score(...)NPC 宏,以在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了自旋按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包而导致的容器和菜单同步问题。
- 修复了在某些情况下关闭按钮无效的问题。
- 修复了在屏幕切换时鼠标光标跳动的问题。
- 修复了翻译文件,并删除了重复和已弃用的条目。
- 将 Easy NPC 法杖移至现有的核心物品标签页,而非创建新的标签页。
- 为不同的模型部件(尾巴除外)添加了猫姿势支持。
- 通过在不必要时禁用发光效果,提升了 EasyNPCWand 发光效果的性能。
- 通过排除非生物实体(如展示框、制造者、投掷物和刷怪笼),改进了自定义实体检测。
- 改进了猫变种的处理方式。
6.1.1
- 通过检查物品是否在手中装备,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 通过强制同步特定模型的帽子和头部图层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本中的猫变种处理。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫渲染器问题。 - 修复了位置、缩放和旋转预览功能。
- 修复了精灵模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型支持和性能。
- 改进了用于玩家皮肤的玩家到 UUID 映射的缓存机制。
- 将更改模型命令和逻辑限制为仅限 Doppler NPCs。
- 添加了 renderEntityRaw 方法以按原样渲染 NPC。
6.1.0 ✨
这是一个重大更新。请在更新前备份你的世界和 NPC 数据。此版本包含许多改进、优化和内部更改,与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要手动调整。
- 内部数据格式和一些行为已被重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,同时包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级运行时和 NPC 逻辑,依赖项极少。旨在用于服务器、整合包和开发者环境。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可安装在需要该界面的客户端上。
🎯 为何进行此更改?
- 允许服务器和整合包仅在服务器端部署 Core 模组,从而实现更精简的设置。
- 当不需要在所有地方使用 UI 时,减少内存占用和加载时间。
- 通过分离 UI 和核心逻辑,加快开发和测试速度。
Easy NPC: Core (1.21.1) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 更多信息请查阅 升级指南。
7.20.0
- 修复了缺少皮肤 ID 的 NPC 导致的崩溃,感谢
voidsipp在 #866 中提供的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了当其他模组中断释放过程时,站在玩家肩膀上的 NPC 会丢失的问题。
- 修复了 NPC 因闪电、溺水、冻结或僵尸攻击而变成原版生物的问题。
- 修复了生成的 NPC 随机获得幼体、骑乘者、装备或效果,并丢失其预设装备的问题。
- 修复了没有启用“拾取物品”选项的 NPC(如村民、猪灵和狐狸)也会拾取物品的问题。
- 修复了骷髅 NPC 除了配置的攻击方式外,还使用原版的弓和近战攻击的问题。
- 修复了末影人 NPC 的水伤害与传送问题,以及史莱姆 NPC 的分身和接触伤害问题。
- 修复了狐狸 NPC 食用手持食物、鸡 NPC 下蛋以及猫 NPC 丢失原版姿势的问题。
- 修复了苦力怕 NPC 被闪电充能,以及反弹的火球瞬间杀死恶魂 NPC 的问题。
- 改动了敌对生物搜索并攻击 NPC 时的服务器性能。
7.19.0
- 通过防止一个 NPC 隐藏的皮肤层在其他同类 NPC 上生效,修复了 #865。
- 修复了类僵尸和末影人 NPC 的自定义姿势被手臂动画覆盖的问题。
- 修复了具有职业的村民和僵尸村民 NPC 重新显示隐藏的头部的问題。
- 修复了在“DEFAULT”或“NONE”动画状态下行走时,隐藏的身体部位重新显示的问题。
- 修复了僵尸猪灵 NPC 在阳光下燃烧的问题。
- 修复了“锁定身体”标签在旋转屏幕中外溢的问题。
- 修复了投射物“物品 ID”字段遮挡物品 ID 开头的问题。
- 修复了兽人战士的英文名称拼写错误(误拼为 "Ork Warrior")。
- 修复了原版姿势按钮在每个游戏启动后改变顺序的问题。
7.18.0
- 通过防止 NPC 在使用 LetMeDespawn 等模组加载时丢失,修复了 #862。
- 修复了拥有近战和远程攻击能力的 NPC 在持有弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标之间旋转,以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送到其他地方或切换维度后,Boss 血条仍停留在屏幕上的问题。
- 修复了创造模式下对 NPC 使用快捷选取(Pick Block)未掉落其刷怪蛋的问题。
- 修复了“记分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 的金重弩,并添加了皮革和铜制版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示,以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英文 Bogged 名称以及原始显示的“主手”/“副手”键名。
- 更改了生存模式下生成 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
- 通过支持 AttributeFix 等模组设置的更高属性上限,修复了 #858。 服务端和客户端均需安装 AttributeFix 或类似模组;护甲值上限固定为 100。
- 通过在没有更改时不再重写 NPC 文件,修复了 #857。
- 通过在一个“打开对话(条件)”的条件不满足时尝试下一个,修复了 #854。
- 修复了动作和对话中的“概率”条件被掷骰两次的情况,这降低了实际概率。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root以及name clear保留名称显示的问题。 - 修复了死亡、骑乘或拴绳的 NPC 出现在肩膀上,以及断开连接时肩膀渲染泄漏的问题。
- 修复了隐藏头部保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(周围光),并将其限制在 0 到 15 之间。 保持默认开关的现有 NPC 也会受到影响;设置为 7 可保留旧外观。
- 更改了“关闭对话”和“回退”动作的执行时机,使其在没有打开条件对话时运行。
- 更改了拥有传送距离的“跟随主人”NPC 的行为,使其跟随主人进入其他维度。
- 更改了服务器停止时的行为,等待最多 2 分钟以完成仍在写入的 NPC 文件。
- 更改了闲置 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 会迷路的问题。
- 修复了“坐在肩膀上”的 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命令设置。 - 更新了测试通过的 NeoForge 版本至 21.1.262,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,使预设导入保持静默。 - 修复了 #380:将 NPC 数量限制应用于默认刷怪箱。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左手持武器的 NPC。
- 修复了 #851:按对话框锁定按钮,而不是跨具有相同标签的对话框锁定。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少其 Epic Fight 生物补丁的问题。
- 更改了要求:客户端和服务端需使用相同的模组版本,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
- 修复了对话框按钮名称中的颜色和格式标签显示为纯文本的问题。
- 修复了编辑器中的按钮预览将小写名称显示为原始翻译键的问题。
- 修复了非创造模式下,NPC 的所有者无法使用“移动 EasyNPC”物品的問題。
- 修复了即使无法更改所有者,
/easy_npc owner set仍报告成功的问题。 - 修复了当 URL 或玩家皮肤屏幕显示皮肤下载错误时游戏崩溃的问题。
- 修复了预设浏览器在向下滚动列表后搜索无结果的问题。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
- 在对话框按钮名称中添加了
@initiator、@npc和@score()支持以修复 #841。 - 添加了使用 Client Runtime Interface Toolkit 的自动客户端测试。
- 进行了更大规模的核心重构和代码清理。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名称标签和对话气泡位于其身体内的问题。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致击中、点击和观察失败的问题。
- 修复了网络数据包中过大的名称、列表和 NPC 数据在无限制情况下被读取的问题。
- 修复了无效 NPC 位置、缩放、属性、名称和持续时间被应用的问题。
- 更改了精灵(Fairy)NPC 占用其模型的空间,使其可以碰撞并可被点击。
- 更改了骷髅、流浪者和泥怪(Bogged)NPC 为原版碰撞箱高度,它们之前略微偏矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并带有原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告替换 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载、泄露 NPC 并清除选择的问题。
- 修复了小窗口中预设列表排序、过滤器顺序和布局裁剪选项的问题。
- 修复了在没有位置信息的情况下执行
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”NPC 堆叠在同一位置的问题。
- 更改了“恢复”行为:当不允许时拒绝操作,而不是生成副本。
- 添加了排序、匹配计数、重新加载、自动关闭、NPC ID 以及预设和皮肤的提示框。
- 添加了带有限制、确认提示和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 修复了 #833,仅向魔杖持有者、所有者和管理员显示简易 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 时间戳的问题。
- 修复了所有者登录恢复时重复、反复恢复、复活或移动未加载的 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文本丢失文字并变得半透明的问题。
- 修复了翻译后的气泡和模组 API 文本中的文本格式化和宏解析问题。
- 添加了
minLightLevel参数,以确保在黑暗环境中气泡内容可读。
7.10.0
- 修复了 #829,允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体。
- 修复了渲染为蝙蝠、青蛙或监守者的 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 格,超出该范围则进行传送。
- 更改了“移动到”和“移回主页”:若三秒内无进展则放弃行动。
- 更改了“移动到”动作的超时机制:按真实游戏刻计算,此前运行时间过长一倍。
- 更改了新的“随机游泳”目标:其优先级低于跟随、逃跑和攻击目标。
- 更改了拥有 Easy Model Entities 模型的 NPC 的不透明度:由该模组本身应用。
- 更改了最低 Easy Model Entities 版本要求为 2.3.0,旧版本将禁用集成。
- 添加了 NPC 游泳高度的“水面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,每项耗时超过 250 毫秒时发出警告。
7.8.1
- 修复了 #827,使鱼类 NPC 在水中直立渲染,而非总是侧身翻滚。
- 修复了 #828,防止受损的 NPC 阻塞世界保存,现在它将回退到默认值。
- 修复了恢复的 NPC 拾取随机预设 ID 的问题,该 ID 每次保存都会变化。
- 更改了 NPC 数据:仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 将已处于目标位置的 NPC 的站立动作改为立即完成移动。
- 将“无”皮肤选项卡更改为“高级”,其中现在包含“禁用皮肤”和纹理字段。
- 添加了“移动到”动作,可将 NPC 发送到位、玩家、其所有者或其家中。
- 添加了“移动并等待”动作,仅在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时时间和可选的传送功能。
- 添加了从 0 到 100 的“不透明度”属性,使身体、护甲和手持物品一同淡入淡出。
- 添加了“设置不透明度”动作,可将 NPC 变为幽灵或完全隐藏。
- 添加了“灯笼幽灵”预设,这是一个在每个角落带有短线的方形行走幽灵。
- 添加了对移动动作和 NPC 不透明度的 API 访问权限。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,在应用前预览输入纹理下的 NPC。
7.7.7
- 通过保留 64x64 皮肤的透明度来修复 #821,Fresh Moves 需要此特性来显示眼睛。之前下载的皮肤需要在玩家皮肤屏幕中通过按钮重新加载。
- 通过让村民和流浪商人 NPC 也运行交易动作来修复 #818。
- 修复了具有多个文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后图像而非原始下载的问题。
- 修复了未翻译的“执行限制”条件中的间隔名称,如
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_npc render texture为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 添加了对 Easy Model NPC 的动画变体、纹理槽位和纹理的 API 访问权限。
7.6.0
- 修复了重复实体数据追踪器 ID 导致的模组冲突错误提示不明确的问题。
- 修复了在配置和对话界面中,第三方血条渲染在 NPC 预览图之上的问题。
- 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非模型尺寸的问题。
- 修复了
/easy_npc命令在服务器端完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入框上方的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺失提示文本的问题。
- 修复了长条件提示溢出编辑器屏幕而非自动换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐不正确的问题。
- 修复了无法保存对“设置姿势(Set Pose)”、“播放动画(Play Animation)”和“停止动画(Stop Animation)”动作的更改的问题。
- 修复了对话气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议逻辑:优先列出准星指向的 NPC,且仅列出没有权限的用户自己的 NPC。
- 更改了预设导出功能:仅存储与新 NPC 不同的部分,不包含位置和所有者信息。
- 更改了没有目标或动作的预设行为:回退到其 NPC 类型的默认值。
- 更改了没有玩家参与的事件(如“生成时”或“击杀时”)的行为:检查其条件。其中包含基于玩家的条件(例如记分板或物品)的动作不再执行。
- 更改了基于时间的动作逻辑:当所有者在附近时,将所有者选为
@initiator。 - 更改了对话气泡的可见时间:根据文本长度,从 5 秒增加到 18 秒。
- 更改了“设置姿势(Set Pose)”动作:仅在“自定义(custom)”姿势条目中显示其输入字段。
- 添加了基于时间的动作,共五个固定步骤,频率从每约 1 秒到每约 15 分钟不等。
- 添加了“消息(Message)”动作,支持聊天、系统消息和对话气泡文本,无需命令。
- 为“消息(Message)”动作添加了文本变体、发送者名称、接收者和翻译键。
- 添加了对话气泡图形资源
easy_npc:textures/gui/speech_bubble.png,供资源包使用。 - 添加了百分比形式的“几率(Chance)”条件以及针对所有者和阵营的“关系(Relationship)”条件。
- 添加了生成、所有者登录、状态变化、白天/夜晚、天气以及缺失的“交易时(On Trade)”事件。
- 在每个 NPC 类型下添加了基础预设
easy_npc:api/preset/base/,可用作父级预设。 - 添加了“流浪同伴(Wandering Companion)”预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的事件数据。
- 为
/easy_npc命令的所有 NPC 建议添加了工具提示,显示名称、类型和距离。 - 改进了 NPC 建议功能:无需输入即可显示,并容忍一个方块内的轻微偏差。
7.5.0
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非按物种共享),修复了 #814。
- 通过让“返回家园(Move back to Home)”在任何距离下生效(而不仅限于家园附近),修复了 #813。
- 通过在每次会话期间检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包的 Cobblemon 方面属性(而不仅仅是“闪亮 shiny”和“雌性 female”),修复了 #810。
- 修复了 NPC 在重生或导入预设后丢失所有者、家园和“无重力”设置的问题。
- 修复了目标保留已消失的目标,并在目标或模组消失时被关闭的问题。
- 修复了像 Allay、Vex 和 Ghast 这样的飞行 NPC 在地面移动而非飞行的问题。
- 修复了存在重复项或特殊字符的对话、按钮、预设、姿势和纹理名称导致的问题。
- 修复了专用服务器上条件不可编辑以及未翻译的条件文本问题。
- 修复了 Easy Model Entities 的 NPC 不转头以及模型列表忽略
/reload命令的问题。 - 修复了新创建的 NPC 出现“旧版 Easy NPC 数据(Legacy Easy NPC Data)”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正,从而显示图层伪影的问题。
- 修复了查询玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了某些语言中“重置注视 ...(Reset look at ...)”目标标签误读为“重置战利品 ...(Reset loot at ...)”的问题。
- 修复了因开发辅助模组导致 Fabric 游戏测试启动崩溃的问题。
- 修复了从未在 Fabric 上运行的 NPC 数据隔离和交易持久性游戏测试问题。
- 修复了 Doppler NPC 和第三方模型的行走动画问题。
- 更改了移动目标的顺序为固定顺序:逃跑、跟随、回家,然后闲逛。因此,具有多个移动目标的 NPC 行为可能与以前不同。
- 更改了数据包预设路径至
easy_npc/preset/,旧文件夹仍可使用,但仅限用于 easy_npc。 - 更改了 Easy Model Entities 的最低要求版本为 1.7.0,浮动模型现在默认悬停。
- 移除了实验性的用户自定义 NPC 和未使用的
SERVER_SKIN皮肤类型。 - 添加了带有数值、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 添加了“导航(Navigation)”和“悬停高度(Hover height)”设置,用于切换任意 NPC 在地面和飞行模式之间。
- 添加了父级预设、来自其他模组的预设、预设可见性以及“锻造守护者(Forge Keeper)”预设。
- 为其他模组添加了自定义条件、事件、NPC 标识符以及更多目标选项。
- 添加了 32 格距离外的“远距离(On Far Distance)”事件,以及当所有者登录时重新生成 NPC 的选项。
- 改进了飞行导航和第三方支持,提供了用于预设和自定义目标的 API。
7.4.0
- 修复 #807:不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复 #805:改为同时评估所有可见性设置,而不是在遇到第一个时停止。
- 修复 #804:为 Doppler NPC 保留自定义名称,以用于基于名称的纹理和命名牌。
- 修复 #803:调整资源以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复昼夜检测逻辑错误(日出被计为夜晚,日落被计为白天)。
- 修复下界与末地的可见性逻辑,其曾错误地使用主世界时间。
- 修复时间与游戏模式可见性复选框显示顺序随机的问题。
- 修复游戏测试仅在首个断言失败时才会报错,从而隐藏了后续失败的问题。
- 修复“骑乘”马匹皮肤变体从未显示马鞍的问题。
- 更改“仅对所有者可见”和“仅对队伍可见”设置,使其也遵循昼夜和游戏模式规则。
- 更改唤魔者、幻影者和卫道士变体:若无“交叉双臂”姿态,则保持手臂下垂。
- 新增“保卫阵营”目标:攻击伤害附近阵营成员或玩家的实体。
- 新增阵营成员互相战斗时的系统消息,表明该阵营不介入冲突。
- 为灾厄村民添加头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置屏幕中新增昼夜预览功能。
- 新增针对可见性属性及阵营防御功能的单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升可见性检查性能。
- 通过补全默认值,完善旧版本中的显示属性。
- 改善目标屏幕交互:当未设置时禁用“保护所有者”和“保卫阵营”选项。
7.3.0
- 改进皮肤变体:将其数据作为类型化字段传递,而非解析变体名称。
- 在共享常量中集中管理 Cobblemon 模组 ID 和默认模型。
- 通过共享
EnumUtils辅助类处理get(String)查找,减少重复的枚举代码。 - 优化村民职业和类型的查找逻辑,改用直接注册表键而非扫描方式。
- 通过在构造时缓存标签名称、ID 和键,优化枚举名称查找性能。
- 新增针对皮肤变体、村民解析及枚举辅助类的单元测试和游戏测试。
7.2.0
- 修复 #801:使用组合 UUID 用于 NPC、对话框和操作,以避免在行动跟踪和执行限制方面发生冲突。
7.1.1
- 修复 #800:采用延迟加载实体类型。
- 修复 #799:修复边界情况,并增加额外文档及更佳的日志消息。
- 修复 #798:将控制台、命令方块视为可信的命令来源。
- 修复单人/局域网模式下的严重问题:客户端和服务端 NPC 曾共享同一注册表。
- 修复配置菜单处理中的内存泄漏,并添加超时断开连接清理机制。
- 修复多个 NPC 同时请求相同皮肤导致的重复下载问题。
- 修复出错后皮肤查找失败,导致慢速服务器冻结游戏的问题。
- 修复 URL 皮肤屏幕在检查远程图片时冻结游戏;现改为后台运行检查。
- 新增世界生成器方块,可限制 NPC 预设在整个世界(所有维度)的使用范围;现有的群组生成器现按维度计数,因此远处的 NPC 不再阻碍其生成。
- 强化远程皮肤下载安全性:严格限制大小并安全处理重定向,防止因过大或恶意皮肤 URL 导致崩溃;新增可选的
blockPrivateAddresses设置。 - 通过仅向实际使用它们的 NPC 发送实体和玩家加载事件(按维度分组),提升服务端性能。
7.0.0
- 修复 #791:新增流浪商人 NPC 类型。
- 修复 #788:将 AI 安全措施扩展至 Epic Fight 模组及原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)。
- 修复 #787、#531、#237 和 #184:新增阵营系统,包含
/easy_npc faction命令、每个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复 #787、#771 和 #572:新增
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。 - 修复 #786:为 Cobblepon NPCs 新增性别和闪光模型变体,可在模型选择中通过输入
female或shiny进行搜索。 - 修复无敌 NPC 之间的阵营战斗问题:新增
Attackable by Factions(可被阵营攻击)战斗属性。 - 修复大型物种的 Cobblemon 模型选择预览:改为使用 Cobblemon 自身的配置文件比例进行缩放,而非基于碰撞箱高度。
- 修复阵营管理边界情况:验证阵营名称、排序阵营列表,并在阵营颜色或删除变更后刷新已加载 NPC 的记分板分配。
- 修复自定义皮肤重载问题:改为按皮肤模型加载并清除纹理缓存,而非始终重建完整的自定义纹理缓存。
- 改进
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)生效,各自为其对应的攻击者群体打开特定的攻击漏洞。 - 改进预设命令和网络处理:将大型处理器拆分为较小的导入、导出及特定功能组件。
- 新增 Easy Model Entities 支持。
- 新增阵营管理器与阵营编辑器界面,用于创建、着色和删除阵营,并管理敌对关系;受新的
FACTION_MANAGEMENT安全特性保护。 - 新增
Misc(杂项)属性选项卡,作为 NPC 阵营分配的主页。 - 新增可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 新增针对阵营、目标目标及 Cobblemon 模型变体的额外单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636 和 #622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对来自其他模组的极端值限制属性滑块,修复了 #767。
- 通过为具有动作和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了在 >= 1.21.x 版本中,纹理管理器运行在错误线程可能导致崩溃和死锁的问题。
- 修复了动作条件中的空 UUID 处理问题。
- 修复了动作的执行限制重置问题。
- 添加了纹理注册队列,以避免在同一刻进行多次同时下载。
- 将 NPC 硬币、钥匙和红令牌作为具有动作和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红令牌物品数据。 - 添加了对抗来自其他模组极端值的属性保护机制。
- 将高生命值 NPC 的回退最大生命值从 1024 增加到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基础刻检查限时交易重置并在打开交易屏幕之前进行检查,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含昼夜时间和天气条件。
6.23.0
- 通过调整纹理重试以应对 403 和 404 错误并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的物品渲染问题 #770。
- 修复了 NPC 无法可靠地打开或关闭门的门循环问题 #769。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE),分别锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称提供支持 32 种颜色且/或手动 RGB/hex 值的颜色选择器弹出窗口,修复了 #709。
- 修复了在未指定颜色的情况下重命名时重置 NPC 名称颜色的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,当“打开门”或“关闭门”处于活动状态时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以提高对依赖特定玩家数据的第三方模组和插件的兼容性,修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及使用这些条件的示例 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话框按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)上第三方村民 AI 读取未注册的大脑记忆导致的崩溃 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做准备。
- 通过添加条件对话框打开支持/命令,以便更好地控制何时向玩家显示对话框,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了大脑 AI,并注册了完整的基础大脑记忆集。
- 为 #757 添加了枪支标签中的额外枪支。
- 添加了新的“打开对话框(条件)”动作,仅在满足其条件时打开命名的对话框,而现有的“打开对话框”动作则无条件打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的无敌特性。
- 添加了新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,因为这在主题上更合适(之前在能力屏幕上)。
6.21.0
- 修复了持交叉手臂姿势的劫掠者的物品附着问题。
- 修复了损坏的劫掠者弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃 #756。
- 修复了与尝试访问不存在的模型部分的第三方 mixins 相关的崩溃 #756。
- 通过减少日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 垃圾消息问题。
- 改进了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组试图访问不存在的 NPC 目标相关的崩溃。
6.19.0
注意:此更新调整了对话框背景图像 10x6 像素,如果您使用的是自定义背景,可能需要调整它们。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过为对话框文本添加打字机效果支持,修复了 #683 和 #215。
- 通过允许对话框、对话框按钮和交互的条件,修复了 #690 和 #309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 重构了对话框背景图像,每侧调整了 10x6 像素。
- 重构了对话框屏幕布局,以更好地适应新的背景尺寸并改善外观。
- 添加了对话框文本的打字机效果和客户端配置。
- 添加了条件符号,以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话框条件和按钮状态相关的较小 bug 修复和优化。
6.18.0
注意:此更新更改了条件和动作的内部数据格式,这可能会重置或移除未存储 ID 的现有执行限制条目。
- 通过为动作添加条件以支持更复杂和动态的行为,修复了 #745。
- 通过为较长文本的对话框按钮添加工具提示,修复了 #652。
- 通过为命令值添加工具提示以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了库存物品检查条件。
- 添加了手持物品检查条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和动作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以便对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以支持更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外工具提示,修复了 #738。
- 通过减少启动期间和游戏中的 log.info 消息,修复了详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用对话框 ESC 键和关闭按钮的选项,修复了 #732。
- 通过在交易界面等特定情况下避免自动关闭,修复了 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0(交易、玩家头颅、Epic Fight 和质量改进更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能,修复了 #730。
- 通过确保交易使用次数正确存储,修复了 #729。
- 通过为玩家头颅添加自定义头颅支持,修复了 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置,修复了 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持,修复了 #218 和 #132。
- 修复了在基本模式和普通/高级模式之间切换时的交易特定边缘情况。
- 通过添加显示完整文本的工具提示,修复了对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步,修复了 Cobblemon 动画问题。
- 添加了针对每项交易的特定动作,允许用户在购买后触发动作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕中添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有动作的示例商人。
- 清理测试文件。
6.14.0
- 通过确保在更改值时将更改同步到客户端,修复了 #727。
- 通过为特定命令添加额外的白名单,修复了 #726。
- 通过添加基本的 Cobblemon 支持(使用 Cobblemon NPC),修复了 #686、#389、#304 和 #211。
- 通过调整对话框精灵和屏幕,修复了对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算,修复了 x 和 z 轴的根旋转问题。
- 通过自定义 NPC 类型和模型添加了基本的 Cobblemon 支持用于测试。
6.13.0(安全和权限更新)
注意:此更新包括更好的安全检查和多玩家环境中的权限控制。它允许执行服务器命令,如果出于恶意意图使用,这些命令可能具有潜在危险性。
此次更新将模型根数据与逻辑从其余模型部分数据和逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据与逻辑从其余模型部分数据和逻辑中分离,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查与权限系统,修复了 #605、#532 和 #529。
- 通过为自定义模型支持添加实验性 API 文档和示例,修复了 #469 和 #311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景双重渲染的问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多玩家环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义能力和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 移除了重复的精灵图集。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了常规代码清理和优化,涉及配置屏幕渲染和资源方面。
6.12.0
- 通过基于原版模型对自定义模型部分列表进行额外检查,修复了 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息,减少了日志详细程度,修复了 #713。
- 通过减少过大尺寸的启动/配置日志输出,修复了 #711。
- 添加了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加了模型部分名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构,改进了 RenderEntityTypeSupportConfig,以提高性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析,修复了 #710。
6.11.0
- 修复了 #703,解决了新自定义层级系统与手部渲染的渲染问题。
- 通过为无效的交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端,修复了头部追踪问题。
- 优化了 CustomLookAtPlayerGoal,以更好地处理边缘情况并减少抖动。
- 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 更新了带有新设计的标志(Logo)。
6.10.0
- 通过对第三方实体创建添加 try-catch 块,修复了 #698。
- 通过在切换至
DEFAULT原版姿态时清除模型部分的旋转/位置,修复了 #695。 - 通过将锁定旋转和姿态动画仅应用于 NPC 处于空闲状态时,修复了 #695。
- 通过将根旋转轴心修正为使用实际的边界框高度而非 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺少针对玩家的刷新以及针对离线目标的重试机制。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转的功能;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了“锁定旋转”复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余地重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加用于逃离玩家、村民、怪物等的额外 Flee 目标,修复了 #597。
- 修复了姿态加载逻辑,改为直接从模组资源读取,而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并可配置移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,以便外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 添加了所有支持 NPC 类型的姿态数据文件。
- 在基本姿态配置屏幕中添加了“锁定旋转”复选框。
- 添加了
MoveToPositionGoal,用于在执行回调动作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl,以尊重锁定的根旋转。 - 将所有者变更和维度变更同步到 NPC 实体数据索引中。
- 在各种实体渲染器中添加了 EasyNPCItemAttachmentLayer。
- 添加了专用的
Flee Objective(逃离目标)配置选项卡,包含针对爬行者、怪物、生物、玩家、村民和太阳的逃离目标。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM目标,使 NPC 能够跟随按资源位置标识的物品实体(例如minecraft:apple)。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了通过 UUID 查看实体和查看主人的目标。 - 在
SynchedDataIndex中添加了persistent标志,使得临时索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 使用者在
SlimeBase中添加了可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET,并将CAT_PURR映射到猫型 NPC,以增加驯服环境音效的多样性。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本强制执行版本不匹配警告,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动,修复了 #665。
- 通过添加禁用跟随鼠标光标的选项以便于摆姿,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过添加使用 NPC 法杖并潜行靠近 NPC 来快速旋转根部使其面向玩家的功能,修复了 #661。
- 通过在交互处理器中添加对移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过在交互处理器中添加对预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整边界框和眼高计算,修复了史莱姆和恶魂的碰撞箱及名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置问题。
6.8.2
- 通过扩展
SafeMerchantData并添加 notifyTrade 以避免崩溃,修复了 #677。 - 添加了基于玩家互动和动作提升 NPC 等级的进度数据支持。
- 添加了全局 NPC 追踪系统,以便在世界范围内更好地管理和调试 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许原始模型使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而非自定义方法,修复了 #676。
6.8.0 (增加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马生蛋模型的显示问题。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便与其他模组和自定义模型更容易集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进空间。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现 Wolf Leg Animations(狼腿动画)解决了 #650,该方法在 setupAnim 中完成。
- 修复了 canBeHitByProjectiles(可被投射物击中)的翻译问题,解决了 #648。
- 添加了
allowBypassInvulnerability配置选项以允许/禁止 NPC 绕过无敌状态,解决了 #645。 - 修复了删除按钮即使宽度较小也显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置 UI 中出现名称标签的问题。
- 修复了距离动作问题,即多个动作未能正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据同步不当的问题。
- 添加了预设浏览器,以便更轻松地选择常用 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了生成器系统以使用新的预设格式,以提高可维护性和未来改进空间。
6.6.2
- 通过重写缩放系统解决了 #643。
- 修复了重启/重新加载后缩放未能正确更新命中盒和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于团队的名称标签可见性支持,尊重原版 Team 机制。
6.6.1
- 通过重构显示属性的内部数据处理解决了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载解决了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 修复了使用原子操作进行纹理重载保护时的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止对同一纹理进行多次同时下载。
- 修复了远程图像验证的异常处理,防止无效 URL 导致崩溃。
- 修复了 NPC 加载期间出现的
defineId called for:警告消息。 - 重构了具有多层防御和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 的线程安全会话服务器防垃圾信息保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用 2 线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 设置了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤问题。
- 通过为 Gradle 依赖项添加缓存改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL(击杀)动作类型和事件解决了 #632。
- 通过改进纹理处理性能、缓存和内存使用情况解决了 #629。
- 修复了 kill 命令在 NPC 上无效的问题。
- 修复了纹理重载保护阻止驱逐后缓存重载的问题。
- 修复了远程图像验证器中的 WebP 验证错误(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了额外的纹理处理单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实施裁剪区域实现了更好的与其他模组的兼容性,解决了 #627。
- 修复了在使用旋转或移动模型部件时生动的动画问题,解决了 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿势动画控制,提供智能、默认和无选项。
6.4.1
- 修复了针对不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade进行的详细调查和修复建议,解决了 #626。
6.4.0
- 通过改进对话框数据验证和错误处理解决了 #626。
- 通过重构渲染数据和渲染处理解决了 #623。
- 确保自定义数据正确保存和加载,解决了 #622。
- 修复了打开对话框的动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法解决了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话框数据来修复对话框数据。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了某些对话框数据字段缺少默认值的问题。
- 添加了对话框优先级支持以控制对话框执行的顺序。
- 为对话框和记分板动作添加了条件支持。
- 为对话框添加了频率支持以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段改进了对话框按钮数据格式。
6.2.0
- 修复了对话框内的字符串注入问题。
- 修复了动作类型缺少翻译的问题。
- 添加了记分板动作类型以增加、减少或设置记分板数值。
- 添加了
@score(...)NPC 宏以在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了旋转按钮,添加了指示器并提高了可用性。
6.1.2
- 修复了容器和菜单同步问题,包括缺失的关闭容器数据包。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了屏幕过渡期间鼠标光标跳跃的问题。
- 修复了翻译文件并删除了重复和已弃用的条目。
- 将 Easy NPC 魔杖移至现有的核心物品标签页,而不是创建新的标签页。
- 添加了针对不同模型部件(尾巴除外)的猫姿势支持。
- 在不必要时禁用发光效果,从而改进了 EasyNPCWand 发光效果的 performance。
- 通过排除非生物实体(如展示框、制造者、投掷物和生成器)改进了自定义实体检测。
- 改进了猫变种的处理。
6.1.1
- 通过重新验证实体类型修复了 #612。
- 通过强制同步特定模型的帽子和头部图层修复了 #610。
- 修复了兽人纹理。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型支持和性能。
- 改进了玩家皮肤的玩家到 UUID 映射的缓存。
- 将更改模型命令和逻辑限制为仅限 Doppler NPC。
6.1.0 ✨
这是一个主要版本。请在更新之前备份您的世界和 NPC 数据。此版本包含许多改进、优化和内部更改,这些更改与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载或需要手动调整。
- 内部数据格式和一些行为已重构以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级运行时和 NPC 逻辑,依赖项最少。旨在用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可以安装在需要该界面的客户端上。
🎯 为什么进行此更改?
- 允许服务器和整合包仅在服务器端分发 Core 模组,从而实现更精简的设置。
- 当不需要在所有地方使用 UI 时,减少内存使用和加载时间。
- 通过分离 UI 和核心逻辑,使开发和测试更快。
Easy NPC(1.20.1)更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请查阅 升级指南。
7.20.0
- 修复了因缺少皮肤 ID 导致拥有该皮肤的 NPC 崩溃的问题,感谢
voidsipp在 #866 中提供的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了在使用 "DEFAULT" 或 "NONE" 动画行走时,隐藏的身体部位再次显示的问题。
- 修复了马匹 NPC 的姿势、溺尸的外部层以及头饰或头颅忽略隐藏部位的问题。
- 修复了当其他模组中断释放过程时,站在玩家肩膀上的 NPC 丢失的问题。
- 修复了 NPC 通过闪电、溺水、冻结或僵尸攻击变成原版生物的问题。
- 修复了生成的 NPC 获得随机幼体、骑乘者、装备或效果并丢失其预设装备的问题。
- 修复了即使未启用“拾取物品”,村民、猪灵和狐狸等 NPC 也会拾取物品的问题。
- 修复了骷髅 NPC 在其配置的攻击之外,还使用原版弓和近战攻击的问题。
- 修复了末影人 NPC 的水伤害和传送问题,以及史莱姆 NPC 分裂和接触伤害的问题。
- 修复了狐狸 NPC 食用手持食物、鸡 NPC 产蛋以及猫 NPC 丢失原版姿势的问题。
- 修复了闪电充能的苦力怕 NPC 以及反弹的火球瞬间杀死恶魂 NPC 的问题。
- 改进了敌对生物搜索攻击 NPC 时的服务器性能。
7.19.0
- 通过防止一个 NPC 的隐藏皮肤层在其他同类型 NPC 上隐藏它们,修复了 #865。
- 修复了类僵尸和末影人 NPC 的自定义姿势被其手臂动画覆盖的问题。
- 修复了具有职业的村民和僵尸村民 NPC 的隐藏头部再次显示的问题。
- 修复了僵尸猪灵 NPC 在阳光下燃烧的问题。
- 修复了“锁定身体”标签超出旋转屏幕范围的问题。
- 修复了投射物“物品 ID”字段隐藏物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后改变顺序的问题。
7.18.0
- 通过防止在加载时因 LetMeDespawn 等模组导致 NPC 丢失,修复了 #862。
- 修复了同时拥有近战和远程攻击的 NPC 在手持弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标之间旋转以及史莱姆 NPC 在攻击时向错误方向跳跃的问题。
- 修复了传送到其他地方或切换维度后,Boss 血条仍停留在屏幕上的问题。
- 修复了创造模式下对 NPC 使用快捷选取(Pick Block)不掉落其生成蛋的问题。
- 修复了记分板条件为没有记分的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 的金重弩,并添加了皮革和铜制重弩的支持。
- 修复了皮肤屏幕上重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签将文件夹命名为
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
- 通过支持 AttributeFix 等模组设置的更高属性上限,修复了 #858。 需要在服务器和客户端都安装 AttributeFix 或类似模组;护甲值上限为 100。
- 通过在不发生更改时不再重写 NPC 文件,修复了 #857。
- 通过当一个条件的不满足时尝试下一个“打开对话(条件性)”,修复了 #854。
- 修复了动作和对话上的“几率”条件被掷两次,从而降低实际几率的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝root以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或被拴绳束缚的 NPC 站到肩膀上,以及断开连接时出现的肩膀渲染泄漏问题。
- 修复了隐藏头部保留其帽子层以及 NPC 跟随其他维度目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(周围光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受到影响;设置为 7 可保持旧外观。
- 更改了“关闭对话”和“回退”动作的执行时机,使其在没有打开条件性对话时运行。
- 更改了具有传送距离的“跟随主人”NPC 的行为,使其跟随主人进入其他维度。
- 更改了服务器停止时的行为,等待最多 2 分钟以确保正在写入的 NPC 文件完成保存。
- 更改了闲置 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 版本起,更改为需要
force参数或新的复活 API 才能使被杀死的 NPC 重新生成。 - 更改了内置目标的优先级设置,使其由附加组件设定而非使用默认值。
- 更改了铁傀儡的“攻击速度”默认为 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 返回、内存泄漏以及多个所有者和用户界面问题。
- 修复了 Epic Fight Wither Skeleton(凋灵骷髅)NPC 缺少其 Epic Fight 生物补丁的问题。
- 更改了要求:客户端和服务端必须运行相同的模组版本,且 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。 - 添加了使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行了较大的核心重构和代码清理。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名字标签和气泡对话框位于其身体内部的问题。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和注视失效的问题。
- 修复了格式错误的网络数据包导致玩家断开连接而非被忽略的问题。
- 修复了应用无效的 NPC 位置、缩放比例、属性、名称和持续时间的问题。
- 更改了精灵(Fairy)NPC 占用其模型的空间,使其可以发生碰撞并被点击。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了 #836:始终显示“还原”,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告将被替换的 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载、泄露 NPC 并清除选择的问题。
- 修复了小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了
/easy_npc preset import data在没有指定位置时将预设导入为默认预设的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”导致多个 NPC 堆叠在同一位置的问题。
- 更改了“还原”行为:在不允许时拒绝操作,而不是生成副本。
- 为预设和皮肤添加了排序、匹配计数、重载、自动关闭、NPC ID 和提示框。
- 添加了带有限制、确认步骤和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 通过仅向魔杖持有者、所有者和管理员显示简易 NPC 魔杖轮廓,修复了问题 #833。 其他玩家不再看到这些轮廓,不可见的 NPC 对他们保持隐藏。
- 通过在位置配置中添加“设为主家”和“重置主家”按钮,修复了问题 #834。
- 通过在导出的预设中保留 NPC ID 和位置,使导入能恢复相同的 NPC,从而修复了问题 #835。
- 修复了预设导入和生成蛋丢失所有者列表条目及所有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失所有者并变成无主状态的问题。
- 修复了选择列表仅显示前六项条目而隐藏其余条目的问题。
- 更改了导入预设的行为:改为在存储的位置更新原始 NPC,而不是添加副本;请使用“作为新 NPC 导入”或预设物品来创建独立的 NPC。
- 更改了已完成交易的音效播放逻辑,现在会播放“交易完成”音效,此前该音效是静音的。
- 更改了 API 对话框调用逻辑,使其报告未知的对话框标签,而不是始终报告成功。
- 更改了没有手臂的 NPC 携带物品的行为:改为在头部或身体处携带手持物品,而不是隐藏它们。
- 将可选依赖项 Easy Model Entities 的版本要求更改为 2.4.0 或更高版本。
- 添加了包含对话、说话、游泳、进食和坠落伤害声音的“声音”配置。
- 在“声音”配置中添加了可搜索的声音选择器,并配有音量和音调滑块。
- 添加了“阻止载具”选项,以防止 NPC 进入船、矿车以及模组提供的椅子。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型添加了新的内置皮肤。
- 添加了客户端设置,用于让姓名标签被墙壁遮挡以及控制魔杖轮廓的
highlightEnabled功能。 - 添加了“存在”条件操作,并提供了对 NPC 移动、动作和预设的 API 访问权限。
7.11.0
- 通过不再在注销时因 NPC 跟随或注视玩家而导致服务器冻结,修复了问题 #828。
- 通过将常规 NPC 移除消息移至调试日志,修复了问题 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了问题 #832。
- 修复了在大型世界中每小时进行 NPC 备份时导致的卡顿问题,以及保留了已移除 NPC 的时间戳的问题。
- 修复了所有者登录恢复功能导致未加载的 NPC 重复、反复恢复、复活或移动的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据问题,避免了冗余写入,并增加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文字丢失且变得半透明的问题。
- 修复了翻译后的气泡文本和模组 API 文本中的文本格式化和宏解析问题。
- 添加了
minLightLevel参数,以确保在黑暗环境中气泡内容可读。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了问题 #829。
- 修复了 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 格,超出该范围才进行传送。
- 更改了“移动到”和“返回主家”逻辑:若三秒内无进展则放弃任务。
- 更改了“移动到”动作的超时计算:改为计算真实刻数,此前运行时间过长两倍。
- 更改了新的“随机游泳”目标的优先级:排在跟随、逃跑和攻击目标之下。
- 更改了带有 Easy Model Entities 模型的 NPC 的不透明度应用方式:改由该模组本身处理。
- 将 Easy Model Entities 的最小版本要求更改为 2.3.0,旧版本将禁用集成。
- 添加了用于 NPC 游泳水平的“水面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,每项耗时超过 250 毫秒时会发出警告。
7.8.1
- 通过使水下鱼类 NPC 直立渲染而非总是侧躺翻滚,修复了问题 #827。
- 通过防止受损 NPC 阻塞世界保存(现回退至默认值),修复了问题 #828。
- 修复了恢复的 NPC 每次保存时都会拾取一个变化的随机预设 ID 的问题。
- 更改了 NPC 数据的写入逻辑:仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和界面问题。
- 修改了已处于目标位置的 NPC,使其立即完成移动。
- 将“无”皮肤选项卡更名为“高级”,其中现在包含“禁用皮肤”和纹理字段。
- 添加了“移动到”动作,可将 NPC 发送至指定位置、玩家、其所有者或家园。
- 添加了“移动到并等待”动作,仅在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时设置以及可选的传送功能。
- 添加了范围从 0 到 100 的“不透明度”属性,可同时淡化身体、盔甲和手持物品。
- 添加了“设置不透明度”动作,可使 NPC 变为幽灵或完全隐藏。
- 添加了“灯笼幽灵”预设,这是一种在每个角落带有短线的方形行走幽灵。
- 提供了对移动动作和 NPC 不透明度的 API 访问权限。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,在应用之前预览使用输入纹理的 NPC。
7.7.7
- 通过保留 64x64 皮肤的透明度来修复 #821,Fresh Moves 需要该透明度来显示眼睛。此前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
- 通过让村民和流浪商人 NPC 也执行交易动作来修复 #818。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载图像的问题。
- 修复了“执行限制”条件中未翻译的时间间隔名称(如
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_npc render texture为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 提供了对 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,供资源包使用。 - 添加了以百分比表示的“几率”条件以及针对所有者和派系的“关系”条件。
- 添加了生成、所有者登录、状态变化、白天/夜晚、天气以及缺失的“交易时”事件。
- 在每个 NPC 类型下添加了基础预设
easy_npc:api/preset/base/,可用作父级预设。 - 添加了“流浪同伴”预设,这是一个由基于时间的消息构建的多话 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的EventData。
- 为
/easy_npc命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,无需输入即可出现,并容忍距离偏差一个方块的情况。
7.5.0
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非每种物种共用一个状态)修复了 #814。
- 通过让“返回家园”在任何距离都能工作(而不仅限于在家园附近)修复了 #813。
- 通过在每个会话期间检查一次玩家是否更改了皮肤修复了 #812。
- 通过接受资源包的 Cobblemon 方面(而不仅限于“闪亮”和“雌性”)修复了 #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 的地面移动和飞行模式之间切换。
- 添加了父级预设、来自其他模组的预设、预设可见性设置以及“Forge Keeper”预设。
- 为其他模组添加了自定义条件、事件、NPC 标识符以及更多的目标选项。
- 添加了 32 格外的“远距离”事件,以及当所有者重新登录时再次生成 NPC 的选项。
- 通过提供预设 API 和自定义目标 API,改进了飞行导航和第三方支持。
7.4.0
- 修复 #807:不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复 #805:改为综合评估所有可见性设置,而不是在遇到第一个时停止。
- 修复 #804:保留 Doppler NPC 的自定义名称,以用于基于名称的纹理和命名牌。
- 修复 #803:调整资源以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复昼夜检测逻辑,此前会将日出计为夜晚、日落计为白天。
- 修复下界(Nether)与末地(End)中的可见性,此前错误使用了主世界时间。
- 修复时间与游戏模式可见性复选框显示顺序随机的问题。
- 修复游戏测试仅在首个断言失败时才会报错,导致后续失败被隐藏的问题。
- 修复“骑乘”马匹皮肤变体,此前从未显示马鞍。
- 更改“仅对所有者可见”和“仅对队伍可见”设置,使其也遵循昼夜和游戏模式的变化。
- 更改唤魔者(Evoker)、幻术师(Illusioner)和卫道士(Vindicator)变体,若未启用“交叉手臂”,则保持手臂下垂。
- 新增“保卫阵营”目标,攻击任何伤害附近阵营成员或玩家的实体。
- 新增阵营成员互相攻击时的系统消息,此时阵营保持中立。
- 为灾厄村民(Illagers)添加头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置界面中新增昼夜预览功能。
- 为可见性属性与阵营防御机制添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升了可见性检查的性能。
- 通过用默认值补全缺失数据,兼容并改进了旧版本版本的显示属性。
- 改进了攻击目标界面,当“保护所有者”和“保卫阵营”未设置时将其禁用。
7.3.0
- 通过以类型化字段携带数据替代解析变体名称,改进了皮肤变体支持。
- 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
- 通过为
get(String)查找提供共享的EnumUtils辅助类,减少了重复的枚举代码。 - 优化了村民职业和类型的查找,改用直接注册表键而非扫描。
- 通过在构造时缓存标签名、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 安全保护扩展至 Epic Fight 模组及原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)。
- 修复 #787、#531、#237 和 #184:新增阵营系统,包含
/easy_npc faction命令、每个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复 #787、#771 和 #572:新增
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 指定特定目标。 - 修复 #786:为 Cobblemon NPC 添加性别和闪光模型变体,可在模型选择中通过
female或shiny进行搜索。 - 修复无敌 NPC 之间的阵营战斗问题,新增
Attackable by Factions(可被阵营攻击)战斗属性。 - 修复 Cobblemon 模型选择预览中对于体型过大的物种的显示问题,改为使用 Cobblemon 自身的配置文件缩放比例,而非碰撞箱高度。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复阵营管理的边缘情况。
- 修复自定义皮肤重载问题,改为按皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存。
- 改进
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)生效,各自为其对应的攻击者群体开放攻击入口。 - 通过拆分大型处理器为更小、更专注的导入、导出和功能专用组件,改进了预设命令和网络处理。
- 新增 Easy Model Entities 支持。
- 新增阵营管理器和阵营编辑器界面,用于创建、着色和删除阵营,并管理敌对关系,受新的
FACTION_MANAGEMENT安全特性保护。 - 新增
Misc(杂项)属性选项卡,作为 NPC 阵营分配的归属位置。 - 新增可复用的警告和帮助图标组件,用于带有工具提示的行内提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过增加额外的缓存和优化远程纹理下载修复了 #780。
- 通过防止其他模组提供的天文数值(极大值)影响属性滑块,修复了 #767。
- 为具有动作和条件的 NPC 添加了自定义数据物品匹配功能,以修复 #754。
- 修复了由于纹理管理器在错误的线程中运行而在 >= 1.21.x 版本中可能导致的崩溃和死锁问题。
- 修复了因操作条件为空 UUID 而导致意外行为的问题。
- 修复了动作执行限制重置的问题。
- 添加了纹理注册队列,以避免在同一刻进行多次同时下载。
- 将 NPC 硬币、钥匙和红代币添加为具有动作和条件的 NPC 的可消耗物品。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,其中包含自定义的硬币、钥匙和红代币作为示例物品,以及用于动作和条件的新物品数据。 - 为属性增加了通用的防护措施,以防止其他模组提供的天文数值(极大值)。
- 将回退最大生命值从 1024 增加到 4096,以支持更复杂的 NPC。
- 改进了纹理管理器,消除了重复的纹理检查和注册。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃问题。
- 通过在基础刻期间和打开交易屏幕之前检查定时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含时间和天气条件。
6.23.0
- 通过调整 403 和 404 错误下的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的物品渲染问题 #770。
- 修复了 NPC 的门循环无法可靠地打开或关闭门的问题 #769。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的颜色选择器弹出窗口以及手动 RGB/十六进制值输入,修复了 #709。
- 修复了在未指定颜色时重命名会重置 NPC 名称颜色的问题,通过保留现有名称颜色来解决。
- 改进了门的移动属性,使得当“打开门”或“关闭门”处于活动状态时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,提高了与依赖特定玩家数据的第三方模组和插件的兼容性,从而修复了 #766。
- 通过添加实体健康、NPC 健康条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 确保现在记录了对话框按钮的执行限制,从而修复了 #763。
- 提供了一个名为
One Wish Companion的示例 NPC 预设,以修复 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)读取未注册的脑记忆时与第三方村民 AI 相关的崩溃问题 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做的准备。
- 通过添加条件对话框打开支持和命令,以便更好地控制何时向玩家显示对话框,从而修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 添加了更多枪械到枪械标签中。
- 添加了新的“打开对话框(条件性)”动作,仅在其条件满足时才打开指定名称的对话框,而现有的“打开对话框”动作仍无条件打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体健康和 NPC 健康条件。
- 为了与其他 NPC 保持一致,使 Piglin、Piglin Brute 和 Zombified Piglin NPC 免疫伤害。
- 添加了新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移动到战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的 Illagers 的物品附着问题。
- 修复了损坏的 Illager 弩攻击目标。
- 修复了与不可作为手持物品渲染的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在的模型部分的第三方 mixin 相关的崩溃问题 #756。
- 通过减少日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 垃圾信息过多的问题。
- 改进了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃问题。
6.19.0
注意:此更新将对话框背景图像调整了 10x6 像素,如果您使用的是自定义背景,可能需要相应调整。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过为对话框文本添加打字机效果支持,修复了 #683 和 #215。
- 通过允许对对话框、对话框按钮和交互设置条件,修复了 #690 和 #309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 将对话框背景图像每边重构调整了 10x6 像素。
- 重构了对话框屏幕布局以更好地适应新的背景尺寸并改善外观。
- 为对话框文本添加了打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话框条件和按钮状态相关的较小错误修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或移除未存储 ID 的旧版现有执行限制条目。
- 通过为操作添加条件以允许更复杂和动态的行为,修复了 #745。
- 通过为较长文本添加对话框按钮提示,修复了 #652。
- 通过添加命令值提示以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏拥有物品的条件。
- 添加了手持物品条件,支持主手和副手。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以便对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外提示,修复了 #738。
- 通过减少启动期间和游戏内的 log.info 消息,修复了详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用对话框 ESC 键和关闭按钮的选项,修复了 #732。
- 通过在交易屏幕等特定情况下避免自动关闭,修复了 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0(交易、玩家头颅、Epic Fight 和 QOL 更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能,修复了 #730。
- 通过确保正确存储交易用途,修复了 #729。
- 通过为玩家头颅添加自定义头颅支持,修复了 #728。
- 通过显示剩余交易用途并允许手动和自动重置,修复了 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持,修复了 #218 和 #132。
- 在基本模式和普通/高级交易模式之间切换时,修复了特定于交易的边缘情况。
- 通过显示完整文本的提示,修复了对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步,修复了 Cobblemon 动画问题。
- 添加了每笔交易特定的操作,允许用户在购买后触发操作。
- 添加了交易重置按钮以轻松重置所有交易。
- 在交易配置屏幕中添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了带有操作的 Griselda Grindstone 作为示例交易者。
- 清理测试文件。
6.14.0(Cobblemon 支持和对话框改进)
- 通过确保更改值时同步到客户端,修复了 #727。
- 通过为特定命令添加额外白名单,修复了 #726。
- 通过带有 Cobblemon NPC 的基本 Cobblemon 支持,修复了 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕,修复了对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算,修复了 x 和 z 根旋转问题。
- 通过带有用于测试的自定义 NPC 类型和模型,添加了基本的 Cobblemon 支持。
6.13.0(安全和权限更新)
注意:此更新包括针对多人游戏环境的更好的安全检查和安全许可。它允许执行服务器命令,如果被恶意使用,这可能具有潜在的危险性。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查和安全许可系统,修复了 #605、#532、#529。
- 通过为自定义模型支持添加实验性 API 文档和示例,修复了 #469、#311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景的双重渲染问题。
- 通过调整边界框,修复了恶魂的碰撞箱和名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多人游戏环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义功能和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了特定于 config-ui 的组件,并将它们从核心模组中移除。
- 移除了重复的精灵表。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 与配置屏幕渲染和资源相关的常规代码清理和优化。
6.12.0
- 通过基于原版模型添加自定义模型部分列表的额外检查,修复了 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息,减少了日志详细程度,修复了 #713。
- 通过减少过大尺寸的启动/配置日志输出,修复了 #711。
- 修复 NBT 验证守卫以防止在生产环境中进行不必要的缓冲区分配。
- 为 EasyNPCModelManager 添加了模型部分名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构以提高性能和可维护性,改进了 RenderEntityTypeSupportConfig。
- 移除了转储大型数据结构的冗长调试日志。
6.11.0
- 修复了 #703 在新自定义图层系统和手部渲染中的渲染问题。
- 通过为无效交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了修改头部位置后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅限服务器端,修复了头部追踪问题。
- 优化 CustomLookAtPlayerGoal 以更好地处理边缘情况并减少抖动。
- 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 使用新设计更新了标志。
6.10.0
- 通过在切换到
DEFAULT(默认)原版姿态时清除模型部分的旋转/位置,修复了 #695。 - 通过在 NPC 处于空闲状态时才应用锁定旋转和姿态动画,修复了 #695。
- 通过修正根旋转枢轴以使用实际的边界框高度而不是 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理程序中的错误 UUID、加入/离开时缺少针对玩家的目标刷新,以及对离线目标的重试机制。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转;现在根锁由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 添加了
NPCDataIsolationTestHelper以及适用于 Fabric 和 Forge 的游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加用于逃离玩家、村民、怪物等的额外逃跑目标,修复了 #597。
- 修复了姿态加载逻辑,改为直接从模组资源读取,而不是将文件复制到磁盘。
- 通过在首先检查现有注册表条目来修复实体加入时的重复
saveNPC调用。 - 添加了
despawn(驱散)和spawn(生成)命令,允许按 UUID 移除和重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,以便外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行业务回调动作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl,以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引中。
- 在各种实体渲染器中添加了 EasyNPCItemAttachmentLayer。
- 添加了专用的
Flee Objective(逃跑目标)配置选项卡,包含针对苦力怕、怪物、生物、玩家、村民和太阳的逃跑目标。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM(跟随物品)目标,使 NPC 能够通过资源定位符跟随物品实体(例如minecraft:apple)。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看主人的目标。 - 向
SynchedDataIndex添加了persistent(持久化)标志,使得临时索引(如弩充能、模型动画)不再触发脏保存标记。 - 向
SlimeBase添加了可配置的customParticlesEnabled标志,供 API 使用者使用。 - 添加了
SoundType.PET并将CAT_PURR映射到猫 NPC,以增加被驯服后的环境声音多样性。 - 将周期性 NPC 保存操作的日志详细程度从 INFO(信息)降低到 DEBUG(调试)。
6.8.3
- 通过升级网络协议版本强制执行版本不匹配,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过添加根旋转的多状态滑动,修复了 #665。
- 通过添加禁用跟随鼠标光标的选项以便于姿态调整,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过在使用 NPC 法杖且潜行靠近 NPC 时将根旋转到面向玩家的方向来实现快速旋转,修复了 #661。
- 通过在交互处理程序中检查移动工具,修复了移动工具错误触发交互的问题。
- 通过在交互处理程序中检查预设物品,修复了预设物品错误触发交互的问题。
- 通过调整边界框和视线高度计算,修复了史莱姆和恶魂的碰撞箱及名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置。
6.8.2
- 通过扩展
SafeMerchantData并添加 notifyTrade(通知交易)以避免崩溃,修复了 #677。 - 添加了基于玩家互动和行动提升 NPC 等级的进度数据支持。
- 添加了全局 NPC 追踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原始模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而不是自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马刷怪蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便与其他模组和自定义模型更轻松地集成。
- 重构了内部数据处理和注册逻辑,以提高可维护性和未来的改进空间。
6.7.1
- 通过添加针对原版漏洞的额外客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现在
setupAnim方法中为狼添加腿部动画,修复了 #650。 - 通过修正
canBeHitByProjectiles的翻译,修复了 #648。 - 添加了
allowBypassInvulnerability配置选项,允许/禁止 NPC 绕过无敌状态,从而修复了 #645。 - 修复了删除按钮在宽度较小时仍显示标签的问题。
- 修复了某些情况下上下按钮定位不正确的问题。
- 修复了对话框和配置 UI 中出现名称标签的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据同步不正确的问题。
- 添加了预设浏览器,以便更轻松地选择常见 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于分享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了生成器系统以使用新的预设格式,以提高可维护性和未来改进的空间。
6.6.2
- 通过重写缩放系统,修复了 #643。
- 修复了重启/重载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于团队的名称标签可见性支持,尊重原版 Team 机制。
6.6.1
- 通过重构用于显示属性的内部数据处理,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证泛滥问题,防止对同一纹理进行多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载期间出现的“defineId called for:”警告消息。
- 重构了具有多级防御和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑,以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 的线程安全会话服务器防垃圾邮件保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用 2 线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过添加 Gradle 依赖缓存,改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了击杀命令对 NPC 无效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重载的问题。
- 修复了远程图像验证器中 WebP 验证的错误(缺少返回语句)。
- 重构了纹理处理逻辑,以提高可维护性和未来改进的空间。
- 添加了基于时间的重载保护(60 秒),以替代永久阻止机制。
- 为纹理处理添加了额外的单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 捆绑方式,以提高模组兼容性和 API 能力。
- 实现了剪刀裁剪以更好地与其他模组兼容,修复了 #627。
- 修复了在使用旋转或移动模型部件时生动的动画问题,修复了 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 针对不同 NPC UUID 的屏幕切换逻辑进行了修复,感谢
Spawnblade进行的详细调查和修复建议,修复了 #626。
6.4.0
- 通过改进对话框数据验证和错误处理,修复了 #626。
- 通过重构渲染数据和渲染处理,修复了 #623。
- 确保自定义数据正确保存和加载,修复了 #622。
- 修复了打开对话框动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了配置 UI 特定组件并将其从核心模组中移除。
- 通过在发送到客户端之前过滤对话框数据,修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了某些对话框数据字段缺少默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框和记分板动作添加了条件支持。
- 为对话框添加了频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段,改进了对话框按钮数据格式。
6.2.0
- 修复了对话框内的字符串注入问题。
- 修复了动作类型缺少翻译的问题。
- 添加了记分板动作类型,用于增加、减少或设置记分板数值。
- 添加了
@score(...)NPC 宏,以便在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了带有指示器的微调按钮,提高了可用性。
6.1.2
- 修复了由于缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了屏幕转换期间鼠标光标跳动的问题。
- 修复了翻译文件并删除了重复和已弃用的条目。
- 将 Easy NPC 法杖移至现有的核心物品标签页,而不是创建新的标签页。
- 为不同的模型部件(尾巴除外)添加了猫姿势支持。
- 通过在不必要时禁用发光效果,改进了 EasyNPCWand 发光效果的性能。
- 通过排除非生物实体(如展示框、制造者、投掷物和生成器),改进了自定义实体检测。
- 改进了猫变种的处理。
6.1.1
- 通过重新验证实体类型修复了 #612。
- 通过对特定模型强制同步帽子和头部图层修复了 #610。
- 修复了兽人纹理。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型支持并提升了性能。
- 改进了玩家皮肤的玩家到 UUID 映射的缓存。
- 将更改模型命令和逻辑限制为仅限 Doppler NPCs。
6.1.0 ✨
这是一个重大版本。请在更新之前备份你的世界和 NPC 数据。此版本包含许多改进、优化和内部更改,这些更改与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或者可能需要手动调整。
- 内部数据格式和一些行为已重构以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级运行时和 NPC 逻辑,依赖项极少。旨在用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何进行此变更?
- 允许服务器和整合包仅在服务器端安装 Core 模组,以实现更精简的配置。
- 当不需要 UI 时,减少内存占用和加载时间。
- 通过分离 UI 和核心逻辑,加快开发和测试速度。
Easy NPC: Core (26.3) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub 历史记录。
注意:在更新至新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请参阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏某个 NPC 的皮肤层导致同类型其他 NPC 也被隐藏。
- 修复了末影人 NPC 的自定义姿势被其默认动画覆盖的问题。
- 修复了在移动时使用 "DEFAULT" 或 "NONE" 动画时隐藏的身体部位重新显示的问题。
- 修复了旋转屏幕中“锁定身体”标签溢出显示的问题。
- 修复了投射物“物品 ID”字段遮挡物品 ID 开头内容的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在每个游戏启动后顺序发生变化的问题。
7.18.0
- 修复了 #862:防止在使用如 LetMeDespawn 等模组加载时 NPC 丢失。
- 修复了拥有近战和远程攻击能力的 NPC 在手持弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标点之间旋转以及史莱姆 NPC 攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后 Boss 血条仍停留在屏幕上的问题。
- 修复了创造模式下对 NPC 使用快捷选取(Pick Block)无法获得其生成蛋的问题。
- 修复了记分板条件在未设置分数的玩家身上添加 0 分的问题。
- 修复了 Spartan Weaponry 的金质重型弩,并添加了皮革和铜质版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误信息和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英语 Bogged 名称以及未处理的“主手”/“副手”键名。
- 更改了生存模式生成 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 等模组设置的更高属性上限。 需要服务器和客户端均安装 AttributeFix 或类似模组;护甲值上限为 100。
- 修复了 #857:当内容未发生变化时,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当一个“打开对话框(条件)”的条件不满足时,尝试执行下一个。
- 修复了动作和对话框上的“几率”条件被掷骰两次,导致几率降低的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root,以及name clear保持名称显示的问题。 - 修复了死亡、骑乘或拴绳的 NPC 出现在肩膀上,以及断开连接时肩膀渲染泄漏的问题。
- 修复了隐藏头部保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了几个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受到影响;设置为 7 可保持旧外观。
- 更改了“关闭对话框”和“回退”动作,使其在没有条件对话框打开时运行。
- 更改了拥有传送距离的“跟随主人”NPC,使其跟随主人进入其他维度。
- 更改了服务器停止行为,等待最多 2 分钟以完成仍在写入的 NPC 文件。
- 更改了空闲 NPC 的反应延迟,对附近的玩家、掉落或压力板的反应时间延长至 0.5 秒。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 提高了 NPC 保存、备份、
/easy_npc list、肩膀同步和空闲 NPC 的性能。
7.16.0
- 修复了 #432:不再在目标被设置多次或移除后重复运行目标。
- 修复了 #852:使长矛能够击中可攻击的 NPC。
- 修复了当玩家无法将 NPC 从肩膀卸下时,NPC 会迷路的问题。
- 修复了“坐在肩膀上”的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自附加组件的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成已存储的 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命令设置。 - 更新了测试通过的 NeoForge 版本至 26.3.0.83,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,预设导入保持静默。 - 修复了 #380:将 NPC 数量限制也应用于默认生成器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左撇子 NPC。
- 修复了 #851:锁定对话框按钮的作用范围限定于单个对话框,而非具有相同标签的所有对话框。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少 Epic Fight 生物补丁的问题。
- 修复了非居中库存屏幕及其关闭按钮与“自定义”交易选项卡重叠的问题。
- 修复了缩放后的 Doppler NPC 保留了模仿实体的完整碰撞箱的问题。
- 修复了位于玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端必须使用相同的模组版本,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
- 修复了对于稍后才开始看到该 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 位置、缩放比例、属性、名称和持续时间的问题。
- 更改了精灵(Fairy)NPC 占用其模型的空間,使其发生碰撞并可被点击。
- 更改了骷髅、流浪者和沼泽僵尸 NPC 的碰撞箱高度为原版标准,此前它们略微偏矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告关于替换的 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载,导致 NPC 泄露和选择清空的问题。
- 修复了选择框下拉列表被其后方的复选框和标签遮挡的问题。
- 修复了小窗口中预设列表排序、筛选顺序和布局裁剪选项的问题。
- 修复了不带位置参数的
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄露、不稳定的预设 ID 以及“生成新实体”在一点堆叠 NPC 的问题。
- 更改了“恢复”行为:当不被允许时拒绝操作,而非生成副本。
- 添加了排序、匹配计数、重新加载、自动关闭、NPC ID 以及预设和皮肤的提示框。
- 添加了带有限制、确认步骤和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 修复了 #833:仅向魔杖持有者、所有者和管理员显示简易 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 备份导致的卡顿,以及保留了已移除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、所有者和位置的问题。
- 修复了所有者登录恢复时重复、反复恢复、复活或移动未加载 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时,对话气泡丢失文本并变得半透明的问题。
- 修复了在使用光影包时,NPC 的“不透明度”被忽略的问题。
- 修复了翻译后的对话气泡和模组 API 文本的文本格式化和宏解析问题。
- 修复了在使用光影包时,对话气泡及其文本停留在方块后面的问题。
- 添加了
minLightLevel以保持对话气泡在黑暗环境中可读。
7.10.0
- 修复了 #829:允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体。
- 修复了流浪商人 NPC 渲染时缺少纹理的问题。
- 修复了渲染为蝙蝠、青蛙或监守者的 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 格,超出该范围才进行传送。
- 更改了“移动到”和“移回家园”:在三秒内无进展时放弃任务。
- 更改了“移动到”动作的超时机制:计算真实游戏刻数,此前运行时间过长两倍。
- 更改了新的“随机游泳”目标:将其优先级排在跟随、逃跑和攻击目标之下。
- 更改了带有 Easy Model Entities 模型的 NPC 的“不透明度”:由该模组本身应用。
- 更改了最低 Easy Model Entities 版本要求为 2.3.0,旧版本将禁用集成。
- 添加了 NPC 游泳层级的“水面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,每项耗时超过 250 毫秒时发出警告。
7.8.1
- 修复了 #827:使水中的鱼形 NPC 直立显示,而非总是侧躺。
- 修复了 #828:防止受损的 NPC 阻止世界保存,现在改为回退到默认值。
- 修复了恢复的 NPC 拾取随机预设 ID 的问题,该 ID 在每次保存时都会变化。
- 更改了 NPC 数据写入逻辑,仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已站在目标位置的 NPC 的行为,使其立即完成移动。
- 将“None”(无)皮肤选项卡更名为“Advanced”(高级),其中包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”动作,可将 NPC 发送至指定位置、玩家、其所有者或家园。
- 添加了“移动并等待”动作,仅在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时机制以及可选的传送功能。
- 添加了范围为 0 到 100 的“不透明度”属性,用于混合淡化身体、盔甲和手持物品。
- 添加了“设置不透明度”动作,可将 NPC 变为幽灵或完全隐藏。
- 添加了“灯笼鬼魂”预设,是一个在每个角落带有短直线的方形路径行走的幽灵。
- 为移动动作和 NPC 的不透明度添加了 API 访问权限。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,可在应用前预览输入纹理下的 NPC 效果。
7.7.7
- 修复了 #821:保留了 64x64 皮肤的透明度,这是 Fresh Moves 用于眼睛所必需的。之前下载的皮肤需要通过在玩家皮肤屏幕中点击按钮来重新加载。
- 修复了 #818:使村民和流浪商人 NPC 也能执行交易动作。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载文件的问题。
- 修复了未翻译的执行限制条件中的间隔名称,例如
PER_DAY。 - 修复了 Easy Model NPCs 的
sit(坐下)动画,该动画从未使用内置的坐姿姿态。 - 修复了当玩家靠近 NPC 头部时,对话框被 NPC 头部遮挡的问题。
- 更改了对话框行为,使其保持屏幕大小,并在玩家靠近时向下或向侧面移动。
- 更改了对话框文本渲染大小,比名牌大 20%。
- 更改了带有“等待”动作的时间基于动作集的运行方式,按顺序执行而非随机选择一个条目。
- 更改了对话框文本的换行逻辑,使其更晚换行,以便现有对话框可以切换到更宽的屏幕布局。
- 更改了回退动作的逻辑,使其在没有玩家时跳过屏幕动作,就像常规动作一样。
- 将 Easy Model Entities 的最低版本要求提升至 2.1.0,旧版本将禁用集成。
- 添加了“等待”动作,暂停事件后续动作指定的持续时间。
- 添加了“倒计时计时器”预设,一个数到十的对话框,最后伴有声音和火花效果。
- 为 Doppler NPCs 添加了缩放和旋转功能,位于“实验性功能”复选框后。两者仅影响可见模型实体,且从不影响碰撞箱。
- 添加了“声音”动作,以指定的声音类别、音量和音调在 NPC 处播放声音。
- 在执行限制条件中添加了“每 5 分钟”和“每 15 分钟”选项。
- 添加了“玩家闲置”条件,检查玩家未移动的时间长度。
- 添加了“不可移动”属性,使 NPC 抵抗推力和击退效果。
- 添加了
/easy_npc pause命令,用于暂停单个 NPC 或所有 NPC;全局暂停在服务结束前持续有效。 - 为声音动作、暂停状态和玩家闲置时间添加了 API 访问权限。
- 通过
/easy_npc render texture命令为 Easy Model NPCs 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 为 Easy Model NPCs 的动画变体、纹理槽位和纹理添加了 API 访问权限。
7.6.0
- 修复了重复实体数据追踪器 ID 导致的模组冲突错误提示不明确的问题。
- 修复了在配置和对话界面中,第三方血条渲染在 NPC 预览上方的问题。
- 修复了 Doppler 和 Easy Model Entities 的 NPC 使用默认碰撞箱而非其模型尺寸作为碰撞箱的问题。
- 修复了
/easy_npc命令在服务器上完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段之上的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕边缘而未自动换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐错位的问题。
- 修复了“设置姿势(Set Pose)”、“播放动画(Play Animation)”和“停止动画(Stop Animation)”动作的更改无法保存的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议列表的显示逻辑:优先显示准星指向的 NPC,且仅显示无权限的自身 NPC。
- 更改了预设导出功能:仅存储与新建 NPC 不同的部分,不包含位置或所有者信息。
- 更改了没有目标或动作的预设行为:回退到其所属 NPC 类型的默认值。
- 更改了不含玩家的事件(如“生成时(On Spawn)”或“击杀时(On Kill)”)的条件检查逻辑。其中包含基于玩家的条件的动作(例如记分板或物品条件)将不再执行。
- 更改了基于时间的动作:当所有者在附近时,将其指定为
@initiator。 - 更改了气泡的可见时间:根据文本长度,从 5 秒增加到最多 18 秒。
- 更改了“设置姿势(Set Pose)”动作:仅在“自定义(custom)”姿势条目时才显示其输入字段。
- 新增了五个固定步长的基于时间的动作,频率从每约 1 秒到每约 15 分钟不等。
- 新增了“消息(Message)”动作,支持聊天、系统消息和气泡文本,无需执行命令。
- 为“消息(Message)”动作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包新增了气泡图形文件
easy_npc:textures/gui/speech_bubble.png。 - 新增了百分比形式的“几率(Chance)”条件以及针对所有者和阵营的“关系(Relationship)”条件。
- 新增了生成、所有者登录、状态变化、白天/夜晚、天气以及缺失的“交易时(On Trade)”事件。
- 新增了每个 NPC 类型的基础预设,位于
easy_npc:api/preset/base/下,可用作父级预设。 - 新增了“流浪同伴(Wandering Companion)”预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 新增了供模组使用的动作注册表、动作处理器、预设验证器以及更丰富的动作数据。
- 为
/easy_npc命令的每个 NPC 建议添加了工具提示,显示名称、类型和距离。 - 改进了 NPC 建议功能:无需输入即可出现,并容忍距离误差为一格以内的情况。
7.5.0
- 修复了 #814,通过为每个 Cobblemon NPC 提供独立的动画状态,而非按物种共享。
- 修复了 #813,使“返回家园”功能可在任意距离生效,而不仅限于靠近家园时。
- 修复了 #812,改为每个会话仅检查一次玩家是否更改了皮肤。
- 修复了 #810,改为接受资源包中的 Cobblemon 方面(aspects),而不仅限于“闪光”和“雌性”。
- 修复了 NPC 的家位置始终显示为未设置的问题,这导致配置屏幕中隐藏了“家”选项、保存时跳过该选项,并使得“返回家园”和“在家附近闲逛”功能失效。
- 修复了从预设、预设浏览器或重生生成的 NPC 从未获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出预设的世界的家位置,而不是使用其生成位置的问题。
- 在使用 Easy NPC Wand 高亮显示时,配置、皮肤和预设屏幕中的 NPC 被错误地绘制为带有阴影的白色剪影。
- 修复了当具有“引诱”目标的 NPC 更新其目标时服务器崩溃的问题。
- 修复了当预设未存储任何 NPC 时,单个或 Boss 刷怪笼无限制生成的问题。
- 修复了新建 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 风格。
- 修复了昼夜检测问题,此前错误地将日出计为夜晚、日落计为白天。
- 修复了下界(Nether)和末地(End)中的可见性问题,此前使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框随机排序的问题。
- 修复了游戏测试仅能在首次断言失败时报告失败的问题,这会导致后续的错误被隐藏。
- 修复了“骑乘状态”马匹皮肤变体,此前从未显示马鞍。
- 更改了“仅对所有者可见”和“仅对队伍可见”选项,使其也遵循昼夜和游戏模式设置。
- 更改了未启用“交叉双臂”的唤魔者(Evoker)、幻术师(Illusioner)和卫道士(Vindicator)变体,使其手臂保持下垂状态。
- 添加了“防御阵营”目标,该目标会攻击伤害附近阵营成员或玩家的任何实体。
- 添加了阵营成员互相战斗且阵营选择不介入时的系统消息。
- 为掠夺者(Illagers)添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置屏幕中添加了昼夜预览功能。
- 为可见性属性和阵营防御添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全旧版本中的显示属性,改进了兼容性。
- 通过在选择未设置时禁用“保护所有者”和“防御阵营”,改进了攻击目标屏幕。
7.3.0
- 通过将皮肤变体数据作为类型字段传递而非解析变体名称,改进了皮肤变体处理。
- 在共享常量中集中管理 Cobblemon 模组 ID 和默认模型。
- 使用共享的
EnumUtils辅助类进行get(String)查找,减少了重复的枚举代码。 - 优化了村民职业和类型的查找过程,改为直接使用注册表键而非扫描。
- 通过在构造时缓存标签名称、ID 和键,优化了枚举名称查找。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.1.2
- 修复了 #801:使用组合方式生成 NPC、对话和动作的 UUID,以避免动作跟踪和执行限制方面的冲突。
7.1.1
- 修复了 #800:采用延迟加载实体类型。
- 修复了 #799:修复了边缘情况,并添加了更多文档及更清晰的日志消息。
- 修复了 #798:将控制台、命令方块视为可信的命令来源。
- 修复了一个严重的单人/LAN 问题,此前客户端和服务端 NPC 共享同一个注册表。
- 修复了配置菜单处理中的内存泄漏,并添加了超时处理和断开连接清理机制。
- 修复了当多个 NPC 同时请求相同皮肤时导致的重复下载问题。
- 修复了在发生错误后皮肤查找失败的问题,防止缓慢的服务器导致游戏冻结。
- 修复了 URL 皮肤屏幕在检查远程图片时冻结游戏的问题;现在该检查在后台运行。
- 添加了一种新的世界生成器方块,可将 NPC 预设限制在整个世界(所有维度)内;现有的组生成器现按维度计数,因此远处的 NPC 不再阻碍其生成。
- 加强了远程皮肤下载的安全性,设置了严格的尺寸限制和安全重定向处理,以防止因过大或恶意的皮肤 URL 导致崩溃;添加了可选的
blockPrivateAddresses设置。 - 通过仅向实际使用这些事件的 NPC 发送实体和玩家加载事件(按维度分组),提高了服务器性能。
7.0.0
- 修复了 #794:使用预期的类型进行 NPC 渲染。
- 修复了缩放屏幕预览问题,通过将实体脚部固定到标尺的 0 线,使 NPC 从底部向上缩放,而非从中心缩放,且在边界框更新后不再向下偏移。
- 修复了 #791:添加了流浪商人(Wandering Trader)NPC 类型。
- 修复了 #788:将 AI 安全措施扩展至 Epic Fight 模组和原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)。
- 修复了 #787、#531、#237 和 #184:添加了阵营系统,包含
/easy_npc faction命令、单个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复了 #787、#771 和 #572:添加了新的
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。 - 修复了 #786:为 Cobblemon NPC 添加了性别和闪亮(shiny)模型变体,可通过在模型选择中输入
female或shiny进行搜索。 - 通过添加新的
Attackable by Factions(可被阵营攻击)战斗属性,修复了无敌 NPC 之间的阵营战斗问题。 - 修复了 Cobblemon 模型选择中对大型物种的预览问题,改为使用 Cobblemon 自身的配置文件比例进行缩放,而非使用碰撞箱高度。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存,修复了自定义皮肤重新加载问题。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)工作,各自为其对应的攻击者群体打开一个可攻击的空隙。 - 通过拆分大型处理器为更小的专注组件(导入、导出和功能特定组件),改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和管理编辑器屏幕,用于创建、着色和删除阵营,并管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性选项卡,作为 NPC 阵营分配的归属。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636、#622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对来自其他模组的极端值限制属性滑块,修复了 #767。
- 通过为具有动作和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了纹理管理器在错误的线程中运行可能导致 >= 1.21.x 版本崩溃和死锁的问题。
- 修复了动作条件中的空 UUID 处理问题。
- 修复了动作的执行限制重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 硬币、钥匙和红令牌作为具有动作和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红令牌物品数据。 - 添加了对抗其他模组极端值的属性保护机制。
- 提高了高生命值 NPC 的回退最大生命值数值,从 1024 提升至 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459、#775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃问题。
- 通过在基础刻检查定时交易重置并在打开交易界面之前进行检查,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含昼夜时间和天气条件。
6.23.0
- 通过将 isSunBurnTick 错误迁移至 26.x,修复了 #774。
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的 #770 物品渲染问题。
- 修复了 NPC 无法可靠地打开或关闭门的 #769 门循环问题。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的颜色选择器弹出窗口以及手动 RGB/hex 值输入,修复了 #709。
- 修复了在未指定颜色时重命名会重置 NPC 名称颜色的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,使得当“开门”或“关门”处于活动状态时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以更好地兼容依赖特定玩家数据的第三方模组和插件,修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话框按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)上第三方村民 AI 读取未注册的大脑记忆导致的崩溃问题 #756。
- 修复了服务器端数据未锁定对话框按钮的问题,这是为 #760 和 #644 做的准备。
- 通过添加条件对话框打开支持/命令,以便更好地控制何时向玩家显示对话框,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了大脑 AI,并注册了完整的基础大脑记忆集。
- 为 #757 添加了更多枪支到枪支标签中。
- 添加了一个新的“打开对话框(条件)”动作,仅在满足其条件时打开指定名称的对话框,而现有的“打开对话框”动作仍无条件地打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的无敌特性。
- 添加了一个新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了一个新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的伊利格人的物品附着问题。
- 修复了损坏的伊利格人弩攻击目标。
- 修复了与不可作为手持物品渲染的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在的模型部分的第三方 mixins 相关的崩溃问题 #756。
- 通过减少日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 刷屏消息问题。
- 提高了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃问题。
6.19.0
注意:此更新调整了对话框背景图像的大小(每边缩小 10x6 像素),如果您使用自定义对话框背景,可能需要相应调整。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752、#130。
- 通过为对话框文本添加打字机效果支持,修复了 #683、#215。
- 通过允许对话框、对话框按钮和交互的条件判断,修复了 #690、#309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 重构了对话框背景图像,每边缩小 10x6 像素。
- 重构了对话框屏幕布局,以更好地适应新的背景尺寸并改善外观。
- 为对话框文本添加了打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和动作。 - 添加了与对话框条件和按钮状态相关的较小 bug 修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或移除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件来修复 #745,以允许更复杂和动态的行为。
- 通过为较长文本添加对话框按钮工具提示来修复 #652。
- 通过添加命令值工具提示以显示完整值来修复 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏中有物品的条件。
- 添加了手持物品条件,支持(主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以允许对条件进行取反,从而实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统,以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的工具提示来修复 #738。
- 通过减少启动期间和游戏内的 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项来修复 #732。
- 通过在特定情况(如交易界面)下避免自动关闭来修复 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.1
- 通过扩展正确的基类来修复 #735。
- 修复了手动生成测试中发现的几个 26.1.2 版本特有的问题。
6.15.0 (交易、玩家头颅、Epic Fight 和质量改进更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能来修复 #730。
- 通过确保正确存储交易使用次数来修复 #729。
- 通过为玩家头颅添加自定义头颅支持来修复 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置来修复 #689。
- 通过新的交易配置屏幕和改进对自定义交易的支持来修复 #218 和 #132。
- 修复了在基本模式和普通/高级交易模式之间切换时的交易特定边缘情况。
- 通过显示完整文本的工具提示来修复对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步来修复 Cobblemon 动画问题。
- 添加了每个交易特定的操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕上添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例交易者。
- 清理测试文件。
6.14.0
- 通过确保在更改值时将更改同步到客户端来修复 #727。
- 通过为特定命令添加额外的白名单来修复 #726。
- 通过添加基本的 Cobblemon 支持(带有 Cobblemon NPC)来修复 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕来修复对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算来修复 x 和 z 根旋转问题。
- 添加了基本的 Cobblemon 支持,包括用于测试的自定义 NPC 类型和模型。
6.13.0 (安全和权限更新)
注意:此更新包括更好的安全检查和多玩家环境中的权限。它允许执行服务器命令,如果恶意使用,这些命令可能具有潜在危险性。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着它可能会将现有 NPC 的根旋转和缩放到默认值重置。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离来修复 #725。
- 通过支持 .sbnt 文件作为本地预设来修复 #722。
- 通过为对话框和配置屏幕背景添加专用资源来修复 #675。
- 通过新的安全检查系统和权限系统来修复 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例来修复 #469、#311。
- 通过移除冗余的背景渲染来修复配置屏幕背景的双重渲染问题。
- 通过调整边界框来修复 Ghast 和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多玩家环境中安全使用。
- 用静态背景替换了动态对话框屏幕背景,以获得更好的性能、自定义能力和兼容性。
- 用静态背景替换了动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 与配置屏幕渲染和资源相关的常规代码清理和优化。
6.12.0
- 通过基于原版模型添加针对自定义模型部分的额外检查来修复 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息来减少日志冗长,从而修复 #713。
- 通过减少过大尺寸的启动/配置日志输出来修复 #711。
- 添加了 NBT 验证守卫,以防止在生产环境中进行不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加了模型部分名称常量,以便在所有 mixin 中一致使用。
- 通过增强过滤逻辑和优化数据结构改进了 RenderEntityTypeSupportConfig,以提高性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析来修复 #710。
6.11.0
- 修复了 #703 在新自定义图层系统和手部渲染中的渲染问题。
- 通过为无效的交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅限服务器端,修复了头部追踪问题。
- 改进了
CustomLookAtPlayerGoal,以更好地处理边缘情况并减少抖动。 - 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 更新了带有新设计的标志。
6.10.0
- 通过为第三方实体创建添加 try-catch 块,修复了 #698。
- 通过在切换到
DEFAULT(原版)姿态时清除模型部分的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过修正根旋转枢轴以使用实际边界框高度而不是 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中错误的 UUID、加入/离开时缺少针对玩家目标的刷新,以及对离线目标的重试。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时自动锁定 ROOT 旋转;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加用于逃离玩家、村民、怪物等的额外 Flee 目标,修复了 #597。
- 修复了姿态加载问题,改为直接从模组资源读取而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许按 UUID 移除和重新生成 NPC,并可配置移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于从外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行回调操作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引。
- 将 EasyNPCItemAttachmentLayer 添加到各种实体渲染器中。
- 添加了专用的
Flee Objective(逃跑目标)配置选项卡,包含针对苦力怕、怪物、生物、玩家、村民和太阳的逃跑目标。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM(跟随物品)目标,使 NPC 能够根据资源位置(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看主人的目标。 - 在
SynchedDataIndex中添加了persistent(持久化)标志,这样临时索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 消费者在
SlimeBase中添加了可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET并将CAT_PURR映射到猫型 NPC,以增加驯服环境音效的变化。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本强制版本不匹配,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动,修复了 #665。
- 通过添加禁用鼠标光标跟随的选项以便于姿态调整,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过在使用 NPC 魔杖并潜行靠近 NPC 时将根旋转朝向玩家来快速旋转,修复了 #661。
- 通过在交互处理器中添加对移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过在交互处理器中添加对预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整边界框和眼睛高度计算,修复了史莱姆和恶魂的碰撞箱及名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置。
6.8.2
- 通过扩展
SafeMerchantData并添加 notifyTrade 以避免崩溃,修复了 #677。 - 添加了对基于玩家互动和操作提升 NPC 等级的进度数据支持。
- 添加了全局 NPC 跟踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原版模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而不是自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马生蛋模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和幻翼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便更轻松地与其他模组和自定义模型集成。
- 重构了内部数据处理和注册,以提高可维护性和未来改进的空间。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现 Wolf Leg Animations 在 setupAnim 方法中修复了 #650。
- 通过修正 canBeHitByProjectiles 翻译修复了 #648。
- 添加了
allowBypassInvulnerability配置选项,以允许/禁止绕过 NPC 的无敌状态,从而修复了 #645。 - 修复了删除按钮在小宽度下仍显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置界面中显示名称标签的问题。
- 修复了距离动作问题,即多个动作未能正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了 Cat NPC 和 Wolf NPC 的所有者数据未正确同步的问题。
- 添加了预设浏览器,以便更轻松地选择常见的 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了生成器系统以使用新的预设格式,以提高可维护性和未来的改进空间。
6.6.2
- 通过重写缩放系统修复了 #643。
- 修复了重启/重新加载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于团队的名称标签可见性支持,遵循原版 Team 机制。
6.6.1
- 通过重构内部数据显示属性的数据处理修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 通过使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止同一纹理的多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致的崩溃。
- 修复了 NPC 加载过程中出现的
defineId called for:警告消息。 - 重构了具有多级防御和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 的线程安全会话服务器防垃圾保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用 2 线程池和 500ms 速率限制。
- 改进了异常处理,为 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过添加 Gradle 依赖缓存改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件修复了 #632。
- 通过改善纹理处理性能、缓存和内存使用情况修复了 #629。
- 修复了 kill 命令对 NPC 无效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重载的问题。
- 修复了远程图像验证器中 WebP 验证的错误(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和未来的改进空间。
- 添加了基于时间的重载保护(60 秒),以替代永久阻塞机制。
- 添加了鸡、猪和狼缺失的变体纹理。
- 添加了纹理处理的额外单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实现剪刀裁剪功能修复了 #627,以更好地与其他模组兼容。
- 修复了 #625 在使用旋转或移动模型部件时的动画活跃性问题。
- 修复了使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 针对不同 NPC UUID 的屏幕切换逻辑修复了 #626,感谢
Spawnblade进行的详细调查和修复建议。
6.4.0
- 通过改进对话框数据验证和错误处理修复了 #626。
- 通过重构渲染数据和渲染处理修复了 #623。
- 通过确保自定义数据正确保存和加载修复了 #622。
- 修复了打开对话框的动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺少的 equals 和 hashCode 方法修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话框数据修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了部分对话框数据字段缺少默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框和记分板动作添加了条件支持。
- 为对话框添加了频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段改进了对话框按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型缺少翻译的问题。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,以便在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了自旋按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了在某些情况下关闭按钮无效的问题。
- 修复了屏幕切换时鼠标光标跳动的问题。
- 修复了翻译文件,并删除了重复及已过时的条目。
- 将 Easy NPC 法杖移至现有的核心物品标签页,而非新建一个。
- 为不同的模型部件(尾巴除外)添加了猫咪姿势支持。
- 通过在不需要时禁用发光效果,提升了 EasyNPCWand 发光效果的运行性能。
- 改进了自定义实体检测,排除了非生物实体如展示框、制造者、投掷物和刷怪笼。
- 改进了猫咪变种的处理逻辑。
6.1.1
- 通过检查物品是否在任一手中装备,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 通过强制同步特定模型的帽子和头部图层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本中的猫咪变种处理。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫咪渲染器。 - 修复了位置、缩放和旋转预览功能。
- 修复了精灵(Fairy)模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型的支持与性能。
- 改进了玩家皮肤到 UUID 映射的缓存机制。
- 将更改模型命令和逻辑限制为仅适用于 Doppler NPCs。
- 添加了
renderEntityRaw方法以原样渲染 NPC。
6.1.0 ✨
这是一个重大版本更新。请在更新前备份你的世界存档和 NPC 数据。此版本包含许多改进、优化和内部更改,不兼容早期版本。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要进行手动调整。
- 内部数据格式和部分行为已重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现已拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级的运行时和逻辑模块,依赖项极少。旨在用于服务器、整合包和开发者环境。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何进行此变更?
- 允许服务器和整合包仅在服务端部署 Core 模组,从而构建更精简的环境。
- 当不需要 UI 时,减少内存占用和加载时间。
- 通过分离 UI 和核心逻辑,加快开发和测试速度。
Easy NPC: Core (26.2) 更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界/NPC! 有关更多信息,请查阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏某个 NPC 的皮肤图层时同时隐藏同类型其他 NPC 的相应图层。
- 修复了僵尸型和末影人型 NPC 的自定义姿势被手臂动画覆盖的问题。
- 修复了在使用 "DEFAULT" 或 "NONE" 动画行走时,隐藏的身体部位重新显示的问题。
- 修复了旋转界面中“锁定身体”标签溢出显示的问题。
- 修复了投射物“物品 ID”字段隐藏了物品 ID 开头部分的问题。
- 修复了兽人战士英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生变化的问题。
7.18.0
- 修复了 #862:防止与 LetMeDespawn 等模组一起使用时 NPC 丢失。
- 修复了拥有近战和远程攻击能力的 NPC 在手持弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标点之间旋转以及史莱姆 NPC 攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后 Boss 血条仍停留在屏幕上的问题。
- 修复了在 Creative 模式下使用创造模式拾取器点击 NPC 无法获得其刷怪蛋的问题。
- 修复了“计分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 的金重型弩,并添加了皮革和铜制版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英语 Bogged 名称以及原始显示的“主手”/“副手”键名。
- 更改了预设物品的行为:在生存模式下生成 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 等模组设置的更高属性上限。 需要在服务器和客户端安装 AttributeFix 或类似模组;护甲值上限为 100。
- 修复了 #857:当未发生任何更改时,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当一个“打开对话框(条件性)”的条件不满足时,尝试执行下一个。
- 修复了动作和对话框上的“几率”条件被掷骰两次,导致实际几率降低的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear保持显示名称的问题。 - 修复了死亡、骑乘或被拴绳的 NPC 出现在肩膀上,以及断开连接时出现的肩膀渲染泄漏问题。
- 修复了隐藏头部保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受到影响;设置为 7 可保留旧版外观。
- 更改了“关闭对话框”和“回退”动作的执行时机:仅在未打开条件性对话框时运行。
- 更改了拥有传送距离的“跟随主人”NPC 的行为:使其能跟随主人进入其他维度。
- 更改了服务器停止时的行为:等待最长 2 分钟,以确保仍在写入的 NPC 文件完成保存。
- 更改了空闲 NPC 的反应延迟:对附近的玩家、坠落或压力板的反应延迟最多增加 0.5 秒。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 提升了 NPC 保存、备份、
/easy_npc list、肩膀同步和空闲 NPC 的性能。
7.16.0
- 修复了 #432:不再在目标被设置多次或移除后重复运行目标。
- 修复了 #852:使长矛能够击中可攻击的 NPC。
- 修复了当玩家无法将 NPC 从肩膀放下时,NPC 迷路的问题。
- 修复了“坐在肩膀上”的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自附加包的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成存储的 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命令设置。 - 更新了测试用的 NeoForge 版本至 26.2.0.93,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,保持预设导入静默。 - 修复了 #380:将 NPC 数量限制也应用于默认生成器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左撇子 NPC。
- 修复了 #851:锁定对话框按钮的范围限定于单个对话框,而非跨具有相同标签的多个对话框。
- 修复了已删除或重复的 NPC 重新出现、内存泄漏以及多个所有者和 UI 问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少 Epic Fight 生物补丁的问题。
- 修复了居中的库存屏幕及其关闭按钮与“自定义”交易选项卡重叠的问题。
- 修复了缩放后的 Doppler NPC 保留了被模仿实体的完整碰撞箱的问题。
- 修复了玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端必须使用相同的模组版本,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。 - 添加了使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行了更大规模的核心重构和代码清理。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名字标签和对话气泡位于其身体内部的问题。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致打击、点击和观察失效的问题。
- 修复了在网络数据包中读取过大的名称、列表和 NPC 数据时没有任何限制的问题。
- 修复了应用无效的 NPC 位置、缩放、属性、名称和持续时间的问题。
- 更改了精灵(Fairy)NPC 占用其模型的空间,使其发生碰撞并可被点击。
- 更改了骷髅(Skeleton)、流浪者(Stray)和沼泽僵尸(Bogged)NPC 的碰撞箱高度为标准原版高度,它们之前略微偏矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告将被替换的 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载,导致泄露 NPC 和清除选择的问题。
- 修复了选择框下拉列表被其后方的复选框和标签覆盖的问题。
- 修复了小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了在没有位置参数的情况下执行
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”功能在同一位置堆叠 NPC 的问题。
- 更改了“恢复”行为:当不允许时拒绝操作,而不是生成副本。
- 添加了排序、匹配计数、重载、自动关闭、NPC ID 以及预设和皮肤的提示框。
- 添加了带有限制、确认步骤和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 通过仅向魔杖持有者、所有者和管理员显示 Easy NPC Wand 的轮廓,修复了问题 #833。 其他玩家不再看到这些轮廓,且隐形 NPC 对他们保持隐藏状态。
- 通过在位置配置中添加“设置此处为家”和“重置家”按钮,修复了问题 #834。
- 通过在导出的预设中保留 NPC ID 和位置,使导入能够还原相同的 NPC,从而修复了问题 #835。
- 修复了预设导入和生成蛋丢失所有者列表条目及所有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失其所有者并变为无主状态的问题。
- 修复了选择列表仅显示前六个条目而隐藏其余条目的问题。
- 更改了导入预设的行为:改为在原位更新原始 NPC,而不是添加副本;请使用“作为新 NPC 导入”或预设物品来创建独立的 NPC。
- 更改了已完成交易的行为:播放“交易完成”音效,此前该音效处于静音状态。
- 更改了 API 对话框调用:当遇到未知的对话框标签时报告错误,而不是一直报告成功。
- 更改了没有手臂的 NPC 的行为:使其在头部或身体处持握物品,而不是隐藏它们。
- 将可选依赖项 Easy Model Entities 的版本要求更改为 2.4.0 或更高版本。
- 添加了包含对话、说话、游泳、进食和坠落伤害声音的“声音”配置。
- 在“声音”配置中添加了可搜索的声音选择器,并配有音量和音调滑块。
- 添加了“阻挡载具”选项,以防止 NPC 进入船只、矿车以及模组制作的椅子中。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型新增了内置皮肤。
- 添加了客户端设置,用于让姓名标签隐藏在墙壁后面以及控制魔杖轮廓的
highlightEnabled设置。 - 添加了“Exists”(存在)条件操作,并提供对 NPC 移动、动作和预设的 API 访问。
7.11.0
- 通过不再在 NPC 跟随或注视玩家时登出导致服务器冻结,修复了问题 #828。
- 通过将常规的 NPC 移除消息移至调试日志,修复了问题 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了问题 #832。
- 修复了大型世界中每小时 NPC 备份导致的卡顿,以及保留了已删除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、所有者和位置的问题。
- 修复了登录恢复所有者时重复、反复恢复、复活或移动未加载 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文字丢失并变得半透明的问题。
- 修复了在游戏包激活期间忽略 NPC “不透明度”的问题。
- 修复了翻译后的气泡文本和模组 API 文本的文本格式化和宏解析问题。
- 修复了在游戏包激活期间气泡及其文本一直隐藏在方块后面的问题。
- 添加了
minLightLevel,以保持气泡在黑暗环境中可读。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了问题 #829。
- 修复了流浪商人 NPC 渲染时缺少纹理的问题。
- 修复了渲染为蝙蝠、青蛙或监守者的 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 格,超出该范围才进行传送。
- 更改了“移动到”和“返回家园”:如果在三秒内没有进展则放弃。
- 更改了“移动到”动作的超时机制:现在计算真实刻数,此前运行时间过长。
- 更改了新的“随机游泳”目标:使其优先级低于跟随、逃跑和攻击目标。
- 更改了拥有 Easy Model Entities 模型的 NPC 的“不透明度”:由该模组本身应用。
- 将 Easy Model Entities 的最小版本要求更改为 2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳水平添加了“水面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,每项耗时超过 250 毫秒时发出警告。
7.8.1
- 通过让水中的鱼形 NPC 直立显示而非始终侧躺,修复了 #827。
- 通过防止受损的 NPC 阻止世界保存来修复 #828,现在它将回退到默认值。
- 修复了恢复的 NPC 拾取一个每次保存都会改变的随机预设 ID 的问题。
- 更改了 NPC 数据,仅在真正发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已处于目标位置的 NPC 的行为,使其立即完成移动。
- 将“无”皮肤选项卡更改为“高级”,其中包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”动作,可将 NPC 发送到某个位置、玩家、其所有者或家园。
- 添加了“移动并等待”动作,该动作仅在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时时间和可选传送功能。
- 添加了范围为 0 到 100 的“不透明度”属性,使身体、护甲和手持物品逐渐融合。
- 添加了“设置不透明度”动作,可将 NPC 变成幽灵或完全隐藏。
- 添加了“灯笼怨灵”预设,这是一个在正方形路径上行走的幽灵,在每个角落都有短线标记。
- 添加了 API 访问权限,用于控制移动动作和 NPC 的不透明度。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,可在应用前预览输入纹理下的 NPC。
7.7.7
- 通过保持 64x64 皮肤的透明度来修复 #821,Fresh Moves 需要此特性以正确显示眼睛。此前下载的皮肤需通过玩家皮肤屏幕中的按钮重新加载。
- 通过为村民和流浪商人 NPC 运行交易动作来修复 #818。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载内容的问题。
- 修复了未翻译的“执行限制”条件中的间隔名称(如
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_npc render texture命令,为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”动作添加了带计数和时间限制的“重复”播放模式。
- 添加了 API 访问权限,用于控制 Easy Model NPC 的动画变体、纹理槽位和纹理。
7.6.0
- 修复了重复实体数据追踪器 ID 导致的模组冲突错误提示不清晰的问题。
- 修复了第三方生命条在配置和对话框中 NPC 预览上方渲染的问题。
- 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而非其模型尺寸的问题。
- 修复了
/easy_npc命令在服务器上完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段上方的问题。
- 修复了动作编辑器中未翻译的“循环”、“当前之后”和“动作数据类型”标签。
- 修复了“几率”条件缺失提示文本的问题。
- 修复了长条件提示超出编辑器屏幕范围而未换行的问题。
- 修复了“消息”动作的帮助图标和文本按钮对齐不正确的问题。
- 修复了“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
- 修复了对话气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议,使其优先列出准星指向的 NPC,并仅显示没有权限的自身拥有的 NPC。
- 更改了预设导出功能,仅存储与新建 NPC 不同的部分,不包含位置或所有者信息。
- 更改了缺少目标或动作的预设,使其回退到其 NPC 类型的默认值。
- 更改了无玩家参与的事件(如“生成时”或“击杀时”),以检查其条件。其中包含基于玩家的条件(例如记分板或物品)的动作不再执行。
- 更改了基于时间的动作,当所有者附近时有将其设为
@initiator。 - 更改了对话气泡的可见时间,根据文本长度从 5 秒调整至 18 秒。
- 更改了“设置姿势”动作,使其仅在“自定义”姿势条目中显示其输入字段。
- 新增了五个固定步长的基于时间的动作,频率从约每 1 秒到约每 15 分钟不等。
- 新增了一个“消息”动作,用于发送聊天、系统消息和对话气泡文本,无需指令。
- 为“消息”动作添加了文本变体、发送者名称、接收者和翻译键。
- 将对话气泡图形作为
easy_npc:textures/gui/speech_bubble.png添加,供资源包使用。 - 新增了百分比形式的“几率”条件以及针对所有者和阵营的“关系”条件。
- 新增了生成、所有者登录、状态变更、白天/夜晚、天气以及缺失的“交易时”事件。
- 在每个 NPC 类型下的
easy_npc:api/preset/base/中添加了基础预设,可用作父预设。 - 新增了“流浪同伴”预设,这是一个由基于时间的消息构建的健谈 NPC。
- 新增了动作注册表、动作处理器、预设验证器以及更丰富的模组的动作数据。
- 为
/easy_npc命令的所有 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,支持无需输入即可出现,并容忍一个方块范围内的轻微偏差。
7.5.0
- 修复了 #814,通过为每个 Cobblemon NPC 赋予独立的状态动画,而非按物种共享。
- 修复了 #813,使“返回家园”功能可在任意距离生效,而不再仅限于家园附近。
- 修复了 #812,改为每个会话仅检查一次玩家是否更改了皮肤。
- 修复了 #810,现在接受资源包中的各类 Cobblemon 属性(如变种、性别等),而不再仅限“闪光”和“雌性”。
- 修复了 NPC 的家位置始终显示为未设置的问题,这会导致配置界面中隐藏“家”选项、保存时跳过该选项,并使“返回家园”和“在家附近漫步”功能失效。
- 修复了从预设生成、预设浏览器或重生生成的 NPC 永远无法获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 会保留导出该预设的世界的家位置,而不是使用其生成位置的问题。
- 修复了在配置、皮肤和预设界面中,当 Easy NPC Wand 高亮选中 NPC 时,NPC 被渲染为带有阴影的白色剪影的问题。
- 修复了拥有“引诱”目标的 NPC 在更新目标时导致服务器崩溃的问题。
- 修复了当预设中未存储任何 NPC 时,单个或 Boss 刷怪笼会在无任何数量限制的情况下刷新的问题。
- 修复了新建 NPC 时出现“旧版 Easy NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤的透明度校正缺失问题,该问题会导致图层伪影。
- 修复了查询玩家名称时玩家皮肤界面短暂冻结的问题。
- 修复了“重置注视...”目标标签在某些语言中被错误显示为“重置战利品...”的问题。
- 修复了导入预设后“无重力”属性被忽略的问题,这会导致 NPC 掉落。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在被重新生成后会失去其所有者(在消失之后)的问题。
- 修复了当提供某目标的模组在启动时缺失,导致该目标从 NPC 上被删除的问题。
- 修复了导入没有存储 ID 的预设时,生成的 NPC 没有所有者和家位置的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保持旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标虽可被存储但从未执行任何操作的问题。
- 修复了 Doppler NPC 及第三方模型的行走动画问题。
- 修复了 Forge 从未运行其服务器启动步骤的问题,这会导致整个会话期间 NPC 追踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发环境启动时不包含任何 Mixin 的问题,这会禁用原版实体调整并在生成 Fox 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、自定义目标和目标配置 API,增强了第三方支持。
7.4.0
- 修复了 #807,不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805,改为同时评估所有可见性设置,而不是在遇到第一个时停止。
- 修复了 #804,为 Doppler NPC 保留自定义名称,以支持基于名称的纹理和命名牌。
- 修复了 #803,调整资产以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测逻辑,此前会将日出误判为夜晚、日落误判为白天。
- 修复了下界和末地的可见性问题,此前错误地使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一次断言失败时才报错的问题,这导致后续的错误被隐藏。
- 修复了“骑乘”马匹皮肤变体从未显示马鞍的问题。
- 更改了“仅主人可见”和“仅队伍可见”选项,使其也遵循昼夜和游戏模式的规则。
- 更改了未佩戴“交叉双臂”姿态的唤魔者、幻术师和卫道士变体,使其保持手臂下垂姿态。
- 添加了“保卫阵营”目标,该目标会攻击伤害附近阵营成员或玩家的实体。
- 当阵营成员互相攻击且阵营选择不介入时,添加了一条系统消息。
- 为掠夺者添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置屏幕中添加了昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全缺失部分,改进了来自旧版本的显示属性数据。
- 改进了攻击目标屏幕,在未设置时禁用“保护主人”和“保卫阵营”选项。
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,添加了新的
target目标标签页,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 攻击特定目标。 - 修复了 #786,为 Cobblemon NPC 添加了性别和闪光模型变体,可通过
female或shiny在模型选择中搜索。 - 通过新增
Attackable by Factions(可被阵营攻击)战斗属性,修复了无敌 NPC 之间的阵营战斗问题。 - 修复了超大体型物种的 Cobblemon 模型选择预览,改为使用 Cobblemon 自身的配置文件比例进行缩放,而非使用碰撞箱高度。
- 通过验证阵营名称、排序阵营列表,并在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存,修复了自定义皮肤重载问题。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)工作,各自为其对应的攻击者群体打开一个可攻击的漏洞。 - 通过拆分大型处理器为更小的、专注于导入、导出和功能特定的组件,改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器与阵营编辑器屏幕,用于创建、着色和删除阵营及管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性标签页,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636 和 #622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对其他模组产生的极端值限制属性滑块的范围,修复了 #767。
- 通过为具有动作和条件的 NPC 添加自定义数据物品匹配功能,修复了 #754。
- 修复了由于纹理管理器在错误的线程中运行,可能导致 >= 1.21.x 版本出现崩溃和死锁的问题。
- 修复了空 UUID 的处理问题(针对动作条件)。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 金币、钥匙和红代币添加为具有动作和条件的 NPC 的可消耗物品。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的金币、钥匙和红代币物品数据。 - 添加了对抗其他模组极端值的属性防护机制。
- 将高生命值 NPC 的回退最大生命值从 1024 提升至 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与不可见 NPC 交互的选项,修复了 #459 和 #775。
- 修复了 #774 启动崩溃问题,该问题与可选的 Epic Fight 和 Cobblemon 实体类型映射有关。
- 通过在基础刻期间及打开交易屏幕前检查定时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件支持。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,支持昼夜时间和天气条件。
6.23.0
- 通过将 isSunBurnTick 错误迁移至 26.x 版本,修复了 #774。
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 #770 中 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的物品渲染问题。
- 修复了 #770 中 NPC 无法可靠地打开或关闭门的门循环问题。
- 通过添加对话选项和配置设置(buttonConditionMode: LOCK 或 HIDE),分别锁定或隐藏不可用的条件对话按钮,从而修复了 #760。
- 通过为名称提供包含 32 种颜色的颜色选择器弹出窗口以及手动 RGB/十六进制值输入,修复了 #709。
- 修复了在未指定颜色时重命名导致 NPC 名称颜色被重置的问题,改为保留现有名称颜色。
- 改进了门移动属性,当“打开门”或“关闭门”处于活动状态时,“穿过门”属性会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,提高了与依赖特定玩家数据的第三方模组和插件的兼容性,从而修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及示例 NPC 预设
Grukk, the Sparring Post,展示了如何使用这些条件,从而修复了 #764。 - 通过确保记录对话按钮的执行限制,修复了 #763。
- 提供了名为
One Wish Companion的示例 NPC 预设,从而修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)读取未注册的脑记忆时导致的第三方村民 AI 崩溃问题 #756。
- 修复了服务器端数据未锁定对话按钮的问题,此为 #760 和 #644 的前置准备。
- 通过添加条件对话打开支持/命令以更好地控制向玩家显示对话的时机,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 添加了更多的枪械到枪械标签中。
- 添加了新的“打开对话(条件)”动作,仅在满足条件时打开指定名称的对话;现有的“打开对话”动作保持无条件打开对话的行为。
- 为动作、对话和对话按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,使 Piglin、Piglin Brute 和 Zombified Piglin NPC 免疫伤害。
- 添加了新的“击退免疫”战斗属性,防止 NPC 受到近战或投射物攻击时的击退效果。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性界面,使其在主题上更加契合(此前位于能力界面)。
6.21.0
- 修复了持交叉手臂姿态的劫掠者物品附着问题。
- 修复了损坏的劫掠者弩攻击目标行为。
- 修复了因第三方物品无法作为手持物品渲染而导致的崩溃问题 #756。
- 修复了因第三方 Mixin 尝试访问不存在的模型部件而导致的崩溃问题 #756。
- 通过降低日志详细程度并为自定义模型部件添加额外检查,修复了 log.info 垃圾信息刷屏问题。
- 提升了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器,移除了默认的手持物品图层。
6.20.0
- 修复了因第三方模组尝试访问不存在的 NPC 目标行为而导致的崩溃问题。
6.19.0
注意:此更新将对话背景图像调整了 10x6 像素,如果您使用的是自定义背景,可能需要相应调整。
- 通过添加对话按钮条件支持以允许禁用按钮,修复了 #752 和 #130。
- 通过添加对话文本的打字机效果支持,修复了 #683 和 #215。
- 通过允许为对话、对话按钮和交互设置条件,修复了 #690 和 #309。
- 修复了对话屏幕布局和背景的较小 UI 问题。
- 重构了对话背景图像,每侧调整了 10x6 像素。
- 重构了对话屏幕布局,以更好地适应新的背景尺寸并改善外观。
- 添加了对话文本的打字机效果及客户端配置选项。
- 添加了条件符号,用于指示对话、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含多种条件和动作。 - 添加了与对话条件和按钮状态相关的较小修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或删除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件来修复 #745,以允许更复杂和动态的行为。
- 通过为较长文本添加对话框按钮提示框来修复 #652。
- 通过添加命令值提示框以显示完整值来修复 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏中有物品的条件。
- 添加了手持物品条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以允许对条件进行取反,从而实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以支持更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的提示框来修复 #738。
- 通过在启动期间和游戏内减少 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项来修复 #732。
- 通过在特定情况(如交易界面)下避免自动关闭来修复 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框的头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.1
- 通过扩展正确的基类来修复 #735。
- 修复了手动生成测试中几个与 26.1.2 相关的问题。
6.15.0 (交易、玩家头颅、Epic Fight 和质量提升更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能来修复 #730。
- 通过确保正确存储交易使用次数来修复 #729。
- 通过为玩家头颅添加自定义头颅支持来修复 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置来修复 #689。
- 通过新的交易配置屏幕和改进的自定义交易支持来修复 #218 和 #132。
- 修复了在基本模式和普通/高级交易模式之间切换时的交易特定边缘情况。
- 通过显示完整文本的提示框来修复对话框按钮文本截断问题。
- 通过将动画状态与 Cobblemon Animation System 同步来修复 Cobblemon 动画问题。
- 添加了针对每项交易的特定操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕上添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例商人。
- 清理测试文件。
6.14.0
- 通过确保更改在修改值时同步到客户端来修复 #727。
- 通过为特定命令添加额外的白名单来修复 #726。
- 通过添加基本的 Cobblemon 支持(使用 Cobblemon NPC)来修复 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕来修复对话框错位和导航问题。
- 通过更正旋转逻辑和枢轴计算来修复 x 和 z 轴根旋转问题。
- 通过为测试添加自定义 NPC 类型和模型,提供了基本的 Cobblemon 支持。
6.13.0 (安全和权限更新)
注意:此更新包括更好的安全检查和多玩家环境中的权限控制。它允许执行服务器命令,如果被恶意使用,可能会带来潜在风险。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有的 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离来修复 #725。
- 通过支持 .sbnt 文件作为本地预设来修复 #722。
- 通过为对话框和配置屏幕背景添加专用资源来修复 #675。
- 通过新的安全检查系统和权限系统来修复 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例来修复 #469、#311。
- 通过移除冗余的背景渲染来修复配置屏幕背景的双重渲染问题。
- 通过调整边界框来修复 Ghast 和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多玩家环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、定制性和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了常规代码清理和优化,涉及配置屏幕渲染和资源方面。
6.12.0
- 通过基于原版模型添加自定义模型部分列表的额外检查来修复 #714。
- 通过降低每个 NPC 的 INFO 消息级别至 DEBUG 并合并冗余警告消息来减少日志冗长程度,从而修复 #713。
- 通过减少过大的启动/配置日志输出来修复 #711。
- 修复了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 向 EasyNPCModelManager 添加了模型部分名称常量,以便在 mixins 中一致使用。
- 改进了 RenderEntityTypeSupportConfig,增强了过滤逻辑并优化了数据结构,以提高性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析来修复 #710。
6.11.0
- 修复了在使用新的自定义层级系统和手部渲染时出现的 #703 渲染问题。
- 通过为无效的交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了头部位置修改后智能动画无法正常工作的问題。
- 通过将玩家检测移回仅服务器端,修复了头部追踪问题。
- 优化 CustomLookAtPlayerGoal 以更好地处理边缘情况并减少抖动。
- 修复了 Doppler NPC 保留其手部背包的问题。
- 改进了 PoseManager 的日志消息。
- 更新了标志设计。
6.10.0
- 通过为第三方实体创建添加 try-catch 块,修复了 #698。
- 通过在切换到
DEFAULT原版姿态时清除模型部分的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过将根旋转枢轴更正为使用实际边界框高度而非 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理程序中的错误 UUID、加入/离开时缺少针对玩家的刷新以及针对离线目标的重试机制。 - 修复了在目标注销后保留目标引用的问题。
- 移除了加载姿态时的 ROOT 旋转自动锁定;现在由用户控制根锁定。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余地重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加用于逃离玩家、村民、怪物等的额外逃跑目标,修复了 #597。
- 修复了姿态加载问题,改为直接从模组资源读取而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并可配置移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,以便从外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,使 NPC 在执行回调动作之前移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引。
- 在各种实体渲染器中添加了 EasyNPCItemAttachmentLayer。
- 添加了专用的
Flee Objective(逃离目标)配置选项卡,包含针对苦力怕、怪物、生物、玩家、村民和太阳的逃离目标。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM(跟随物品)目标,使 NPC 能够跟随按资源位置标识的物品实体(例如minecraft:apple)。 - 添加了
LookAtEntityByUUIDGoal,并在注视目标屏幕中启用了按 UUID 注视实体和注视主人的目标。 - 在
SynchedDataIndex中添加了persistent(持久化)标志,这样瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 消费者在
SlimeBase中添加了可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET并将CAT_PURR(猫呼噜声)映射到驯服的猫 NPC,以增加环境声音的多样性。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本强制执行版本不匹配检查,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动功能,修复了 #665。
- 通过添加禁用跟随鼠标光标的选项以便于姿态调整,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过添加使用 NPC 魔杖并潜行靠近 NPC 以快速旋转根部朝向玩家的功能,修复了 #661。
- 通过在交互处理程序中检查移动工具,修复了移动工具错误触发交互的问题。
- 通过在交互处理程序中检查预设物品,修复了预设物品错误触发交互的问题。
- 通过调整边界框和眼睛高度计算,修复了史莱姆和恶魂的碰撞箱及名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置问题。
6.8.2
- 通过扩展
SafeMerchantData并添加 notifyTrade 以避免崩溃,修复了 #677。 - 添加了基于玩家互动和行为的 NPC 升级进度数据支持。
- 添加了全局 NPC 追踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原始模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而不是自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马刷怪蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、掠夺者、铁傀儡、史莱姆和幻翼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便更轻松地与其他模组和自定义模型集成。
- 重构了内部数据处理和注册机制,以提高可维护性和便于未来改进。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现 Wolf Leg Animations(狼腿动画)在 setupAnim 方法中修复了 #650。
- 通过修复 canBeHitByProjectiles 的翻译修复了 #648。
- 添加了
allowBypassInvulnerability配置选项,以允许/禁止 NPC 绕过无敌状态,从而修复了 #645。 - 修复了删除按钮即使宽度较小也显示标签的问题。
- 修复了某些情况下上下按钮定位不正确的问题。
- 修复了对话框和配置界面中出现名称标签的问题。
- 修复了距离动作问题,即多个动作未能正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据同步不正常的问题。
- 添加了预设浏览器,以便更轻松地选择常用 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于分享 NPC 预设。
- 重构了现有 NPC 预设,使其使用新的 .snbt 格式。
- 重构了生成器系统,以使用新的预设格式,从而提高可维护性并为未来改进奠定基础。
6.6.2
- 通过重写缩放系统修复了 #643。
- 修复了重启/重新加载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 为更精细地控制 NPC 名称显示,添加了 MID 和 MOUSE_OVER 名称标签可见性模式。
- 添加了对尊重原版 Team 的团队基础名称标签可见性支持。
6.6.1
- 通过重构内部数据处理以处理显示属性,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 通过使用原子操作修复了纹理重载保护中的竞争条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止对同一纹理进行多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载期间出现的
defineId called for:警告消息。 - 通过多级防御和速率限制重构了纹理加载架构。
- 重构了实体数据注册逻辑,以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了基于 ConcurrentHashMap 的线程安全会话服务器防垃圾信息保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用 2 线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 使用了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤问题。
- 通过为 Gradle 依赖项添加缓存,改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了击杀命令无法作用于 NPC 的问题。
- 修复了纹理重载保护阻止在驱逐后重新加载缓存的问题。
- 修复了远程图像验证器中的 WebP 验证错误(缺少返回语句)。
- 重构了纹理处理逻辑,以提高可维护性并为未来改进奠定基础。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了鸡、猪和狼缺失的变体纹理。
- 添加了针对纹理处理的额外单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实施剪刀效果实现了更好的与其他模组的兼容性,修复了 #627。
- 修复了在使用旋转或移动模型部件时生动的动画问题,修复了 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿势动画控制,提供智能、默认和无选项。
6.4.1
- 针对不同 NPC UUID 的屏幕切换逻辑进行了修复,感谢
Spawnblade进行的详细调查和修复建议,修复了 #626。
6.4.0
- 通过改进对话框数据验证和错误处理,修复了 #626。
- 通过重构渲染数据和渲染处理,修复了 #623。
- 通过确保自定义数据正确保存和加载,修复了 #622。
- 修复了打开对话框动作类型,以允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺少的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话框数据,修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了部分对话框数据字段缺少默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框和记分板动作添加了条件支持。
- 为对话框添加了频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段改进了对话框按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的翻译缺失问题。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,以在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了自旋按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了部分情况下关闭按钮无效的问题。
- 修复了在屏幕过渡期间鼠标光标跳动的问题。
- 修复了翻译文件,并删除了重复及已过时的条目。
- 将 Easy NPC 法杖移至现有的核心物品标签页,而非创建新的标签页。
- 为不同的模型部件(尾巴除外)添加了猫姿态支持。
- 通过在不必要时禁用发光效果,提升了 EasyNPCWand 发光效果的表演性能。
- 通过排除非生物实体(如显示实体、制造者、投掷物和刷怪笼),改进了自定义实体检测。
- 改进了猫变种的处理方式。
6.1.1
- 通过检查物品是否装备在任一手中,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 通过对特定模型强制同步帽子和头部层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本的猫变种处理。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫渲染器问题。 - 修复了位置、缩放和旋转预览功能。
- 修复了精灵模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型的支持和性能。
- 优化了玩家皮肤的玩家到 UUID 映射的缓存。
- 将更改模型命令和逻辑限制为仅限 Doppler NPCs。
- 添加了 renderEntityRaw 方法以按原样渲染 NPC。
6.1.0 ✨
这是一个重大版本。请在更新前备份你的世界和 NPC 数据。此版本包含许多改进、优化和内部更改,与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要手动调整。
- 内部数据格式和部分行为已重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,同时包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级运行时和 NPC 逻辑,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何进行此更改?
- 允许服务器和整合包仅在服务器端分发 Core 模组,以实现更精简的设置。
- 当 UI 并非在所有地方都需要时,减少内存占用和加载时间。
- 通过分离 UI 和核心逻辑,加快开发和测试速度。
Easy NPC: Core (26.1.2) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请前往 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界/NPC! 更多信息请参阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏皮肤层的一个 NPC 将其隐藏效果应用于其他同类 NPC。
- 修复了僵尸类和人型末影人(enderman)NPC 的自定义姿势被手臂动画覆盖的问题。
- 修复了在“DEFAULT”或“NONE”动画下行走时,隐藏的身体部位重新显示的问题。
- 修复了“锁定身体”标签在旋转界面中溢出显示的问题。
- 修复了投射物“Item ID”字段遮挡 Item ID 开头部分的问题。
- 修复了兽人战士英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生变化的问题。
7.18.0
- 修复了 #862:防止在使用 LetMeDespawn 等模组加载时 NPC 丢失。
- 修复了同时拥有近战和远程攻击能力的 NPC 在手持弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标之间移动时旋转,以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后 Boss 条仍停留在屏幕上的问题。
- 修复了在创造模式下对 NPC 使用快捷拾取(pick block)不掉落其刷怪蛋的问题。
- 修复了“记分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 模组中的金色重型弩,并添加了皮革和铜制版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误信息和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英文 Bogged 名称以及原始的主手/副手键名。
- 更改了预设物品:在生存模式中生成 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 等模组设置的更高属性上限。 服务器和客户端均需安装 AttributeFix 或类似模组;护甲值上限固定为 100。
- 修复了 #857:当内容未发生变化时,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当一个“打开对话框(条件式)”的条件不满足时,尝试执行下一个。
- 修复了动作和对话框上的“概率”条件被掷骰两次,导致实际概率降低的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或拴绳的 NPC 出现在肩膀上,以及断开连接时肩膀渲染泄漏的问题。
- 修复了隐藏头部时保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保持默认开关的现有 NPC 也会受到影响;设置为 7 可保留旧版外观。
- 更改了“关闭对话框”和“回退”动作:当没有条件对话框打开时执行。
- 更改了具有传送距离的“跟随主人”NPC:使其能跟随主人进入其他维度。
- 更改了服务器停止行为:等待最多 2 分钟,以便完成仍在写入的 NPC 文件。
- 更改了闲置 NPC 的反应延迟:对附近的玩家、坠落或压力板的反应延迟增加至 0.5 秒。
- 新增了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 提升了 NPC 保存、备份、
/easy_npc list、肩膀同步和闲置 NPC 的性能。
7.16.0
- 修复了 #432:不再在目标被多次设置或移除后重复运行目标。
- 修复了 #852:长矛现在可以击中可攻击的 NPC。
- 修复了当玩家无法将 NPC 从肩膀卸下时,NPC 迷路的问题。
- 修复了“坐于肩头”的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自附加组件的 Easy Model Entities 风格的 NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成已存储的 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命令设置。 - 更新:测试通过的 NeoForge 版本至 26.1.2.120,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,预设导入保持静默。 - 修复了 #380:NPC 数量限制也适用于默认刷怪器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左撇子 NPC。
- 修复了 #851:对话按钮按单个对话锁定,而非跨具有相同标签的多个对话锁定。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及若干所有者和 UI 问题。
- 修复了 Epic Fight Wither Skeleton(凋灵骷髅)NPC 缺少其 Epic Fight 生物补丁的问题。
- 修复了非居中的库存界面及其关闭按钮与“自定义”交易选项卡重叠的问题。
- 修复了缩放后的 Doppler NPC 保留了被模仿实体的完整碰撞箱的问题。
- 修复了位于玩家肩膀上的 NPC 忽略其自身缩放比例及 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端需使用相同的模组版本,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。 - 新增:使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 核心重构和代码清理工作加大。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名称标签和对话气泡嵌入其身体内的问题。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和注视判定失误的问题。
- 修复了在网络数据包中无限制地读取过大的名称、列表和 NPC 数据的问题。
- 修复了应用无效的 NPC 位置、缩放、属性、名称和持续时间的问题。
- 更改:精灵 NPC 现在占据其模型的整个空间,从而产生碰撞并可被点击。
- 更改:骷髅、流浪者和沼泽尸骸(Bogged)NPC 的碰撞箱高度改为原版标准,此前它们略微偏矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同版本的模组。
7.12.1
- 修复了 #836:始终显示“恢复”,包括数据包预设,并附带原因提示框。
- 修复了预设导入和导出消息缺失、错误或未警告关于替换 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载,导致泄露 NPC 和清除选择的问题。
- 修复了选择框下拉列表被其后方的复选框和标签遮挡的问题。
- 修复了在小窗口中预设列表排序、过滤顺序和布局裁剪选项的问题。
- 修复了
/easy_npc preset import data在没有指定位置时将位置作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”导致多个 NPC 堆叠在同一位置的问题。
- 更改:“恢复”功能在不被允许时拒绝操作,而不是生成副本。
- 新增:预设和皮肤的排序、匹配计数、重载、自动关闭、NPC ID 及工具提示。
- 新增:带有限制、确认对话框和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 通过仅向魔杖持有者、所有者和管理员显示简易 NPC 魔杖轮廓,修复了 #833。 其他玩家不再看到轮廓,隐形 NPC 对他们保持隐藏。
- 通过在位置配置中添加“设置此处为家”和“重置家”按钮,修复了 #834。
- 通过在导出的预设中保留 NPC ID 和位置,使导入能恢复相同的 NPC,修复了 #835。
- 修复了预设导入和生成蛋丢失所有者列表条目和所有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失其所有者并变为无主状态的问题。
- 修复了选择列表仅显示前六个条目而隐藏其余条目的问题。
- 更改了导入预设的行为:现在会在其存储的位置更新原始 NPC,而不是添加副本;使用“作为新 NPC 导入”或预设物品来创建单独的 NPC。
- 更改了已完成交易的音效,使其播放“交易完成”声音(此前静音)。
- 更改了 API 对话框调用,使其报告未知的对话框标签,而不是一直报告成功。
- 更改了没有手臂的 NPC 的行为:改为在头部或身体处携带手持物品,而不是隐藏它们。
- 将可选依赖项 Easy Model Entities 的版本要求更改为 2.4.0 或更高版本。
- 添加了包含对话框、说话、游泳、进食和坠落伤害声音的“声音”配置。
- 在“声音”配置中添加了可搜索的声音选择功能,并配有音量和音调滑块。
- 添加了“阻止车辆”选项,以防止 NPC 进入船、矿车以及模组制作的椅子。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型添加了新的内置皮肤。
- 添加了客户端设置,用于隐藏墙壁后的名称标签以及魔杖轮廓的
highlightEnabled功能。 - 添加了“存在”条件操作,并提供了对 NPC 移动、动作和预设的 API 访问。
7.11.0
- 通过不再在 NPC 跟随或注视玩家时注销服务器导致服务器冻结,修复了 #828。
- 通过将常规 NPC 移除消息移至调试日志,修复了 #831。
- 通过使人形 NPC 忽略自定义玩家模型、动画和姿势,修复了 #832。
- 修复了大型世界中每小时 NPC 备份导致的卡顿,以及保留了已移除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份丢失被备份 NPC 的身份、所有者和位置的问题。
- 修复了登录恢复所有者时重复、反复恢复、复活或移动未加载的 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或错误警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文本丢失并变得半透明的问题。
- 修复了在使用光影包时忽略 NPC “不透明度”的问题。
- 修复了翻译后的对话气泡和模组 API 文本的文本格式化和宏解析问题。
- 修复了在使用光影包时,对话气泡及其文本停留在方块后面的问题。
- 添加了
minLightLevel,以保持黑暗环境中对话气泡的可读性。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了 #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 格,超出该范围才进行传送。
- 更改了“移动到”和“移回家园”的行为,使其在无进展三秒后放弃。
- 更改了“移动到”动作的超时计算方式,使其计算真实刻数,此前运行时间过长。
- 更改了新的“随机游泳”目标的优先级,使其低于跟随、逃跑和攻击目标。
- 更改了具有 Easy Model Entities 模型的 NPC 的“不透明度”,使其由该模组本身应用。
- 将最低要求的 Easy Model Entities 版本更改为 2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳水平添加了“水面以下深度”和“地面以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,每项超过 250 毫秒时发出警告。
7.8.1
- 修复了 #827:使水中的鱼形 NPC 直立显示,而非总是侧身翻倒。
- 修复了 #828:防止受损的 NPC 阻碍世界保存,现在它会回退到默认值。
- 修复了恢复后的 NPC 拾取随机预设 ID(该 ID 每次保存时都会变化)的问题。
- 更改了 NPC 数据逻辑,仅在实际发生变化时才将其写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已到达目标位置的 NPC 的行为,使其立即完成移动。
- 将“无”皮肤选项卡更名为“高级”,其中包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”动作,可将 NPC 发送至指定位置、玩家、其所有者或家园。
- 添加了“移动并等待”动作,仅在抵达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时设置以及可选的传送功能。
- 添加了范围为 0 到 100 的“不透明度”属性,用于使身体、盔甲和手持物品逐渐淡入/淡出。
- 添加了“设置不透明度”动作,可使 NPC 变为幽灵状态或完全隐藏。
- 添加了“灯笼怨灵”预设,这是一个在正方形路径上行走的幽灵,在每个角落处留下一条短线。
- 添加了对 NPC 移动动作和不透明度的 API 访问权限。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,可在应用前预览输入纹理下的 NPC 效果。
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_npc render texture命令为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”动作添加了带计数和时间限制的“重复”播放模式。
- 添加了对 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。 - 新增了百分比形式的“几率”条件以及针对所有者和阵营的“关系”条件。
- 新增了生成、所有者登录、状态变更、白天/夜晚、天气以及缺失的“交易时”事件。
- 在每个 NPC 类型下的
easy_npc:api/preset/base/目录中新增了基础预设,可用作父级预设。 - 新增了“流浪同伴”预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 为模组新增了动作注册表、动作处理器、预设验证器以及更丰富的EventData。
- 为
/easy_npc命令的每个 NPC 建议新增了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,该建议在未输入内容时即可出现,并容忍一个方块内的轻微偏差。
7.5.0
- 修复了 NPC 的家位置始终显示为未设置的问题,这会导致在配置界面中隐藏“Home”(家)、保存时跳过该选项,并使“Move back to Home”(返回家中)和“Stroll around Home”(在家中漫步)功能失效。
- 修复了通过预设、预设浏览器或重生生成的 NPC 无法获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 使用了导出该预设的世界的家位置,而不是其出生位置的问题。
- 修复了在 Easy NPC Wand(简易 NPC 法杖)高亮选中时,NPC 在配置、皮肤和预设界面中显示为带有阴影的白色剪影的问题。
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非每个物种共用一个),修复了问题 #814。
- 通过允许“Move back to Home”(返回家中)在任何距离生效(而不仅仅是靠近家时),修复了问题 #813。
- 通过在每次会话中检查一次玩家是否更改了皮肤,修复了问题 #812。
- 通过接受资源包中的 Cobblemon 方面属性,而不仅仅是“shiny”(闪光)和“female”(雌性),修复了问题 #810。
- 修复了当具有“Tempt”(引诱)目标的 NPC 计算目标时导致服务器崩溃的问题。
- 修复了单个或 Boss 刷怪笼在没有存储任何 NPC 的预设导入后,生成数量没有限制的问题。
- 修复了新创建的 NPC 也会显示“Legacy Easy NPC Data”(旧版简易 NPC 数据)警告的问题。
- 修复了旧版 64x32 皮肤的透明度校正缺失问题,这些问题会导致图层伪影。
- 修复了在查询玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中“Reset look at ...”(重置注视对象...)标签错误显示为“Reset loot at ...”(重置掉落物于...)的问题。
- 修复了预设导入后“No Gravity”(无重力)属性被忽略的问题,这会导致 NPC 坠落。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在被驱散后重新生成时会失去所有者身份的问题。
- 修复了在游戏开始时提供相关目标的模组缺失时,NPC 的目标被删除的问题。
- 修复了导入没有存储 ID 的预设时,会生成没有所有者和家位置的 NPC 的问题。
- 修复了所有者变更后,“Follow owner”(跟随所有者)和“Look at owner”(注视所有者)仍保持旧目标的问题。
- 修复了攻击目标在被瞄准实体消失后仍分配给 NPC 的问题。
- 修复了“Look at Item”(注视物品)目标虽然可以存储但从未执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画。
- 修复了 Forge 从未运行其服务器启动步骤的问题,这导致整个会话期间 NPC 追踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发环境启动时缺少 Mixin 的问题,这会导致原版实体调整失效,并在生成 Fox NPC(狐狸 NPC)时崩溃。
- 将移动目标改为固定顺序:逃跑、跟随、回家,然后漫步。因此,具有多个移动目标的 NPC 行为可能与之前有所不同。
- 更改了将预设插入原版怪物刷怪笼的行为,以保留其延迟、数量和范围。
- 更改了未选择目标的“Follow owner”(跟随所有者)和“Look at owner”(注视所有者)目标,使其跟随 NPC 的所有者。
- 将数据包预设路径更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 更改了预设浏览器的显示顺序,使其始终按相同顺序列出条目。
- 移除了实验性的用户定义 NPC 功能;不再读取或创建额外的配置文件。
- 移除了未使用的
SERVER_SKIN皮肤类型。 - 添加了新的游戏测试结构,以支持 1.21.11 及更高版本的游戏测试。
- 为玩家皮肤屏幕的每个条目添加了重载按钮,以便重新获取单个皮肤。
- 每当移除 NPC 时,日志中添加原因,以便追踪意外的驱散事件。
- 为
/easy_npc render set species命令添加了建议提示。 - 添加了对其他模组预设的支持,这些预设不再必须使用
easy_npc命名空间。 - 添加了预设可见性功能,可将预设从预设浏览器和 NPC 界面中隐藏。
- 为跟随目标添加了传送距离和休息点偏移量。
- 为“Follow item”(跟随物品)目标添加了物品标签、“can be scared”(可被惊吓)选项和“only without owner”(仅限无所有者时)选项。
- 为注视目标添加了物品字段,使 NPC 可以注视选定的掉落物品。
- 为每个 NPC 添加了标识符,以便模组能够重新找到自己的 NPC。
- 添加了当所有者上线时重新生成 NPC 的选项。
- 为 NeoForge 添加了游戏测试(此前没有),并恢复了在更新到 1.21.11 过程中丢弃的生成蛋、对话框界面、数据隔离和烟雾测试。
- 为每个配置和编辑器界面添加了游戏测试,覆盖所有三种加载器。
- 为家位置添加了游戏测试,涵盖出生默认值、存储值和重载情况。
- 改进了模型名称解析逻辑,此前会将以“_shiny”结尾的物种误认为是变体。
- 改进了飞行 NPC 的跟随逻辑,现在在没有空中路径时会直接转向。
- 通过提供用于预设、自定义目标和目标配置的 API,改进了第三方支持。
7.4.0
- 修复了 #807,不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805,改为同时评估所有可见性设置,而不是在遇到第一个时停止。
- 修复了 #804,保留 Doppler NPC 的自定义名称以用于基于名称的纹理和命名牌。
- 修复了 #803,调整资产以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测逻辑,此前会将日出计为夜晚、日落计为白天。
- 修复了在下界和末地中的可见性问题,此前错误地使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一次断言失败时才会报错的问题,这会导致后续的错误被隐藏。
- 修复了“骑乘”马匹皮肤变体,此前从未显示马鞍。
- 更改了“仅主人可见”和“仅队伍可见”选项,使其也遵循昼夜和游戏模式的规则。
- 更改了没有“交叉双臂”特征的唤魔者、幻术师和卫道士变体,使其保持手臂下垂的姿态。
- 添加了“保卫阵营”目标,攻击伤害附近阵营成员或玩家的实体。
- 添加了阵营成员互相战斗且阵营保持中立的系统消息。
- 为灾厄村民添加了头部装备槽,以便移除或更换其队长旗帜。
- 在显示配置界面中添加了昼夜预览功能。
- 为可见性属性和阵营防御添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全缺失项,改进了旧版本版本的显示属性数据。
- 改进了攻击目标界面,在未设置时禁用“保护主人”和“保卫阵营”。
7.3.0
- 通过将皮肤变体的数据作为类型化字段存储而非解析变体名称,改进了皮肤变体功能。
- 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
- 通过为
get(String)查找操作提供共享的EnumUtils辅助类,减少了重复的枚举代码。 - 优化了村民职业和类型的查找,改用直接注册表键而非扫描方式。
- 通过在构造时缓存标签名称、ID 和键,优化了枚举名称查找。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.1.2
- 修复了 #801,通过使用 NPC、对话框和操作 UUID 的组合来避免动作跟踪和执行限制方面的冲突。
7.1.1
- 修复了 #800,采用惰性加载实体类型。
- 修复了 #799,修复了边缘情况并添加了更多文档及更好的日志消息。
- 修复了 #798,将控制台、命令和命令方块视为可信的命令来源。
- 修复了一个严重的单人/LAN 问题,此前客户端和服务器的 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,添加了新的
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 指定特定目标。 - 修复了 #786,为 Cobblemon NPC 添加了性别和闪光模型变体,可在模型选择中通过
female或shiny进行搜索。 - 修复了无敌 NPC 之间的阵营战斗问题,通过添加新的
Attackable by Factions(可被阵营攻击)战斗属性。 - 修复了超大体型物种的 Cobblemon 模型选择预览,改用 Cobblemon 自身的配置文件比例进行缩放,而非命中盒高度。
- 通过验证阵营名称、排序阵营列表并在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存,修复了自定义皮肤重载问题。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)生效,各自为其对应的攻击者群体打开一个特定的漏洞。 - 通过拆分大型处理器为更小的、专注于导入、导出和功能特定的组件,改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和管理编辑界面,用于创建、着色和删除阵营,并管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性选项卡,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636、#622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对来自其他模组的极端值进行属性滑块钳制,修复了 #767。
- 通过为具有行为和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了纹理管理器在错误的线程运行可能导致 >= 1.21.x 版本崩溃和死锁的问题。
- 修复了行为条件中处理空 UUID 的问题。
- 修复了行为的执行限制重置问题。
- 添加了纹理注册队列,以避免在同一刻(tick)内发生多个同时下载。
- 将 NPC 硬币、钥匙和红令牌作为具有行为和条件的 NPC 的可消耗物品添加。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红令牌物品数据。 - 添加了针对来自其他模组的极端值的属性保护机制。
- 将高生命值 NPC 的回退最大生命值从 1024 增加到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459、#775。
- 修复了与可选模组 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基础刻检查定时交易重置并在打开交易界面之前进行检查,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含昼夜时间和天气条件。
6.23.0
- 通过将 isSunBurnTick 错误迁移到 26.x,修复了 #774。
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和类人皮肤)的 #770 物品渲染问题。
- 修复了 NPC 不 reliably 打开或关闭门的 #769 门循环问题。
- 通过添加对话选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的手动 RGB/十六进制值的颜色选择器弹出窗口,修复了 #709。
- 修复了在未指定颜色时重命名导致 NPC 名称颜色被重置的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,当“开门”或“关门”激活时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行以更好地兼容依赖特定玩家数据的第三方模组和插件,修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)上第三方村民 AI 读取未注册的脑记忆导致的崩溃问题 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做准备。
- 通过添加条件对话打开支持/命令以更好地控制何时向玩家显示对话,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 向枪标签添加了更多枪支。
- 添加了新的“打开对话(条件性)”行为,仅在满足条件时打开命名对话,而现有的“打开对话”行为继续无条件打开对话。
- 为行为、对话和对话按钮添加了新的实体生命值和 NPC 生命值条件。
- 添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的无敌状态,以与其他 NPC 保持一致。
- 添加了新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(之前在能力屏幕上)。
6.21.0
- 修复了持交叉手臂姿势的灾厄村民的物品附着问题。
- 修复了损坏的灾厄村民弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在的模型部分的第三方 Mixin 相关的崩溃问题 #756。
- 通过减少日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 垃圾信息问题。
- 提高了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃问题。
6.19.0
注意:此更新将对话背景图像调整了 10x6 像素,如果您使用的是自定义背景,可能需要调整它们。
- 通过添加对话按钮条件支持以允许禁用按钮,修复了 #752、#130。
- 通过为对话文本添加打字机效果支持,修复了 #683、#215。
- 通过允许对话、对话按钮和交互的条件,修复了 #690、#309。
- 修复了对话屏幕布局和背景的较小 UI 问题。
- 重构了对话背景图像,每侧调整了 10x6 像素。
- 重构了对话屏幕布局以更好地适应新的背景尺寸并改善外观。
- 添加了对话文本的打字机效果和客户端配置。
- 添加了条件符号以指示对话、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和行为。 - 添加了与对话条件和按钮状态相关的较小修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或删除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件以支持更复杂和动态的行为,修复了 #745。
- 通过为长文本添加对话框按钮提示框,修复了 #652。
- 通过添加命令值提示框以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了库存中有物品的条件。
- 添加了手持物品条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,允许对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并替换为随机 UUID。 - 重构了条件系统以支持更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外提示框,修复了 #738。
- 通过减少启动期间和游戏内的 log.info 消息,修复了详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项,修复了 #732。
- 在交易屏幕等特定情况下避免自动关闭,修复了 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.1
- 通过扩展正确的基类,修复了 #735。
- 修复了手动生成测试中发现的几个 26.1.2 版本特有的问题。
6.15.0(交易、玩家头颅、Epic Fight 和 QOL 更新)
- 如果客户端物种列表为空,则重新同步物种数据,修复了 #731。
- 通过改进 Epic Fight 集成并启用实验性功能,修复了 #730。
- 确保交易使用次数正确存储,修复了 #729。
- 添加了玩家头颅的自定义头颅支持,修复了 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置,修复了 #689。
- 通过新的交易配置界面和对自定义交易的更好支持,修复了 #218 和 #132。
- 修复了在基本模式和普通/高级交易模式之间切换时的交易特定边缘情况。
- 修复了对话框按钮文本截断问题,并通过提示框显示完整文本。
- 通过将动画状态与 Cobblemon Animation System 同步,修复了 Cobblemon 动画问题。
- 添加了针对每个交易的特定操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置界面中添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例商人。
- 清理测试文件。
6.14.0
- 通过确保更改值时同步到客户端,修复了 #727。
- 通过为特定命令添加额外的白名单,修复了 #726。
- 通过添加基本的 Cobblemon 支持(使用 Cobblemon NPC),修复了 #686、#389、#304 和 #211。
- 通过调整对话框精灵和屏幕,修复了对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算,修复了 x 和 z 根旋转问题。
- 通过自定义 NPC 类型和模型,添加了基本的 Cobblemon 支持用于测试。
6.13.0(安全性和权限更新)
注意:此更新包括更好的安全检查和多玩家环境中的权限控制。它允许执行服务器命令,如果恶意使用,这些命令可能会造成潜在危险。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查系统和权限系统,修复了 #605、#532 和 #529。
- 通过添加自定义模型支持的实验性 API 文档和示例,修复了 #469 和 #311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景的双重渲染问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多玩家环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义支持和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了常规代码清理和优化,涉及配置屏幕渲染和资源。
6.12.0
- 通过基于原版模型添加对自定义模型部件列表的额外检查,修复了 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息来减少日志冗长度,修复了 #713。
- 通过减少过大的启动/配置日志输出,修复了 #711。
- 修复了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 向 EasyNPCModelManager 添加了模型部件名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构以提高性能和可维护性,改进了 RenderEntityTypeSupportConfig。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析,修复了 #710。
6.11.0
- 修复了 #703,解决了新自定义层级系统与手部渲染的渲染问题。
- 通过为无效的交易报价添加额外的安全措施和日志记录,修复了 #701。
- 修复了头部位置修改时智能动画无法正常工作的问题。
- 通过将玩家检测移回仅限服务端处理,修复了头部追踪问题。
- 优化
CustomLookAtPlayerGoal以更好地处理边缘情况并减少抖动。 - 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 使用新设计更新了标志。
6.10.0
- 通过对第三方实体创建添加 try-catch 块,修复了 #698。
- 通过在切换至
DEFAULT(默认)原版姿态时清除模型部分的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过将根旋转轴心修正为使用实际的包围盒高度而非 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺失的玩家目标刷新以及离线目标的重试机制。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时的 ROOT 旋转自动锁定;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航角范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加针对逃离玩家、村民、怪物等的额外逃跑目标,修复了 #597。
- 修复了姿态加载逻辑,改为直接从模组资源读取,而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于从外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,使 NPC 在执行回调动作之前移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl以尊重锁定的根旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引。
- 在各种实体渲染器中添加了 EasyNPCItemAttachmentLayer。
- 添加了专用的
Flee Objective(逃离目标)配置选项卡,包含针对逃离爬行者、怪物、生物、玩家、村民和太阳的目标。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM(跟随物品)目标,使 NPC 能够根据资源位置(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看所有者的目标。 - 向
SynchedDataIndex添加了persistent标志,以便瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 向
SlimeBase添加了可配置的customParticlesEnabled标志,供 API 使用者使用。 - 添加了
SoundType.PET(宠物音效),并将CAT_PURR(猫呼噜声)映射到驯服的猫 NPC,以增加驯服环境音效的变化性。 - 将定期 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本来强制版本不匹配,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动,修复了 #665。
- 通过添加禁用跟随鼠标光标的选项以便于姿态调整,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过在使用 NPC 魔杖时潜行靠近 NPC 来快速旋转根部朝向玩家,修复了 #661。
- 通过在交互处理器中添加对移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过在交互处理器中添加对预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整包围盒和眼睛高度的计算,修复了史莱姆和恶魂的命中框及名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置问题。
6.8.2
- 通过扩展
SafeMerchantData并添加 notifyTrade 以避免崩溃,修复了 #677。 - 添加了基于玩家互动和行为的 NPC 升级进度数据支持。
- 添加了全局 NPC 跟踪系统,以便更好地管理和调试世界范围内的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原始模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而非自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马刷怪蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,以便更轻松地与其他模组和自定义模型集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进空间。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现 Wolf Leg Animations 方法中的 setupAnim 修复了 #650。
- 通过修正 canBeHitByProjectiles 翻译修复了 #648。
- 添加了
allowBypassInvulnerability配置选项,允许/禁止绕过 NPC 的无敌状态,从而修复了 #645。 - 修复了在宽度较小时删除按钮仍显示标签的问题。
- 修复了在某些情况下上下按钮定位不正确的问题。
- 修复了对话框和配置界面中名称标签显示的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据同步不正确的问题。
- 添加了预设浏览器,以便更轻松地选择常用 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有的 NPC 预设以使用新的 .snbt 格式。
- 重构了生成器系统以使用新的预设格式,以提高可维护性和未来改进空间。
6.6.2
- 通过重写缩放系统修复了 #643。
- 修复了重启/重载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于团队的名称标签可见性支持,遵循原版 Team 机制。
6.6.1
- 通过重构显示属性的内部数据处理修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 修复了使用原子操作进行纹理重载保护时的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏。
- 修复了 URL 验证垃圾信息导致同一纹理被多次同时下载的问题。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载过程中出现的
defineId called for:警告消息。 - 重构了具有多层防护和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 实现的线程安全会话服务器防垃圾信息保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用双线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 设置了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤问题。
- 通过为 Gradle 依赖项添加缓存改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用修复了 #629。
- 修复了击杀命令无法对 NPC 生效的问题。
- 修复了纹理重载保护阻止驱逐后重新加载缓存的问题。
- 修复了远程图像验证器中 WebP 验证的错误(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替代永久阻止机制。
- 添加了鸡、猪和狼的缺失变体纹理。
- 添加了纹理处理的额外单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 捆绑方式,以提高模组兼容性和 API 能力。
- 通过实施剪刀效果修复了 #627,以更好地与其他模组兼容。
- 修复了在使用旋转或移动模型部件时使用生动动画的问题(#625)。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿势动画控制,提供智能、默认和无选项。
6.4.1
- 修复了针对不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade提供的详细调查和修复建议(#626)。
6.4.0
- 通过改进对话数据验证和错误处理修复了 #626。
- 通过重构渲染数据和渲染处理修复了 #623。
- 通过确保自定义数据正确保存和加载修复了 #622。
- 修复了打开对话框动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法修复了哈希问题。
- 添加了自定义数据测试物品(#622),并简化了自定义数据的测试流程。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话数据来修复对话数据。
- 修复了对话编辑器布局问题并提高了可用性。
- 修复了某些对话数据字段缺失默认值的问题。
- 添加了对话优先级支持,以控制对话执行的顺序。
- 为对话和记分板动作添加了条件支持。
- 为对话添加了频率支持,以限制对话显示的频率。
- 添加了新的 NPC 预设以支持记分板和条件。
- 通过移除冗余字段改进了对话按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的缺失翻译。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,用于在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了旋转按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包导致的容器和菜单同步问题。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了屏幕切换时鼠标光标跳动的问题。
- 修复了翻译文件,并删除了重复和已过时的条目。
- 将 Easy NPC 魔杖移到了现有的核心物品标签页,而不是创建一个新的标签页。
- 为不同的模型部件(尾巴除外)添加了猫姿势支持。
- 通过在不必要时禁用发光效果,提升了 EasyNPCWand 发光效果的表演性能。
- 通过排除非生物实体(如展示框、制造器、投掷物和刷怪笼),改进了自定义实体检测。
- 改进了猫变种的处理逻辑。
6.1.1
- 通过检查物品是否在任一手中装备,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 通过对特定模型强制同步帽子和头部图层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本中猫变种的处理逻辑。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫渲染器问题。 - 修复了位置、缩放和旋转的预览功能。
- 修复了精灵模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型的支持和性能。
- 优化了玩家皮肤的玩家到 UUID 映射的缓存机制。
- 将更改模型的命令和逻辑限制为仅限 Doppler NPCs。
- 添加了 renderEntityRaw 方法,以按原样渲染 NPC。
6.1.0 ✨
这是一个重大版本更新。请在更新之前备份你的世界和 NPC 数据。此版本包含许多改进、优化和内部更改,这些更改与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或者需要手动调整。
- 内部数据格式和一些行为已被重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,同时包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级的 NPC 运行时和逻辑,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可安装在需要该界面的客户端上。
🎯 为什么进行此更改?
- 允许服务器和整合包仅在服务器端分发 Core 模组,从而实现更精简的设置。
- 当不需要在所有地方使用 UI 时,减少内存占用和加载时间。
- 通过将 UI 和核心逻辑分离,加快开发和测试速度。
Easy NPC: Core (1.21.11) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub 历史记录。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请查阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏一个 NPC 的皮肤层导致同类型其他 NPC 也被隐藏。
- 修复了僵尸类和末影人类自定义姿势被其手臂动画覆盖的问题。
- 修复了在使用“DEFAULT”或“NONE”动画行走时,隐藏的身体部位再次显示的问题。
- 修复了“锁定身体”标签在旋转屏幕中溢出显示的问题。
- 修复了投射物“物品 ID”字段遮挡物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生改变的问题。
7.18.0
- 修复了 #862:防止加载模组(如 LetMeDespawn)时 NPC 丢失。
- 修复了拥有近战和远程攻击能力的 NPC 在手持弓、弩或枪时不发射投射物的问题。
- 修复了 NPC 在目标之间移动时旋转异常,以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后Boss条仍停留在屏幕上的问题。
- 修复了在创造模式下对 NPC 使用快捷选取(Pick Block)无法获得其生成蛋的问题。
- 修复了“记分板”条件在没有分数的玩家身上添加 0 分的问题。
- 修复了 Spartan Weaponry 的金制重型十字弩,并添加了皮革和铜制版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英文 Bogged 名称以及原始“主手”/“副手”键名。
- 更改了预设物品的行为:在生存模式下生成 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 等模组设置的更高属性上限。 需要在服务器和客户端安装 AttributeFix 或类似模组;护甲值上限为 100。
- 修复了 #857:在未发生更改的情况下,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当某个“打开对话(条件)”的条件不满足时,尝试执行下一个。
- 修复了动作和对话中的“几率”条件被掷骰两次的情况,这会导致实际几率降低。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或被拴绳的 NPC 出现在肩膀上,以及断开连接时出现的肩膀渲染泄漏问题。
- 修复了隐藏头部保留帽子层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了几个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受到影响;设置为 7 可保持旧版外观。
- 更改了“关闭对话”和“回退”动作的执行时机:仅在无条件对话未打开时运行。
- 更改了拥有传送距离限制的“跟随主人”NPC 的行为:使其跟随主人进入其他维度。
- 更改了服务器停止时的行为:等待最多 2 分钟,以确保仍在写入的 NPC 文件完成保存。
- 更改了空闲 NPC 的反应延迟:对附近玩家、掉落或压力板的反应延迟最长可达 0.5 秒。
- 添加了
/easy_npc attribute、/easy_npc debug stats file_storage命令以及storage.cfg保存设置。 - 提升了 NPC 保存、备份、
/easy_npc list、肩膀同步和空闲 NPC 的性能。
7.16.0
- 通过不再重复运行目标或在移除后再次运行(当设置多次时),修复了 #432。
- 通过将长矛攻击可攻击的 NPC,修复了 #852。
- 修复了当无法从玩家肩膀放下 NPC 时导致其迷路的问题。
- 修复了“坐于肩头”的 NPC 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自插件的 Easy Model Entities NPC 在玩家肩膀上不可见的问题。
- 修复了通过 UUID 生成存储的 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命令设置。 - 更新了测试通过的 NeoForge 版本至 21.11.48,该版本修复了三个网络漏洞。
7.15.0
- 通过在通过
/execute或命令方块运行时保持预设导入静默,修复了 #838。 - 通过将 NPC 数量限制应用于默认刷怪器,修复了 #380。
- 通过在声音配置中允许资源包声音,修复了 #849。
- 通过不再随机生成左撇子 NPC,修复了 #349。
- 通过将对话框按钮锁定在每个对话框内而非跨具有相同标签的对话框,修复了 #851。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少其 Epic Fight 生物补丁的问题。
- 修复了缩放后的 Doppler NPC 保留被模仿生物的完整碰撞箱的问题。
- 修复了位于玩家肩膀上的 NPC 忽略其缩放比例和 Doppler 模仿模型的问题。
- 更改了要求:客户端和服务端需使用相同的模组版本,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
- 通过让稍后开始看到该 NPC 的玩家保留自定义姿势,修复了 #846。
- 修复了稍后开始看到该 NPC 的玩家缺少属性和交易设置的问题。
- 修复了直到重载前,更改的最大使用次数、经验值和交易类型未在交易界面中显示的问题。
- 修复了直到 NPC 重载前,
/easy_npc sound set的更改未生效到玩家的问题。 - 添加了在游戏测试中检查重生后和新玩家的 NPC 姿势及设置的测试。
7.13.0
- 修复了对话框按钮名称中的颜色和格式标签显示为纯文本的问题。
- 修复了编辑器中的按钮预览将小写名称显示为原始翻译键的问题。
- 修复了“移动 EasyNPC”物品在非创造模式下的 NPC 所有者身上无法使用的问题。
- 修复了即使无法更改所有者,
/easy_npc owner set仍报告成功的问题。 - 修复了当 URL 或玩家皮肤屏幕显示皮肤下载错误时游戏崩溃的问题。
- 修复了向下滚动列表后预设浏览器搜索不显示任何结果的问题。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
- 在对话框按钮名称中添加了对
@initiator、@npc和@score()的支持以修复 #841。 - 添加了使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行了较大的核心重构和代码清理。
7.12.2
- 修复了精灵的碰撞箱过小,导致其名称标签和对话气泡位于其体内的问題。
- 修复了缩放的 NPC 保留旧的碰撞箱和视线高度,导致命中、点击和观察落空的问题。
- 修复了在网络数据包中读取超大的名称、列表和 NPC 数据时没有任何限制的问题。
- 修复了应用无效的 NPC 位置、缩放、属性、名称和持续时间的问题。
- 更改了精灵 NPC 占用其模型的空間,使其发生碰撞并可被点击。
- 将骷髅、流浪者和沼泽尸骸 NPC 更改为原版碰撞箱高度,它们之前略微偏矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 通过始终显示“恢复”,包括数据包预设,并附带原因提示框,修复了 #836。
- 修复了预设导入和导出消息缺失、错误或未警告替换 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载、泄露 NPC 并清除选择的问题。
- 修复了小窗口中预设列表排序、筛选顺序和布局裁剪选项的问题。
- 修复了没有位置信息的
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”在同一位置堆叠 NPC 的问题。
- 更改为当不允许时,“恢复”操作拒绝执行而不是生成副本。
- 添加了排序、匹配计数、重载、自动关闭、预设和皮肤的 NPC ID 及提示框。
- 添加了带有数量限制的
matching <pattern>批量导入、确认提示和可点击的位置。
7.12.0
- 修复了 #833,现在仅向魔杖持有者、所有者和管理员显示简易 NPC 魔杖的轮廓。 其他玩家不再看到这些轮廓,隐形 NPC 对他们也保持隐藏状态。
- 通过添加“设置此处为家”和“重置家”按钮到位置配置中,修复了 #834。
- 通过在导出的预设中保留 NPC ID 和位置,从而让导入操作恢复相同的 NPC,修复了 #835。
- 修复了预设导入和生成蛋丢失所有者列表条目及所有者目标的问题。
- 修复了从自动备份恢复的 NPC 丢失其所有者并变成无主状态的问题。
- 修复了选择列表只显示前六项条目而隐藏其余条目的问题。
- 更改了导入预设的行为:改为在原 NPC 存储的位置更新原 NPC,而不是添加副本;请使用“作为新 NPC 导入”或预设物品来创建独立的 NPC。
- 更改了已完成交易以播放“交易完成”音效,此前该音效处于静音状态。
- 更改了 API 对话框调用,使其报告未知的对话框标签,而不是一直报告成功。
- 更改了没有手臂的 NPC 携带手持物品的行为,改为在头部或身体处展示,而不是隐藏它们。
- 将可选依赖项 Easy Model Entities 的版本要求更改为 2.4.0 或更高版本。
- 添加了包含对话、说话、游泳、进食和坠落伤害声音的“声音”配置。
- 在“声音”配置中添加了可搜索的声音选择器,并配有音量和音调滑块。
- 添加了“阻止载具”选项,以防止 NPC 进入船、矿车以及模组提供的椅子。
- 在所有皮肤配置中添加了职业选择,并为每种 NPC 类型添加了新的内置皮肤。
- 添加了客户端设置,允许在墙壁后方隐藏名称标签以及用于魔杖轮廓的
highlightEnabled。 - 添加了“存在”条件操作,并提供对 NPC 移动、动作和预设的 API 访问。
7.11.0
- 通过不再让玩家登出时服务器因 NPC 跟随或注视玩家而冻结,修复了 #828。
- 通过将常规的 NPC 移除消息移至调试日志,修复了 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势,修复了 #832。
- 修复了在大型世界中每小时 NPC 备份导致的卡顿问题,以及保留了已移除 NPC 的时间戳的问题。
- 修复了每小时 NPC 备份导致备份的 NPC 身份、所有者和位置丢失的问题。
- 修复了所有者登录恢复功能重复复制、反复恢复、复活或移动未加载的 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后残留的 NPC 数据问题,避免了冗余写入,并增加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时气泡文字丢失且变得半透明的问题。
- 修复了在游戏包激活期间忽略 NPC “不透明度”设置的问题。
- 修复了翻译后的气泡文本和模组 API 文本的文本格式化和宏解析问题。
- 修复了在游戏包激活期间气泡及其文本被隐藏在方块后面的问题。
- 添加了
minLightLevel以保持气泡在黑暗环境中可读。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体,修复了 #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 格,超出该范围才进行传送。
- 更改了“移动到”和“返回家中”的动作,如果在三秒内没有进展则放弃。
- 更改了“移动到”动作的超时机制,使其计算真实刻数,此前运行时间过长两倍。
- 更改了新的“随机游泳”目标,使其优先级低于跟随、逃跑和攻击目标。
- 更改了带有 Easy Model Entities 模型的 NPC 的不透明度应用方式,改由该模组自身处理。
- 将 Easy Model Entities 的最小版本要求更改为 2.3.0,旧版本将禁用集成。
- 为 NPC 的游泳层级添加了“水面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入 NPC 文件的日志条目,每条耗时超过 250 毫秒时发出警告。
7.8.1
- 通过让水中的鱼形 NPC 直立显示而非始终侧躺,修复了 #827。
- 通过防止损坏的 NPC 阻止世界保存(改为回退到默认值),修复了 #828。
- 修复了恢复的 NPC 拾取随机预设 ID 导致每次保存都变化的问题。
- 更改了 NPC 数据逻辑,仅在实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已处于目标位置的 NPC 的行为,使其立即完成移动。
- 将“None”皮肤选项卡更名为“Advanced”,其中现在包含“禁用皮肤”和纹理字段。
- 添加了“移动到”动作,可将 NPC 发送到指定位置、玩家、其所有者或其家园。
- 添加了“移动到并等待”动作,仅在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时以及可选的传送功能。
- 添加了范围从 0 到 100 的“不透明度”属性,使身体、盔甲和手持物品一起淡入淡出。
- 添加了“设置不透明度”动作,可将 NPC 变为幽灵或完全隐藏。
- 添加了“灯笼幽灵”预设,一个在每个角落都有短线的方形路径上行走的幽灵。
- 添加了对移动动作和 NPC 不透明度的 API 访问。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,可在应用前预览使用输入纹理的 NPC。
7.7.7
- 通过保持 64x64 皮肤的透明度(Fresh Moves 需要其用于眼睛),修复了 #821。此前下载的皮肤需要在玩家皮肤屏幕的按钮处重新加载。
- 通过让村民和流浪商人 NPC 也执行交易动作,修复了 #818。
- 修复了具有多个文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载图像的问题。
- 修复了未翻译的执行限制条件中的间隔名称(如
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_npc render texture为 Easy Model NPC 的每个模型槽位添加了纹理覆盖。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 添加了对 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。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的EventData。
- 为
/easy_npc命令的所有 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能:无需输入即可出现,并容忍距离偏差为一个方块以内。
7.5.0
- 修复了 NPC 的家位置始终被读取为未设置的问题,这导致配置界面中隐藏了“家”选项,保存时跳过该选项,并使“返回家”和“在家附近漫步”功能失效。
- 修复了通过预设、预设浏览器或重生生成的 NPC 从未获得家位置的问题。
- 修复了通过预设浏览器生成的 NPC 保留导出预设的世界的家位置,而不是使用其生成位置的问题。
- 修复了在 Easy NPC Wand 高亮显示 NPC 时,在配置、皮肤和预设屏幕中 NPC 被绘制成带有阴影的白色剪影的问题。
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非每个物种一个状态),修复了 #814。
- 通过允许“返回家”在任何距离生效(而不仅仅是在家附近),修复了 #813。
- 通过在每次会话中检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包中的 Cobblemon 方面(aspects),而不仅仅是“shiny”和“female”,修复了 #810。
- 修复了当具有“Tempt”目标的 NPC 计算其目标时服务器崩溃的问题。
- 修复了 Allay、Vex 和 Ghast 等飞行 NPC 在地面上移动而不是飞行的问题。
- 修复了对话框、按钮、预设、姿势和纹理名称中存在重复项或特殊字符的问题。
- 修复了专用服务器上无法编辑条件以及条件文本未翻译的问题。
- 修复了 Easy Model Entities NPC 不转头以及其模型列表忽略
/reload命令的问题。 - 修复了新创建的 NPC 出现“Legacy Easy NPC Data”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正,导致图层伪影的问题。
- 修复了查询玩家姓名时玩家皮肤屏幕短暂冻结的问题。
- 修复了某些语言中“重置看向...”目标标签误读为“重置战利品获取...”的问题。
- 修复了由于开发辅助模组导致 Fabric 游戏测试启动时崩溃的问题。
- 修复了 NPC 在消失后重新生成时失去其所有者归属的问题。
- 修复了当提供目标的模组在启动时缺失,导致 NPC 上的目标被删除的问题。
- 修复了当目标实体缺失时,目标被永久关闭的问题。
- 修复了导入没有存储 ID 的预设时,生成的 NPC 没有所有者和家的问题。
- 修复了“跟随所有者”和“看向所有者”在所有者变更后仍保持旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“看向物品”目标可以被存储但从不执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画。
- 修复了 Forge 从未运行其服务器启动步骤的问题,这导致整个会话期间 NPC 跟踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发运行在没有 mixins 的情况下启动的问题,这禁用了原版实体调整并在生成 Fox NPC 时导致崩溃。
- 将移动目标改为固定顺序:逃跑、跟随、回家,然后漫步。因此,具有多个移动目标的 NPC 行为可能与以前不同。
- 将数据包预设更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 将预设浏览器更改为始终以相同顺序列出其条目。
- 将所需的 Easy Model Entities 版本更改为 1.7.0,浮动模型现在默认悬停。
- 移除了实验性的用户定义 NPC;不再读取或创建额外的配置文件。
- 移除了未使用的
SERVER_SKIN皮肤类型。 - 添加了新的 gametest 结构以支持 1.21.11 及更高版本的 gametest。
- 在玩家皮肤屏幕的每个条目中添加了一个重新加载按钮,以便再次获取单个皮肤。
- 每当移除 NPC 时,在日志中添加原因,以便追踪意外的消失。
- 为
/easy_npc render set species添加了建议。 - 添加了对来自其他模组预设的支持,这些预设不再必须使用
easy_npc命名空间。 - 添加了预设可见性,可从预设浏览器和 NPC 屏幕中隐藏预设。
- 为跟随目标添加了传送距离和休息点偏移量。
- 为“跟随物品”添加了物品标签、“可被吓到”选项和“仅限无主”选项。
- 为看向目标添加了物品字段,以便 NPC 可以注视选定的掉落物品。
- 为每个 NPC 添加了标识符,以便模组可以再次找到其自己的 NPC。
- 添加了当其所有者登录时重新生成 NPC 的选项。
- 添加了具有数字、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 为“导航”和“悬停高度”添加了设置,可在任何 NPC 的地面和飞行模式之间切换。
- 添加了父预设引用,使预设可以基于另一个预设构建并仅覆盖更改。
- 添加了由状态驱动的“Forge Keeper”预设。
- 添加了供其他模组使用的自定义条件和对话、动作及状态事件。
- 添加了“远距离”作为距离动作,其在 32 格处触发。
- 为 NeoForge 添加了游戏测试(此前没有),并恢复了在更新到 1.21.11 过程中丢弃的刷怪蛋、对话框屏幕、数据隔离和烟雾测试。
- 为每个配置和编辑器屏幕添加了游戏测试,涵盖所有三种加载器。
- 为家位置添加了游戏测试,涵盖生成默认值、存储值和重新加载。
- 改进了模型名称解析,之前会将以 "_shiny" 结尾的物种误认为是变体。
- 改进了对飞行 NPC 的跟随,现在在没有空中路径时直接转向。
- 改进了浮动 Easy Model Entities 模型,现在上下浮动。
- 通过为预设、自定义目标和目标配置提供 API,改进了第三方支持。
7.4.0
- 修复了 #807:不再将 32 格内所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805:改为同时评估所有可见性设置,而不是在遇到第一个设置时就停止。
- 修复了 #804:保留 Doppler NPCs 的自定义名称,以便用于基于名称的纹理和命名牌。
- 修复了 #803:调整资源以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测逻辑,此前会将日出计为夜晚、日落计为白天。
- 修复了下界和末地的可见性问题,此前错误地使用了主世界时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在首个断言失败时才会报错的问题,这会导致后续失败被隐藏。
- 修复了“骑乘”马匹皮肤变体从未显示马鞍的问题。
- 更改了“仅对主人可见”和“仅对队伍可见”,使其也遵循昼夜和游戏模式规则。
- 更改了没有“交叉手臂”姿态的唤魔者、幻术师和卫道士变体,使其保持手臂下垂姿态。
- 添加了“保卫阵营”目标,会攻击伤害附近阵营成员或玩家的实体。
- 当阵营成员互相战斗且阵营选择不介入时,添加系统消息提示。
- 为灾厄村民添加了头部装备槽,以便移除或更换其队长旗帜。
- 在显示配置界面中添加了昼夜预览功能。
- 为可见性属性和阵营防御添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升了可见性检查的性能。
- 通过用默认值补全缺失部分,改进了旧版本中的显示属性。
- 改进了攻击目标界面,在未设置时禁用“保护主人”和“保卫阵营”选项。
7.3.0
- 通过以类型化字段携带数据替代解析变体名称,改进了皮肤变体处理。
- 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
- 通过为
get(String)查找提供共享的EnumUtils辅助类,减少了重复的枚举代码。 - 优化了村民职业和类型的查找,改为直接使用注册表键而非扫描。
- 通过在构造时缓存标签名称、ID 和键,优化了枚举名称查找。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.2.0
- 修复了 #801:使用组合方式生成 NPC、对话和动作的 UUID,以避免在动作跟踪和执行限制方面发生冲突。
7.1.1
- 修复了 #800:采用延迟加载实体类型。
- 修复了 #799:修复了边缘情况,并增加了额外的文档说明及更清晰的日志消息。
- 修复了 #798:将控制台、命令方块视为可信的命令来源。
- 修复了单人 / 局域网模式下客户端与服务器 NPC 共享同一注册表的严重问题。
- 修复了配置菜单处理中的内存泄漏,并添加了超时断开连接清理机制。
- 修复了多个 NPC 同时请求相同皮肤时的重复下载问题。
- 修复了在出现错误后皮肤查找失败的问题,防止慢速服务器导致游戏冻结。
- 修复了检查远程图片时 URL 皮肤屏幕导致游戏冻结的问题;现在该检查在后台运行。
- 添加了新的世界刷怪块(World Spawner),可限制整个世界中(所有维度)的 NPC 预设;现有的组刷怪块现按维度计数,因此远处的 NPC 不再阻碍其运作。
- 强化了远程皮肤下载的安全性,设置了严格的文件大小限制和安全重定向处理,以防止因过大或恶意皮肤 URL 导致的崩溃;新增了可选的
blockPrivateAddresses设置。 - 通过仅向实际使用这些事件的 NPC 发送实体和玩家加载事件(按维度分组),提升了服务器性能。
7.0.0
- 修复了 #794:使用预期类型进行 NPC 渲染。
- 修复了 #791:添加了流浪商人 NPC 类型。
- 修复了 #788:将 AI 安全措施扩展至 Epic Fight 模组和原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)。
- 修复了 #787、#531、#237 和 #184:添加了阵营系统,包含
/easy_npc faction命令、单个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复了 #787、#771 和 #572:添加了新的
target目标选项卡,允许攻击敌对阵营或通过玩家名称、队伍、实体标签或 UUID 指定特定目标。 - 修复了 #786:为 Cobblemon NPC 添加了性别和闪光模型变体,可在模型选择中通过
female或shiny进行搜索。 - 修复了无敌 NPC 之间的阵营战斗问题,添加了新的
Attackable by Factions战斗属性。 - 修复了大型物种的 Cobblemon 模型选择预览,改为使用 Cobblemon 自身的配置文件缩放比例而非碰撞箱高度。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存(而非始终重建完整的自定义纹理缓存),修复了自定义皮肤重新加载问题。
- 改进了
Attackable by Players/Monsters/Factions战斗属性,使其独立于Invulnerable工作,各自为其所属的攻击者群体打开独立的攻击通道。 - 通过拆分大型处理器为更小的专注组件(导入、导出和功能特定组件),改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和阵营编辑器界面,用于创建、着色和删除阵营并管理敌对关系,受新的
FACTION_MANAGEMENT安全特性保护。 - 添加了新的
Misc属性选项卡,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636、#622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对属性滑块进行限制以防止其他模组传入的极端值,修复了 #767。
- 通过为带有动作和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了在 >= 1.21.x 版本中,因纹理管理器运行在错误的线程上而可能导致崩溃和死锁的问题。
- 修复了空 UUID 处理动作条件的问题。
- 修复了动作执行限制重置的问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 金币、钥匙和红代币作为带有动作和条件的 NPC 的可消耗物品添加。
- 添加了示例 NPC 预设
Welcome Coin Trader,其中包含自定义金币、钥匙和红代币物品数据。 - 添加了针对其他模组极端值的属性保护机制。
- 对于高生命值 NPC,将回退最大生命值从 1024 提升至 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与不可见 NPC 交互的选项,修复了 #459、#775。
- 修复了与可选 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基础刻期间及打开交易界面之前检查限时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了示例 NPC 预设
Skywatch Scout,支持昼夜时间和天气条件。
6.23.0
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的 #770 物品渲染问题。
- 修复了 NPC 未能可靠地打开或关闭门的 #769 门循环问题。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE)以锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色的颜色选择器弹出窗口以及手动 RGB/十六进制值输入,修复了 #709。
- 修复了在未指定颜色时重命名会重置 NPC 名称颜色的问题,通过保留现有名称颜色来解决。
- 改进了门移动属性,当“打开门”或“关闭门”处于活动状态时,“穿过门”将自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,提高了对依赖特定玩家数据的第三方模组和插件的兼容性,从而修复了 #766。
- 通过添加实体生命值、NPC 生命值条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话框按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(如 PoiCompetitorScan / job_site)读取未注册的脑记忆时导致的与第三方村民 AI 相关的崩溃 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做的准备。
- 通过添加条件对话框打开支持/命令以更好地控制向玩家显示对话框的时机,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 向枪械标签添加了更多枪械。
- 添加了新的“打开对话框(条件性)”动作,仅当满足其条件时才打开命名的对话框,而现有的“打开对话框”动作则无条件打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的无敌特性。
- 添加了新的“击退免疫”战斗属性,防止 NPC 受到近战或投射物攻击的击退效果。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的掠夺者物品的附着问题。
- 修复了损坏的掠夺者弩攻击目标。
- 修复了与无法作为手持物品渲染的第三方物品相关的崩溃 #756。
- 修复了与尝试访问不存在的模型部分的第三方 Mixin 相关的崩溃 #756。
- 通过降低日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 垃圾消息。
- 改进了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与第三方模组尝试访问不存在的 NPC 目标相关的崩溃。
6.19.0
注意:此更新将对话框背景图像各边调整了 10x6 像素,如果您使用的是自定义背景,可能需要相应调整。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752、#130。
- 通过为对话框文本添加打字机效果支持,修复了 #683、#215。
- 通过允许为对话框、对话框按钮和交互设置条件,修复了 #690、#309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 重构了对话框背景图像,每边调整了 10x6 像素。
- 重构了对话框屏幕布局以适应新的背景尺寸并改善外观。
- 添加了对话框文本的打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了示例 NPC 预设
Threshold Warden,包含各种条件和动作。 - 添加了与对话框条件和按钮状态相关的较小 bug 修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或删除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件以允许更复杂和动态的行为,修复了 #745。
- 通过为较长文本添加对话框按钮工具提示,修复了 #652。
- 通过添加命令值工具提示以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏中有物品的条件。
- 添加了手持物品条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以便对条件取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的工具提示,修复了 #738。
- 通过在启动期间和游戏内减少 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项,修复了 #732。
- 通过在特定情况下(如交易界面)避免自动关闭,修复了 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 添加了对话框的头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0(交易、玩家头颅、Epic Fight 和 QOL 更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能,修复了 #730。
- 通过确保正确存储交易使用次数,修复了 #729。
- 通过为玩家头颅添加自定义头颅支持,修复了 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置,修复了 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持,修复了 #218 和 #132。
- 在基本模式和正常/高级交易模式之间切换时,修复了交易特定的边缘情况。
- 通过工具提示显示完整文本来修复对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步,修复了 Cobblemon 动画问题。
- 添加了针对每项交易的特定操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置屏幕上添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了带有操作的 Griselda Grindstone 作为示例商人。
- 清理测试文件。
6.14.0
- 通过确保更改值时同步到客户端,修复了 #727。
- 通过为特定命令添加额外的白名单,修复了 #726。
- 通过添加基本的 Cobblemon 支持(使用 Cobblemon NPC),修复了 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕,修复了对话框错位和导航问题。
- 通过更正旋转逻辑和枢轴计算,修复了 x 和 z 根旋转问题。
- 通过自定义 NPC 类型和模型添加了基本的 Cobblemon 支持以进行测试。
6.13.0(安全性和权限更新)
注意:此更新包括用于多人环境更好的安全检查及权限。它允许执行服务器命令,如果被恶意使用可能会带来潜在危险。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有的 NPC 的根旋转和缩放将被重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查及权限系统,修复了 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例,修复了 #469、#311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景的双重渲染问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多人环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义支持和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了配置 UI 特定组件并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为未来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了常规代码清理和优化,涉及配置屏幕渲染和资源方面。
6.12.0
- 通过基于原版模型添加对自定义模型部分列表的额外检查,修复了 #714。
- 通过将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息来减少日志详细程度,修复了 #713。
- 通过减少过大的启动/配置日志输出,修复了 #711。
- 添加了 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加了模型部分名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构,改进了 RenderEntityTypeSupportConfig,以提升性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析,修复了 #710。
6.11.0
- 修复了 #703,解决了新自定义图层系统与手部渲染导致的渲染问题。
- 修复了 #701,通过为无效的交易报价添加额外的安全措施和日志记录来解决。
- 修复了头部位置修改后智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端来解决头部追踪问题。
- 优化了
CustomLookAtPlayerGoal,以更好地处理边缘情况并减少抖动。 - 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 使用新设计更新了标志。
6.10.0
- 修复了 #698,通过在创建第三方实体时添加 try-catch 块来解决。
- 修复了 #695,在切换到
DEFAULT(默认)原版姿态时清除模型部分的旋转/位置。 - 修复了 #695,仅在 NPC 处于空闲状态时才应用锁定旋转和姿态动画。
- 修复了 #695,修正根旋转枢轴以使用实际包围盒高度而不是 0.5f。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中错误的 UUID、加入/离开时缺少针对玩家的目标刷新,以及对离线目标的重试机制。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时 ROOT 旋转的自动锁定;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定于模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 修复了 #692 和 #666,通过添加缓存和安全措施来防止冗余地重新触发 NPC 实体数据更新。
- 修复了 #651 和 #617,为所有支持的 NPC 类型添加了基本自定义姿态。
- 修复了 #597,添加了用于逃离玩家、村民、怪物等的额外 Flee(逃离)目标。
- 修复了姿态加载问题,改为直接从模组资源读取而不是将文件复制到磁盘。
- 修复了实体加入时重复调用
saveNPC的问题,通过首先检查现有的注册表条目来解决。 - 添加了
despawn和spawn命令,允许按 UUID 移除和重新生成 NPC,并可配置移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,用于从外部模组控制 NPC 姿态和管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行回调动作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl,以尊重锁定的根旋转。 - 将所有者更改和维度更改同步到 NPC 实体数据索引。
- 将 EasyNPCItemAttachmentLayer 添加到各种实体渲染器中。
- 添加了专用的
Flee Objective(逃离目标)配置选项卡,包含用于逃离苦力怕、怪物、生物、玩家、村民和太阳的目标。 - 在跟随目标选项卡中添加了
FOLLOW_ITEM(跟随物品)目标,使 NPC 能够通过资源位置跟随物品实体(例如minecraft:apple)。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看所有者的目标。 - 在
SynchedDataIndex中添加了persistent(持久化)标志,这样瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 使用者在
SlimeBase中添加了可配置的customParticlesEnabled(启用自定义粒子)标志。 - 添加了
SoundType.PET,并将CAT_PURR映射到猫型 NPC,以增加驯服环境声音的变化。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 修复了 #680,通过升级网络协议版本来强制执行版本不匹配检测。
- 修复了 #679,重置了姓名标签的位置、旋转和大小。
- 修复了 #665,为根旋转添加了多状态滑动功能。
- 修复了 #664,添加了禁用跟随鼠标光标的选项,以便于摆姿势。
- 修复了 #663,改进对 X 和 Z 根旋转的支持。
- 修复了 #661,添加了使用 NPC 魔杖配合潜行靠近 NPC 以快速旋转根部使其面向玩家的功能。
- 修复了移动工具错误触发交互的问题,通过在交互处理器中添加对移动工具的检査来解决。
- 修复了预设物品错误触发交互的问题,通过在交互处理器中添加对预设物品的检查来解决。
- 通过调整包围盒和眼睛高度的计算,修复了史莱姆和恶魂的碰撞箱及姓名标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置问题。
6.8.2
- 修复了 #677,通过扩展
SafeMerchantData并添加 notifyTrade(通知交易)来避免崩溃。 - 添加了基于玩家互动和动作提升 NPC 等级的进度数据支持。
- 添加了全局 NPC 跟踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在使用原始模型时使用变体纹理。
6.8.1
- 修复了 #676,通过使用现有的预设辅助方法而不是自定义方法来解决问题。
6.8.0 (添加 API 支持)
- 修复了 #667,通过为无效的网络数据包添加警告消息和额外检查来解决。
- 修复了马刷怪蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、illager(掠夺者)、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 NPC 基类,以提供更好的 API 支持。
- 添加了 NPC 原始类,以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,便于与其他模组和自定义模型集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进的空间。
6.7.1
- 修复了 #657 和 #656,通过为原版漏洞添加额外的客户端检查来解决。
6.7.0
- 通过实现 Wolf Leg Animations 中的 setupAnim 方法,修复了 #650。
- 通过修复 canBeHitByProjectiles 的翻译,解决了 #648。
- 添加了
allowBypassInvulnerability配置选项,以允许/禁止 NPC 绕过无敌状态,从而修复了 #645。 - 修复了删除按钮在小宽度下仍显示标签的问题。
- 修复了上下按钮在某些情况下位置不正确的问题。
- 修复了对话框和配置界面中显示名称标签的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据同步不正确的问题。
- 添加了预设浏览器,以便更轻松地选择常用 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于分享 NPC 预设。
- 重构了现有的 NPC 预设,以使用新的 .snbt 格式。
- 重构了生成器系统,以使用新的预设格式,从而提高可维护性和未来改进空间。
6.6.2
- 通过重新设计缩放系统,修复了 #643。
- 修复了重启/重载后缩放未能正确更新碰撞箱和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于团队的名称标签可见性支持,尊重原版 Team 机制。
6.6.1
- 通过重构内部数据处理以处理显示属性,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏卡顿的问题。
- 使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止同一纹理的多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载过程中出现的
defineId called for:警告消息。 - 重构了纹理加载架构,采用多级防御和速率限制。
- 重构了实体数据注册逻辑,以提高可维护性。
- 将数据类转换为现代 Java records,以提高不可变性和线程安全性。
- 添加了线程安全的会话服务器防垃圾保护,使用 ConcurrentHashMap。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,采用双线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过添加 Gradle 依赖缓存,改进了 GitHub 工作流。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了 kill 命令无法对 NPC 生效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重载的问题。
- 修复了远程图像验证器中的 WebP 验证错误(缺少返回语句)。
- 重构了纹理处理逻辑,以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替代永久阻止机制。
- 添加了鸡、猪和狼的缺失变体纹理。
- 添加了更多纹理处理的单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过改进剪刀实现,增强了与其他模组的兼容性,修复了 #627。
- 修复了在使用旋转或移动模型部件时生动动画出现的问题,修复了 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿势动画控制,提供智能、默认和无选项。
6.4.1
- 修复了不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade进行的详细调查和修复建议,修复了 #626。
6.4.0
- 通过改进对话框数据验证和错误处理,修复了 #626。
- 通过重构渲染数据和渲染处理,修复了 #623。
- 确保自定义数据正确保存和加载,修复了 #622。
- 修复了打开对话框的动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法,修复了哈希问题。
- 添加了自定义数据测试物品(#622),并简化了自定义数据的测试。
- 改进了 records 并修复了潜在的数据缺失问题。
6.3.0
- 重构了特定于配置 UI 的组件,并将其从核心模组中移除。
- 通过在发送到客户端之前过滤对话框数据,修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了某些对话框数据字段缺失默认值的问题。
- 添加了对话框优先级支持,以控制对话框执行的顺序。
- 为对话框记分板动作添加了条件支持。
- 添加了对话框频率支持,以限制对话框显示的频率。
- 添加了新的 NPC 预设,以支持记分板和条件。
- 通过移除冗余字段,改进了对话框按钮数据格式。
6.2.0
- 修复了旧版自定义名称解析问题。
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的翻译缺失问题。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,以在对话框中显示记分板数值。 - 添加了更多单元测试。
- 改进了旋转按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了因缺少关闭容器数据包而导致的容器和菜单同步问题。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了在屏幕切换时鼠标光标跳动的问题。
- 修复了翻译文件,并删除了重复和已弃用的条目。
- 将 Easy NPC 魔杖移至现有的核心物品标签页,而非创建新的标签页。
- 为不同的模型部件(尾巴除外)添加了猫咪姿势支持。
- 通过在不需要时禁用发光效果,提升了 EasyNPCWand 发光效果的执行性能。
- 改进了自定义实体检测,排除了展示框、制造器、投掷物及刷怪笼等非生命实体。
- 改进了猫咪变体的处理逻辑。
6.1.1
- 通过检查物品是否装备在双手之一中,修复了 #615。
- 通过重新验证实体类型,修复了 #612。
- 通过强制同步特定模型的帽子和头部层,修复了 #610。
- 修复了兽人纹理。
- 修复了 1.21.5 版本的猫咪变体处理。
- 通过调整渲染状态
skin字段,修复了玩家渲染问题。 - 通过调整渲染状态
texture字段,修复了猫咪渲染器。 - 修复了位置、缩放和旋转预览。
- 修复了精灵模型。
- 通过将相关逻辑移至仅客户端侧,改进了自定义模型的支持和执行性能。
- 改进了玩家皮肤的玩家到 UUID 映射缓存。
- 将更改模型命令和逻辑限制为仅适用于 Doppler NPCs。
- 添加了 renderEntityRaw 方法以按原样渲染 NPC。
6.1.0 ✨
这是一个重大版本。请在更新前备份你的世界和 NPC 数据。此版本包含许多改进、优化和内部变更,与早期版本不完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或者需要手动调整。
- 内部数据格式和一些行为已被重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,包含 Core 和 Configuration UI,提供即插即用的体验。
- Easy NPC: Core - 轻量级的 NPC 运行时和逻辑,依赖极少。旨在用于服务器、整合包和开发者环境。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可安装在需要该界面的客户端上。
🎯 为何进行此变更?
- 允许服务器和整合包仅在服务器端部署 Core 模组,从而构建更精简的环境。
- 当不需要在所有地方使用 UI 时,可减少内存占用并缩短加载时间。
- 通过将 UI 和核心逻辑分离,使开发和测试更加快速。
Easy NPC: Core (1.21.1) 更新日志
说明
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub 历史记录。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请参阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏一个 NPC 的皮肤层导致同类型其他 NPC 也隐藏该皮肤层。
- 修复了僵尸类和末影人类自定义姿势被手臂动画覆盖的问题。
- 修复了村民和僵尸村民 NPC 在拥有职业时重新显示被隐藏的头部。
- 修复了在“DEFAULT”或“NONE”动画下行走时身体部位重新显示的问题。
- 修复了亡灵猪人(Zombified Piglin)NPC 在白天燃烧的问题。
- 修复了“锁定身体”标签在旋转屏幕中溢出显示的问题。
- 修复了投射物“物品 ID”字段遮挡物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生改变的问题。
7.18.0
- 修复了 #862:防止在使用 LetMeDespawn 等模组加载时 NPC 丢失。
- 修复了同时具备近战和远程攻击的 NPC 在手持弓、弩或枪时不射击的问题。
- 修复了 NPC 在目标间移动时旋转以及史莱姆 NPC 攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后Boss栏仍停留在屏幕上的问题。
- 修复了创造模式下对 NPC 使用“拾取方块”无法获得其生成蛋的问题。
- 修复了“计分板”条件在未设置分数的玩家身上添加 0 分的问题。
- 修复了 Spartan Weaponry 金色重型弩并添加了皮革和铜质版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英语 Bogged 名称以及原始的“主手”/“副手”键名。
- 更改了预设物品:在生存模式下生成 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 等模组设置的更高属性上限。 需要在服务器和客户端均安装 AttributeFix 或类似模组;护甲值上限为 100。
- 修复了 #857:当内容未发生变化时,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当一个“打开对话(条件式)”的条件不满足时,尝试执行下一个。
- 修复了动作和对话中的“概率”条件被掷骰两次,从而降低了实际概率的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear保持名称显示的问题。 - 修复了死亡、骑乘或拴绳的 NPC 出现在肩膀上,以及断开连接时肩膀渲染泄漏的问题。
- 修复了被隐藏的头部保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了多个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 更改了默认的“光照等级”从 7 改为 0(周围光照),并将其限制在 0 到 15 之间。 已存在的保留了默认开关的 NPC 也会应用此更改;设置为 7 可保留旧外观。
- 更改了“关闭对话”和“回退”动作:当没有条件对话打开时执行。
- 更改了具有传送距离的“跟随主人”NPC:使其跟随主人进入其他维度。
- 更改了服务器停止逻辑:等待最多 2 分钟,以便完成仍在写入的 NPC 文件。
- 更改了闲置 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。 - 更改了已死亡的 NPC 需要
force参数或新的复活 API 才能再次生成,自 7.15.0 版本起生效。 - 更改了内置目标以保留由插件设置的优先级,而非使用默认值。
- 更改了铁傀儡“攻击速度”的默认值为 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命令设置。 - 更新了测试通过的 NeoForge 版本至 21.1.262,该版本修复了三个网络漏洞。
7.15.0
- 修复了通过
/execute或命令方块运行时,预设导入静默处理的问题 #838。 - 修复了 NPC 数量限制同样应用于默认刷怪器的问題 #380。
- 修复了允许在声音配置中使用资源包声音的问题 #849。
- 修复了不再随机生成左手持物的 NPC 的问题 #349。
- 修复了对话框按钮按单个对话框锁定,而不是跨具有相同标签的多个对话框锁定的问题 #851。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和用户界面问题。
- 修复了 Epic Fight Wither Skeleton NPC 缺少 Epic Fight 生物补丁的问题。
- 更改了要求:客户端和服务端需使用相同的模组版本,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
- 修复了对于稍后开始看到该 NPC 的玩家,自定义姿势得以保留的问题 #846。
- 修复了稍后开始看到该 NPC 的玩家缺失属性和交易设置的问题。
- 修复了更改的最大使用次数、经验值和交易类型在未重新加载前未显示在交易屏幕中的问题。
- 修复了
/easy_npc sound set的更改在 NPC 重新加载前未传达到玩家的问题。 - 添加了在游戏测试中检查重生后和新玩家的 NPC 姿势及设置的功能。
7.13.0
- 修复了对话框按钮名称中的颜色和格式标签显示为纯文本的问题。
- 修复了编辑器中的按钮预览将小写名称显示为原始翻译键的问题。
- 修复了非创造模式下的 NPC 所有者无法使用“移动 EasyNPC”物品的問題。
- 修复了即使无法更改所有者,
/easy_npc owner set仍报告成功的问题。 - 修复了当 URL 或玩家皮肤屏幕显示皮肤下载错误时游戏崩溃的问题。
- 修复了预设浏览器搜索在下拉列表后无结果的问题。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
- 添加了对话按钮名称中对
@initiator、@npc和@score()的支持以修复 #841。 - 添加了使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行了较大的核心重构和代码清理。
7.12.2
- 修复了精灵(Fairy)的碰撞箱过小,导致其名称标签和对话气泡位于其体内的問題。
- 修复了缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和观察失误的问题。
- 修复了在网络数据包中读取过大的名称、列表和 NPC 数据时无任何限制的问题。
- 修复了应用无效 NPC 位置、缩放、属性、名称和持续时间的問題。
- 更改了精灵(Fairy)NPC 占用其模型的空间,使其发生碰撞并可被点击。
- 更改了骷髅、流浪者和泥沼僵尸 NPC 的碰撞箱高度为原版高度,此前它们略矮。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复了始终显示“还原”,包括数据包预设,并附带原因工具提示的问题 #836。
- 修复了预设导入和导出消息缺失、错误或未警告替换 NPC 的问题。
- 修复了预设浏览器在每次按键时重新加载、泄漏 NPC 并清除选择的问题。
- 修复了小窗口中预设列表排序、筛选顺序和布局裁剪选项的问题。
- 修复了不带位置参数的
/easy_npc preset import data将其作为默认预设导入的问题。 - 修复了生成速率限制泄漏、不稳定的预设 ID 以及“生成新”NPC 堆叠在同一位置的问题。
- 更改了“还原”功能,在不允许时拒绝生成副本。
- 添加了排序、匹配计数、重新加载、自动关闭、预设和皮肤的 NPC ID 及工具提示。
- 添加了带有限制、确认提示和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 修复了 #833,现在仅向魔杖持有者、所有者和管理员显示简易 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 的时间戳。
- 修复了登录恢复功能重复复制、反复恢复、复活或移动未加载的 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后 NPC 数据陈旧的问题,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时对话气泡丢失文本并变得半透明的问题。
- 修复了翻译后的对话气泡和模组 API 文本中的文本格式化和宏解析问题。
- 添加了
minLightLevel(最小光照等级),以确保在黑暗环境中对话气泡的可读性。
7.10.0
- 修复了 #829,允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体。
- 修复了渲染为蝙蝠、青蛙或监守者的 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 变成幽灵或完全隐藏。
- 添加了“灯笼幽灵”预设,这是一个在每个角落都有短线的方形行走幽灵。
- 添加了对移动操作和 NPC 不透明度的 API 访问。
- 添加了“资源位置”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”皮肤选项卡,可在应用前预览带有输入纹理的 NPC。
7.7.7
- 通过保留 64x64 皮肤的透明度来修复 #821,Fresh Moves 需要该透明度用于眼睛。此前下载的皮肤需要在玩家皮肤屏幕中通过按钮重新加载。
- 通过让村民和流浪商人 NPC 也执行交易操作来修复 #818。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载文件的问题。
- 修复了“执行限制”条件中未翻译的时间间隔名称(如
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_npc render texture命令为 Easy Model NPC 的每个模型槽位添加了纹理覆盖功能。 - 为“播放动画”操作添加了带有计数和时间限制的“重复”播放模式。
- 添加了对 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。 - 添加了以百分比表示的“几率”条件以及针对所有者和阵营的“关系”条件。
- 添加了生成、所有者登录、状态变更、白天/夜晚、天气以及缺失的“交易时”事件。
- 在每个 NPC 类型下的
easy_npc:api/preset/base/添加了基础预设,可用作父级预设。 - 添加了“流浪同伴”预设,这是一个由基于时间的消息构建的健谈 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的EventData。
- 为
/easy_npc命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,无需输入即可出现,并容忍一个方块内的轻微偏差。
7.5.0
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非按物种共享),修复了 #814。
- 通过使“返回家园”在任何距离下都能工作(而不仅仅是在家园附近),修复了 #813。
- 通过在每个会话中检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包的 Cobblemon 方面属性,而不仅仅是“闪亮”和“雌性”,修复了 #810。
- 修复了重生或导入预设后 NPC 丢失所有者、家园和“无重力”设置的问题。
- 修复了目标保留已消失的目标并在其目标或模组消失时被关闭的问题。
- 修复了像 Allay、Vex 和 Ghast 这样的飞行 NPC 在地面上移动而非飞行的问题。
- 修复了具有重复项或特殊字符的对话、按钮、预设、姿势和纹理名称的问题。
- 修复了在专用服务器上条件不可编辑以及条件文本未翻译的问题。
- 修复了 Easy Model Entities 的 NPC 不转头以及其模型列表忽略
/reload的问题。 - 修复了新建 NPC 时出现“旧版 Easy NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正导致图层伪影的问题。
- 修复了查找玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了某些语言中“重置注视...”目标标签误读为“重置战利品...”的问题。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 Fabric 上从未运行的 NPC 数据隔离和交易持久性游戏测试。
- 修复了 Doppler NPC 和第三方模型的行走动画。
- 将移动目标更改为固定顺序:逃跑、跟随、回家,然后闲逛。因此,具有多个移动目标的 NPC 行为可能与之前不同。
- 将数据包预设更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 将所需的 Easy Model Entities 版本更改为 1.7.0,浮动模型现在默认悬浮。
- 移除了实验性的用户定义 NPC 和未使用的
SERVER_SKIN皮肤类型。 - 添加了带有数值、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 为“导航”和“悬停高度”添加了设置,以切换任何 NPC 在地面和飞行之间。
- 添加了父级预设、来自其他模组的预设、预设可见性以及“Forge Keeper”预设。
- 为其他模组添加了自定义条件、事件、NPC 标识符以及更多目标选项。
- 添加了 32 块距离外的“远距离”事件,以及当所有者登录时重新生成 NPC 的选项。
- 通过提供预设和自定义目标的 API,改进了飞行导航和第三方支持。
7.4.0
- 修复了 #807:不再将 32 格范围内的所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805:改为同时评估所有可见性设置,而不是在遇到第一个时停止。
- 修复了 #804:保留 Doppler NPC 的自定义名称,以便用于基于名称的纹理和命名牌。
- 修复了 #803:调整资产以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测逻辑,此前错误地将日出计为夜晚、日落计为白天。
- 修复了下界和末地的可见性问题,此前错误地使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一次断言失败时才会报错的问题,这会导致后续失败被隐藏。
- 修复了“骑乘”马匹皮肤变体,此前从未显示马鞍。
- 更改了“仅主人可见”和“仅队伍可见”设置,使其也遵循昼夜和游戏模式的变化。
- 更改了没有“交叉手臂”姿态的唤魔者、幻影者和卫道士变体,使其保持手臂下垂姿态。
- 添加了“保卫阵营”目标,该目标会攻击伤害附近阵营成员或玩家的任何实体。
- 添加了阵营成员互相战斗且阵营选择置身事外时的系统消息。
- 为灾厄村民添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置屏幕中添加了昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升了可见性检查的性能。
- 通过用默认值补全缺失项,改进了旧版本中的显示属性数据。
- 改进了攻击目标屏幕,当未设置时禁用“保护主人”和“保卫阵营”选项。
7.3.0
- 通过以类型化字段携带数据替代解析变体名称,改进了皮肤变体的处理方式。
- 将 Cobblemon 模组 ID 和默认模型集中到共享常量中。
- 使用共享的
EnumUtils辅助类处理get(String)查找,减少了重复的枚举代码。 - 优化了村民职业和类型的查找过程,改用直接注册表键而非扫描方式。
- 通过在构造时缓存标签名、ID 和键,优化了枚举名称查找过程。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.2.0
- 修复了 #801:通过使用 NPC、对话和动作 UUID 的组合来避免动作跟踪和执行限制方面的冲突。
7.1.1
- 修复了 #800:通过延迟加载实体类型解决。
- 修复了 #799:通过修复边缘情况,并添加更多文档和更好的日志消息解决。
- 修复了 #798:通过将控制台、命令和命令方块视为受信任的命令来源解决。
- 修复了一个严重的单人/局域网问题,其中客户端和服务端 NPC 共享同一个注册表。
- 修复了配置菜单处理中的内存泄漏,并添加了超时和断开连接清理机制。
- 修复了多个 NPC 同时请求相同皮肤时的重复下载问题。
- 修复了在发生错误后皮肤查找失败的问题,防止缓慢的服务器导致游戏冻结。
- 修复了在检查远程图片时 URL 皮肤屏幕导致游戏冻结的问题;现在该检查在后台运行。
- 添加了新的世界生成器方块,可限制整个世界中(所有维度)的 NPC 预设;现有的组生成器现按维度计数,因此远处的 NPC 不再阻碍其工作。
- 增强了远程皮肤下载的安全性,设置了严格的尺寸限制和安全重定向处理,以防止因过大或恶意的皮肤 URL 导致崩溃;添加了可选的
blockPrivateAddresses设置。 - 通过仅向实际使用它们的 NPC 发送实体和玩家加载事件(按维度分组),改善了服务器性能。
7.0.0
- 修复了 #791:添加了流浪商人 NPC 类型。
- 修复了 #788:将 AI 安全措施扩展至 Epic Fight 模组和原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)。
- 修复了 #787、#531、#237 和 #184:添加了阵营系统,包含
/easy_npc faction命令、单个 NPC 的阵营分配以及自动记分板队伍同步。 - 修复了 #787、#771 和 #572:添加了新的
target目标选项卡,允许攻击敌对阵营或通过玩家姓名、队伍、实体标签或 UUID 指定特定目标。 - 修复了 #786:为 Cobblemon NPC 添加了性别和闪光模型变体,可在模型选择中通过
female或shiny进行搜索。 - 修复了无敌 NPC 之间的阵营战斗问题,通过添加新的
Attackable by Factions(可被阵营攻击)战斗属性解决。 - 修复了超大体型物种的 Cobblemon 模型选择预览问题,改为使用 Cobblemon 自身的配置文件缩放比例而非碰撞箱高度进行缩放。
- 修复了阵营管理的边缘情况,包括验证阵营名称、排序阵营列表,以及在阵营颜色更改或删除后刷新已加载 NPC 的记分板分配。
- 修复了自定义皮肤重载问题,改为按每个皮肤模型加载和清除纹理缓存,而不是始终重建完整的自定义纹理缓存。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)工作,各自为其对应的攻击者群体打开一个特定的攻击入口。 - 通过拆分大型处理器为更小的专注导入、导出和功能特定的组件,改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和阵营编辑器屏幕,用于创建、着色和删除阵营,并管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性选项卡,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过在校验期间保留数据组件,修复了 #782、#636、#622。
- 通过缓存远程纹理下载并减少重复注册,修复了 #780。
- 通过对属性滑块针对来自其他模组的极端值进行限制,修复了 #767。
- 通过为具有行为和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了纹理管理器在错误线程运行可能导致 >= 1.21.x 版本崩溃和死锁的问题。
- 修复了空 UUID 对行为条件的处理。
- 修复了行为的执行限制重置。
- 添加了纹理注册队列,以避免在同一刻内发生多个同时下载。
- 将 NPC 硬币、钥匙和红令牌作为具有行为和条件的 NPC 的可消耗物品。
- 添加了
Welcome Coin Trader作为示例 NPC 预设,包含自定义的硬币、钥匙和红令牌物品数据。 - 添加了针对来自其他模组的极端值的属性保护机制。
- 提高了高生命值 NPC 的回退最大生命值从 1024 到 4096。
- 通过减少重复的纹理检查和注册,改进了纹理管理器。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459、#775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃。
- 通过在基础刻和打开交易界面之前检查定时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout作为示例 NPC 预设,包含昼夜时间和天气条件。
6.23.0
- 通过调整 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的 #770 物品渲染问题。
- 修复了 NPC 无法可靠地打开或关闭门的 #769 门循环问题。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加包含 32 种颜色的颜色选择器弹出窗口和/或手动 RGB/hex 值,修复了 #709。
- 修复了在未指定颜色时重命名导致 NPC 名称颜色被重置的问题,通过保留现有的名称颜色。
- 改进了门移动属性,使得当“开门”或“关门”处于活动状态时,“穿过门”会自动启用。
6.22.0
- 通过将完整的服务器玩家上下文传递给命令执行,以更好地兼容依赖特定玩家数据的第三方模组和插件,修复了 #766。
- 通过添加实体生命值、NPC 生命值条件和作为使用这些条件示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 通过确保现在记录对话框按钮的执行限制,修复了 #763。
- 通过提供名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了 Easy NPC 村民(例如 PoiCompetitorScan / job_site)中第三方村民 AI 读取未注册的大脑记忆导致的崩溃 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,这是为 #760 和 #644 做的准备。
- 通过添加条件对话框打开支持/命令以更好地控制何时向玩家显示对话框,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了大脑 AI,并注册了完整的基础大脑记忆集。
- 为 #757 添加了枪标签中的额外枪支。
- 添加了新的“打开对话框(条件)”行为,仅在满足其条件时打开命名的对话框,而现有的“打开对话框”行为将继续无条件打开对话框。
- 为行为、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的无敌特性。
- 添加了新的“击退免疫”战斗属性,防止 NPC 受到近战或投射物攻击的击退效果。
- 添加了新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了持交叉手臂姿势的劫掠者物品附着问题。
- 修复了损坏的劫掠者弩攻击目标。
- 修复了与不可作为手持物品渲染的第三方物品相关的崩溃 #756。
- 修复了与尝试访问不存在的模型部分的第三方 mixins 相关的崩溃 #756。
- 通过减少日志详细程度并为自定义模型部分添加额外检查,修复了 log.info 垃圾信息问题。
- 改进了 EasyNPCModelManager 性能。
- 重构了 NPC 渲染器以移除默认的手持物品层。
6.20.0
- 修复了与试图访问不存在 NPC 目标的第三方模组相关的崩溃。
6.19.0
注意:此更新将对话框背景图像调整了 10x6 像素,如果您使用的是自定义背景,可能需要调整您的自定义对话框背景。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752、#130。
- 通过为对话框文本添加打字机效果支持,修复了 #683、#215。
- 通过允许对话框、对话框按钮和交互的条件,修复了 #690、#309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 重构了对话框背景图像,每边调整了 10x6 像素。
- 重构了对话框屏幕布局以更好地适应新的背景尺寸并改善外观。
- 为对话框文本添加了打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了
Threshold Warden作为示例 NPC 预设,包含各种条件和行为。 - 添加了与对话框条件和按钮状态相关的较小修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置或删除未存储 ID 的现有执行限制条目。
- 通过为操作添加条件来修复 #745,以支持更复杂和动态的行为。
- 通过为长文本添加对话框按钮提示框来修复 #652。
- 通过添加命令值提示框以显示完整值来修复 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏拥有物品的条件。
- 添加了手持物品条件,支持主手和副手。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,允许对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统,以支持更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外提示框来修复 #738。
- 通过减少启动期间和游戏内的 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项来修复 #732。
- 通过避免在特定情况(如交易界面)下自动关闭来修复 #723。
- 添加了通用对话框配置选项,允许用户自定义对话框行为。
- 为对话框添加了头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0 (交易、玩家头颅、Epic Fight 和便利性更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能来修复 #730。
- 通过确保正确存储交易使用次数来修复 #729。
- 通过为玩家头颅添加自定义头颅支持来修复 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置来修复 #689。
- 通过新的交易配置界面和对自定义交易的更好支持来修复 #218 和 #132。
- 通过在基本模式和普通/高级模式之间切换时修复交易特定的边缘情况。
- 通过显示完整文本的提示框来修复对话框按钮文本被截断的问题。
- 通过将动画状态与 Cobblemon Animation System 同步来修复 Cobblemon 动画问题。
- 添加了每笔交易特定的操作,允许用户在购买后触发操作。
- 添加了交易重置按钮,以便轻松重置所有交易。
- 在交易配置界面中添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了 Griselda Grindstone 作为带有操作的示例商人。
- 清理测试文件。
6.14.0
- 通过确保更改值时同步到客户端来修复 #727。
- 通过为特定命令添加额外的白名单来修复 #726。
- 通过添加基本的 Cobblemon 支持(带 Cobblemon NPC)来修复 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕来修复对话框错位和导航问题。
- 通过修正旋转逻辑和枢轴计算来修复 x 和 z 根旋转问题。
- 通过自定义 NPC 类型和模型添加了基本的 Cobblemon 支持用于测试。
6.13.0 (安全和权限更新)
注意:此更新包括更好的安全检查和多玩家环境的权限控制。它允许执行服务器命令,如果被恶意使用可能会造成潜在危险。
此更新将模型根节点的数据和逻辑从其余模型部分的数据和逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根节点的数据和逻辑从其余模型部分的数据和逻辑中分离来修复 #725。
- 通过支持 .sbnt 文件作为本地预设来修复 #722。
- 通过为对话框和配置界面背景添加专用资源来修复 #675。
- 通过新的安全检查系统和权限系统来修复 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例来修复 #469、#311。
- 通过移除冗余的背景渲染来修复配置界面背景的双重渲染问题。
- 通过调整边界框来修复 Ghast 和史莱姆的碰撞箱和名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多玩家环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义性和兼容性。
- 用静态背景替换动态配置界面背景,以获得更好的性能。
- 重构了特定于配置 UI 的组件,并将它们从核心模组中移除。
- 移除了重复的精灵表。
- 为将来可能的 Luck Perms 集成(如 #712)准备权限系统。
- 与配置界面渲染和资源相关的常规代码清理和优化。
6.12.0
- 通过基于原版模型添加针对自定义模型部分的额外检查来修复 #714。
- 通过降低每个 NPC 的 INFO 消息级别至 DEBUG 并合并冗余警告消息来减少日志详细程度,从而修复 #713。
- 通过减少过大尺寸的启动/配置日志输出来修复 #711。
- 修复 NBT 验证守卫,以防止在生产环境中不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加模型部分名称常量,以便在 mixins 中一致使用。
- 通过增强过滤逻辑和优化数据结构来提高 RenderEntityTypeSupportConfig 的性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.1
- 通过改进可恢复交易数据的向后兼容解析来修复 #710。
6.11.0
- 修复了 #703 在新自定义层级系统和手部渲染中的渲染问题。
- 通过为无效交易报价添加额外安全措施和日志记录,修复了 #701。
- 修复了头部位置修改时智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务器端,修复了头部追踪问题。
- 优化了 CustomLookAtPlayerGoal 以更好地处理边缘情况并减少抖动。
- 修复了 Doppler NPC 保留其手部物品栏的问题。
- 改进了 PoseManager 的日志消息。
- 更新了具有新设计的标志。
6.10.0
- 通过对第三方实体创建添加 try/catch 块,修复了 #698。
- 通过在切换至
DEFAULT原版姿态时清除模型部件的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过将根旋转枢轴更正为使用实际的边界框高度而非 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺少针对玩家的目标刷新,以及对离线目标的重试机制。 - 修复了在目标注销后仍保留目标引用的问题。
- 移除了加载姿态时 ROOT 旋转的自动锁定;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在默认姿态屏幕的
ConfigurationMenuHandler中添加了特定模型的姿态键过滤功能。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 添加了
NPCDataIsolationTestHelper以及用于 Fabric 和 Forge 的游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施以防止冗余重新触发 NPC 实体数据更新,修复了 #692 和 #666。
- 通过为所有支持的 NPC 类型添加基本自定义姿态,修复了 #651 和 #617。
- 通过添加额外的逃跑目标(用于逃离玩家、村民、怪物等),修复了 #597。
- 修复了姿态加载问题,使其直接从模组资源读取而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除和重新生成 NPC,并支持可配置的移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,以便外部模组控制 NPC 姿态并以编程方式管理 NPC。 - 为所有支持的 NPC 类型添加了姿态数据文件。
- 在基本姿态配置屏幕中添加了锁定旋转复选框。
- 添加了
MoveToPositionGoal,用于在执行回调动作之前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl以尊重锁定的根旋转。 - 将所有者更改和维度更改同步到 NPC 实体数据索引。
- 将 EasyNPCItemAttachmentLayer 添加到各种实体渲染器中。
- 添加了专用的
Flee Objective配置标签页,包含针对苦力怕、怪物、生物、玩家、村民和阳光的逃跑目标。 - 在跟随目标标签页中添加了
FOLLOW_ITEM目标,使 NPC 能够通过资源位置(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在查看目标屏幕中启用了按 UUID 查看实体和查看主人的目标。 - 在
SynchedDataIndex中添加了persistent标志,使得瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 API 消费者在
SlimeBase中添加了可配置的customParticlesEnabled标志。 - 添加了
SoundType.PET,并将CAT_PURR映射到驯服的猫 NPC,以增加环境声音的多样性。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低到 DEBUG。
6.8.3
- 通过升级网络协议版本强制执行版本不匹配警告,修复了 #680。
- 通过重置名称标签的位置、旋转和大小,修复了 #679。
- 通过为根旋转添加多状态滑动,修复了 #665。
- 通过添加禁用跟随鼠标光标的选项以便于姿态调整,修复了 #664。
- 通过改进对 X 和 Z 根旋转的支持,修复了 #663。
- 通过添加使用 NPC 魔杖并潜行靠近 NPC 以快速旋转根部朝向玩家的功能,修复了 #661。
- 通过在交互处理器中添加对移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过在交互处理器中添加对预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整边界框和视线高度计算,修复了史莱姆和恶魂的碰撞箱及名称标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂的 GUI 位置问题。
6.8.2
- 通过扩展
SafeMerchantData以包含 notifyTrade 来避免崩溃,修复了 #677。 - 添加了基于玩家互动和行为的 NPC 升级进度数据支持。
- 添加了全局 NPC 跟踪系统,以便更好地管理和调试世界中的 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原版模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而非自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过为无效网络数据包添加警告消息和额外检查,修复了 #667。
- 修复了马刷新的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和幻翼的姿态支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,便于与其他模组和自定义模型集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进空间。
6.7.1
- 通过为原版漏洞添加额外的客户端检查,修复了 #657 和 #656。
6.7.0
- 通过实现 Wolf Leg Animations 动画并在 setupAnim 方法中调用,修复了 #650。
- 通过修复 canBeHitByProjectiles 的翻译逻辑,修复了 #648。
- 添加了
allowBypassInvulnerability配置选项,用于允许/禁止 NPC 绕过无敌状态,从而修复了 #645。 - 修复了删除按钮在宽度较小时仍显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置界面中名称标签错误显示的问题。
- 修复了距离动作问题:当多个动作存在时,未能正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据不同步的问题。
- 添加了预设浏览器,以便更轻松地选择常用 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于分享 NPC 预设。
- 重构了现有的 NPC 预设,使其使用新的 .snbt 格式。
- 重构了生成器系统,以使用新的预设格式,从而提高可维护性和未来改进空间。
6.6.2
- 通过重写缩放系统,修复了 #643。
- 修复了重启/重载后缩放未正确更新命中盒和名称标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名称标签可见性模式,以更精细地控制 NPC 名称的显示。
- 添加了基于队伍的名称标签可见性支持,尊重原版 Team 机制。
6.6.1
- 通过重构显示属性的内部数据处理,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载,修复了 #634。
- 修复了纹理加载阻塞渲染线程导致游戏冻结的问题。
- 通过原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏问题。
- 修复了 URL 验证垃圾信息问题,防止同一纹理的多次同时下载。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载过程中出现的
defineId called for:警告消息。 - 重构了纹理加载架构,采用多级防御和速率限制机制。
- 重构了实体数据注册逻辑,以提高可维护性。
- 将数据类转换为现代 Java record 类型,以提高不可变性和线程安全性。
- 添加了线程安全的会话服务器防垃圾保护,使用 ConcurrentHashMap 实现。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载性能,使用双线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 设置了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过添加 Gradle 依赖缓存,改进了 GitHub 工作流。
- 优化了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了 #629。
- 修复了 kill 命令对 NPC 无效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重载的问题。
- 修复了远程图像验证器中的 WebP 验证 bug(缺少 return 语句)。
- 重构了纹理处理逻辑,以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了额外的纹理处理单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过实现剪刀算法(scissor implementation),修复了 #627,以提高与其他模组的兼容性。
- 修复了 #627,解决了在使用旋转或移动模型部件时动画不流畅的问题。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 修复了针对不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade进行的详细调查和修复建议,从而解决了 #626。
6.4.0
- 通过改进对话框数据验证和错误处理,修复了 #626。
- 通过重构渲染数据和渲染处理逻辑,修复了 #623。
- 确保自定义数据正确保存和加载,从而修复了 #622。
- 修复了打开对话框的动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,并简化了自定义数据的测试过程。
- 改进了 record 类型的使用,并修复了潜在的数据缺失问题。
6.3.0
- 重构了配置 UI 特定组件,并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话框数据,修复了对话框数据问题。
- 修复了对话框编辑器布局问题并提高了可用性。
- 修复了部分对话框数据字段缺少默认值的问题。
- 添加了对话框优先级支持,以控制对话框的执行顺序。
- 为对话框和记分板动作添加了条件支持。
- 添加了对话框频率支持,以限制对话框显示的频率。
- 添加了支持记分板和条件的新 NPC 预设。
- 通过移除冗余字段,改进了对话框按钮数据格式。
6.2.0
- 修复了对话框内的字符串注入问题。
- 修复了动作类型缺少翻译的问题。
- 添加了记分板动作类型,用于增加、减少或设置记分板数值。
- 添加了
@score(...)NPC 宏,以便在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了自旋按钮,增加了指示器并提高了可用性。
6.1.2
- 修复了容器和菜单同步问题,解决了缺少关闭容器数据包的问题。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了屏幕转换期间鼠标光标跳跃的问题。
- 修复了翻译文件,并删除了重复和已弃用的条目。
- 将 Easy NPC 法杖移至现有的核心物品选项卡,而不是创建新的选项卡。
- 添加了针对不同模型部件(尾巴除外)的猫姿态支持。
- 通过在不需要时禁用发光效果,改进了 EasyNPCWand 发光效果的 performance。
- 通过排除非生物实体(如展示框、制造者、投掷物和生成器),改进了自定义实体检测。
- 改进了猫变种的处理逻辑。
6.1.1
- 通过重新验证实体类型修复了 #612。
- 通过对特定模型的帽子和头部图层进行强制同步,修复了 #610。
- 修复了兽人纹理问题。
- 通过将相关逻辑移至仅客户端运行,改进了自定义模型的支持与性能。
- 改进了玩家皮肤中玩家到 UUID 映射的缓存机制。
- 将更改模型命令和逻辑限制为仅限 Doppler NPC。
6.1.0 ✨
这是一个重大版本更新。请在更新前备份你的世界存档和 NPC 数据。此版本包含许多改进、优化以及内部变更,不与前期的版本完全兼容。
⚠️ 破坏性变更
- 来自 6.1.0 之前版本的现有 NPC 及其配置数据可能无法正确加载,或需要手动调整。
- 内部数据格式和部分行为已重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 捆绑包,同时包含 Core(核心)和 Configuration UI(配置界面),提供即插即用的体验。
- Easy NPC: Core - 轻量级的 NPC 运行时与逻辑模块,依赖项极少。适用于服务器、整合包及开发者。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何做出此变更?
- 允许服务器和整合包仅在服务器端部署 Core 模组,从而构建更精简的环境。
- 当无需在所有地方使用界面时,可减少内存占用并缩短加载时间。
- 通过分离界面与核心逻辑,加快开发与测试速度。
Easy NPC (1.20.1) 更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请查阅 升级指南。
7.19.0
- 修复了 #865:保持一个 NPC 的隐藏皮肤层不会导致同类型的其他 NPC 也隐藏该皮肤层。
- 修复了僵尸类和末影人类 NPC 的自定义姿势被其手臂动画覆盖的问题。
- 修复了村民和僵尸村民 NPC 隐藏头部后,在拥有职业时再次显示头部的 bug。
- 修复了僵尸猪灵 NPC 在阳光下燃烧的问题。
- 修复了“锁定身体”标签在旋转屏幕外运行的问题。
- 修复了投射物“Item ID”字段遮挡 Item ID 开头内容的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生变化的问题。
7.18.0
- 修复了 #862:防止像 LetMeDespawn 这类模组加载时 NPC 丢失。
- 修复了同时拥有近战和远程攻击的 NPC 在持有弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标之间旋转以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后 Boss 栏仍停留在屏幕上的问题。
- 修复了创造模式下对 NPC 使用快速挖掘无法获得其生成蛋的问题。
- 修复了“记分板”条件为没有分数的玩家添加 0 分的问题。
- 修复了 Spartan Weaponry 的金质重型弩,并添加了皮革和铜质版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义”皮肤标签页将文件夹命名为
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 等模组设置的更高属性上限。 需要在服务器和客户端都安装 AttributeFix 或类似模组;护甲值上限为 100。
- 修复了 #857:当未发生任何更改时,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当一个“打开对话框(条件)”的条件不满足时,尝试执行下一个。
- 修复了动作和对话框上的“几率”条件被掷骰两次,从而降低实际几率的问题。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或被拴绳的 NPC 出现在肩膀上,以及断开连接时的肩膀渲染泄漏问题。
- 修复了隐藏头部保留帽子图层,以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了几个默认预设,包括 "Grukk"、"Forge Keeper" 和 "Yoga Master"。
- 将默认的“光照等级”从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受到影响;设置为 7 可保持旧版外观。
- 更改了“关闭对话框”和“回退”动作的执行时机:当没有条件对话框打开时运行。
- 更改了具有传送距离的“跟随主人”NPC 的行为:使其跟随主人进入其他维度。
- 更改了服务器停止逻辑:等待最长 2 分钟,以便仍在写入的 NPC 文件完成保存。
- 更改了空闲 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。 - 更改了已死亡的 NPC:自 7.15.0 版本起,需要
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 问题。
- 修复 Epic Fight Wither Skeleton NPC 缺少 Epic Fight 生物补丁的问题。
- 更改要求:客户端和服务端需使用相同的模组版本,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
- 修复对话框按钮名称中的颜色和格式标签显示为纯文本的问题。
- 修复编辑器中按钮预览将小写名称显示为原始翻译键的问题。
- 修复非创造模式下 NPC 所有者无法使用“移动 EasyNPC”物品的问题。
- 修复
/easy_npc owner set即使所有者无法更改也报告成功的问题。 - 修复当 URL 或玩家皮肤屏幕显示皮肤下载错误时导致游戏崩溃的问题。
- 修复预设浏览器向下滚动列表后搜索无结果的问题。
- 更改网络协议版本,因此客户端和服务端必须运行相同的模组版本。
- 添加对对话框按钮名称中
@initiator、@npc和@score()的支持以修复 #841。 - 添加使用 Client Runtime Interface Toolkit 进行的自动客户端测试。
- 进行较大的核心重构和代码清理。
7.12.2
- 修复精灵(Fairy)碰撞箱过小,导致其名称标签和对话气泡位于其身体内的问题。
- 修复缩放后的 NPC 保留旧的碰撞箱和视线高度,导致攻击、点击和观察偏离目标的问题。
- 修复格式错误的网络数据包导致玩家断开连接而非被忽略的问题。
- 修复应用无效的 NPC 位置、缩放比例、属性、名称和持续时间的问题。
- 更改精灵(Fairy)NPC 占用其模型的空间,使其可以碰撞并可被点击。
- 更改网络协议版本,因此客户端和服务端必须运行相同的模组版本。
7.12.1
- 修复 #836:始终显示“恢复”,包括数据包预设,并附带原因提示框。
- 修复预设导入和导出消息缺失、错误或未警告关于替换的 NPC 的问题。
- 修复预设浏览器在每次按键时重新加载、泄露 NPC 并清除选择的问题。
- 修复在小窗口中预设列表排序、筛选顺序和布局裁剪选项的问题。
- 修复
/easy_npc preset import data在未指定位置时将预设导入为默认预设的问题。 - 修复生成速率限制泄漏、不稳定的预设 ID 以及“生成新”在同一位置堆叠 NPC 的问题。
- 更改“恢复”行为:当不允许时拒绝操作,而不是生成副本。
- 为预设和皮肤添加排序、匹配计数、重新加载、自动关闭、NPC ID 和工具提示。
- 添加带有限制、确认步骤和可点击位置的
matching <pattern>批量导入功能。
7.12.0
- 修复 #833:仅向法杖持有者、所有者和管理员显示 Easy NPC Wand 轮廓。 其他玩家不再看到轮廓,且隐形 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
- 通过不再在 NPC 跟随或注视玩家时注销服务器来修复 #828。
- 通过将常规 NPC 移除消息移至调试日志来修复 #831。
- 通过让人形 NPC 忽略自定义玩家模型、动画和姿势来修复 #832。
- 修复了在大型世界中每小时 NPC 备份卡顿以及保留已移除 NPC 时间戳的问题。
- 修复了所有者登录恢复导致重复、反复恢复、复活或移动未加载的 NPC 的问题。
- 修复了导致 NPC 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了使用 Iris 光影时对话气泡失去文本并变得半透明的问题。
- 修复了翻译后的对话气泡和模组 API 文本的文本格式化和宏解析问题。
- 添加了
minLightLevel以保持对话气泡在黑暗环境中的可读性。
7.10.0
- 通过允许蝙蝠和其他非行走生物作为 Doppler NPC 的渲染实体来修复 #829。
- 修复了 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 格,并仅在该范围之外进行传送。
- 更改了“移动到”和“返回家园”,使其在没有进展三秒后放弃。
- 更改了“移动到”动作的超时以计算真实刻度,之前运行时间过长。
- 更改了新的“随机游泳”目标,使其优先级低于跟随、逃跑和攻击目标。
- 更改了具有 Easy Model Entities 模型的 NPC 的不透明度,使其由该模组本身应用。
- 将 Easy Model Entities 的最小版本更改为 2.3.0,旧版本禁用集成。
- 为 NPC 的游泳水平添加了“表面以下深度”和“地板以上高度”滑块。
- 添加了世界保存时写入的 NPC 文件的日志条目,每项超过 250 毫秒发出警告。
7.8.1
- 通过在水下直立渲染鱼类 NPC 而不是总是侧翻来修复 #827。
- 通过防止受损的 NPC 阻止世界保存来修复 #828,现在它回退到默认值。
- 修复了恢复的 NPC 选择一个随每次保存而改变的随机预设 ID 的问题。
- 更改了 NPC 数据,使其仅在实际上发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已经站在目标位置的 NPC 以立即完成移动。
- 将“无”皮肤选项卡更改为“高级”,其中现在包含“禁用皮肤”和纹理字段。
- 添加了“移动到”动作,将 NPC 发送到位置、玩家、其所有者或其家园。
- 添加了“移动到并等待”动作,仅在到达后才运行后续动作。
- 为两个移动动作添加了到达半径、超时和可选传送。
- 添加了从 0 到 100 的“不透明度”属性,使身体、盔甲和手持物品一起淡出。
- 添加了“设置不透明度”动作,使 NPC 变成幽灵或完全隐藏。
- 添加了“灯笼幽灵”预设,一个在正方形上行走并在每个角落带有一条短线的幽灵。
- 添加了对移动动作和 NPC 不透明度的 API 访问。
- 添加了“资源位置”皮肤类型,渲染模组或资源包的任何纹理。
- 添加了“高级”皮肤选项卡,在应用之前预览带有输入纹理的 NPC。
7.7.7
- 通过保留 64x64 皮肤的透明度来修复 #821,这是 Fresh Moves 用于其眼睛所必需的。在此日期之前下载的皮肤需要在玩家皮肤屏幕中的按钮上进行重载。
- 通过为村民和流浪商人 NPC 运行交易动作来修复 #818。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载文件的问题。
- 修复了“执行限制”条件中未翻译的时间间隔名称(如
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_npc render texture为 Easy Model NPC 添加了每个模型槽位的纹理覆盖功能。 - 为“播放动画”动作添加了带有计数和时间限制的“重复”播放模式。
- 为 Easy Model NPC 的动画变体、纹理槽位和纹理添加了 API 访问权限。
7.6.0
- 修复了实体数据跟踪器 ID 重复导致的模糊模组冲突错误。
- 修复了第三方生命条在配置和对话框屏幕上渲染在 NPC 预览之上的问题。
- 修复了 Doppler 和 Easy Model Entities NPC 使用默认碰撞箱而非其模型尺寸的问题。
- 修复了在服务器上
/easy_npc命令完全不建议任何 NPC UUID 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段之上的问题。
- 修复了动作编辑器中未翻译的“循环”、“当前之后”和“动作数据类型”标签。
- 修复了“几率”条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕而未换行的问题。
- 修复了“消息”动作的帮助图标和文本按钮对齐不正确的问题。
- 修复了无法保存对“设置姿势”、“播放动画”和“停止动画”动作的更改的问题。
- 修复了对话气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议列表,使其优先列出准星指向的 NPC,并且仅在无权限时列出拥有者。
- 更改了预设导出功能,使其仅存储与新建 NPC 不同的部分,而不包含位置或拥有者信息。
- 更改了没有目标或动作的预设,使其回退到其 NPC 类型的默认值。
- 更改了无需玩家参与的事件(如“生成时”或“击杀时”),使其检查其条件。其中包含基于玩家的条件(例如记分板或物品)的动作不再执行。
- 更改了时间触发动作,只要拥有者在附近,就将其作为
@initiator选择。 - 更改了对话气泡的可见时间,根据文本长度保持在 5 到 18 秒之间。
- 更改了“设置姿势”动作,使其仅对“自定义”姿势条目显示其输入字段。
- 添加了五个固定步骤的时间触发动作,频率从约每 1 秒到约每 15 分钟。
- 添加了“消息”动作,用于聊天、系统消息和对气泡文本,无需命令。
- 为“消息”动作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包添加了对气泡图形
easy_npc:textures/gui/speech_bubble.png的支持。 - 添加了百分比形式的“几率”条件以及针对拥有者和阵营的“关系”条件。
- 添加了生成、拥有者登录、状态变更、白天/夜晚、天气以及缺失的“交易时”事件。
- 在
easy_npc:api/preset/base/下为每种 NPC 类型添加了基础预设,可用作父预设。 - 添加了“流浪伙伴”预设,这是一个由时间触发消息构建的多话 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的EventData。
- 为
/easy_npc命令的每个 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,使其在无需输入时即可出现,并容忍距离一格的偏差。
7.5.0
- 通过让每个 Cobblemon NPC 拥有独立的状态而非按物种共享,修复了 #814。
- 通过允许“返回家园”在任何距离下生效(而不仅仅是在家附近),修复了 #813。
- 通过在每次会话中仅检查一次玩家是否更换了皮肤,修复了 #812。
- 通过接受资源包中的 Cobblemon 方面(aspects)属性,而不仅仅是“闪亮”和“雌性”,修复了 #810。
- 修复了在重生或预设导入后 NPC 丢失所有者、家园和“无重力”设置的问题。
- 修复了目标在目标消失或被移除时仍保留已消失的目标并在其目标或模组消失时被关闭的问题。
- 修复了像 Allay、Vex 和 Ghast 这样的飞行 NPC 在地面上移动而非飞行的问题。
- 修复了存在重复项或特殊字符的对话、按钮、预设、姿势和纹理名称的问题。
- 修复了专用服务器上无法编辑条件以及未翻译的条件文本的问题。
- 修复了 Easy Model Entities 的 NPC 不转头且其模型列表忽略
/reload命令的问题。 - 将移动目标的顺序固定为:逃跑、跟随、返回家园,然后漫步。因此,具有多个移动目标的 NPC 行为可能与之前不同。
- 将数据包预设更改为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 将 Easy Model Entities 所需的最低版本更改为 1.7.0,浮动模型现在默认悬浮。
- 移除了实验性的用户自定义 NPC 和未使用的
SERVER_SKIN皮肤类型。 - 添加了带有数字、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 添加了“导航”和“悬浮高度”设置,用于在任何地面和飞行模式之间切换任意 NPC。
- 添加了父级预设、来自其他模组的预设、预设可见性以及 “Forge Keeper” 预设。
- 添加了自定义条件、事件、NPC 标识符以及其他模组可用的更多目标选项。
- 添加了 32 格外的“远距离”检测,并添加了当所有者登录时重新生成 NPC 的选项。
- 改进了飞行导航和第三方支持,提供了用于预设和自定义目标的 API。
7.4.0
- 通过不再将 32 格内所有同类型 NPC 拉入“自卫”战斗中,修复了 #807。
- 通过同时评估所有可见性设置而不是在第一个处停止,修复了 #805。
- 通过为 Doppler NPC 保留自定义名称以用于基于名称的纹理和名牌,修复了 #804。
- 通过调整资产以匹配典型的 Minecraft 风格而非通用 UI 风格,修复了 #803。
- 修复了昼夜检测,该检测将日出计为夜晚,将日落计为白天。
- 修复了下界和末地的可见性问题,该问题错误地使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框随机出现顺序的问题。
- 修复了游戏测试仅在第一次断言失败时才能报错,从而隐藏了后续失败的问题。
- 修复了“骑乘”马匹皮肤变体从不显示马鞍的问题。
- 更改了“仅对所有者可见”和“仅对队伍可见”,使其也遵循白天、夜晚和游戏模式。
- 更改了没有“交叉手臂”的 Evoker、Illusioner 和 Vindicator 变体,使其保持手臂下垂。
- 添加了“保卫派系”目标,攻击伤害附近派系成员或玩家的任何人。
- 添加了当派系成员互相战斗且派系保持中立时的系统消息。
- 为 Illagers 添加了头部装备槽位,以便移除或替换其队长旗帜。
- 在显示配置屏幕中添加了白天和黑夜预览。
- 为可见性属性和派系防御添加了单元测试和游戏测试。
- 通过仅在每次检查时读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全旧版本的显示属性,改进了来自旧版本的显示属性。
- 通过在未设置时禁用“保护所有者”和“保卫派系”,改进了攻击目标屏幕。
7.3.0
- 通过将数据作为类型化字段携带而非解析变体名称,改进了皮肤变体。
- 在共享常量中集中了 Cobblemon 模组 ID 和默认模型。
- 通过使用共享的
EnumUtils辅助类进行get(String)查找,减少了重复的枚举代码。 - 优化了村民职业和类型的查找,使用直接注册表键而非扫描。
- 通过在构造时缓存标签名称、ID 和键,优化了枚举名称查找。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.2.0
- 通过使用 NPC、对话和动作 UUID 的组合来避免动作跟踪和执行限制的冲突,修复了 #801。
7.1.1
- 通过延迟加载实体类型,修复了 #800。
7.1.0
- 通过修复边缘情况并添加额外的文档和更好的日志消息,修复了 #799。
- 通过将控制台、命令和命令方块视为受信任的命令源,修复了 #798。
- 修复了一个严重的单人/LAN 问题,其中客户端和服务端 NPC 共享相同的注册表。
- 修复了配置菜单处理中的内存泄漏,并添加了超时和断开连接清理。
- 修复了当多个 NPC 同时请求相同皮肤时的重复下载问题。
- 修复了出错后皮肤查找失败,导致慢速服务器冻结游戏的问题。
- 修复了 URL 皮肤屏幕在检查远程图像时冻结游戏的问题;现在该检查在后台运行。
- 添加了新的 World Spawner 区块,限制整个世界中(所有维度)的 NPC 预设;现有的 Group Spawner 现在按维度计数,因此远处的 NPC 不再阻塞它。
- 通过严格的尺寸限制和安全的重定向处理加固了远程皮肤下载,以防止因过大或恶意的皮肤 URL 导致的崩溃;添加了可选的
blockPrivateAddresses设置。 - 通过仅向实际使用它们的 NPC 发送实体和玩家加载事件(按维度分组),提高了服务器性能。
7.0.0
- 通过添加流浪商人 NPC 类型修复了 #791。
- 通过将 AI 安全保护扩展至 Epic Fight 和原始 NPC 变体(猪灵、村民、末影人、苦力怕、掠夺者和女巫)修复了 #788。
- 通过添加带有
/easy_npc faction命令的阵营系统、单个 NPC 阵营分配以及自动记分板队伍同步,修复了 #787、#531、#237 和 #184。 - 通过添加新的
target目标标签页以攻击敌对阵营或按玩家名称、队伍、实体标签或 UUID 指定特定目标,修复了 #787、#771 和 #572。 - 通过在模型选择中支持使用
female或shiny搜索,为 Cobblemon NPC 添加了性别和闪光模型变体,修复了 #786。 - 通过添加新的
Attackable by Factions(可被阵营攻击)战斗属性,修复了无敌 NPC 之间的阵营战斗问题。 - 通过根据 Cobblemon 自身的配置档案缩放比例而非碰撞箱高度进行缩放,修复了超大体型物种的 Cobblemon 模型选择预览问题。
- 通过验证阵营名称、排序阵营列表并在阵营颜色或删除更改后刷新已加载的 NPC 记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存,而不是始终重建整个自定义纹理缓存,修复了自定义皮肤的重新加载问题。
- 改进了
Attackable by Players/Monsters/Factions(可被玩家/怪物/阵营攻击)战斗属性,使其独立于Invulnerable(无敌)工作,为各自的攻击者组打开一个独立的攻击入口。 - 通过将大型处理器拆分为更小的专注于导入、导出和功能特定的组件,改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和管理器编辑器屏幕,用于创建、着色和删除阵营并管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc(杂项)属性标签页,作为 NPC 阵营分配的归属地。 - 添加了可复用的警告和帮助图标组件,用于带有工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过为远程纹理下载添加额外的缓存和优化机制,修复了 #780。
- 通过防止其他模组的天文数值导致属性滑块异常,修复了 #767。
- 通过为具有动作和条件的 NPC 添加自定义数据物品匹配,修复了 #754。
- 修复了在 >= 1.21.x 版本中,纹理管理器在错误线程运行可能导致崩溃和死锁的问题。
- 修复了因操作条件中 UUID 为空而导致意外行为的问题。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多个同时下载。
- 将 NPC 硬币、钥匙和红代币添加为具有动作和条件的 NPC 的可消耗物品。
- 添加了
Welcome Coin Trader(欢迎币商)作为示例 NPC 预设,其中包含自定义硬币、钥匙和红代币作为示例物品,并为动作和条件提供新的物品数据。 - 添加了对抗其他模组天文数值的通用属性安全保护。
- 将回退最大生命值从 1024 增加到 4096,以允许创建更复杂的 NPC。
- 改进了纹理管理器,消除了重复的纹理检查和注册。
6.24.0
- 通过添加阻止与隐形 NPC 交互的选项,修复了 #459 和 #775。
- 修复了与可选的 Epic Fight 和 Cobblemon 实体类型映射相关的 #774 启动崩溃问题。
- 通过在基础刻期间和在打开交易屏幕之前检查定时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了
Skywatch Scout(天卫侦察兵)作为示例 NPC 预设,其中包含昼夜时间和天气条件。
6.23.0
- 通过调整针对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、劫掠者、卫道士和人形皮肤)的物品渲染问题 #770。
- 修复了 NPC 未能可靠地打开或关闭门的门循环问题 #769。
- 通过添加对话框选项和配置设置(buttonConditionMode: LOCK 或 HIDE)来锁定或隐藏不可用的条件对话框按钮,修复了 #760。
- 通过为名称添加支持 32 种颜色及手动 RGB/十六进制值的颜色选择器弹出窗口,修复了 #709。
- 通过保留现有名称颜色,修复了在不指定颜色的情况下重命名时 NPC 名称颜色被重置的问题。
- 改进了门移动属性,使得当 "Open Door"(开门)或 "Close Door"(关门)处于活动状态时,自动启用 "Pass Door"(穿过门)。
6.22.0
- 通过向命令执行传递完整的服务器玩家上下文,修复了 #766,以更好地兼容依赖特定玩家数据的第三方模组和插件。
- 通过添加实体生命值、NPC 生命值条件以及作为使用这些条件的示例的 NPC 预设
Grukk, the Sparring Post,修复了 #764。 - 确保现在记录了对话框按钮执行的限制,修复了 #763。
- 提供了名为
One Wish Companion的示例 NPC 预设,修复了 #758。 - 修复了在 Easy NPC 村民(例如 PoiCompetitorScan / job_site)上,第三方村民 AI 读取未注册的脑记忆时导致的崩溃问题 #756。
- 修复了对话框按钮未锁定服务器端数据的问题,为 #760 和 #644 做准备。
- 通过添加条件性对话框打开支持/命令,以便更好地控制何时向玩家显示对话框,修复了 #628。
- 为 Piglin 和 Piglin Brute NPC 添加了脑 AI,并注册了完整的原版脑记忆集。
- 为 #757 向枪械标签添加了额外的枪械。
- 添加了一个新的“打开对话框(条件性)”操作,仅在满足其条件时打开指定名称的对话框,而现有的“打开对话框”操作则无条件地打开对话框。
- 为动作、对话框和对话框按钮添加了新的实体生命值和 NPC 生命值条件。
- 为了与其他 NPC 保持一致,添加了 Piglin、Piglin Brute 和 Zombified Piglin NPC 的不受击倒属性。
- 添加了一个新的“击退免疫”战斗属性,防止 NPC 被近战或投射物攻击击退。
- 添加了一个新的“爆炸免疫”战斗属性,使 NPC 免疫爆炸伤害和位移(例如 TNT、苦力怕、末影水晶)。
- 将“投射物碰撞”属性移至战斗属性屏幕,使其在主题上更合适(此前位于能力屏幕)。
6.21.0
- 修复了交叉手臂姿势下 Illagers 的物品附着问题。
- 修复了损坏的 Illager 弩攻击目标。
- 修复了与无法渲染为手持物品的第三方物品相关的崩溃问题 #756。
- 修复了与尝试访问不存在的模型部件的第三方 mixins 相关的崩溃问题 #756。
- 通过减少日志详细程度并为自定义模型部件添加额外检查,修复了 log.info 垃圾邮件消息。
- 提高了 EasyNPCModelManager 的性能。
- 重构了 NPC 渲染器,移除了默认的手持物品层。
6.20.0
- 修复了第三方模组尝试访问不存在的 NPC 目标时导致的崩溃问题。
6.19.0
注意:此更新将对话框背景图像调整了 10x6 像素,如果您使用自定义背景,可能需要调整您的自定义对话框背景。
- 通过添加对话框按钮条件支持以允许禁用按钮,修复了 #752、#130。
- 通过为对话框文本添加打字机效果支持,修复了 #683、#215。
- 通过允许对话框、对话框按钮和交互的条件设置,修复了 #690、#309。
- 修复了对话框屏幕布局和背景的较小 UI 问题。
- 将对话框背景图像每侧重构调整了 10x6 像素。
- 重构了对话框屏幕布局,以更好地适应新的背景尺寸并改善外观。
- 添加了对话框文本的打字机效果和客户端配置。
- 添加了条件符号以指示对话框、按钮和交互的条件状态。
- 为物品条件添加了数量字段,以允许检查特定数量的物品。
- 添加了包含各种条件和操作的示例 NPC 预设
Threshold Warden。 - 添加了与对话框条件和按钮状态相关的较小错误修复和优化。
6.18.0
注意:此更新更改了条件和操作的内部数据格式,这可能会重置/删除未存储 ID 的遗留现有执行限制条目。
- 通过为操作添加条件以允许更复杂和动态的行为,修复了 #745。
- 通过为较长的文本添加对话框按钮工具提示,修复了 #652。
- 通过添加命令值工具提示以显示完整值,修复了 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了背包中有物品的条件。
- 添加了手持物品条件,支持主手和副手。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的示例 NPC 预设 Goldmere。
- 添加了否定条件支持,以允许否定条件以实现更复杂的逻辑。
- 为
ActionDataEntry移除了参数伪 ID,并用随机 UUID 替换它们。 - 重构了条件系统以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的工具提示,修复了 #738。
- 通过减少启动期间和游戏内的 log.info 消息,修复了过多的详细日志。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和关闭按钮的选项,修复了 #732。
- 通过在特定情况(如交易屏幕)下避免自动关闭,修复了 #723。
- 添加了通用对话框配置选项,以允许用户自定义对话框行为。
- 为对话框添加了头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0(交易、玩家头颅、Epic Fight 和质量改进更新)
- 通过重新同步物种数据修复了 #731,如果客户端的物种列表为空。
- 通过改进 Epic Fight 集成并启用实验性功能修复了 #730。
- 确保交易用途被正确存储以修复了 #729。
- 为玩家头颅添加自定义头部支持以修复了 #728。
- 显示剩余交易用途并允许手动和自动重置以修复了 #689。
- 通过新的交易配置界面和对自定义交易的更好支持修复了 #218 和 #132。
- 在基本交易与普通/高级交易模式之间切换时修复了特定于交易的边缘情况问题。
- 对话框按钮文本截断时通过工具提示显示完整文本以修复该问题。
- 通过与 Cobblemon Animation System 同步动画状态修复了 Cobblemon 动画问题。
- 添加了每个交易特定的操作,允许用户在购买后触发操作。
- 添加了交易重置按钮以轻松重置所有交易。
- 在交易配置界面中添加了交易使用信息。
- 添加了实验性功能状态,允许用户手动启用实验性功能。
- 添加了带有操作的 Griselda Grindstone 作为示例交易者。
- 清理测试文件。
6.14.0(Cobblemon 支持与对话框改进)
- 通过确保更改值时同步到客户端修复了 #727。
- 通过为特定命令添加额外的允许列表修复了 #726。
- 通过添加带有 Cobblemon NPC 的基本 Cobblemon 支持修复了 #686、#389、#304、#211。
- 通过调整对话框精灵和屏幕修复了对话框错位和导航问题。
- 通过更正旋转逻辑和枢轴计算修复了 x 和 z 根旋转问题。
- 添加了带有用于测试的自定义 NPC 类型和模型的基本 Cobblemon 支持。
6.13.0(安全与权限更新)
注意:此更新包括针对多人游戏环境的更好的安全检查与权限控制。它允许执行服务器命令,如果出于恶意意图使用,这些命令可能会带来潜在危险。
此次更新将模型根数据与逻辑从其余模型部分数据和逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据与逻辑从其余模型部分数据和逻辑中分离来修复 #725。
- 通过支持 .sbnt 文件作为本地预设来修复 #722。
- 通过为对话框和配置屏幕背景添加专用资源来修复 #675。
- 通过新的安全检查与权限系统修复了 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例修复了 #469、#311。
- 通过移除冗余的背景渲染修复了配置屏幕背景的双重渲染问题。
- 通过调整包围盒修复了 Ghast 碰撞箱与名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多人游戏环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、定制性和兼容性。
- 用静态背景替换动态配置屏幕背景,以获得更好的性能。
- 重构了特定于 config-ui 的组件并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为可能的 Luck Perms 集成(如 #712)准备权限系统。
- 进行了通用代码清理和优化,涉及配置屏幕渲染与资源方面。
6.12.0
- 通过基于原版模型添加对自定义模型部件列表的额外检查修复了 #714。
- 通过降低日志详细程度,将每个 NPC 的 INFO 消息降级为 DEBUG 并合并冗余警告消息来修复 #713。
- 通过减少过大体积的启动/配置日志输出来修复 #711。
- 修复 NBT 验证守卫以防止在生产环境中进行不必要的缓冲区分配。
- 在 EasyNPCModelManager 中添加模型部件名称常量以便在 mixins 之间一致使用。
- 通过增强过滤逻辑和优化数据结构改进了 RenderEntityTypeSupportConfig,以提升性能和可维护性。
- 移除了转储大型数据结构的冗长调试日志。
6.11.0
- 通过新的自定义图层系统和手部渲染修复了 #703 渲染问题。
- 通过为无效的交易报价添加额外的安全措施和日志记录修复了 #701。
- 修复了在修改头部位置时智能动画无法正常工作的问题。
- 通过将玩家检测移回仅服务端来修复头部追踪问题。
- 优化 CustomLookAtPlayerGoal 以更好地处理边缘情况并减少抖动。
- 修复了 Doppler NPC 保留其手部库存的问题。
- 改进了 PoseManager 的日志消息。
- 更新了标志设计。
6.10.0
- 通过在切换到
DEFAULT原版姿态时清除模型部件的旋转/位置修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画修复了 #695。
- 通过更正根旋转枢轴以使用实际的包围盒高度而非 0.5f 来修复 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、leave-handler 中的错误 UUID、加入/离开时缺失的玩家目标刷新以及针对离线目标的重试机制。 - 修复了目标注销后保留目标引用的问题。
- 移除了加载姿态时 ROOT 旋转的自动锁定;现在根锁定由用户控制。
- 在高级和自定义姿态配置屏幕中添加了锁定旋转复选框。
- 在
ConfigurationMenuHandler中为默认姿态屏幕添加了特定于模型的姿态键过滤。 - 为
CustomPosition、CustomRotation、CustomScale、ModelPose、ModelAnimationBehavior和ModelAnimationData添加了单元测试。 - 为 Fabric 和 Forge 添加了
NPCDataIsolationTestHelper和游戏测试。 - 将最大头部偏航范围从 60° 增加到 65°。
6.9.0
- 通过添加缓存和安全措施防止 NPC 实体数据更新重复触发,修复了 #692、#666。
- 为所有支持的 NPC 类型添加了基本自定义姿势,修复了 #651、#617。
- 添加了额外的逃跑目标(包括逃离玩家、村民、怪物等),修复了 #597。
- 修复了姿势加载逻辑,改为直接从模组资源读取而非将文件复制到磁盘。
- 通过在实体加入时先检查现有注册表条目,修复了重复调用
saveNPC的问题。 - 添加了
despawn和spawn命令,允许通过 UUID 移除并重新生成 NPC,且可配置移除原因。 - 添加了
ModelPoseAPI和EasyNPCEntityHandler公共 API 类,供外部模组编程控制 NPC 姿势和管理 NPC。 - 添加了所有支持 NPC 类型的姿势数据文件。
- 在基础姿势配置界面中添加了“锁定旋转”复选框。
- 添加了
MoveToPositionGoal,用于在执行回调动作前将 NPC 移动到指定位置。 - 添加了
EasyNPCLookControl和EasyNPCBodyRotationControl,以尊重锁定的根部旋转。 - 将所有者更改和维度更改同步添加到 NPC 实体数据索引中。
- 将 EasyNPCItemAttachmentLayer 添加到各种实体渲染器中。
- 添加了专用的“逃跑目标”配置选项卡,包含针对苦力怕、怪物、生物、玩家、村民和太阳的逃跑目标。
- 在跟随目标选项卡中添加了
FOLLOW_ITEM目标,使 NPC 能够根据资源定位符(例如minecraft:apple)跟随物品实体。 - 添加了
LookAtEntityByUUIDGoal,并在注视目标界面中启用了按 UUID 注视实体和注视主人的目标。 - 向
SynchedDataIndex添加了persistent标志,使得临时索引(如弩充能、模型动画)不再触发脏保存标记。 - 向
SlimeBase添加了可配置的customParticlesEnabled标志,供 API 使用者使用。 - 添加了
SoundType.PET,并将CAT_PURR映射到驯服的猫 NPC,以增加驯服环境音效的变化。 - 将周期性 NPC 保存操作的日志详细程度从 INFO 降低至 DEBUG。
6.8.3
- 通过升级网络协议版本强制执行版本不匹配检测,修复了 #680。
- 重置了名字标签的位置、旋转和大小,修复了 #679。
- 为根部旋转添加了多状态滑动功能,修复了 #665。
- 添加了禁用跟随鼠标光标的选项以便于姿势调整,修复了 #664。
- 改进了对 X 轴和 Z 轴根部旋转的支持,修复了 #663。
- 添加了快速旋转功能:手持 NPC 法杖并潜行靠近 NPC 可将根部旋转朝向玩家,修复了 #661。
- 通过交互处理程序中添加移动工具的检查,修复了移动工具错误触发交互的问题。
- 通过交互处理程序中添加预设物品的检查,修复了预设物品错误触发交互的问题。
- 通过调整边界框和眼睛高度计算,修复了史莱姆和恶魂的碰撞箱及名字标签位置问题。
- 通过调整偏移值,修复了史莱姆和恶魂 GUI 的位置问题。
6.8.2
- 通过扩展
SafeMerchantData添加notifyTrade以避免崩溃,修复了 #677。 - 添加了基于玩家互动和操作进行 NPC 等级提升的进度数据支持。
- 添加了全局 NPC 追踪系统,以便更好地在世界范围内管理和调试 NPC。
- 添加了
OriginalModelConfig.withVariantTexture()选项,允许在原模型中使用变体纹理。
6.8.1
- 通过使用现有的预设辅助方法而非自定义方法,修复了 #676。
6.8.0 (添加 API 支持)
- 通过添加警告消息和对无效网络数据包的其他检查,修复了 #667。
- 修复了马刷新蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、灾厄村民、铁傀儡、史莱姆和恼鬼的姿势支持。
- 添加了 NPC 基类以提供更好的 API 支持。
- 添加了 NPC 原始类以提供高级 API 支持。
- 添加了史莱姆和恶魂 NPC 类型。
- 添加了自定义模型 API,便于与其他模组和自定义模型集成。
- 重构了内部数据处理和注册机制,以提高可维护性和未来改进空间。
6.7.1
- 通过添加额外的客户端原版漏洞检查,修复了 #657 和 #656。
6.7.0
- 在
setupAnim方法中实现了狼腿动画,修复了 #650。 - 修复了
canBeHitByProjectiles的翻译,修复了 #648。 - 添加了
allowBypassInvulnerability配置选项,允许/禁止 NPC 绕过无敌状态,修复了 #645。 - 修复了删除按钮在小宽度下仍显示标签的问题。
- 修复了上下按钮在某些情况下未正确定位的问题。
- 修复了对话框和配置 UI 中显示名字标签的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 NPC 预设相关的问题。
- 修复了猫 NPC 和狼 NPC 所有者数据不同步的问题。
- 添加了预设浏览器,便于选择常见的 NPC 预设。
- 添加了预设 .snbt(文本)导出和导入功能,用于共享 NPC 预设。
- 重构了现有 NPC 预设以使用新的 .snbt 格式。
- 重构了生成器系统以使用新的预设格式,提高可维护性和未来改进空间。
6.6.2
- 通过重写缩放系统,修复了 #643。
- 修复了重启/重载后缩放未能正确更新碰撞箱和名字标签位置的问题。
- 添加了 MID 和 MOUSE_OVER 名字标签可见性模式,以更精细地控制 NPC 名称显示。
- 添加了基于队伍的名字标签可见性支持,尊重原版 Team 机制。
6.6.1
- 通过重构用于显示属性的内部数据处理,修复了 #638。
6.6.0
- 通过实现带有专用线程池的异步纹理加载修复了 #634。
- 修复了因纹理加载阻塞渲染线程导致的游戏卡顿问题。
- 使用原子操作修复了纹理重载保护中的竞态条件。
- 修复了远程纹理下载期间 HTTP 连接的资源泄漏。
- 修复了 URL 验证滥用导致的同一纹理多次同时下载问题。
- 修复了远程图像验证的异常处理,防止因无效 URL 导致崩溃。
- 修复了 NPC 加载期间的
defineId called for:警告消息。 - 重构了具有多级防御和速率限制的纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 Java records(记录),以提供更好的不可变性和线程安全性。
- 添加了基于 ConcurrentHashMap 的线程安全会话服务器防垃圾信息保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载性能,采用双线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 设置了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤的问题。
- 通过为 Gradle 依赖项添加缓存,改进了 GitHub 工作流。
- 缩短了 Gradle 构建时间并优化了清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件修复了 #632。
- 通过改进纹理处理性能、缓存和内存使用情况修复了 #629。
- 修复了 kill 命令无法在 NPC 上生效的问题。
- 修复了纹理重载保护阻止驱逐后重新加载缓存的问题。
- 修复了远程图像验证器中 WebP 验证的错误(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和便于未来改进。
- 添加了基于时间的重载保护(60 秒)以替代永久阻止机制。
- 为纹理处理添加了额外的单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 捆绑方式,以提供更好的模组兼容性和 API 功能。
- 通过实现裁剪功能修复了 #627,以更好地与其他模组兼容。
- 修复了 #627 中使用旋转或移动模型部件时的生动动画问题。
- 修复了使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 修复了不同 NPC UUID 的屏幕切换逻辑,感谢
Spawnblade提供的详细调查和修复建议。
6.4.0
- 通过改进对话数据验证和错误处理修复了 #626。
- 通过重构渲染数据和渲染处理修复了 #623。
- 确保自定义数据正确保存和加载,从而修复了 #622。
- 修复了打开对话框的动作类型,允许从其他 NPC 打开对话框。
- 通过为 ConditionDataSet 和 ActionDataSet 添加缺失的 equals 和 hashCode 方法,修复了哈希问题。
- 为 #622 添加了自定义数据测试物品,使自定义数据的测试更加容易。
- 改进了 records(记录)并修复了潜在的数据缺失问题。
6.3.0
- 重构了配置 UI 的特定组件并将其从核心模组中移除。
- 通过在发送给客户端之前过滤对话数据来修复对话数据。
- 修复了对话编辑器布局问题并提高了可用性。
- 修复了某些对话数据字段缺失默认值的问题。
- 添加了对话优先级支持,以控制对话执行的顺序。
- 为对话和记分板动作添加了条件支持。
- 添加了频率支持,以限制对话显示的频率。
- 添加了新的 NPC 预设以支持记分板和条件。
- 通过移除冗余字段改进了对话按钮数据格式。
6.2.0
- 修复了对话框内的字符串注入问题。
- 修复了动作类型的翻译缺失问题。
- 添加了记分板动作类型,用于增加、减少和设置记分板数值。
- 添加了
@score(...)NPC 宏,以便在对话框中显示记分板数值。 - 添加了额外的单元测试。
- 改进了旋转按钮,增加了指示器并提升了可用性。
6.1.2
- 修复了容器和菜单同步问题,解决了缺失关闭容器数据包的问题。
- 修复了某些情况下关闭按钮无效的问题。
- 修复了在屏幕过渡期间鼠标光标跳动的问题。
- 修复了翻译文件并删除了重复和已弃用的条目。
- 将 Easy NPC 法杖移至现有的核心物品标签页,而不是创建一个新的。
- 添加了针对不同模型部件(尾巴除外)的猫姿态支持。
- 通过在不需要时禁用发光效果,改进了 EasyNPCWand 的发光效果性能。
- 通过排除非生物实体(如展示框、制造者、投掷物和刷怪笼),改进了自定义实体检测。
- 改进了猫变种的处理。
6.1.1
- 通过重新验证实体类型修复了 #612。
- 通过强制同步特定模型的帽子和头部图层修复了 #610。
- 修复了兽人纹理。
- 通过将相关逻辑移至仅客户端端,改进了自定义模型支持和性能。
- 改进了玩家到 UUID 映射的缓存,用于玩家皮肤。
- 将更改模型命令和逻辑限制为仅限 Doppler NPCs。
6.1.0 ✨
这是一个重大版本。请在更新前备份你的世界和 NPC 数据。此版本包含许多改进、优化和内部更改,这些更改与早期版本不完全兼容。
⚠️ 破坏性变更
- 6.1.0 版本之前的现有 NPC 及其配置数据可能无法正确加载,或者可能需要手动调整。
- 内部数据格式和一些行为已被重构,以支持新的用例。
🧩 新的模块化结构
Easy NPC 现在拆分为三个独立的模组:
- Easy NPC - 包含 Core(核心)和 Configuration UI(配置界面)的捆绑包,提供即插即用的体验。
- Easy NPC: Core - 轻量级的运行时和 NPC 逻辑,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可以安装在需要该界面的客户端上。
🎯 做出此更改的原因
- 允许服务器和整合包仅在服务端提供 Core 模组,以实现更精简的部署。
- 当不需要在所有地方显示用户界面时,可减少内存占用并缩短加载时间。
- 通过将用户界面与核心逻辑分离,加快开发与测试速度。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
评论 0
登录后参与评分
还没有评论,来抢沙发吧