? Easy NPC (Bundle)
[][issues]
Easy NPC 为地图制作者、RPG 游戏、冒险服务器、整合包及其他模组提供了一个简化的自定义 NPC 创建系统,支持对话、交易和交互功能。
本项目是 Easy NPC Bundle(Easy NPC 捆绑包),一个启动器便捷安装包,可自动安装所需的 Easy NPC 模块。
此捆绑包本身不包含 Easy NPC 模块。
? 安装概览
Easy NPC 被拆分为多个模块。 该捆绑包的存在是为了简化通过支持自动依赖解析的启动器进行的安装过程。
选项 A:启动器安装(推荐)
- 安装 Easy NPC Bundle
- 你的启动器将自动安装所需的模块:
- Easy NPC Core
- Easy NPC Config UI(配置工具及所需的网络功能)
选项 B:手动安装或复制的整合包
如果你是手动安装模组或在实例之间复制整合包,请确保存在所需的模块:
- Easy NPC Core
- Easy NPC Config UI
提示:在分享或复制整合包时,请复制完整的 mods/ 文件夹,以确保包含所有必需的 jar 文件。
简介与概述视频(英文)
✨ 特性
- 带有对话、交易和交互功能的简易 NPC
- 为地图制作者、服务器和 RPG 环境提供简单的设置流程
- 可配置的操作及调试选项
- 支持交易,可配置的交易条件和优惠内容
- 皮肤配置,支持玩家名称和 URL
- 专为服务器和客户端环境设计
- 提供 API 支持,可与其他模组集成
? 模组集成
Armourer's Workshop
为 Armourer's Workshop 提供基本集成,以使用库中的皮肤。
Epic Fight Mod
自 Easy NPC 6.4.x 版本起内置对 Epic Fight 的支持。 无需额外的集成模组。
[Immersive Melodies][immersive-melodies]
为 Immersive Melodies 提供基本集成,以使用音乐乐器。
使用方法
使用相应的生成蛋或通过召唤命令生成 NPC。
使用预定义的 /easy_npc 命令或 NPC 配置法杖打开图形用户界面 (GUI)。
GUI 允许你直接在游戏中的对话、交易选项、皮肤、操作和其他 NPC 相关设置进行配置。
大多数交互和调整均可在游戏中直接完成,无需编辑文件或重启服务器。
⬆️ 升级
请在升级/更新到新版本前查阅 升级指南。
ℹ️ 为什么不再有“jar 嵌套”捆绑包
旧版本使用 jar-in-jar(jar 嵌套)设置将多个 Easy NPC 模块打包为单个文件。
这种方法导致了几个技术问题:
- 当模块单独安装时出现重复的模组 ID
- 类加载冲突及模糊的模组来源
- 仅需要 Easy NPC Core 作为依赖时的不兼容问题
- 增加了维护和支持的复杂性
现代启动器已经提供了依赖解析机制。 使用这种机制能带来更清晰、更可预测的设置,并允许独立更新 Easy NPC 模块。
ℹ️ 更多信息
请查看 wiki 以获取更多信息。
? 报告问题、错误、崩溃或功能请求
请通过 [issues 链接][issues] 报告问题和功能请求。我很乐意为你提供帮助。
? 支持我
如果你喜欢使用我的作品,请考虑支持我的开发!☕️ 通过 Ko-fi 捐赠非常有帮助, 但不是必须的(我的模组是免费且开源的!)。 每一份支持都能帮助我在空闲时间继续制作模组,覆盖软件、服务、硬件成本以及额外的披萨或 Spezi 饮料。
⚖️ 许可证
MIT LICENSE 仅适用于本仓库中的代码。 图片、模型和其他资源明确排除在外。
🗣 Easy NPC (Bundle)
Easy NPC provides a simplified system for creating custom NPCs with dialogs, trading, and interactions for map makers, RPGs, adventure servers, modpacks, and other mods.
This project is the Easy NPC Bundle, a launcher convenience package that installs the required Easy NPC modules automatically.
This bundle does not contain the Easy NPC modules themselves.
📦 Installation Overview
Easy NPC is split into multiple modules. The bundle exists to simplify installation via launchers that support automatic dependency resolution.
Option A: Launcher install (recommended)
- Install Easy NPC Bundle
- Your launcher will automatically install the required modules:
- Easy NPC Core
- Easy NPC Config UI (configuration tools and required networking)
Option B: Manual install or copied modpacks
If you install mods manually or copy a modpack between instances, make sure the required modules are present:
- Easy NPC Core
- Easy NPC Config UI
Tip: When sharing or copying a modpack, copy the full mods/ folder to ensure all required jars are
included.
Introduction & Overview Video (English)
✨ Features
- Easy NPCs with dialogs, trading, and interactions
- Simple setup for map makers, servers, and RPG environments
- Configurable actions with debug options
- Trading support with configurable offers and conditions
- Skin configuration with player name and URL support
- Designed for both server and client environments
- API support and integration for other mods
📦 Mod Integration
Armourer's Workshop
Basic integration for Armourer's Workshop to use skins from the library.
Epic Fight Mod
Built in support for Epic Fight is included since Easy NPC 6.4.x. No additional integration mod is required.
[Immersive Melodies][immersive-melodies]
Basic integration for Immersive Melodies to use music instruments.
Usage
Spawn an NPC using the corresponding spawn egg or via the summon command.
Use the predefined /easy_npc commands or the NPC config wand to open a graphical user interface.
The GUI allows you to configure dialogs, trading options, skins, actions, and other NPC related
settings directly in game.
Most interactions and adjustments can be done directly in game without editing files or restarting the server.
⬆️ Upgrading
Please make sure to check the upgrade guide before upgrading/updating to a new version.
ℹ️ Why there is no jar-in-jar bundle anymore
Older versions used a jar-in-jar setup to bundle multiple Easy NPC modules into a single file.
This approach caused several technical issues:
- Duplicate mod IDs when modules were installed separately
- Class loading conflicts and ambiguous mod sources
- Incompatibilities when only the Easy NPC Core was required as a dependency
- Increased maintenance and support complexity
Modern launchers already provide dependency resolution. Using this mechanism results in a cleaner, more predictable setup and allows Easy NPC modules to be updated independently.
ℹ️ More Information
Please check the wiki for additional information.
🐛 Report Issues, Bugs, Crashes or Feature Requests
Please report issues and feature requests over the issues link. I'm happy to help you.
🫶 Support me
If you enjoy using my creations, consider supporting my development! ☕️ Donations via Ko-fi are immensely helpful, but not required (my mods are free and open-source!). Every bit helps me keep creating mods in my free time, covering software, services, hardware costs and some extra slice of pizza or additional Spezi.
⚖️ License
The MIT LICENSE applies only to the code in this repository. Images, models and other assets are explicitly excluded.
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
下载 Easy NPC
Easy NPC: Core (26.1.2) 更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub 历史记录。
注意:在更新到新版本之前,请务必备份您的世界 / NPC! 更多信息请查阅 升级指南。
7.20.0
- 修复了缺少皮肤 ID 的 NPC 导致的崩溃问题,感谢
voidsipp在 #866 中的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了人形 NPC 在使用“无”或资源定位符皮肤时显示 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栏仍停留在屏幕上的问题。
- 修复了在 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 在没有距离或时间限制的情况下追逐其主人的问题。
- 修复了来自附加模组(addons)的 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
- 修复了精灵的碰撞箱过小,导致其名字标签和对话框位于其身体内的问题。
- 修复了缩放的 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
- 修复了 #827,使水中的鱼形 NPC 直立显示,而不是一直侧躺。
- 修复了 #828,防止损坏的 NPC 阻止世界保存;现在它会回退到默认值。
- 修复了恢复的 NPC 拾取随机预设 ID 的问题,该 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)预设,这是一种在正方形路径上行走的幽灵,在每个角落会留下一条短线。
- 开放了 API 访问权限,支持对移动动作和 NPC 不透明度的控制。
- 添加了“资源位置”(Resource Location)皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“高级”(Advanced)皮肤选项卡,可在应用前预览使用输入纹理的 NPC 效果。
7.7.7
- 修复了 #821,保留了 64x64 皮肤的透明度,这是 Fresh Moves 用于眼睛所必需的。此前下载的皮肤需要通过玩家皮肤界面中的按钮重新加载。
- 修复了 #818,使村民和流浪商人 NPC 也能正常执行交易动作。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后图像而非原始下载图像的问题。
- 修复了“执行限制”条件中未翻译的时间间隔名称(如
PER_DAY)。 - 修复了 Easy Model NPC 的
sit(坐下)动画,该动画从未使用内置的坐姿姿态。 - 修复了当玩家靠近 NPC 时,对话气泡被 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)播放模式。
- 开放了 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。
- 为模组新增了动作注册表、动作处理器、预设验证器以及更丰富的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 更新其目标时导致服务器崩溃的问题。
- 修复了单个或 Boss 刷怪笼在预设未存储任何 NPC 时无限生成的问题。
- 修复了新创建的 NPC 出现“Legacy Easy NPC Data”(旧版简易 NPC 数据)警告的问题。
- 修复了针对旧版 64x32 皮肤的透明度校正缺失问题,这会导致图层伪影。
- 修复了查询玩家名称时玩家皮肤屏幕短暂卡死的问题。
- 修复了“重置注视...”目标标签在某些语言中被错误显示为“Reset loot at ...”(重置战利品于...)的问题。
- 修复了导入预设后“无重力”属性被忽略,导致 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 风格。
- 修复了昼夜检测逻辑,此前错误地将日出计为夜晚、日落计为白天。
- 修复了下界(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:添加了流浪商人(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 的记分板分配。
- 修复了自定义皮肤重新加载问题,改为按皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存。
- 改进了
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 生命值条件。
- 为保持一致性,使 Piglin、Piglin Brute 和僵尸猪灵 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 (交易、玩家头颅、史诗战斗与 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。 - 修复了删除按钮在宽度较小时仍显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置 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 record,以提高不可变性和线程安全性。
- 添加了使用 ConcurrentHashMap 的线程安全会话服务器防垃圾信息保护。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,使用 2 线程池和 500ms 速率限制。
- 改进了异常处理,针对 IIOException 和 FileNotFoundException 添加了特定的捕获块。
6.5.2
- 修复了村民职业和工作皮肤问题。
- 通过添加 Gradle 依赖缓存,改进了 GitHub 工作流程。
- 改进了 Gradle 构建时间和清理任务。
6.5.1
- 通过实现 ON_KILL 动作类型和事件,修复了问题 #632。
- 通过改进纹理处理性能、缓存和内存使用,修复了问题 #629。
- 修复了 kill 命令对 NPC 无效的问题。
- 修复了纹理重载保护在驱逐后阻止缓存重载的问题。
- 修复了远程图像验证器中的 WebP 验证错误(缺少 return 语句)。
- 重构了纹理处理逻辑,以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(60 秒),以替换永久阻止机制。
- 添加了鸡、猪和狼缺失的变体纹理。
- 添加了额外的纹理处理单元测试。
- 改进了 Gradle 构建任务。
6.5.0
- ⚠️ 移除了 jar-in-jar 打包方式,以提高模组兼容性和 API 能力。
- 通过改进剪刀裁剪实现,提高了与其他模组的兼容性,修复了问题 #627。
- 修复了在使用旋转或移动模型部件时 lively 动画出现的问题,修复了问题 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
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 发光效果的渲染性能。
- 通过排除显示器、制造器、投掷物和刷怪笼等非生物实体,改进了自定义实体的检测逻辑。
- 改进了猫咪变体处理逻辑。
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 - 轻量级的 NPC 运行时和逻辑模块,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何进行此变更?
- 允许服务器和整合包仅在服务端部署 Core 模组,从而构建更精简的环境。
- 当无需在所有地方使用 UI 时,可减少内存占用并缩短加载时间。
- 通过将 UI 和核心逻辑分离,使开发和测试更加高效。
Easy NPC: Core (1.21.11) 更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请前往 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 更多信息请参阅 升级指南。
7.20.0
- 修复了缺少皮肤 ID 的 NPC 导致崩溃的问题,感谢
voidsipp在 #866 中的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了人形 NPC 在使用“None”或资源位置皮肤时显示史蒂夫皮肤的问题。
- 修复了在 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”动画行走时,隐藏的身体部位再次显示的问题。
- 修复了“锁定身体”标签在旋转屏幕中溢出显示的问题。
- 修复了投射物“Item ID”字段遮挡 Item ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误为 "Ork Warrior" 的问题。
- 修复了原版姿势按钮在游戏每次启动后顺序发生变化的问题。
7.18.0
- 通过防止加载时 NPC 丢失来修复 #862,适用于诸如 LetMeDespawn 等模组。
- 修复了拥有近战和远程攻击的 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 返回、内存泄漏以及多个所有者和 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
- 修复了精灵的碰撞箱过小,导致其名称标签和对话气泡嵌入身体内的问题。
- 修复了缩放后的 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,在位置配置中添加了“设为主家”和“重置主家”按钮。
- 修复了 #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 丢失、崩溃或虚假警告的 NPC 索引和文件同步问题。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入,并增加了重复卸载警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时,对话气泡丢失文本并变得半透明的问题。
- 修复了激活光影包时忽略 NPC “不透明度”的问题。
- 修复了翻译后的对话气泡和模组 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
- 通过让水中的鱼 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 的问题。 - 修复了“设置姿势”动作的姿势列表绘制覆盖其输入框的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕边缘而未换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐错误的问题。
- 修复了“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
- 修复了对话气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议逻辑:优先列出准星指向的 NPC,且仅列出用户无权限的自身拥有的 NPC。
- 更改了预设导出逻辑:仅存储与新建 NPC 不同的部分,且不包含位置和所有者信息。
- 更改了没有目标或动作的预设行为:回退到其所属 NPC 类型的默认值。
- 更改了不带玩家的事件(如“生成时”或“击杀时”)会检查其条件。此类事件中若包含基于玩家的條件(例如计分板或物品),则不再执行。
- 更改了基于时间的动作:当所有者在附近时,将所有者选择为
@initiator。 - 更改了对话气泡的可见时间:根据文本长度,从 5 秒增加到 18 秒。
- 更改了“设置姿势”动作:仅在“自定义”姿势条目时显示其输入框。
- 新增了五个固定步骤的基于时间的动作,间隔从约 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”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正,从而显示图层伪影的问题。
- 修复了在查询玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中“Reset look at ...”目标标签误读为“Reset loot at ...”的问题。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在被驱逐后重新生成时失去所有者身份的问题。
- 修复了在游戏开始时提供相关目标的模组缺失时,NPC 的目标被删除的问题。
- 修复了当目标实体缺失时,目标被永久关闭的问题。
- 修复了导入没有存储 ID 的预设时,会生成一个没有所有者和家的 NPC 的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者更改后仍保留旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“Look at Item”目标可以被存储但从未执行任何操作的问题。
- 修复了 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 屏幕中隐藏。
- 为跟随目标添加了传送距离和休息点偏移量。
- 为“Follow item”目标添加了物品标签、“can be scared”选项和“only without owner”选项。
- 为注视目标添加了物品字段,使 NPC 可以注视选定的掉落物品。
- 为每个 NPC 添加了标识符,以便模组可以再次找到自己的 NPC。
- 添加了当所有者登录时重新生成 NPC 的选项。
- 添加了数值、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 为所有 NPC 添加了“Navigation”和“Hover height”设置,以切换地面与飞行模式。
- 添加了父预设引用,使预设可以基于另一个预设构建并仅覆盖更改。
- 添加了由状态驱动的“Forge Keeper”预设。
- 为其他模组添加了自定义条件和对话、动作及状态事件。
- 添加了“On Far Distance”作为距离动作,在 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)中的可见性问题,此前错误地使用了主世界时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一次断言失败时才会报错的问题,这会导致后续失败被隐藏。
- 修复了“骑乘状态”(Saddled)的马匹皮肤变体,此前从未显示马鞍。
- 更改了“仅主人可见”和“仅队伍可见”设置,使其也遵循昼夜和游戏模式的逻辑。
- 更改了唤魔者(Evoker)、幻术师(Illusioner)和卫道士(Vindicator)变体的逻辑:若无“交叉双臂”样式,则保持手臂下垂。
- 添加了“防御阵营”目标,攻击任何伤害附近阵营成员或玩家的人。
- 当阵营成员互相攻击且阵营保持中立时,添加系统消息提示。
- 为灾厄村民(Illagers)添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置屏幕中添加了昼夜预览功能。
- 为可见性属性和阵营防御功能添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全缺失项,改善了旧版本版本的显示属性数据。
- 改进了攻击目标屏幕:在未设置时禁用“保护主人”和“防御阵营”选项。
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:添加了流浪商人(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 的记分板分配。
- 修复了自定义皮肤重载问题:改为按皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存。
- 改进了
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。
- 修复了与尝试访问不存在模型部件的第三方 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 和 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 (安全和权限更新)
注意:此更新包括更好的安全检查和多玩家环境中的权限。它允许执行服务器命令,如果被恶意使用,可能会造成潜在危险。
此次更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有 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 的日志消息。
- 更新了带有新设计的 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。
- 通过添加用于逃离玩家、村民、怪物等的额外逃跑目标,修复了 #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。 - 修复了删除按钮即使在小宽度下也显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置界面中显示名称标签的问题。
- 修复了距离操作问题,即多个操作未正确触发。
- 修复了 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 验证错误(缺少返回语句)。
- 重构了纹理处理逻辑以提高可维护性和未来的改进空间。
- 添加了基于时间的重新加载保护(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 添加了自定义数据测试项,并简化了自定义数据的测试。
- 改进了 record 并修复了潜在的数据缺失问题。
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 - 轻量级的运行时和逻辑模块,依赖项极少。适用于服务器、整合包和开发者。
- 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 使用选择方块未给出其刷怪蛋的问题。
- 修复了计分板条件为没有分数的玩家添加 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 在没有距离或时间限制的情况下追逐其所有者。
- 修复了来自插件的 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 凋零骷髅 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 数据时没有设置任何限制的问题。
- 修复了应用无效的 NPC 位置、缩放、属性、名称和持续时间的问题。
- 更改了精灵(Fairy)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。 - 添加了“存在”条件操作,并为 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,使用飞行移动方式。
- 更改了渲染实体列表:隐藏座位、画作、投掷物和其他非生物实体。
- 为飞行 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 不同的部分,不包含位置或所有者信息。
- 更改了没有目标或动作的预设逻辑:回退到其 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
- 通过让每个 Cobblemon NPC 拥有独立的状态而非按物种共享,修复了 #814。
- 通过让“返回家园”在任何距离生效而不仅限于家附近,修复了 #813。
- 通过在每会话内检查一次玩家是否更换了皮肤,修复了 #812。
- 通过接受资源包的 Cobblemon 方面属性而不仅限于“闪亮”和“雌性”,修复了 #810。
- 修复了重生或导入预设后 NPC 丢失所有者、家园和“无重力”设置的问题。
- 修复了目标保留已消失的目标并在其目标或模组消失时被关闭的问题。
- 修复了飞行类 NPC(如悦灵、恼鬼和恶魂)在地面移动而非飞行的问题。
- 修复了存在重复项或特殊字符的对话、按钮、预设、姿势和纹理名称的问题。
- 修复了专用服务器上条件不可编辑以及条件文本未翻译的问题。
- 修复了 Easy Model Entities 的 NPC 不转头及其模型列表忽略
/reload的问题。 - 修复了新创建的 NPC 显示“旧版 Easy NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤缺失透明度校正导致图层伪影的问题。
- 修复了在查询玩家名称时玩家皮肤界面短暂冻结的问题。
- 修复了部分语言中“重置注视...”目标标签误读为“重置战利品...”的问题。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 数据隔离和交易持久性游戏测试在 Fabric 上从未运行的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画。
- 更改了移动目标的顺序为固定顺序:逃跑、跟随、回家,然后闲逛。因此,具有多个移动目标的 NPC 行为可能与之前不同。
- 更改了数据包预设的路径为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 更改了所需的 Easy Model Entities 版本为 1.7.0,浮动模型现在默认悬浮。
- 移除了实验性的用户定义 NPC 和未使用的
SERVER_SKIN皮肤类型。 - 添加了数值、是/否和文本值的 NPC 状态,可用作条件、动作和命令。
- 添加了“导航”和“悬浮高度”设置,用于在任何 NPC 地面行走和飞行之间切换。
- 添加了父级预设、来自其他模组的预设、预设可见性以及“锻造守护者”预设。
- 为其他模组添加了自定义条件、事件、NPC 标识符及更多目标选项。
- 添加了 32 格外的“远距离”事件,以及所有者登录时重新生成 NPC 的选项。
- 通过预设和自定义目标的 API,改进了飞行导航和第三方支持。
7.4.0
- 修复了 #807,不再将 32 格内的所有同类型 NPC 拉入“自卫”战斗。
- 修复了 #805,改为同时评估所有可见性设置,而不是在第一个处停止。
- 修复了 #804,保留 Doppler NPC 的自定义名称以用于基于名称的纹理和姓名标签。
- 修复了 #803,调整资源以匹配典型的 Minecraft 风格,而非通用 UI 风格。
- 修复了昼夜检测逻辑,此前错误地将日出计为夜晚、日落计为白天。
- 修复了下界(Nether)和末地(End)中的可见性问题,此前错误地使用了主世界的时间。
- 修复了时间和游戏模式可见性复选框随机显示顺序的问题。
- 修复了游戏测试仅能在第一次断言失败时报告失败的问题,这会导致后续失败被隐藏。
- 修复了“骑乘”马匹皮肤变体,此前从未显示马鞍。
- 更改了“对所有者可见”和“对队伍可见”设置,使其也遵循昼夜和游戏模式。
- 更改了唤魔者(Evoker)、幻术师(Illusioner)和卫道士(Vindicator)变体,若没有“交叉双臂”,则保持手臂下垂。
- 添加了“防御派系”目标,攻击任何伤害附近派系成员或玩家的实体。
- 当派系成员互相战斗且派系选择不介入时,添加了一条系统消息。
- 为灾厄村民(Illagers)添加了头部装备槽,以便移除或更换其队长旗帜。
- 在显示配置界面添加了昼夜预览功能。
- 为可见性属性和派系防御添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全缺失项,改进了来自旧版本的显示属性。
- 通过在未设置时禁用“保护所有者”和“防御派系”,改进了攻击目标界面。
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
- 修复了 #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进行搜索。 - 通过添加新的
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
- 通过调整纹理重试策略以应对 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 生命值条件。
- 为保持一致性,使 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.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。
- 通过移除冗余的背景渲染,修复了配置界面背景双重渲染问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多人游戏环境中安全使用。
- 用静态背景替换动态对话框屏幕背景,以获得更好的性能、自定义功能和兼容性。
- 用静态背景替换动态配置界面背景,以获得更好的性能。
- 重构了特定于配置界面的组件,并将其从核心模组中移除。
- 移除了重复的精灵表。
- 为将来可能的 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
- 通过实现 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 能力。
- 通过实现裁剪功能,修复了 #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 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.20.0
- 修复了当 NPC 缺少皮肤 ID 时导致的崩溃,感谢
voidsipp在 #866 中提供的修复。 - 修复了当其他模组破坏了存储的 ID 时,NPC、刷怪笼和预设无法加载的问题。
- 修复了在使用 "DEFAULT" 或 "NONE" 动画行走时,隐藏的身体部位再次显示的问题。
- 修复了马匹 NPC 的姿态、 drowned(溺尸)外层模型以及头颅/骷髅无视隐藏部位的问题。
- 修复了当其他模组中断释放过程时,位于玩家肩上的 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 血条仍停留在屏幕上的问题。
- 修复了在 Creative(创造模式)下对 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
- 通过支持 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 版本起,更改为需要
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
- 修复了对于稍后开始看到该 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 的行为,使其占据模型的空间,从而产生碰撞并可被点击。
- 更改了网络协议版本,因此客户端和服务端必须运行相同版本的模组。
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”条件操作,并通过 API 开放了对 NPC 移动、动作和预设的访问权限。
7.11.0
- 修复了 #828:当 NPC 跟随或注视玩家时,登出服务器不再导致服务器冻结。
- 修复了 #831:将常规的 NPC 移除消息移至调试日志。
- 修复了 #832:使人形 NPC 忽略自定义玩家模型、动画和姿势。
- 修复了大型世界中每小时 NPC 备份导致的卡顿,以及保留了已移除 NPC 的时间戳。
- 修复了拥有者登录恢复功能重复复制、反复恢复、复活或移动未加载的 NPC 的问题。
- 修复了因 NPC 索引和文件同步问题导致的 NPC 丢失、崩溃或误报警告。
- 修复了卸载后过时的 NPC 数据,避免了冗余写入,并增加了重复卸载的警告。
- 修复了预设浏览器无法列出以 SNBT 格式保存的自定义和世界预设的问题。
- 修复了在使用 Iris 光影时,对话气泡丢失文本并变为半透明的问题。
- 修复了翻译后的对话气泡和模组 API 文本中的文本格式化和宏解析问题。
- 添加了
minLightLevel属性,以保持对话气泡在黑暗环境中可读。
7.10.0
- 修复了 #829:允许蝙蝠和其他非行走生物作为 Doppler 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(高级)”,其中现在包含“Disable Skin(禁用皮肤)”和纹理字段。
- 添加了“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 皮肤的透明度来修复 #821,Fresh Moves 需要该透明度来显示眼睛。此前下载的皮肤需要通过玩家皮肤屏幕中的按钮重新加载。
- 通过让村民和流浪商人 NPC 也执行交易动作来修复 #818。
- 修复了具有多种文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载图像的问题。
- 修复了“Execution Limit(执行限制)”条件中未翻译的时间间隔名称,如
PER_DAY。 - 修复了 Easy Model NPC 的
sit动画从未使用内置坐姿的问题。 - 修复了当玩家靠近时,NPC 头部遮挡对话气泡的问题。
- 更改了对话气泡的行为,使其保持屏幕尺寸,并在玩家靠近时向下或向侧面移动。
- 更改了对话气泡文本的渲染大小,使其比姓名标签大 20%。
- 更改了带有“Wait(等待)”动作的时间触发动作集的执行顺序,改为按顺序执行而非随机选择一项。
- 更改了对话框文本的换行逻辑,使其更晚换行,以便现有对话框可以切换到更宽的屏幕布局。
- 更改了回退动作的逻辑,使其在没有玩家时跳过屏幕相关动作,与常规动作保持一致。
- 将 Easy Model Entities 的最低版本要求提升至 2.1.0,旧版本将禁用集成。
- 添加了“Wait(等待)”动作,使事件中的后续动作暂停指定的持续时间。
- 添加了“Countdown Timekeeper(倒计时计时器)”预设,显示从 1 到 10 的计数,并在结束时伴有音效和火花特效。
- 为位于“Experimental Features(实验性功能)”复选框下方的 Doppler NPC 添加了缩放和旋转功能。这两项仅影响接受这些功能的实体的可见模型,且绝不会影响碰撞箱。
- 添加了“Sound(声音)”动作,可在 NPC 处播放指定类别、音量和音调的声音。
- 在“Execution Limit(执行限制)”条件中添加了“Every 5 Minutes(每 5 分钟)”和“Every 15 Minutes(每 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。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的事件数据。
- 为
/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/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。
- 修复了昼夜检测,此前会将日出计为夜晚、日落计为白天。
- 修复了下界和末地的可见性,此前使用了主世界时间。
- 修复了时间和游戏模式可见性复选框随机显示的问题。
- 修复了游戏测试仅能在其首个断言失败时报告失败,从而隐藏后续失败的问题。
- 修复了“骑乘”马匹皮肤变体,此前从未显示马鞍。
- 更改了“对所有者可见”和“对队伍可见”,使其也遵循昼夜和游戏模式。
- 更改了未带有“交叉双臂”特征的唤魔者、幻术师和卫道士变体,使其手臂保持下垂。
- 添加了“保卫阵营”目标,会攻击伤害附近阵营成员或玩家的任何实体。
- 当阵营成员互相战斗且阵营置身事外时,添加了系统消息。
- 为掠夺者添加了头部装备槽,以便移除或更换其队长旗帜。
- 在显示配置屏幕中添加了昼夜预览。
- 为可见性属性和阵营防御添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全旧版本中的显示属性,改进了这些属性。
- 在未设置“保护所有者”和“保卫阵营”时禁用它们,从而改进了攻击目标屏幕。
7.3.0
- 通过将皮肤变体的数据作为类型字段携带而非解析变体名称,改进了皮肤变体。
- 在共享常量中集中了 Cobblemon 模组 ID 和默认模型。
- 使用共享的
EnumUtils辅助类处理get(String)查找,减少了重复的枚举代码。 - 优化了村民职业和类型的查找,改用直接注册表键而非扫描。
- 通过在构造时缓存标签名称、ID 和键,优化了枚举名称查找。
- 为皮肤变体、村民解析和枚举辅助类添加了单元测试和游戏测试。
7.2.0
- 通过使用 NPC、对话和操作 UUID 的组合来避免动作跟踪和执行限制方面的冲突,修复了 #801。
7.1.1
- 通过延迟加载实体类型,修复了 #800。
7.1.0
- 通过修复边缘情况并添加额外文档和更好的日志消息,修复了 #799。
- 通过将控制台、命令和命令方块视为可信的命令来源,修复了 #798。
- 修复了单人/局域网模式下客户端和服务端 NPC 共享同一注册表的严重问题。
- 修复了配置菜单处理中的内存泄漏,并添加了超时和断开连接清理机制。
- 修复了当多个 NPC 同时请求相同皮肤时的重复下载问题。
- 修复了出错后皮肤查找失败导致慢速服务器冻结游戏的问题。
- 修复了在检查远程图片时 URL 皮肤屏幕冻结游戏的问题;现在该检查在后台运行。
- 添加了新的世界生成器方块,可限制整个世界中(所有维度)的 NPC 预设;现有的组生成器现按维度计数,因此远处的 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。 - 通过为 Cobblemon NPC 添加性别和闪光模型变体(可在模型选择中通过
female或shiny搜索),修复了 #786。 - 通过添加新的“可被阵营攻击”战斗属性,修复了无敌 NPC 之间的阵营战斗问题。
- 通过根据 Cobblemon 自身的配置文件比例而非碰撞箱高度进行缩放,修复了超大物种的 Cobblemon 模型选择预览。
- 通过验证阵营名称、排序阵营列表以及在阵营颜色或删除更改后刷新已加载 NPC 的记分板分配,修复了阵营管理的边缘情况。
- 通过按皮肤模型加载和清除纹理缓存而非始终重建完整自定义纹理缓存,修复了自定义皮肤重载问题。
- 改进了“可被玩家/怪物/阵营攻击”战斗属性,使其独立于“无敌”工作,各自为其所属攻击者群体打开一个特定的漏洞。
- 通过拆分大型处理器为更小的聚焦导入、导出和功能专用组件,改进了预设命令和网络处理。
- 添加了 Easy Model Entities 支持。
- 添加了阵营管理器和管理员编辑器屏幕,用于创建、着色和删除阵营以及管理敌对关系,受新的
FACTION_MANAGEMENT安全功能保护。 - 添加了新的
Misc属性选项卡,作为 NPC 阵营分配的归属地。 - 添加了可重用的警告和帮助图标组件,用于带工具提示的内联提示。
- 为阵营、目标目标和 Cobblemon 模型变体添加了额外的单元测试和游戏测试。
6.25.0
- 通过增加额外的缓存和优化远程纹理下载修复了 #780。
- 通过防止其他模组提供的天文数值(极大值)影响属性滑块,修复了 #767。
- 为带有动作和条件的 NPC 添加了自定义数据物品匹配功能,修复了 #754。
- 修复了在 >= 1.21.x 版本中,纹理管理器在错误线程运行可能导致崩溃和死锁的问题。
- 修复了由于动作条件中存在空 UUID 导致意外行为的问题。
- 修复了动作执行限制的重置问题。
- 添加了纹理注册队列,以避免在同一刻内发生多次同时下载。
- 将 NPC 金币、钥匙和红代币添加为带有动作和条件的 NPC 的可消耗物品。
- 添加了示例 NPC 预设
Welcome Coin Trader,其中包含作为示例物品的自定义金币、钥匙和红代币,以及用于动作和条件的新物品数据。 - 添加了针对其他模组提供天文数值(极大值)的属性通用保护机制。
- 将回退最大生命值从 1024 提升至 4096,以支持更复杂的 NPC。
- 改进了纹理管理器,消除了重复的纹理检查和注册。
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)。
- 修复了与尝试访问不存在的模型部分的第三方 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。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了库存中拥有物品的条件。
- 添加了手持物品条件(支持主手和副手)。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和动作的 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 支持(包括 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.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标志,使得临时索引(如弩充能、模型动画)不再触发脏保存标记。 - 为 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。
- 修复了马生蛋模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、illager(敌对村民)、铁傀儡、史莱姆和恼鬼的姿态支持。
- 添加了 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。
- 添加了全面的错误恢复机制,在失败时自动重置冷却时间。
- 改进了纹理加载,使用双线程池和 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
- 通过重新验证实体类型修复了 #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: Core 更新日志 (26.3)
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub 历史记录。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 更多信息请查阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏一个 NPC 的皮肤层导致同类型其他 NPC 也隐藏该皮肤层。
- 修复了末影人 NPC 的自定义姿势被其默认动画覆盖的问题。
- 修复了在使用“DEFAULT”或“NONE”动画行走时,隐藏的身体部位重新显示的问题。
- 修复了“锁定身体”标签在旋转界面中溢出显示的问题。
- 修复了投射物“物品 ID”字段遮挡物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在每个游戏启动后改变顺序的问题。
7.18.0
- 修复了 #862:防止加载游戏时 NPC 因 LetMeDespawn 等模组而丢失。
- 修复了拥有近战和远程攻击能力的 NPC 在手持弓、弩或枪时不射击的问题。
- 修复了 NPC 在目标之间移动时旋转,以及史莱姆 NPC 攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后 Boss 栏仍停留在屏幕上的问题。
- 修复了在 Creative 模式下使用创造模式拾取(Pick Block)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,修复了 #852。
- 修复了当玩家无法将 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
- 通过在通过
/execute或命令方块运行时保持预设导入静默,修复了 #838。 - 通过将 NPC 数量限制应用于默认刷怪笼,修复了 #380。
- 通过在声音配置中允许资源包声音,修复了 #849。
- 通过不再随机生成左撇子 NPC,修复了 #349。
- 通过将对话框按钮锁定在每个对话框内,而不是跨具有相同标签的对话框,修复了 #851。
- 修复了已删除或重复的 NPC 返回、内存泄漏以及多个所有者和 UI 问题。
- 修复了 Epic Fight 凋灵骷髅 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 的玩家缺失属性和交易设置的问题。
- 修复了直到重新加载前,最大使用次数、经验值和交易类型的更改未在交易屏幕中显示的问题。
- 修复了
/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
- 修复了 #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 在目标不可达时每刻都搜索新路径的问题。
- 修复了“移动到”动作在目标抬高时未能完全到达,或在空中时未开始执行的问题。
- 修复了“返回主页”忽略高度差异且从不从超过 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
- 通过让水中的鱼形 NPC 直立显示而非总是侧躺,修复了 #827。
- 通过防止损坏的 NPC 阻止世界保存来修复 #828,现在它会回退到默认值。
- 修复了恢复后的 NPC 拾取一个每次保存都会变化的随机预设 ID 的问题。
- 更改了 NPC 数据,仅在数据实际发生更改时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改逻辑,使已经到达目标位置的 NPC 立即完成移动。
- 将“无”皮肤选项卡更改为“高级”,其中包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“移动到”动作,可将 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。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的数据事件。
- 为
/easy_npc命令的每个 NPC 建议添加了包含名称、类型和距离的提示框。 - 改进了 NPC 建议功能:无需输入即可出现,并容忍一个方块范围内的轻微偏差。
7.5.0
- 修复了 #814,为每个 Cobblemon NPC 分配独立的动画状态,而非按物种共享。
- 修复了 #813,使“返回家园”功能可在任意距离生效,而不再仅限于家园附近。
- 修复了 #812,在每次会话中仅检查一次玩家是否更改了皮肤。
- 修复了 #810,允许资源包中的 Cobblemon 方面(aspects)除“闪亮”和“雌性”外被识别。
- 修复了 NPC 的家位置始终显示为未设置的问题,这会导致配置屏幕中隐藏“家园”选项、保存时跳过该选项,并使“返回家园”和“在家园周围漫步”功能失效。
- 修复了从预设、预设浏览器或重生生成的 NPC 无法获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出该预设的世界的家位置,而非使用其生成位置的问题。
- 修复了在配置、皮肤和预设屏幕中,当 Easy NPC Wand 高亮选中 NPC 时,它们会显示为带有阴影的白色剪影的问题。
- 修复了具有“引诱”目标的 NPC 在执行目标逻辑时导致服务器崩溃的问题。
- 修复了当预设中未存储任何 NPC 时,单个或首领刷怪笼会在无数量限制的情况下生成的问题。
- 修复了新创建的 NPC 仍会显示“旧版 Easy NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正,导致出现图层伪影的问题。
- 修复了在查询玩家名称期间玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中“重置注视 ...”目标标签错误显示为“重置战利品 ...”的问题。
- 修复了导入预设后“无重力”属性被忽略,导致 NPC 掉落的问题。
- 修复了由于开发辅助模组导致 Fabric 游戏测试在启动时崩溃的问题。
- 修复了 NPC 在被驱逐后重新生成时会失去所有者身份的问题。
- 修复了在游戏启动时提供目标功能的模组缺失,导致 NPC 的目标被删除的问题。
- 修复了导入未存储 ID 的预设时,生成的 NPC 没有所有者和家位置的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保留旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标虽然可以保存但从未执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画问题。
- 修复了 Forge 从未运行其服务器启动步骤,导致整个会话期间 NPC 追踪、阵营和自定义标识符索引为空的问题。
- 修复了 Forge 开发环境启动时不包含任何 Mixin,导致 vanilla 实体调整失效以及在生成 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 风格。
- 修复昼夜检测问题,此前会将日出计为夜晚、日落计为白天。
- 修复下界(Nether)和末地(The End)中的可见性问题,此前错误地使用了主世界时间。
- 修复时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复游戏测试仅在第一次断言失败时才会报错的问题,这会导致后续失败被隐藏。
- 修复“骑乘中”(Saddled)的马皮肤变体,此前从未显示马鞍。
- 更改“仅对主人可见”和“仅对队伍可见”设置,使其也遵循昼夜和游戏模式规则。
- 更改唤魔者(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:添加流浪商人 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。
- 修复了 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 预设,包含各种条件和动作。 - 添加了与对话条件和按钮状态相关的较小 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 和 QOL 更新)
- 如果客户端物种列表为空,则通过重新同步物种数据,修复了 #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。
- 通过移除冗余的背景渲染,修复了配置屏幕背景的双重渲染问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在的漏洞利用,并允许在多玩家环境中安全使用。
- 用静态背景替换了动态对话框屏幕背景,以获得更好的性能、自定义能力和兼容性。
- 用静态背景替换了动态配置屏幕背景,以获得更好的性能。
- 重构了配置 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。
- 修复了马刷怪蛋的模型。
- 修复了悦灵、鸡、苦力怕、狐狸、恶魂、马、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。 - 修复了删除按钮即使在小宽度下仍显示标签的问题。
- 修复了在某些情况下向上和向下按钮位置不正确的问题。
- 修复了对话框和配置 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 验证 bug(缺少 return 语句)。
- 重构了纹理处理逻辑以提高可维护性和未来改进空间。
- 添加了基于时间的重载保护(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 - 轻量级运行时和逻辑模块,依赖项极少。适用于服务器、整合包和开发者。
- 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" 动画行走时,隐藏的身体部位重新显示的问题。
- 修复了旋转界面中 “Lock Body”(锁定身体)标签溢出屏幕的问题。
- 修复了投射物 “Item ID”(物品 ID)字段遮挡物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误,原为 "Ork Warrior"。
- 修复了原版姿势按钮在游戏每次启动后顺序发生变化的问题。
7.18.0
- 修复了 #862:防止加载模组(如 LetMeDespawn)时 NPC 丢失。
- 修复了拥有近战和远程攻击能力的 NPC 在持有弓、弩或枪时不进行射击的问题。
- 修复了 NPC 在目标点之间移动时旋转、以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后 Boss 血条仍停留在屏幕上的问题。
- 修复了在创造模式下对 NPC 使用“拾取方块”功能不掉落其生成蛋的问题。
- 修复了 “Scoreboard”(计分板)条件在未拥有分数的玩家身上添加 0 分的问题。
- 修复了 Spartan Weaponry 金色重型十字弓,并添加了皮革和铜质版本。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误信息和日志刷屏问题。
- 修复了 “Custom”(自定义)皮肤选项卡将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英语 Bogged 名称以及原文保留的 “Main Hand”/“Off Hand” 键名。
- 更改了预设物品的使用逻辑:在生存模式中生成 NPC 时会消耗物品,以修复 #844。
- 更改了漫步、回家和注视目标的执行逻辑:在战斗期间及战斗结束后暂停 3 秒。
- 更改了拥有目标但无可用攻击手段(如手中无弓)的 NPC 的行为:改为注视其目标。
- 简化了 “Attack”(攻击)和 “Projectile Settings”(投射物设置)界面,并添加了滑块工具提示。
- 将 Boss 血条选项移至 “Display”(显示)中的独立界面,并新增 “Hide after”(一段时间后隐藏)设置。
- 在 “Display”(显示)选项卡中添加了按玩家可见性条件(如通过分数),以修复 #785。
- 添加了带有伤害、轨迹和撞击效果的自定义投射物(适用于弓、弩和枪),以修复 #855。
- 添加了无需武器即可发射投射物的 “Projectile Attack”(投射物攻击)目标,例如法师。
- 添加了多种投射物类型(如子弹、火球或物品)、多重射击、击退效果和状态效果。
- 添加了
projectile、boss_bar和objective … set attack type命令及相应的 API。 - 在
npc_base.cfg中添加了 “Ranged Attack”(远程攻击)音效及投射物爆炸限制。
7.17.1
- 重构了构建流程,不再打包测试文件,使模组文件大小最多减少 20%。
7.17.0
- 修复了 #858:支持由 AttributeFix 等模组设置的更高属性上限。 服务端和客户端均需安装 AttributeFix 或类似模组;护甲值上限为 100。
- 修复了 #857:当未发生任何更改时,不再在每次区块卸载时重写 NPC 文件。
- 修复了 #854:当一个 “Open Dialog (Conditional)”(打开对话(条件))的条件不满足时,尝试执行下一个。
- 修复了动作和对话中的 “Chance”(几率)条件被掷骰两次的情况,这会导致实际几率降低。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数,以及name clear未能清除显示名称的问题。 - 修复了死亡、骑乘或被拴绳的 NPC 出现在肩膀上,以及断开连接时出现的肩膀渲染泄漏问题。
- 修复了隐藏头部时仍保留帽子图层,以及 NPC 跟随其他维度目标的问题。
- 修复并改进了多个默认预设,包括 “Grukk”、“Forge Keeper” 和 “Yoga Master”。
- 将默认的 “Light Level”(光照等级)从 7 改为 0(环境光),并将其限制在 0 到 15 之间。 保留了默认开关的现有 NPC 也会受影响;设置为 7 可保持旧版外观。
- 更改了 “Close Dialog”(关闭对话)和 “Fallback”(回退)动作的执行时机:仅在未打开条件对话时运行。
- 更改了拥有传送距离的 “Follow Owner”(跟随主人)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 重新出现、内存泄漏以及多个所有者和用户界面问题。
- 修复了 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 占据其模型的空间,使其发生碰撞并可被点击。
- 更改了骷髅、流浪者和沼泽僵尸 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。 - 添加了“存在”条件操作,并提供了对 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 已经站在目标位置,则立即完成移动。
- 将“None”皮肤选项卡重命名为“Advanced”,其中现在包含“禁用皮肤”和纹理字段。
- 将 Easy Model Entities 的最低版本要求提升至 2.2.0,不再接受旧版本。
- 添加了“Move to”动作,可将 NPC 移动到指定位置、玩家、其所有者或其家。
- 添加了“Move to and Wait”动作,该动作会在到达后才执行后续动作。
- 为两种移动动作添加了到达半径、超时时间和可选的传送功能。
- 添加了“Opacity”属性(范围 0 到 100),用于混合淡化身体、盔甲和手持物品的外观。
- 添加了“Set Opacity”动作,可将 NPC 变成幽灵或完全隐藏。
- 添加了“Lantern Wraith”预设,这是一个在每个角落带有短线的方形路径行走的幽灵。
- 为移动动作和 NPC 的不透明度添加了 API 访问支持。
- 添加了“Resource Location”皮肤类型,可渲染模组或资源包中的任何纹理。
- 添加了“Advanced”皮肤选项卡,可在应用前预览输入纹理下的 NPC 效果。
7.7.7
- 通过保持 64x64 皮肤的透明度来修复 #821,Fresh Moves 需要这种透明度来显示眼睛。此前下载的皮肤需要通过玩家皮肤界面中的按钮重新加载。
- 通过让村民和流浪商人 NPC 也运行交易动作来修复 #818。
- 修复了具有多个文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载图像的问题。
- 修复了未翻译的“Execution Limit”条件中的间隔名称,例如
PER_DAY。 - 修复了 Easy Model NPC 的
sit动画,它从未使用内置的坐姿姿态。 - 修复了当玩家靠近时,NPC 头部遮挡对话气泡的问题。
- 更改了对话气泡的行为:保持屏幕尺寸不变,并在玩家靠近时向下或向侧面移动。
- 更改了对话气泡文本的渲染大小,使其比名牌大 20%。
- 更改了带“Wait”动作的时间相关动作集的执行顺序,改为按顺序运行而不是随机选择一个条目。
- 更改了对话框文本的换行逻辑,使其更晚换行,以便现有的对话框可以切换到更宽的屏幕布局。
- 更改了回退动作的逻辑,使其在没有玩家的情况下跳过屏幕动作,就像常规动作一样。
- 将 Easy Model Entities 的最低版本要求提升至 2.1.0,旧版本将禁用集成。
- 添加了“Wait”动作,用于暂停事件后续动作指定的持续时间。
- 添加了“Countdown Timekeeper”预设,这是一个倒计时至十的对话气泡,结束时会伴随声音和火花效果。
- 在“Experimental Features”复选框后添加了 Doppler NPC 的缩放和旋转功能。两者仅影响接受这些设置的实体的可见模型,且从不影响碰撞箱。
- 添加了“Sound”动作,可在 NPC 处播放指定类别、音量和音调的声音。
- 在“Execution Limit”条件中添加了“Every 5 Minutes”和“Every 15 Minutes”。
- 添加了“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 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段上的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕边缘而非自动换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐错误的问题。
- 修复了无法保存对“设置姿势(Set Pose)”、“播放动画(Play Animation)”和“停止动画(Stop Animation)”动作的更改的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议逻辑:优先列出准星指向的 NPC,且仅显示无权限的用户拥有的 NPC。
- 更改了预设导出逻辑:仅存储与新 NPC 不同的部分,不包含位置或所有者信息。
- 更改了没有目标或动作的空预设:回退到其所属 NPC 类型的默认值。
- 更改了不含玩家的事件(如“生成时”或“击杀时”)的条件检查逻辑。其中包含基于玩家条件(例如计分板或物品)的动作将不再执行。
- 更改了基于时间的动作逻辑:当所有者在附近时,将其作为
@initiator选择。 - 更改了对话气泡的可见时间:根据文本长度,从 5 秒调整至最长 18 秒。
- 更改了“设置姿势”动作:仅在“自定义”姿势条目中显示其输入字段。
- 添加了五个固定间隔的基于时间的动作选项,频率从每 ~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”选项,保存时跳过该选项,并使“返回家”和“在家附近闲逛”功能失效。
- 修复了从预设、预设浏览器或重生生成的 NPC 从未获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出该预设的世界的家位置,而不是使用其生成位置的问题。
- 当 Easy NPC Wand 高亮选中 NPC 时,修复了在配置、皮肤和预设屏幕中 NPC 被渲染为带有阴影的白色剪影的问题。
- 修复了当具有“Tempt”目标的 NPC 更新其目标时服务器崩溃的问题。
- 修复了单个或 Boss 刷怪笼在没有存储任何 NPC 的预设时,以无限制方式生成的问题。
- 修复了新建 NPC 时出现“Legacy Easy NPC Data”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正的问题,这会导致图层伪影。
- 修复了查找玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了“Reset look at ...”目标标签在某些语言中被错误显示为“Reset loot at ...”的问题。
- 修复了导入预设后“Ignore Gravity”属性被忽略的问题,这导致 NPC 会掉落。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在被再次生成前消失后丢失其所有者的问题。
- 修复了在游戏开始时提供相关目标的模组缺失时,NPC 的目标被删除的问题。
- 修复了导入没有存储 ID 的预设时,生成的 NPC 没有所有者和家的問題。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保留旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“Look at Item”目标虽然可以存储但从未执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画问题。
- 修复了 Forge 从不运行其服务器启动步骤的问题,这导致整个会话期间 NPC 追踪、阵营和自定义标识符索引为空。
- 修复了 Forge 开发运行从不包含任何 mixins 的问题,这禁用了原版实体调整,并在生成 Fox 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 风格。
- 修复了昼夜检测逻辑,此前会将日出误计为夜晚、日落误计为白天。
- 修复了下界(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进行搜索。 - 修复了无敌 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。
- 修复了 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,以支持更复杂和动态的行为。
- 通过为较长的文本添加对话框按钮提示(tooltip)来修复 #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。
- 通过移除冗余的背景渲染来修复配置屏幕背景的双重渲染问题。
- 通过调整包围盒来修复 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 的日志消息。
- 更新了采用新设计的 Logo。
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,添加了额外的逃跑目标,用于逃离玩家、村民、怪物等。
- 修复了姿态加载方式,改为直接从模组资源读取,而不是将文件复制到磁盘。
- 通过在实体加入时首先检查现有注册表条目,修复了重复调用
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。 - 修复了删除按钮在宽度较小时仍显示标签的问题。
- 修复了某些情况下上下按钮定位不正确的问题。
- 修复了对话框和配置界面中显示名称标签的问题。
- 修复了距离动作问题,即多个动作未正确触发。
- 修复了 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提供的详细调查和修复建议。
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 - 轻量级的 NPC 运行时和逻辑模块,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 用于创建和编辑 NPC 的独立配置界面。可安装在需要该界面的客户端上。
🎯 为什么进行此变更?
- 允许服务器和整合包仅在服务器端部署 Core 模组,从而实现更精简的设置。
- 当不需要 UI 时,减少内存占用和加载时间。
- 通过分离 UI 和核心逻辑,使开发和测试更加快速。
Easy NPC: Core (26.1.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 栏仍停留在屏幕上的问题。
- 修复了创造模式下对 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.1.2.120,该版本修复了三个网络漏洞。
7.15.0
- 修复了 #838:通过
/execute或命令方块运行时,预设导入保持静默。 - 修复了 #380:将 NPC 数量限制也应用于默认生成器。
- 修复了 #849:允许在声音配置中使用资源包声音。
- 修复了 #349:不再随机生成左手持物的 NPC。
- 修复了 #851:对话按钮按单个对话锁定,而非在所有具有相同标签的对话间锁定。
- 修复了已删除或重复的 NPC 重新出现、内存泄漏以及多个所有者和 UI 问题。
- 修复了 Epic Fight 凋灵骷髅 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
- 修复了 #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(高级)”,其中包含“Disable Skin(禁用皮肤)”和纹理字段。
- 将 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
- 修复了 #821:保留了 64x64 皮肤的透明度,Fresh Moves 需要此特性来渲染眼睛。此前下载的皮肤需要通过玩家皮肤界面中的按钮重新加载。
- 修复了 #818:现在村民和流浪商人 NPC 也会执行交易动作。
- 修复了当对话框具有多个文本变体时,其气泡大小每秒切换一次的问题。
- 修复了皮肤缓存存储处理后图像而非原始下载文件的问题。
- 修复了“Execution Limit(执行限制)”条件中未翻译的时间间隔名称(如
PER_DAY)。 - 修复了 Easy Model NPCs 的
sit动画从未使用内置坐姿的问题。 - 修复了当玩家靠近时,NPC 头部遮挡对话气泡的问题。
- 更改了对话气泡逻辑:保持屏幕尺寸不变,并在玩家靠近时向下或向侧面移动。
- 更改了对话气泡文本渲染大小,比名字牌大 20%。
- 更改了基于时间的动作序列:若包含“Wait(等待)”动作,则按顺序执行而非随机选择一个条目。
- 更改了对话框文本换行逻辑,使其更晚换行,以便现有对话框可以切换到更宽的屏幕布局。
- 更改了回退动作逻辑:跳过没有玩家参与的屏幕动作,与普通动作的行为保持一致。
- 将 Easy Model Entities 的最低版本要求提升至 2.1.0,旧版本将禁用集成。
- 添加了“Wait(等待)”动作,用于暂停事件后续动作指定的持续时间。
- 添加了“Countdown Timekeeper(倒计时计时器)”预设,一个数到十的气泡,结束时会发出声音并产生火花效果。
- 为 Doppler NPCs 添加了缩放和旋转功能,位于“Experimental Features(实验性功能)”复选框后方。这两项仅影响可见模型(仅限支持该特性的实体),且从不影响碰撞箱。
- 添加了“Sound(声音)”动作,可在 NPC 处播放指定音效类别、音量和音调的声音。
- 在“Execution Limit(执行限制)”条件中添加了“Every 5 Minutes(每 5 分钟)”和“Every 15 Minutes(每 15 分钟)”。
- 添加了“Player Idle(玩家闲置)”条件,用于检查玩家多久未移动。
- 添加了“Immovable(不可移动)”属性,使 NPC 抵抗推挤和击退效果。
- 添加了
/easy_npc pause命令,用于暂停单个 NPC 或所有 NPC;全局暂停将在服务器结束时重置。 - 开放了对声音动作、暂停状态和玩家闲置时间的 API 访问。
- 通过
/easy_npc render texture命令,为 Easy Model NPCs 提供了每个模型槽位的纹理覆盖功能。 - 为“Play Animation(播放动画)”动作添加了带有计数和时间限制的“Repeat(重复)”播放模式。
- 开放了对 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 类型的默认值。
- 更改了无玩家参与的事件(如“生成时”或“击杀时”)以检查其条件。其中基于玩家的条件(例如计分板或物品)不再执行。
- 更改了基于时间的动作:当所有者在附近时,将所有者选择为
@initiator。 - 更改了气泡可见时间:根据文本长度,从 5 秒增加到最多 18 秒。
- 更改了“设置姿势”动作:仅在“自定义”姿势条目时显示其输入字段。
- 新增了五个固定间隔的基于时间的动作,间隔从约 1 秒到约 15 分钟不等。
- 新增了“消息(Message)”动作,支持聊天、系统消息和气泡文本,无需指令。
- 为“消息(Message)”动作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包新增了气泡图形文件
easy_npc:textures/gui/speech_bubble.png。 - 新增了百分比形式的“几率(Chance)”条件以及针对所有者和阵营的“关系(Relationship)”条件。
- 新增了生成、所有者登录、状态变更、白天/夜晚、天气以及缺失的“交易时(On Trade)”事件。
- 在
easy_npc:api/preset/base/下按 NPC 类型添加了基础预设,可用作父预设。 - 新增了“流浪同伴(Wandering Companion)”预设,这是一个由基于时间的消息构建的多话 NPC。
- 为模组新增了动作注册表、动作处理器、预设验证器以及更丰富的动作事件数据。
- 为
/easy_npc命令的所有 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能:无需输入即可显示,并容忍一个方块内的接近误差。
7.5.0
- 修复了 NPC 的家位置始终显示为未设置的问题,这会导致在配置界面中隐藏“家”选项、保存时跳过该选项,并使“返回家”和“在家附近闲逛”功能失效。
- 修复了从预设、预设浏览器或重生生成的 NPC 从未获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留导出该预设的世界的家位置,而不是使用其出生位置的问题。
- 修复了在 Easy NPC Wand 高亮显示时,NPC 在配置、皮肤和预设界面中以带有阴影的白色剪影形式渲染的问题。
- 通过让每个 Cobblemon NPC 拥有独立的状态而非每个物种共享一个状态,修复了 #814。
- 通过允许“返回家”在任何距离下工作(而不仅仅是在家附近),修复了 #813。
- 通过在每次会话中检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包中的 Cobblemon 方面(aspects),而不仅仅是“闪亮”和“雌性”,修复了 #810。
- 修复了当具有“引诱”目标的 NPC 更新其目标时服务器崩溃的问题。
- 修复了单个或Boss刷怪笼在没有存储任何 NPC 的预设时,生成时没有数量限制的问题。
- 修复了新建 NPC 时出现“旧版 Easy NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤缺少透明度校正,导致图层伪影的问题。
- 修复了在查询玩家名称时玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中“重置注视...”目标标签错误显示为“重置战利品...”的问题。
- 修复了导入预设后“无重力”属性被忽略,导致 NPC 掉落的问题。
- 修复了由于开发辅助模组导致 Fabric 游戏测试启动时崩溃的问题。
- 修复了 NPC 在消失后重新生成时丢失所有者身份的问题。
- 修复了在游戏开始时提供这些目标的模组缺失时,NPC 的目标被删除的问题。
- 修复了导入没有存储 ID 的预设时,生成的 NPC 没有所有者和家的问题。
- 修复了更改所有者后,“跟随所有者”和“注视所有者”仍保持旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标虽然可以保存但从不执行任何操作的问题。
- 修复了 Doppler NPC 和第三方模型的行走动画问题。
- 修复了 Forge 从未运行其服务器启动步骤的问题,这导致整个会话期间 NPC 追踪、派系和自定义标识符索引为空。
- 修复了 Forge 开发运行在未加载任何 mixins 的情况下启动,导致 vanilla 实体调整禁用以及在生成 Fox NPC 时崩溃的问题。
- 将移动目标改为固定顺序:逃跑、跟随、回家,然后闲逛。因此,具有多个移动目标的 NPC 行为可能与之前不同。
- 更改了将预设插入 vanilla 怪物刷怪笼的行为,以保留其延迟、数量和范围。
- 更改了在没有选择目标的情况下,“跟随所有者”和“注视所有者”将跟随 NPC 的所有者。
- 更改了数据包预设的路径为
easy_npc/preset/,旧文件夹仍然有效,但仅适用于 easy_npc。 - 更改了预设浏览器,使其始终以相同的顺序列出条目。
- 移除了实验性的用户定义 NPC;不再读取或创建额外的配置文件。
- 移除了未使用的
SERVER_SKIN皮肤类型。 - 添加了新的 gametest 结构,以支持 1.21.11 及更高版本的 gametest。
- 在玩家皮肤屏幕的每个条目中添加了一个重新加载按钮,以便再次获取单个皮肤。
- 每当移除 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 风格。
- 修复了昼夜检测逻辑,之前错误地将日出计为夜晚、日落计为白天。
- 修复了下界和末地的可见性问题,此前错误地使用了主世界时间。
- 修复了时间和游戏模式可见性复选框显示顺序随机的问题。
- 修复了游戏测试仅在第一次断言失败时才报错的问题,这会导致后续失败被隐藏。
- 修复了“骑乘(Saddled)”马匹皮肤变体无法显示马鞍的问题。
- 更改了“仅对所有者可见”和“仅对队伍可见”选项,使其也遵循昼夜和游戏模式规则。
- 更改了未开启“交叉双臂”的唤魔者、幻术师和卫道士变体,使其手臂保持下垂状态。
- 添加了“保卫阵营”目标,攻击任何伤害附近阵营成员或玩家的人。
- 当阵营成员互相战斗且阵营选择置身事外时,添加了一条系统消息。
- 为灾厄村民添加了头部装备槽位,以便移除或更换其队长旗帜。
- 在显示配置界面添加了昼夜预览功能。
- 为可见性属性和阵营防御添加了单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提高了可见性检查的性能。
- 通过用默认值补全缺失项,改进了旧版本中的显示属性。
- 改进了攻击目标界面,在未设置时禁用“保护所有者”和“保卫阵营”。
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,为 Cobblepon 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。
- 修复了 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 spam 消息。
- 改进了 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 根旋转问题。
- 添加了基本的 Cobblemon 支持,包括用于测试的自定义 NPC 类型和模型。
6.13.0 (安全和权限更新)
注意:此更新包括更好的安全检查和多player环境下的权限控制。它允许执行服务器命令,如果被恶意使用,可能会带来潜在危险。
此更新将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离出来,这意味着现有 NPC 的根旋转和缩放可能会被重置为默认值。
- 通过将模型根数据及其逻辑从其余模型部分数据及其逻辑中分离,修复了 #725。
- 通过支持 .sbnt 文件作为本地预设,修复了 #722。
- 通过为对话框和配置屏幕背景添加专用资源,修复了 #675。
- 通过新的安全检查系统和权限系统,修复了 #605、#532、#529。
- 通过添加自定义模型支持的实验性 API 文档和示例,修复了 #469、#311。
- 通过移除冗余的背景渲染,修复了配置屏幕背景的双重渲染问题。
- 通过调整边界框,修复了恶魂和史莱姆的碰撞箱及名称标签位置问题。
- ⚠️ 添加了安全检查以防止潜在漏洞,并允许在多 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
- 通过对第三方实体创建添加 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 预设相关的问题。
- 修复了猫 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:(为...调用 defineId)警告消息。 - 通过多级防御和速率限制重构了纹理加载架构。
- 重构了实体数据注册逻辑以提高可维护性。
- 将数据类转换为现代 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(Jar 内 Jar)打包方式,以提高模组兼容性和 API 能力。
- 通过实现裁剪区域(scissor)提高了与其他模组的兼容性,修复了 #627。
- 修复了在使用旋转或移动模型部件时生动动画(lively animation)的问题,修复了 #625。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿势动画控制,提供智能(smart)、默认(default)和无(none)选项。
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 - 轻量级的运行时和逻辑模块,依赖项极少。适用于服务器、整合包和开发者。
- Easy NPC: Configuration UI - 独立配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何做出此变更?
- 允许服务器和整合包仅在服务器端部署 Core 模组,从而实现更精简的设置。
- 当不需要在所有地方使用 UI 时,减少内存占用和加载时间。
- 通过将 UI 和核心逻辑分离,加快开发和测试速度。
Easy NPC: Core(1.21.11)更新日志
注意
此更新日志包含变更摘要。如需查看完整更新日志,请前往 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 栏仍停留在屏幕上的问题。
- 修复了在创造模式下使用快捷挖掘(Pick Block)点击 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 版本至 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
- 修复了精灵(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。 - 添加了“存在”条件操作,并为 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 的问题。
- 更改了 NPC 数据逻辑,仅在实际发生更改时才将其写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 更改了已到达目标位置的 NPC 的行为,使其立即完成移动动作。
- 将“无”皮肤选项卡更名为“高级”,其中包含“禁用皮肤”和纹理字段。
- 添加了“移动到”动作,可将 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 建议的问题。 - 修复了“设置姿势”(Set Pose)操作的姿势列表绘制在其输入框上方的问题。
- 修复了操作编辑器中未翻译的“循环”(Loop)、“当前之后”(After current)和“操作数据类型”(Action Data Type)标签。
- 修复了“几率”(Chance)条件缺少提示文本的问题。
- 修复了长条件提示文本超出编辑器屏幕边界而非自动换行的问题。
- 修复了“消息”(Message)操作中帮助图标和文本按钮对齐不正确的问题。
- 修复了“设置姿势”、“播放动画”和“停止动画”操作的更改无法保存的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议列表,优先列出准星指向的 NPC,且仅列出没有权限的自身拥有的 NPC。
- 更改了预设导出功能,仅存储与新建 NPC 不同的部分,且不包含位置或所有者信息。
- 更改了当预设没有目标或操作时,回退到其 NPC 类型的默认值。
- 更改了不包含玩家的事件(如“生成时”或“击杀时”)以检查其条件。其中带有基于玩家条件(例如记分板或物品)的操作不再执行。
- 更改了基于时间的操作,当所有者在附近时,将所有者选择为
@initiator。 - 更改了气泡的可见时间,根据文本长度从 5 秒到 18 秒不等。
- 更改了“设置姿势”操作,仅在“自定义”姿势条目中显示其输入字段。
- 添加了五个固定间隔的基于时间的操作,频率从约每秒一次到约每 15 分钟一次。
- 添加了“消息”(Message)操作,用于聊天、系统消息和无需命令的气泡文本。
- 为“消息”(Message)操作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包添加了气泡图形
easy_npc:textures/gui/speech_bubble.png。 - 添加了百分比形式的“几率”(Chance)条件以及针对所有者和阵营的“关系”(Relationship)条件。
- 添加了生成、所有者登录、状态变化、白天/黑夜、天气以及缺失的“交易时”(On Trade)事件。
- 在每个 NPC 类型下的
easy_npc:api/preset/base/路径中添加了基础预设,可用作父级预设。 - 添加了“流浪同伴”(Wandering Companion)预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 为模组添加了操作注册表、操作处理器、预设验证器以及更丰富的EventData。
- 为
/easy_npc命令的所有 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能,现在无需输入即可出现,并容忍准星偏离一个方块以内的误差。
7.5.0
- 修复了 NPC 的家位置始终显示为未设置,导致配置屏幕中隐藏“家”选项、保存时跳过该选项,并使“返回家”和“在家附近漫步”功能失效的问题。
- 修复了从预设、预设浏览器或重生机制生成的 NPC 永远无法获得家位置的问题。
- 修复了从预设浏览器生成的 NPC 保留了导出该预设的世界的家位置,而非使用其生成位置的问题。
- 修复了在配置、皮肤和预设屏幕中,当 Easy NPC Wand(简易 NPC 魔杖)高亮选中 NPC 时,NPC 会显示为带有阴影的白色剪影的问题。
- 通过为每个 Cobblemon NPC 分配独立的动画状态(而非按物种共享),修复了问题 #814。
- 通过允许“返回家”在任何距离下生效(而不仅仅是在家附近),修复了问题 #813。
- 通过在每次会话期间检查一次玩家是否更改了皮肤,修复了问题 #812。
- 通过接受资源包中的 Cobblemon 属性(而不只是“闪亮”和“雌性”),修复了问题 #810。
- 修复了当拥有“诱惑”目标的 NPC 刷新其目标时服务器崩溃的问题。
- 修复了悦灵、恼鬼和恶魂等飞行类 NPC 在地面上移动而非飞行的问题。
- 修复了包含重复项或特殊字符的对话、按钮、预设、姿势和纹理名称的问题。
- 修复了专用服务器上条件不可编辑以及条件文本未翻译的问题。
- 修复了 Easy Model Entities NPC 无法转头,且其模型列表忽略
/reload命令的问题。 - 修复了新创建的 NPC 出现“旧版简易 NPC 数据”警告的问题。
- 修复了旧版 64x32 皮肤的透明度校正缺失,导致图层伪影显示的问题。
- 修复了查询玩家姓名时玩家皮肤屏幕短暂冻结的问题。
- 修复了部分语言中“重置注视...”目标标签错误显示为“重置战利品...”的问题。
- 修复了 Fabric 游戏测试因开发辅助模组而在启动时崩溃的问题。
- 修复了 NPC 在消失后重新生成时丢失所有者身份的问题。
- 修复了在游戏启动时提供相关目标的模组缺失,导致 NPC 的目标被删除的问题。
- 修复了当目标实体缺失时,目标永久被关闭的问题。
- 修复了导入未存储 ID 的预设时,生成的 NPC 没有所有者和家位置的问题。
- 修复了“跟随所有者”和“注视所有者”在所有者变更后仍保留旧目标的问题。
- 修复了攻击目标在被攻击实体消失后仍分配给 NPC 的问题。
- 修复了“注视物品”目标可被保存但从未执行任何操作的问题。
- 修复了 Doppler NPC 及第三方模型的行走动画问题。
- 修复了 Forge 从不运行其服务器启动步骤,导致整个会话期间 NPC 追踪、阵营和自定义标识符索引为空的问题。
- 修复了 Forge 开发环境启动时缺少 mixins,从而禁用原版实体调整并在生成狐狸 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)中的可见性问题,这些区域此前错误使用了主世界的时间。
- 修复时间和游戏模式可见性复选框出现顺序随机的问题。
- 修复游戏测试仅能在首次断言失败时才报错的问题,这导致后续的错误被隐藏。
- 修复“骑乘”马匹皮肤变体无法显示马鞍的问题。
- 更改“对所有者可见”和“对队伍可见”选项,使其也遵循昼夜和游戏模式设置。
- 更改唤魔者(Evoker)、幻术师(Illusioner)和卫道士(Vindicator)变体,若无“交叉手臂”样式,则保持手臂下垂。
- 新增“保卫派系”目标,攻击伤害附近派系成员或玩家的实体。
- 新增派系成员互相战斗且派系保持中立的系统消息。
- 为灾厄村民(Illagers)添加头部装备槽,以便移除或替换其队长旗帜。
- 在显示配置屏幕中添加昼夜预览功能。
- 为可见性属性和派系防御功能添加单元测试和游戏测试。
- 通过每次检查仅读取一次显示属性,提升可见性检查性能。
- 通过用默认值补全缺失项,改进旧版本中的显示属性。
- 改进攻击目标屏幕,当未设置时禁用“保护所有者”和“保卫派系”。
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
- 修复 #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(可被派系攻击)战斗属性。 - 修复 oversized 物种的 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 实体类型映射相关的 #775 启动崩溃问题(注:原文写的是 #774,但根据上下文通常指代启动相关,此处按原文翻译)。
- 通过在基础刻期间及打开交易屏幕前检查限时交易重置,修复了 #773。
- 通过正确增加内部计时器,修复了交易重置时机问题。
- 为 #459 添加了昼夜时间和天气条件。
- 为交易重置、计时器处理和实体属性添加了额外的单元测试和游戏测试。
- 添加了名为
Skywatch Scout的示例 NPC 预设,支持昼夜时间和天气条件。
6.23.0
- 通过调整对 403 和 404 错误的纹理重试次数并降低日志记录级别,修复了 #772。
- 修复了 Epic Fight NPC(唤魔者、掠夺者、卫道士和人形皮肤)的 #770 物品渲染问题。
- 修复了 #769 NPC 门循环中无法可靠地打开或关闭门的问题。
- 通过添加对话框选项和配置设置(
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
- 修复了持交叉手臂姿势的 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 (交易、玩家头颅、史诗战斗和质量改进更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #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 类型和模型的 basic 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标志,以便瞬态索引(如弩充能、模型动画)不再触发脏保存标记。 - 向
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。 - 修复了删除按钮即使在小宽度下仍显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置 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 record,以提高不可变性和线程安全性。
- 添加了基于 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(jar 内打包)方案,以提高模组兼容性和 API 能力。
- 通过实现裁剪区域(scissor)修复了 #627,以更好地与其他模组兼容。
- 修复了在使用旋转或移动模型部件时出现的不生动动画问题(#625)。
- 修复了在使用缩放模型部件时默认动画被取消的问题。
- 添加了更好的姿态动画控制,提供智能、默认和无选项。
6.4.1
- 针对不同 NPC UUID 的屏幕切换逻辑进行了修复(#626),感谢
Spawnblade进行的详细调查和修复建议。
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 发光效果的渲染性能。
- 通过排除非生物实体(如显示实体、制造者、投掷物和刷怪笼),改进了自定义实体的检测逻辑。
- 改进了猫咪变体处理逻辑。
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 - 轻量级的运行时和逻辑模块,依赖项极少。旨在供服务器、整合包和开发者使用。
- Easy NPC: Configuration UI - 独立于核心的配置界面,用于创建和编辑 NPC。可安装在需要该界面的客户端上。
🎯 为何做出此变更?
- 允许服务器和整合包仅在服务端部署 Core 模组,从而构建更精简的环境。
- 当不需要处处使用界面时,减少内存占用和加载时间。
- 通过将界面与核心逻辑分离,加快开发和测试速度。
Easy NPC: Core (1.21.1) 更新日志
注意
本更新日志包含变更摘要。如需查看完整更新日志,请访问 GitHub History。
注意:在更新到新版本之前,请务必备份你的世界 / NPC! 有关更多信息,请参阅 升级指南。
7.19.0
- 修复了 #865:防止隐藏某个 NPC 的皮肤层会同时隐藏同类型其他 NPC 的相同皮肤层。
- 修复了僵尸类与末影人类 NPC 的自定义姿势被其手臂动画覆盖的问题。
- 修复了村民和僵尸村民 NPC 在拥有职业时重新显示被隐藏的头部的 Bug。
- 修复了在使用“默认 (DEFAULT)”或“无 (NONE)”动画行走时,被隐藏的身体部位重新显示的 Bug。
- 修复了僵尸化猪灵 NPC 在阳光下燃烧的问题。
- 修复了“锁定身体 (Lock Body)”标签在旋转界面中溢出显示的问题。
- 修复了投射物“物品 ID”字段遮挡物品 ID 开头部分的问题。
- 修复了兽人战士的英文名称拼写错误(原为 "Ork Warrior")。
- 修复了原版姿势按钮在游戏每次启动后顺序发生变化的问题。
7.18.0
- 修复了 #862:防止在安装 LetMeDespawn 等模组加载 NPC 时丢失。
- 修复了同时具备近战和远程攻击能力的 NPC 在手持弓、弩或枪时不发射远程攻击的问题。
- 修复了 NPC 在目标点之间旋转以及史莱姆 NPC 在攻击时跳跃方向错误的问题。
- 修复了传送离开或切换维度后Boss条仍停留在屏幕上的问题。
- 修复了在 Creative(创造)模式下对 NPC 使用拾取方块无法获得其生成蛋的问题。
- 修复了“计分板 (Scoreboard)”条件在未设置分数的玩家身上添加 0 分的问题。
- 修复了 Spartan Weaponry 金色重型弩的问题,并添加了皮革和铜制版本的支持。
- 修复了皮肤界面中重叠的提示、复选框工具提示以及缺失的错误和日志刷屏问题。
- 修复了“自定义 (Custom)”皮肤选项卡将文件夹命名为
skins而非config/easy_npc/skin的问题。 - 修复了大量德语翻译、英语 Bogged 名称以及原始的“主手 (Main Hand)”/“副手 (Off Hand)”键名。
- 更改了预设物品的行为,使其在生存模式下生成 NPC 时被消耗,以修复 #844。
- 更改了闲逛、回家和注视目标的行为,使其在战斗期间及结束后 3 秒内暂停。
- 更改了有目标但无可用的攻击手段(例如手中没有弓)的 NPC 的行为,使其注视目标。
- 简化了“攻击 (Attack)”和“投射物设置 (Projectile Settings)”界面,并添加了滑块工具提示。
- 更改了 Boss 条选项至“显示 (Display)”下的独立界面,并新增了“之后隐藏 (Hide after)”设置。
- 添加了按玩家可见性条件(例如通过分数),位于“显示 (Display)”选项卡中,以修复 #785。
- 添加了带有伤害、轨迹和撞击效果的自定义投射物,支持弓、弩和枪,以修复 #855。
- 添加了无需武器即可发射投射物的“投射物攻击 (Projectile Attack)”目标,例如法师。
- 添加了子弹、火球或物品等投射物类型,支持多重射击、击退和效果。
- 添加了
projectile、boss_bar和objective … set attack type命令及 API。 - 在
npc_base.cfg中添加了“远程攻击 (Ranged Attack)”音效和投射物爆炸限制。
7.17.1
- 重构了构建流程,不再打包测试文件,使模组文件大小最多减少 20%。
7.17.0
- 修复了 #858:支持由 AttributeFix 等模组设置的更高属性上限。 服务器和客户端均需安装 AttributeFix 或类似模组;护甲值上限固定为 100。
- 修复了 #857:在没有更改的情况下,不再于每个区块卸载时重写 NPC 文件。
- 修复了 #854:当某个“打开对话框(条件型)”的条件未满足时,尝试执行下一个。
- 修复了动作和对话框中的“几率 (Chance)”条件被掷两次骰子的问题,这降低了实际几率。
- 修复了未保存的 NPC 更改、损坏的预设导出以及崩溃后重复执行的生成动作。
- 修复了
scale、rotate和position拒绝接受root参数的问题,以及name clear保留显示名称的问题。 - 修复了死亡、骑乘或被拴绳的 NPC 出现在肩膀上以及断开连接时的肩膀渲染泄漏问题。
- 修复了被隐藏头部仍保留帽子图层以及 NPC 在其他维度跟随目标的问题。
- 修复并改进了几个默认预设,包括“Grukk”、“Forge Keeper”和“Yoga Master”。
- 将默认的“光照等级 (Light Level)”从 7 改为 0(周围光),并将其限制在 0 到 15 之间。 保持默认开关的现有 NPC 也会受影响;设置为 7 可保留旧版外观。
- 更改了“关闭对话框 (Close Dialog)”和“回退 (Fallback)”动作的执行时机,使其在无条件对话框打开时运行。
- 更改了具有传送距离的“跟随主人 (Follow Owner)”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 版本起,更改为已死亡的 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)凋灵骷髅 NPC 缺少其史诗战斗生物补丁的问题。
- 更改了要求:客户端和服务端需使用相同的模组版本,简易模型实体(Easy Model Entities)需 2.5.0 或更高版本。
- 更改了所有世界备份和已死亡 NPC 数据的过期时间为 30 天,详见
storage.cfg。 - 添加了“跳跃”、“协助所有者”和“跟随最近玩家”功能,以修复 #845、#310 和 #761。
- 添加了包含物品拾取和死亡掉落物的 NPC 背包功能,以修复 #111、#197、#543 和 #670。
- 添加了“坐在肩上”功能、Boss 血条以及
/easy_npc debug core loglevel命令,以修复 #577 和 #219。 - 添加了“手持”动画模式、“银行柜员”预设以及供附加包使用的新 API 方法。
7.14.0
- 修复了 #846:对于稍后才开始看到该 NPC 的玩家,保留自定义姿势。
- 修复了稍后才开始看到该 NPC 的玩家缺少属性和交易设置的问题。
- 修复了更改后的最大使用次数、经验值和交易类型在未重新加载前未显示在交易屏幕中的问题。
- 修复了
/easy_npc sound set的更改在未重新加载 NPC 前未生效于玩家的问题。 - 添加了游戏测试,用于检查重生后和新玩家的 NPC 姿势及设置。
7.13.0
- 修复了对话框按钮名称中的颜色和格式标签显示为纯文本的问题。
- 修复了编辑器中按钮预览将小写名称显示为原始翻译键的问题。
- 修复了“移动 EasyNPC”物品在非创造模式下对 NPC 所有者无效的问题。
- 修复了即使所有者无法更改,
/easy_npc owner set仍报告成功的问题。 - 修复了当 URL 或玩家皮肤屏幕显示皮肤下载错误时导致游戏崩溃的问题。
- 修复了预设浏览器在向下滚动列表后搜索无结果的问题。
- 更改了网络协议版本,因此客户端和服务端必须运行相同的模组版本。
- 在对话框按钮名称中添加了对
@initiator、@npc和@score()的支持,以修复 #841。 - 添加了使用客户端运行时接口工具包(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 导入”或预设物品来创建独立的 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 数据,避免了冗余写入,并添加了重复卸载警告。
- 修复了预设浏览器无法列出以 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 的问题。
- 更改了 NPC 数据:仅在数据实际发生变化时才写入磁盘。
7.8.0
- 修复了较小的文本和 UI 问题。
- 修改了已处于目标位置的 NPC,使其立即完成移动。
- 将“无(None)”皮肤选项卡更名为“高级(Advanced)”,其中包含“禁用皮肤”和纹理字段。
- 添加了“移动到(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 皮肤的透明度来修复 #821,Fresh Moves 需要该透明度来显示眼睛。此前下载的皮肤需要通过玩家皮肤界面中的按钮重新加载。
- 通过让村民和流浪商人 NPC 也执行交易动作来修复 #818。
- 修复了具有多个文本变体的对话框每秒切换一次气泡大小的问题。
- 修复了皮肤缓存存储处理后的图像而非原始下载文件的问题。
- 修复了“执行限制(Execution Limit)”条件中未翻译的时间间隔名称,如
PER_DAY。 - 修复了 Easy Model NPC 的
sit动画从未使用内置坐姿的问题。 - 修复了当玩家靠近时,NPC 头部遮挡对话气泡的问题。
- 修改了对话气泡的行为,使其保持屏幕尺寸,并在玩家靠近时向下或向侧方移动。
- 修改了对话气泡文本,使其渲染尺寸比名字标签大 20%。
- 修改了带有“等待(Wait)”动作的时间型动作集,使其按顺序执行而非随机选择一项。
- 修改了对话框文本的换行逻辑,使其更晚换行,从而使现有对话框能够切换到更宽的屏幕布局。
- 修改了回退动作,使其在没有玩家时跳过屏幕相关动作,与常规动作行为保持一致。
- 将 Easy Model Entities 的最小版本要求提升至 2.1.0,旧版本将禁用集成。
- 添加了“等待(Wait)”动作,用于暂停事件后续动作指定的时长。
- 添加了“倒计时计时员(Countdown Timekeeper)”预设,对话气泡从一数到十,结束时伴有声音和火花特效。
- 在“实验性功能(Experimental Features)”复选框后为 Doppler NPC 添加了缩放和旋转功能。两者仅影响接受这些功能的实体的可见模型,且绝不会影响碰撞箱。
- 添加了“声音(Sound)”动作,可在 NPC 处播放带有声音类别、音量和音调的声音。
- 在“执行限制(Execution Limit)”条件中添加了“每 5 分钟(Every 5 Minutes)”和“每 15 分钟(Every 15 Minutes)”。
- 添加了“玩家闲置(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 的问题。 - 修复了“设置姿势”动作的姿势列表绘制在其输入字段之上的问题。
- 修复了动作编辑器中未翻译的“循环(Loop)”、“当前之后(After current)”和“动作数据类型(Action Data Type)”标签。
- 修复了“几率(Chance)”条件缺少提示文本的问题。
- 修复了长条件提示超出编辑器屏幕而非自动换行的问题。
- 修复了“消息(Message)”动作的帮助图标和文本按钮对齐错位的问题。
- 修复了“设置姿势”、“播放动画”和“停止动画”动作的更改无法保存的问题。
- 修复了气泡文本距离上边框比下边框更近的问题。
- 更改了 NPC 建议逻辑:优先列出准星指向的 NPC,且仅列出没有权限的玩家拥有的 NPC。
- 更改了预设导出逻辑:仅存储与新 NPC 不同的部分,不包含位置和所有者信息。
- 更改了无目标或动作的预设逻辑:回退至其 NPC 类型的默认值。
- 更改了无玩家参与的事件(如“生成时”或“击杀时”)的逻辑:检查其条件。如果其中的动作包含基于玩家的條件(例如计分板或物品),则不再执行。
- 更改了基于时间的动作逻辑:当所有者在附近时,将所有者选为
@initiator。 - 更改了气泡显示逻辑:根据文本长度,气泡可见时间从 5 秒增加到 18 秒。
- 更改了“设置姿势”动作逻辑:仅在“自定义”姿势条目中显示其输入字段。
- 添加了五个固定步骤的基于时间的动作,频率从每 ~1 秒到每 ~15 分钟不等。
- 添加了“消息(Message)”动作,支持聊天、系统消息和气泡文本,无需指令。
- 为“消息(Message)”动作添加了文本变体、发送者名称、接收者和翻译键。
- 为资源包添加了气泡图形素材
easy_npc:textures/gui/speech_bubble.png。 - 添加了百分比形式的“几率(Chance)”条件以及针对所有者和阵营的“关系(Relationship)”条件。
- 添加了生成、所有者登录、状态变化、白天/夜晚、天气以及缺失的“交易时(On Trade)”事件。
- 在
easy_npc:api/preset/base/下为每种 NPC 类型添加了基础预设,可用作父级预设。 - 添加了“流浪同伴(Wandering Companion)”预设,这是一个由基于时间的消息构建的健谈型 NPC。
- 为模组添加了动作注册表、动作处理器、预设验证器以及更丰富的数据事件。
- 为
/easy_npc命令的所有 NPC 建议添加了包含名称、类型和距离的工具提示。 - 改进了 NPC 建议功能:无需输入即可显示,并容忍一个方块内的微小偏差。
7.5.0
- 通过让每个 Cobblemon NPC 拥有独立的动画状态(而非按物种共享),修复了 #814。
- 通过让“返回家园”在任何距离下生效(而不仅限于家园附近),修复了 #813。
- 通过在每次会话期间检查一次玩家是否更改了皮肤,修复了 #812。
- 通过接受资源包的 Cobblemon 外观属性(而不仅限于“闪亮”和“雌性”),修复了 #810。
- 修复了 NPC 在重生或导入预设后丢失所有者、家园和“无重力”设置的问题。
- 修复了目标保留已消失的目标,并在目标或相关模组消失时被关闭的问题。
- 修复了飞行类 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 守护者(Forge Keeper)”预设。
- 为其他模组添加了自定义条件、事件、NPC 标识符以及更多目标选项。
- 添加了 32 块距离外的“远距离(On Far Distance)”事件,以及所有者上线时重新生成 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.2.0
- 修复了 #801,通过使用 NPC、对话和动作 UUID 的组合来避免动作跟踪和执行限制中的冲突。
7.1.1
- 修复了 #800,采用惰性加载实体类型。
- 修复了 #799,修复了边缘情况,并增加了额外文档及更好的日志消息。
- 修复了 #798,将控制台、命令方块和指令视为可信的命令来源。
- 修复了一个严重的单人/LAN 问题,此前客户端和服务端 NPC 共享同一个注册表。
- 修复了配置菜单处理中的内存泄漏,并添加了超时和断开连接清理机制。
- 修复了多个 NPC 同时请求相同皮肤时导致的重复下载问题。
- 修复了出错后皮肤查找失败的问题,防止缓慢的服务端导致游戏冻结。
- 修复了在检查远程图片时 URL 皮肤界面导致游戏冻结的问题;现在该检查在后台运行。
- 添加了新的“世界生成器”方块,可在全世界(所有维度)限制 NPC 预设;现有的“群组生成器”现按维度计数,因此远处的 NPC 不再阻塞它。
- 增强了远程皮肤下载的安全性,设置了严格的尺寸限制和安全重定向处理,以防止因过大或恶意的皮肤 URL 导致崩溃;添加了可选的
blockPrivateAddresses设置。 - 通过仅向实际使用这些事件的 NPC 发送实体和玩家加载事件(按维度分组),改善了服务器性能。
7.0.0
- 修复了 #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 的记分板分配。
- 修复了自定义皮肤重载问题,改为针对每个皮肤模型加载和清除纹理缓存,而非始终重建完整的自定义纹理缓存。
- 改善了
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 实体类型映射相关的 #775 启动崩溃问题。
- 通过在基础刻内及打开交易屏幕前检查定时交易重置,修复了 #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,以允许更复杂和动态的行为。
- 通过为较长文本添加对话框按钮提示工具(tooltip)来修复 #652。
- 通过添加命令值提示工具(tooltip)以显示完整值来修复 #687。
- 添加了经验等级条件。
- 添加了游戏模式条件。
- 添加了物品栏中有物品的条件。
- 添加了手持物品条件,支持主手和副手。
- 添加了玩家生命值条件。
- 添加了玩家标签条件。
- 添加了玩家队伍条件。
- 添加了包含各种条件和操作的 Goldmere 示例 NPC 预设。
- 添加了否定条件支持,以便对条件进行取反以实现更复杂的逻辑。
- 移除了
ActionDataEntry的参数伪 ID,并将其替换为随机 UUID。 - 重构了条件系统以允许更多类型的条件。
6.17.0
- 通过为“作为玩家执行”添加额外的提示工具(tooltip)来修复 #738。
- 通过在启动期间和游戏内减少 log.info 消息来修复详细日志问题。
- 添加了额外的单元测试和游戏测试。
6.16.0
- 通过提供禁用 ESC 键和对话框关闭按钮的选项来修复 #732。
- 通过在特定情况(如交易屏幕)下避免自动关闭来修复 #723。
- 添加了通用对话框配置选项,以允许用户自定义对话框行为。
- 添加了对话框头像缩放和位置偏移选项。
- 添加了缺失的翻译键。
6.15.0 (交易、玩家头颅、Epic Fight 和 QOL 更新)
- 如果客户端物种列表为空,则通过重新同步物种数据来修复 #731。
- 通过改进 Epic Fight 集成并启用实验性功能来修复 #730。
- 通过确保正确存储交易使用次数来修复 #729。
- 通过为玩家头颅添加自定义头颅支持来修复 #728。
- 通过显示剩余交易使用次数并允许手动和自动重置来修复 #689。
- 通过新的交易配置屏幕和对自定义交易的更好支持来修复 #218 和 #132。
- 修复了在基本模式和正常/高级交易模式之间切换时的交易特定边缘情况。
- 通过显示完整文本的提示工具(tooltip)来修复对话框按钮文本被截断的问题。
- 通过将动画状态与 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
- 通过为第三方实体创建添加 try-catch 块,修复了 #698。
- 通过在切换至
DEFAULT(原版)姿态时清除模型部件的旋转/位置,修复了 #695。 - 通过仅在 NPC 处于空闲状态时应用锁定旋转和姿态动画,修复了 #695。
- 通过将根旋转轴心修正为使用实际的边界框高度而不是 0.5f,修复了 #695。
- 修复了多个目标注册问题,包括反转的
isTargetedPlayer检查、离开处理器中的错误 UUID、加入/离开时缺少针对玩家的目标刷新,以及对离线目标的重试机制。 - 修复了目标注销后仍保留目标引用的问题。
- 移除了加载姿态时 ROOT 旋转的自动锁定;现在 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 实体数据索引中。
- 在 various 实体渲染器中添加了 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。 - 修复了删除按钮即使宽度较小也显示标签的问题。
- 修复了某些情况下上下按钮位置不正确的问题。
- 修复了对话框和配置 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。
- 修复了杀除命令无法对 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 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 和核心逻辑,加快开发和测试速度。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
一个用于收集生物掉落物的多区块模组。
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
新增 50+ 个独特生物群系,为你的世界增添新树木、花卉等更多元素!
模组
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
评论 0
登录后参与评分
还没有评论,来抢沙发吧