Easy NPC：核心版（1.21.11）更新日志

说明

本更新日志汇总了主要变更内容。
完整更新日志请参阅 [GitHub 历史记录][history]。

注意：升级至新版本前，请务必备份您的世界存档及所有NPC数据！
更多详细信息请查阅 [升级指南][upgrade_guide]。

7.2.0

• 通过为NPC、对话框与操作分别组合生成UUID，修复了#801问题，避免操作执行追踪与执行次数限制发生冲突。

7.1.1

• 通过延迟加载实体类型，修复了#800问题。
• 通过修正边界情况并补充文档说明与更清晰的日志信息，修复了#799问题。
• 将控制台、命令及命令方块视为可信命令来源，修复了#798问题。
• 修复了一个严重单人游戏/局域网问题：客户端与服务端NPC共享同一注册表。
• 修复了配置菜单处理过程中的内存泄漏，并新增超时机制与断开连接后的清理逻辑。
• 修复了多个NPC同时请求同一皮肤时重复下载的问题。
• 修复了皮肤查询因错误失败后导致慢速服务器卡死游戏的问题。
• 修复了URL皮肤界面在检查远程图片时冻结游戏的问题；现该检查将在后台运行。
• 新增“世界刷怪箱”方块，可将NPC预设限制于整个世界（所有维度）；现有“群组刷怪箱”改为按维度计数，使远距离NPC不再影响其触发。
• 加强远程皮肤下载安全性：严格限制文件大小、安全处理重定向，防止因过大或恶意皮肤URL导致崩溃；新增可选设置blockPrivateAddresses。
• 提升服务器性能：仅向实际使用实体与玩家加载事件的NPC发送对应事件，并按维度分组发送。

7.0.0

• 通过采用预期的NPC渲染类型，修复了#794问题。
• 新增流浪商人NPC类型，修复了#791问题。
• 扩展AI防护机制，覆盖史诗战斗（Epic Fight）及原始NPC变体（猪灵、村民、末影人、苦力怕、掠夺者与女巫），修复了#788问题。
• 新增派系系统，包含/easy_npc faction指令、每NPC派系分配及自动同步记分板队伍，修复了#787、#531、#237与#184问题。
• 新增“目标”目标页签，支持攻击敌对派系或指定目标（玩家名、队伍、实体标签或UUID），修复了#787、#771与#572问题。
• 为方块宝可梦（Cobblemon）NPC新增性别与闪光模型变体，可在模型选择中通过关键词female（雌性）或shiny（闪光）搜索，修复了#786问题。
• 新增“派系可攻击”战斗属性，修复了无敌NPC间派系战斗无法生效的问题。
• 针对方块宝可梦（Cobblemon）大型物种的模型预览问题，改用其自身档案缩放比例而非碰撞箱高度进行缩放。
• 通过校验派系名称、排序派系列表、以及在派系颜色变更或删除后刷新已加载NPC的记分板分配，修复了派系管理的边界情况。
• 通过按皮肤模型分别加载与清空纹理缓存（而非始终重建全部自定义纹理缓存），修复了自定义皮肤重载问题。
• 改进“玩家/怪物/派系可攻击”战斗属性，使其各自独立于“无敌”属性运作，为对应攻击者群体单独开放针对性漏洞。
• 优化预设命令与网络处理：将大型处理器拆分为更小、更专注的导入、导出及功能专属组件。
• 新增Easy Model Entities支持。
• 新增派系管理器与派系编辑器界面，用于创建、着色、删除派系及管理敌对关系，并受全新FACTION_MANAGEMENT安全特性保护。
• 新增“杂项”属性页签，作为NPC派系分配的归属位置。
• 新增可复用的警告图标与帮助图标组件，支持内联提示与悬浮工具提示。
• 新增针对派系、目标目标及方块宝可梦（Cobblemon）模型变体的额外单元测试与游戏测试。

6.25.0

• 在验证过程中保留数据组件，修复了#782、#636与#622问题。
• 通过缓存远程纹理下载并减少重复注册，修复了#780问题。
• 对其他模组引入的极端属性值进行钳制，修复了#767问题。
• 新增自定义数据物品匹配功能，支持含操作与条件的NPC，修复了#754问题。
• 修复了纹理管理器在错误线程中运行可能引发崩溃与死锁的问题（适用于1.21.x及以上版本）。
• 修复了操作条件中空UUID的处理。
• 修复了操作执行次数限制的重置逻辑。
• 新增纹理注册队列，避免同一刻内多次并发下载。
• 新增NPC金币、钥匙与红令牌作为消耗品，供含操作与条件的NPC使用。
• 新增示例NPC预设“欢迎金币商人”，含自定义金币、钥匙与红令牌物品数据。
• 新增针对其他模组引入极端属性值的防护机制。
• 将高生命值NPC的备用最大生命值从1024提升至4096。
• 优化纹理管理器：减少重复纹理检查与注册。

6.24.0

• 新增选项以阻止与隐形NPC交互，修复了#459与#775问题。
• 修复了因可选的史诗战斗（Epic Fight）与方块宝可梦（Cobblemon）实体类型映射引发的启动崩溃（#774）。
• 在基础刻度周期内及打开交易界面前检查限时交易重置，修复了#773问题。
• 通过正确增加内部刻度器，修复了交易重置时机问题。
• 为#459新增昼夜时间与天气条件支持。
• 新增针对交易重置、刻度器处理及实体属性的额外单元测试与游戏测试。
• 新增示例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预设格鲁克——陪练木桩，修复了#764问题。
• 确保对话按钮执行次数限制现已被记录，修复了#763问题。
• 提供名为一愿伴侣的示例NPC预设，修复了#758问题。
• 修复了第三方村民AI读取Easy NPC村民未注册脑记忆（如PoiCompetitorScan/工作地点）导致的崩溃（#756）。
• 为#760与#644做准备，修复了服务端数据下对话按钮未锁定的问题。
• 新增条件型对话开启支持/指令，实现对对话显示时机的精细控制，修复了#628问题。
• 为猪灵与猪灵蛮兵NPC添加脑AI，并注册完整原版脑记忆集。
• 为枪械标签（gun tag）新增更多枪械，支持#757。
• 新增“开启对话（条件型）”操作：仅当满足条件时才开启指定名称的对话框；而原有“开启对话”操作仍无条件开启。
• 新增实体生命值与NPC生命值条件，支持操作、对话框及对话按钮。
• 为猪灵、猪灵蛮兵与僵尸猪灵NPC新增无敌属性，与其他NPC保持一致。
• 新增“击退免疫”战斗属性，防止NPC被近战或投射物攻击击退。
• 新增“爆炸免疫”战斗属性，使NPC免疫爆炸伤害与位移（如TNT、苦力怕、末影水晶）。
• 将“投射物碰撞”属性移至战斗属性界面（此前位于能力界面），更符合主题分类。

6.21.0

• 修复了交叉手臂姿势下卫道士（Illager）的物品附着问题。
• 修复了卫道士（Illager）十字弓攻击目标失效的问题。
• 修复了第三方物品无法作为手持物品渲染导致的崩溃（#756）。
• 修复了第三方混入（Mixin）尝试访问不存在模型部件导致的崩溃（#756）。
• 通过降低日志冗余度并为自定义模型部件添加额外校验，减少log.info信息刷屏。
• 提升EasyNPCModelManager性能。
• 重构NPC渲染器，移除默认手持物品图层。

6.20.0

• 修复了第三方模组尝试访问不存在NPC目标导致的崩溃。

6.19.0

注意：本次更新将对话框背景图像尺寸调整为每边+10×6像素，若用户使用自定义对话框背景，则可能需要相应调整。

• 新增对话按钮条件支持，允许禁用按钮，修复了#752与#130问题。
• 新增打字机效果支持对话文本，修复了#683与#215问题。
• 允许对话、对话按钮及交互添加条件，修复了#690与#309问题。
• 修复了对话界面布局与背景的小型UI问题。
• 按每边+10×6像素重构对话框背景图像。
• 重构对话界面布局，适配新背景尺寸并提升视觉效果。
• 新增打字机效果及客户端对话文本配置选项。
• 新增条件符号，直观指示对话、按钮及交互的条件状态。
• 新增物品条件的数量字段，支持检测特定数量的物品。
• 新增示例NPC预设阈值守望者，含多种条件与操作。
• 新增否定条件支持，便于构建更复杂的逻辑。

6.18.0

注意：本次更新更改了条件与操作的内部数据格式，可能导致旧版执行次数限制条目（无存储ID者）被重置或移除。

• 新增操作条件支持，实现更复杂、动态的行为，修复了#745问题。
• 新增对话按钮工具提示以支持长文本，修复了#652问题。
• 新增命令值工具提示以显示完整值，修复了#687问题。
• 新增经验等级条件。
• 新增游戏模式条件。
• 新增物品栏持有物品条件。
• 新增手持物品条件（支持主手与副手）。
• 新增玩家生命值条件。
• 新增玩家标签条件。
• 新增玩家队伍条件。
• 新增示例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）动画系统，修复其动画问题。
• 新增每笔交易专属操作，允许用户在购买后触发操作。
• 新增交易重置按钮，便于一键重置全部交易。
• 在交易配置界面中添加交易使用信息。
• 新增实验性功能开关，允许用户手动启用实验性功能。
• 新增示例商人格里斯尔达·磨石，含操作功能。
• 清理测试文件。

6.14.0

• 确保数值变更时同步至客户端，修复了#727问题。
• 新增特定命令的白名单，修复了#726问题。
• 新增基础方块宝可梦（Cobblemon）支持（含Cobblemon NPC），修复了#686、#389、#304与#211问题。
• 通过调整对话精灵图与界面，修复对话错位与导航问题。
• 修正X轴与Z轴根部旋转逻辑与枢轴点计算，修复旋转问题。

6.13.0（安全与权限更新）

说明：本次更新增强了多人游戏环境下的安全检查与权限控制。
部分服务端命令存在潜在风险，恶意使用可能导致安全隐患。

本次更新将模型根部数据与逻辑与其他模型部件数据与逻辑分离，可能导致现有NPC的根部旋转与缩放重置为默认值。

• 将模型根部数据与逻辑与其他模型部件数据与逻辑分离，修复了#725问题。
• 支持.sbnt文件作为本地预设，修复了#722问题。
• 为对话与配置界面背景新增专用资源，修复了#675问题。
• 新增安全检查与权限系统，修复了#605、#532与#529问题。
• 新增实验性API文档与自定义模型支持示例，修复了#469与#311问题。
• 通过移除冗余背景渲染，修复配置界面背景双重渲染问题。
• 通过调整包围盒，修复恶魂（Ghast）与史莱姆（Slime）的碰撞箱及名称标签位置问题。
• ⚠️ 新增安全检查，防止潜在漏洞利用，确保多人游戏环境下的安全使用。
• 将动态对话界面背景替换为静态背景，以提升性能、自定义性与兼容性。
• 将动态配置界面背景替换为静态背景，以提升性能。
• 重构配置UI专属组件，并将其从核心模组中移除。
• 移除重复的精灵图集。
• 为未来可能的LuckPerms集成（如#712）准备权限系统。
• 通用代码清理与优化，聚焦于配置界面渲染与资源处理。

6.12.0

• 基于原版模型，为自定义模型部件列表新增额外校验，修复了#714问题。
• 降低日志冗余度：将每NPC的INFO级消息降级为DEBUG级，并合并冗余警告消息，修复了#713问题。
• 减少启动/配置日志输出量，修复了#711问题。
• 强化NBT校验防护，防止生产环境中不必要的缓冲区分配。
• 在EasyNPCModelManager中添加模型部件名称常量，确保混入（Mixin）中的一致使用。
• 优化RenderEntityTypeSupportConfig：增强过滤逻辑并优化数据结构，提升性能与可维护性。
• 移除输出大型数据结构的冗长调试日志。

6.11.1

• 改进可恢复交易数据的向后兼容解析，修复了#710问题。

6.11.0

• 修复新自定义图层系统与手部渲染导致的渲染问题（#703）。
• 新增额外防护与日志记录，防范无效交易报价（#701）。
• 修复智能动画在修改头部位置后无法正常工作的问题。
• 将玩家检测移回服务端，修复头部追踪问题。
• 改进CustomLookAtPlayerGoal，更好处理边界情况并减少抖动。
• 修复多普勒NPC（Doppler NPCs）持续持有手部物品的问题。
• 优化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的单元测试。
• 新增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集成至各类实体渲染器。
• 新增专用“逃跑目标”配置页签，含针对苦力怕、怪物、生物、玩家、村民及太阳的逃跑目标。
• 在跟随目标页签中新增FOLLOW_ITEM目标，支持NPC根据资源位置（如minecraft:apple）跟随物品实体。
• 新增LookAtEntityByUUIDGoal，并在查看目标界面中启用“按UUID查看实体”与“查看所有者”目标。
• 在SynchedDataIndex中新增`persist

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