更新日志总览 - LiPet 文档

2.3.13 末影人召唤雨水保护

修复低血量末影人在召唤初始化期间被雨水或入水伤害杀死的问题，成功注册后解除保护，无需新增配置。更新说明。

2.3.12（2026-10-21）

新增 Folia 26.3 build 5 隔离服验证与版本检查覆盖；Paper 26.3 build 210 加载通过。保留 2.3.11 的闪光捕捉提示与发光药水逻辑。验证范围见 26.3 兼容说明。

2.3.11 闪光捕捉提示与发光药水

闪光捕捉成功增加专属聊天和标题提示，闪光宠物召唤后添加发光药水；均可配置开关。更新说明。

2.3.10 仓库独立宠物图标

支持按宠物类型配置原版或 CE 图标，未配置时沿用默认，保留现有仓库操作。配置说明。

2.3.9 菜单详情与成长分离

修复两个管理按钮打开相同页面，保留原 CE 成长配置，新增独立详情页。更新说明。

2.3.8 原生属性培养

新增带档案版本校验的属性分配 API，防止重复加点与空属性扣点，配套 LiUI 0.9.0-dev8。详见 2.3.8 更新说明。

2.3.7 Paper 26.3 适配

新增 Paper 26.3 的明确验证支持，保留 Java 21 编译下限和已有配置；运行 Paper 26.3 使用 Java 25。模型骑乘、MM 技能、和平世界以及原版宠物存档回归通过。Folia 保持原兼容范围，本次不升级。详见 2.3.7 更新说明。

2.3.6 和平宠物世界

在 config.yml 的 peaceful-worlds 中填写世界名，即可让指定世界内的宠物免伤、停止攻击和技能，同时保留跟随与骑乘。默认空列表，修改后 /lipet reload 生效。详见 2.3.6 更新说明。

2.3.5 低座位下马净空

修复 model-seat.y: 0.5 等低座位下马后脚部进入方块的问题。保留座位高度，按方块真实碰撞形状寻找下马净空，同时处理 Folia 已排队的座位更新与首次移动取消回退。无需覆盖配置或更新资源包。详见 2.3.5 更新说明。

2.3.4 模型下马位置同步

修复 ModelEngine 虚拟座位下马后残留上马前移动事件起点的问题：正常下马同步当前位置，首个移动包提前到达时校正事件起点，避免移动被取消后玩家退回上马位置。取消下马、立即重新骑乘及外部传送保留原有语义，不覆盖配置或模型文件。详见 2.3.4 更新说明。

2.3.3 无驾驶骨模型运行时座位

没有原生驾驶骨的 ModelEngine 宠物会补充运行时虚拟驾驶座，避免隐藏原版载体时的乘客绑定缺口；已有驾驶骨保持原样。支持全局 riding.model-seat 和单宠 behavior.model-seat 配置真实模型、父骨与局部坐标，修改后重载并重新召唤。

保留原模型文件、可见性、存档与已有自定义配置。座位挂载结构的修复不等于任意模型坐姿都已完成客户端验收；具体模型仍需实测调整。详见 2.3.3 更新说明。

2.3.2 主动攻击名称统一

宠物设置按钮、默认说明和操作提示统一为“主动攻击”。旧官方默认名称和消息按完整字符串匹配迁移，按钮说明按完整列表匹配；任何自定义文字、颜色或说明行保留。

沿用原来的 auto-attack 配置、动作与变量标识，已有宠物的开关、数据库结构和攻击行为保持原样，保留 2.3.1 全部功能。迁移范围、升级方式和验证记录见 2.3.2 更新说明。

2.3.1 模型骑乘主驾驶与换乘冲突修复

多模型骑乘改为使用 ModelEngine 主驾驶管理器；旧座位下马取消时拒绝换乘，MM 直接上马也保护已有挂载关系，避免两把座位重复绑定骑手。完全没有驾驶骨的模型继续使用原版骑乘，2.3.0 的全部功能与旧配置保留。

本次修复已确认的主驾驶选择与换乘冲突，录像中的脱模表现尚需实际客户端复测。完整范围及最终验证进度见 2.3.1 更新说明。

2.3.0 MythicMobs 双向集成

MM 技能现在可用 @LipetOwner 选择施法宠物的主人，以 lipetExperience{amount=25} @self 给宠物提交经验奖励，并通过 <lipet.level>、<lipet.damage>、<lipet.max_health>、四维属性与品质 ID 读取 LiPet 档案。未安装 MCPets 时同时提供 @PetOwner 和 petExperience{exp=25} 兼容名称。

现有 mythic-skills 的等级解锁、trigger 和 power 保持原行为；MM 使用 <skill.power> 获取传入值。MM damage 默认还会自动乘一次 power，显式引用它时需设 poweraffectsdamage=false 避免重复。伤害数值不等于 <pet.damagemodifier> 倍率，其他 MCPets 专属机制仍需按包核对。详见双向集成指南和 2.3.0 更新说明。

2.2.5 GUI 标题支持 PlaceholderAPI 变量

宠物主菜单、商城、仓库、信息、管理、放生确认及独立背包的标题，统一支持 PlaceholderAPI 的 %变量% 与原有 LiPet <变量>。例如管理菜单标题可写成 <gold><pet_name></gold> · %player_name%；PAPI 按打开菜单的玩家解析，查看他人宠物时也是查看者上下文。

保留原有 MiniMessage 颜色、<font:命名空间:字体> 与 Unicode 字符；未安装 PAPI、变量未知或解析异常时保留原文并继续打开菜单。现有标题配置不被覆盖，修改配置后执行 /lipet reload 并重新打开菜单；升级 Jar 仍需正常重启。

详见 2.2.5 GUI 标题变量说明。

2.2.4 宠物主动攻击开关（2.3.2 统一名称）

宠物管理菜单新增每宠攻击开关，2.3.2 起显示为“主动攻击”，按每只宠物分别保存，默认开启。关闭后清除当前目标，停止自动索敌、援助反击与自动战斗技能并继续跟随；召回、重进和正常重启保留选择。玩家开关仍遵守管理员物种配置与区域保护，手动技能保留原有目标与冷却校验。

详见 2.2.4 更新说明。

2.2.3 捕捉品质提示

捕捉成功主消息增加实际已保存宠物的品质，保留原有特性详细行。支持品质、性格、闪光、成长倍率、宠物名和成功率占位符；仅迁移精确匹配旧官方默认的成功提示，服主自定义文本保持不变。

抽取概率、捕捉规则与 CE 贴图包不变。本轮 769 项测试和隔离 Paper 26.2 的 37 项集成检查通过，覆盖实际 SQLite 保存、聊天数据包、旧默认迁移与自定义保留；详见 2.2.3 更新说明。

2.2.2 持久化全链路审计

封闭数据库在线切换窗口；明确结束停服队列中尚未开始的数据库任务，保持已开始 SQL 的真实结果。背包增加编辑互斥、快照条件保存和恢复文件；技能书与购买增加未确认事务核对凭据，并收紧旧会话、死亡和创建保存的处理。

不改数据库表结构，不承诺自动恢复历史缺失数据。769 项单元测试、83 项真实 MySQL 检查和 Paper 26.1.2 / Paper 26.2 / Folia 26.2 合计 81 项服务端检查通过；详见 2.2.2 审计说明。

2.2.1 MySQL 持久化修复

修复 MySQL 模式下使用被动技能书后，连接残留手动提交状态，导致后续新宠物显示保存成功、实际未提交并在断线或重启后消失的问题。归还连接时先回滚遗留事务，再恢复自动提交、只读状态和事务隔离级别；恢复失败直接丢弃连接，并修复连接池关闭时的归还竞争。

688 项单元测试通过；真实 MySQL 8.0.45 先复现旧版缺陷，修复后 33 项检查与数据库进程重启后的 4 项检查全部通过。详见 2.2.1 更新说明。

2.2.0 已有 ModelEngine 动画技能

新增 12 项使用已有 ModelEngine 动画的技能，目录共 112 项：100 项物种技能与 12 项模型技能。9 项通过缩小的 LiSeasons 场景蓝图表现，3 项直接播放现有 Parro 的攻击、跳跃和奔跑动画。原有 88 种生物的三槽分配保留；long_1、long_2 只在缺少类型覆盖时补入 Parro 三槽，已有管理员列表保留。所有技能继续提供粒子和音效。

增加 EFFECT / PET 动画目标及播放倍率；仅补缺失字段和中文注释。宠物动画结束时仅处理本次播放句柄，其他系统后来播放的同名动画继续保留。详见 2.2.0 更新说明。

2.1.0 原版生物特性技能

100 项默认技能按物种特性重新设计与分配，加入一次性概率闪避、火焰/凋零持续伤害、失明、悬浮与抗火效果。史莱姆“滑溜溜”可在短时间内闪避一次攻击；每宠三个技能、自动/手动共用冷却及全技能特效保留。详见 2.1.0 更新说明。

2.0.1 CE 配方原物品捕捉

修复 CE 原物品只能经 LiPet 指令发放才能捕捉的问题，按唯一完整 ID 直接识别配方产物。退款改为退回实际消费物品的快照，保留 CE 模型、名称与组件。附可选 CE 合成示例，已有配置不被覆盖。详见 2.0.1 更新说明。

2.0.0 百种宠物技能

新增 100 个带默认粒子、RGB 轨迹和音效的主动技能；每只宠物默认三槽，支持战斗自动释放、手动指令、独立与公共冷却及可选 CE/ModelEngine 模型表现。详见 2.0 更新说明。

0.29.16 宠物信息食物展示优化

食物开关改为 show-in-pet-info，明确只作用于宠物信息界面；旧 show-in-info 自动兼容迁移。全部食物隐藏时默认移除整行，GUI 配置新增单项格式、分隔符、空内容文字及空列表显示策略。

详见 0.29.16 更新说明。

0.29.15 宠物食物信息显示开关

新增 gui.yml -> info.foods-display.enabled 整行开关，以及每条食物的 show-in-pet-info 单项开关。隐藏食物不会影响识别、扣除、喂养、经验、治疗、属性点或等级限制；旧配置只补缺失节点与中文注释，不覆盖现有设置。

详见 0.29.15 更新说明。

0.29.14 监守者动作跟随与凋灵受控 AI

监守者近战改用实体专属攻击状态，客户端可播放原版攻击动作；关闭 Brain 后即使 Paper 拒绝寻路，也会在落地时先按碰撞物理主动追随，持续受阻再安全召回。凋灵的原版感知、普通目标和三个头部独立目标全部交由 LiPet 接管，不再自行随机发射凋灵之首；跟随与战斗改用受控飞行速度。

本次不新增或覆盖配置。详见 0.29.14 更新说明。

0.29.13 完整宠物 PAPI 与宠物币变量

补齐并集中整理活动宠物、品质性格、成长属性、宠物数量、服务器、CraftEngine 捕捉球和内置宠物币变量。新增宠物币余额、名称、格式化余额及常用别名；余额在登录时异步预热，PAPI 读取不会阻塞服务器线程。

详见 0.29.13 更新说明和完整 PlaceholderAPI 变量表。

0.29.12 CraftEngine 捕捉球 PAPI 变量

新增捕捉开关、球列表及按球 ID 查询 CE 物品 ID、名称、命名空间、类型和三档捕捉概率的 PlaceholderAPI 变量；同时提供配置原值与显示百分比。不新增配置节点，也不覆盖已有捕捉球设置。

详见 0.29.12 更新说明。

0.29.11 监守者跟随与召唤名牌

修复监守者受控移动推进间隔、宽体寻路边角及跳跃中断问题，保留原版 Brain 关闭和主人保护。召唤成功注册后才显示名牌，召回及失败后的延迟刷新不再重新创建名牌。不覆盖配置或修改跟随阈值。

详见 0.29.11 更新说明。

0.29.10 停服保存与残留攻击保护

停服保存不再等待下一实体 tick；带标记但无活动会话的宠物禁止造成伤害，间接攻击保留来源，嘎枝正确清除主人仇恨。不修改存档主人。

详见 0.29.10 更新说明。

0.29.9 重启残留与归属提示

修正缺失活动会话被误报为“不是主人”的情况；实体加载后延迟核对，右键补清理重启残留，并保护尚未完成的召唤。不改数据库归属，不按点击者认领宠物。

详见 0.29.9 更新说明。

0.29.8 · 鱼类水中跟随与骑乘

修复鱼类水中跟随水平推进不足，以及骑乘持续下沉、不能上浮。原版鱼 AUTO 模式在水中使用游泳控制：空格上浮、低头前进下潜、松键停止升降；新增 SWIMMING 模式，离水不飞行。保留外部模型驾驶控制。

详见鱼类跟随与游泳骑乘。

0.29.7 · 原生宠物体型缩放

内置原生 SCALE 缩放，无需 LiAnimalScale；支持公共、单宠类型和等级倍率，模型与碰撞箱由 Minecraft 同步。默认关闭，仅作用于 LiPet 宠物；外部 ModelEngine/CraftEngine 模型跳过。重载、重召与等级变化同步，关闭时安全恢复。

详见原生宠物体型缩放。

0.29.6 · info 界面行数修复

属性界面支持 1-6 行，不再强制改为 5 行或把仓库返回按钮改到 40。保留管理员布局、动作及注释；缩小时须将属性卡片、属性按钮和两个返回按钮移入有效范围。旧版已写回的值需手动重新设置。

详见 info 界面行数修复。

0.29.5 · 监守者宠物主人保护

监守者宠物改用 LiPet 受控移动与近战，不再由原版 Brain 追打主人或释放黑暗、声波。跟随、主动索敌、坐下及 WG 规则保留；不屏蔽野生监守者的黑暗，不清除玩家其他来源的药水效果。需正常重启并重新召唤旧宠物。

详见监守者宠物主人保护。

0.29.4 · WorldGuard 与召唤跟随

新增 lipet-spawn、lipet-attack 区域开关，控制召唤与攻击。收回坐下宠物后再次召唤恢复跟随。MM 在禁刷怪区域仍需 WG mobs.block-plugin-spawning: false（影响该世界所有插件生成，普通自然刷怪仍受区域限制）；未配置时明确提示并回滚，不再空指针。原版宠物无需这一额外设置。完整重启注册旗标，勿用热卸载代替。

详见 WorldGuard 与召唤跟随。

0.29.3 · 主人保护

禁止宠物把主人设为原版仇恨目标，并周期清理绕过事件直接写入的主人目标。伤害前后两次检查宠物本体、投射物及可追溯的间接来源，对主人取消并归零伤害。普通怪物仍能正常伤害玩家，不改已有配置。必须完整重启并确认启动版本为 0.29.3-SNAPSHOT。

0.29.2 · 追击与绕障

保留主动索敌，修复近距离隔墙停步及追击被空闲跟随距离打断；原地卡住约 4 秒会放弃目标，主动扫描短暂跳过它。主人远离后仍优先返回。更新 Jar 必须正常重启服务端并核对启动版本，配置重载不能替换正在运行的代码。

0.29.1 · 主动索敌

空闲宠物现在可主动攻击附近可见敌对怪物，默认扫描范围 8 格；排除玩家、宠物、驯服生物及部分中立生物。坐下、骑乘、牵引、返回主人时不索敌，主人走远仍优先跟随。公共及独立宠物配置支持 behavior.auto-attack.enabled/radius，配置重载可生效。

0.29.0 · 品质、性格与闪光

新捕捉宠物可获得五档品质、可配置性格和稀有闪光。成长倍率与名称随档案保存，召回、重载和重新读取存档不重抽，旧宠物保持原数值。仓库、详情、名牌与 PAPI 均可显示。新增 traits.yml；材料进化、探索派遣留待后续批次。详见本次品质、性格与闪光更新文档。

0.28.0 · 骑乘、命名与多行名牌

原版骑乘新增自动迈步和 LOOK/MOVEMENT 朝向；ModelEngine 保留独立驾驶控制。新增 naming.yml 命名规则与 nameplate.lines 多行排版，兼容已有配置和名字。 0.28.0 为扩展开发第一批；品质/性格/闪光已在 0.29.0 补充，材料进化与探索派遣仍待后续。配置说明见本次更新文档。

0.27.29 · 跟随与模型骑乘稳定性

地面宠物在主人附近停靠，减少贴身重叠；脱战返回不再反复重置路径。模型虚拟座位跨 Folia 区域时保留骑乘判断，暂停不安全的读取；减少骑乘时名牌重复刷新。不新增必填配置，具体行为及验证范围见本次更新说明。

0.27.28 · 单宠名牌与战斗跟随

单宠物 nameplate 支持覆盖及热重载；主人走远时宠物脱战返回，返回途中不重新接战。补充模型驾驶座 Bukkit 输入同步与骑乘期间技能控制。两份龙配置的缩进问题与模型测试边界见本次更新说明。

2026-09-12 · 0.27.27 · MM 模型与骑乘等级

修复模型容器回收、名牌跟随和模型驾驶座识别；增加骑乘等级门槛及 MM 事件校验。详见更新日志-2026-09-12-MM模型与骑乘等级。

当前版本：0.27.26-SNAPSHOT。

2026-09-08 · 0.27.26 · 独立背包贴图标题

独立宠物背包可按实际 1-6 行容量选择资源包标题；默认关闭，缺失或空标题回退普通显示。
普通标题也可在 gui.yml 配置，支持宠物名字；不改变容量、存储和物品。
默认 API 与 Paper 26.2 API 各 386 项测试通过；客户端贴图与实际背包存取待验收。

详见背包贴图标题配置。

2026-09-06 · 0.27.25 · 生命周期逐项排查

区分首次召唤与属性刷新，重载、区块恢复和成长保留实时血量；喂食追加治疗不覆盖异步期间的新伤害。
保留待保存死亡事件，失败后召唤/收回先重试死亡落盘，避免变回活宠；保留首次冷却，退出保存失败记录日志。
两套 API 各 383 项测试通过；旧版末影人血量 5→20 问题实机复现，新版修复并验证死亡数据库失败恢复。
待保存事件仅在内存中，崩溃持久化、背包多人编辑、重载原子性及原服联动仍未完成。

详见逐项检查结果、剩余风险与验证边界。

2026-09-06 · 0.27.24 · 死亡扣级惩罚

默认死亡扣 1 级、最低 1 级；config.yml -> death-penalty 可关闭或调整，支持 /lipet reload。
实际掉级时清空当前级经验，优先扣未分配属性点，不足部分按当前四维比例扣回；达到下限或关闭时保留成长数据。
死亡状态和惩罚一起持久化，revision 冲突有限重试，重复死亡不重复扣级；主人通知回到其 Folia 区域。
两套 API 各 377 项测试通过，Folia 实测配置重载、真实死亡、重复回调、完整重启及复活后的等级和属性。

详细规则、初始属性扣回边界和升级步骤见死亡扣级惩罚。

2026-09-06 · 0.27.23 · Folia 专项排查

修复延迟/重复任务退休回调、跨区战斗目标、弹射物属性读取和 MythicMobs 技能目标边界。
捕捉跨区中断退款、目标退休清理和保存后原实体移除分别调度；玩家离线时退款球退为捕捉位置掉落物。
GUI 开关延迟到下个玩家 tick，过期菜单点击不影响新菜单；跟随任务拒绝旧会话，方块探测限制区域和高度。
默认 API 与 Paper 26.2 API 各 366 项测试通过，Folia 26.2 隔离服定向测试通过。
仍有同宠物背包并发编辑、配置快照及捕捉崩溃一致性风险，详见完整排查报告及验证边界。

2026-09-06 · 0.27.22 · GUI 物品保护修复

补齐 InventoryDragEvent 保护，拖拽只要触及 LiPet 只读菜单的顶部槽位就会被取消，展示物品不能再经拖拽路径被改动。
普通菜单点击改为在最高事件优先级处理，并明确按当前视图的顶部 InventoryHolder 识别 LiPet 菜单。
主菜单、双商城、仓库、详情、管理和放生确认页全部受保护；玩家只在自己背包内拖拽时仍可正常整理。
宠物独立背包保持可编辑并在关闭时保存，不会被只读菜单保护误伤。
无新增配置；默认兼容 API 与 Paper 26.2 API 各 361 项测试通过。

完整说明见 2026-09-06 GUI 物品保护修复。

2026-09-06 · 0.27.21 · Folia 认主与召唤时序修复

Folia 新实体在生成当 tick 可能暂时返回 isValid=false；旧逻辑会误报“宠物实体生成被保护插件拦截”并回滚召唤，本版不再用该瞬时标志判断生成结果。
宠物初始化后至少等待一个宠物实体 tick，再在宠物自己的 Entity Scheduler 上完成活动会话注册。实体死亡、调度拒绝和调度前退休仍会安全回滚数据库与租约。
玩家重进的主人恢复继续由宠物 Entity Scheduler 执行，玩家和宠物不在同一 Folia 区域也不会直接跨线程修改驯服状态。
Folia 26.2 实测带持久化外观的狼正常召唤，并在跨 1024 格区域后完成主人 UUID 恢复与收回；默认兼容 API 与 Paper 26.2 API 各 359 项测试通过。
无新增配置，0.27.20 的喂食冷却和已有管理员配置保持不变。

完整说明见 2026-09-06 Folia 认主与召唤时序修复。

2026-09-06 · 0.27.20 · 重进认主与喂食冷却

玩家重进时会查找仍处于活动会话的宠物，并在宠物实体所属线程重新绑定持久化主人。
区块重新载入与热重载也恢复狼、猫等原版驯服实体的主人；鹦鹉继续解除原版驯服，防止上肩后脱离实体索引。
新增 config.yml -> feeding.cooldown-seconds，默认 1.0 秒、范围 0-60、支持小数；设为 0 可关闭，执行 /lipet reload 后生效。
冷却按宠物计算，只在合法且会产生效果的喂食上占位；冷却中、无效食物、非主人、无效果或保存失败均不扣除食物，保存失败会立即撤销冷却。
旧配置仅补充缺失节点、默认值和中文注释，不覆盖已有管理员配置。

完整说明见 2026-09-06 重进认主与喂食冷却。

2026-09-05 · 0.27.19 · 属性加点与属性归属修复

属性保存遇到短暂 revision 冲突时最多重试两次；活动档案先与数据库对账，仓库档案重新读取，避免一次竞争就表现为“加不了”。
修正属性职责：力量只增加攻击、暴击伤害与少量吸血；暴击率由敏捷增加。
属性按钮动作改为安全解析，并兼容 STRENGTH / strength；错误 UUID、缺失参数和未知属性不再抛出背包点击异常。
新增可配置的“属性点不足”和“按钮动作无效”提示。旧配置只补全缺失节点，不覆盖管理员修改。
默认兼容 API 全量 353 项测试通过。

完整说明见 2026-09-05 属性加点与属性归属修复。

2026-09-05 · 0.27.18 · Residence 天气与属性加点修复

新增 Residence 局部天气运行时挂钩；领地有效 sun=true 时，LiPet 烈焰人不再因世界底层仍在下雨而持续受到淋雨伤害。
伤害保护限定为世界风暴、DROWNING、LiPet 烈焰人且未泡水；普通烈焰人、未设晴天、领地外和真实水/气泡柱伤害均不改变。
修复连续属性加点后的界面刷新读取较早数据库档案，导致显示旧属性或像未生效的问题；成功后直接显示本次已保存的档案。
不新增配置、不修改 Residence Flag，也不覆盖管理员自定义。两套 API 全量构建各 349 项测试通过，Paper 26.2 Build 111 隔离服完成天气标志优先级、伤害事件和真实泡水边界验证。

完整说明见 2026-09-05 Residence 天气与属性加点修复。

2026-09-05 · 0.27.17 · 风弹喂食冲突修复

修复给旋风人喂风弹时同时触发原版发射、重复消耗的问题。
合法食物在异步喂食前登记保护，由独立物品使用监听器阻止紧随其后的主手/副手使用。
保护只覆盖同一玩家、同一物品及短时交互；新实体交互、切槽、换手、退出或过期后清理，不全局禁用风弹。
保留食物配置、原有成功扣除/失败不扣除和创造模式规则，不新增管理员配置。
默认兼容构建和 Paper 26.2 API 全量构建各 343 项测试通过。

原因、升级步骤和实测结果见 2026-09-05 风弹喂食冲突修复。

2026-09-04 · 0.27.16 · 捕捉幼体认主修复

捕捉外观已记录 adult=false，但旧版没有锁定原版年龄，幼体仍会自然长大并偏离数据库记录。
捕捉到的幼体现在保持幼体并锁定自然年龄；召唤、区块重新载入与活动实体恢复共用同一外观校正。
成年宠物清除遗留锁龄，避免冻结成年实体的原版年龄计时。
Paper 26.2 Build 111 边界探针确认狼、猫、马自然成年会保留实体 UUID、PDC、驯服状态和主人 UUID，不需要迁移或重建宠物档案。
本版不新增配置或覆盖管理员设置。默认构建与 Paper 26.2 Profile 各 333 项测试通过。

原因、升级步骤和验证记录见 2026-09-04 捕捉幼体认主修复。

2026-09-04 · 0.27.15 · 快乐恶魂移动修复

成年快乐恶魂的原生移动控制与通用路径组合不稳定；即使路径接口返回已接受，实体也可能停住或移动异常。
快乐恶魂跟随和战斗追击改由飞行速度直接接管，并在开始接管时清除旧路径；其他地面和飞行宠物保持原有导航策略。
按实际 4 格成年体型把跟随与召回脚底目标提高到主人上方 3 格，幼年快乐恶魂仍使用至少 1.5 格高度。
骑乘期间额外同步快乐恶魂身体 yaw，继续支持原地转向、持续按住前进后转头和多层模型座位。
本版不新增或覆盖配置。默认构建与 Paper 26.2 Profile 各 330 项测试通过；Paper 26.2 Build 111 真实成年实体完成跟随、抬升、骑乘与安全关闭验证。

原因、升级步骤和验证数据见 2026-09-04 快乐恶魂移动修复。

2026-09-04 · 0.27.14 · 原版宠物专属食物校准

对照 Paper 26.2 服务端内置原版食物标签，逐项复核全部 87 种默认可捕捉原版宠物；另有 2 个自定义示例文件。
修正枯骆驼、猪灵、猪灵蛮兵、硫磺魔方、狼、猫、僵尸马与僵尸鹦鹉螺的默认或模板食物；烈焰人烈焰粉等其余专属规则保留。
原版有明确喂食规则时优先使用原版接受的物品；没有原生食物的生物继续使用生态、掉落物或修复材料作为主题物品。
所有官方食物继续保持 4 点经验。升级不改写旧服已有 growth.foods，需要管理员手动采用新映射。
默认构建与 Paper 26.2 Profile 各 327 项测试通过；隔离服实读新生成文件确认新食物与经验后安全关闭。

完整映射、旧服修改清单和验证结果见 2026-09-04 原版宠物专属食物校准。

2026-09-04 · 0.27.13 · 默认喂食经验平衡

所有官方默认食物的单次经验统一为 4，低于默认配置下最弱目标约 6 点的战斗经验；20 点最大生命的常见目标提供 15 点。
公共配置、狼/猫模板、原版商城模板、全部新生成原版可捕捉宠物和缺失食物补全共用该数值。
附魔金苹果继续提供治疗和属性点，但其喂食经验同样调整为 4，避免高经验喂食替代战斗升级。
旧服已有 growth.foods 不会被覆盖；要采用新平衡时，将相应食物的 experience 手动改为 4。
默认构建与 Paper 26.2 Profile 各 325 项测试通过；Paper 26.2 Build 111 全新生成 89 个宠物文件，公共食物和烈焰人专属食物均验证为 4，重载成功并安全关闭。

配置范围、升级方法和验证记录见 2026-09-04 默认喂食经验平衡。

2026-09-04 · 0.27.12 · Folia 名牌跨区修复

修复 PetNameplateVisibility.hasPlayerPassenger 在旧名牌刷新容错分支中重复访问乘客，导致 Folia/Shiroha owning-region 异常逃出实体任务的问题。
名牌刷新增加区域所有权检查与一次实体下一 tick 重试；最终失败保留当前显示状态并限频记录，不再从异常分支触碰实体。
骑乘状态由挂载事件和宠物区域行为循环提前确认后传入名牌服务，名牌刷新不再为了判断隐藏状态重复扫描乘客树。
多层模型座位遍历只继续访问当前线程拥有的实体；已有骑乘隐藏、下马恢复与自定义名牌配置不变。
默认构建与 Paper 26.2 Profile 各 324 项测试通过；最终 Jar 在 Paper 26.2 Build 111 两次完成插件、SQLite、PlayerPoints 启用及安全关闭。工作区没有 Shiroha/Folia 核心，目标服仍需换 Jar 验收。

原因、升级方法和验证边界见 2026-09-04 Folia 名牌跨区修复。

2026-09-04 · 0.27.11 · 原版食物与成长持久化

全部默认可捕捉原版生物均有独立食物；烈焰人默认使用烈焰粉，其他生物按物种使用鱼、种子、菌类、矿物或对应掉落物。
新安装直接生成完整中文注释食物配置；旧官方原版宠物文件仅在完全缺少 growth.foods 时补全，已有食物节点、数值、注释及自定义宠物文件不覆盖。
同一只宠物在数据库写入期间新增的战斗经验合并为下一批保存，同时保留玩家操作队列顺序；两名玩家同时刷级不会再让大量逐次写入堵住 SQLite 队列。
revision 冲突时重读数据库最新宠物记录并重试，活动宠物三份索引以同一临界区更新；关服回收保存仍会等待已排队的经验批次，避免重启后读回旧等级。
战斗经验保存失败会写控制台警告，并通过可配置的 pet-combat-experience-save-failed 告知在线主人，不再表现成只有宠物币、经验无反馈。
默认兼容构建与 Paper 26.2 Profile 各 321 项测试通过；同一最终 Jar 已在 Paper 26.1.2 Build 70 与 Paper 26.2 Build 111 完成真实 SQLite 启动、状态检查、重载和安全关闭。

配置、升级和验证记录见 2026-09-04 原版食物与成长持久化修复。

2026-09-03 · 0.27.10 · 技能书与敏捷速度

技能书先写入持久预扣台账，再扣除一本并按玩家串行升级；失败、满级、掉线或服务器重启后会退还，不再因连续右键并发覆盖等级。
MySQL 在同一事务内锁定宠物和技能记录；SQLite 与 MySQL 都会拒绝向不存在的宠物写入技能。
实体地面/飞行属性、跟随导航、战斗追击、GUI 与 PlaceholderAPI 统一使用“基础速度 + 敏捷 + 速度技能”的最终值，成长刷新不会再覆盖技能速度。
速度显示最多保留三位小数；默认基础速度 0.25 加 1 点敏捷后显示 0.255，不会再四舍五入为 0.3。
默认兼容构建与 Paper 26.2 Profile 各 315 项测试通过；同一最终 Jar 在 Paper 26.1.2 Build 70、Paper 26.2 Build 111 的真实 SQLite 中完成并发升级与实体速度验证并安全关闭。

配置、升级和验证记录见 2026-09-03 技能书与敏捷速度修复。

2026-09-02 · 0.27.9 · 商城、飞行加速与回收

道具商城余额不足改用独立的 item-shop-insufficient-funds，不再显示“无法购买宠物”；扣款后的发放任务受理后退休也会结束并退款。
基础速度、敏捷和技能加速同时写入实体支持的地面/飞行速度属性；骑乘实时读取疾跑键，并按可配置的 riding-sprint-multiplier 放大水平与飞行俯仰速度。
命令、管理 GUI 和信号棒统一回收反馈；超过 100 tick 提示正在保存，反馈调度失败有日志和独立文本，数据库保存安全顺序保持不变。
默认兼容构建与 Paper 26.2 Profile 各 312 项测试通过；同一最终 Jar 在 Paper 26.1.2 Build 70、26.2 Build 111 各完成 8 轮真实 SQLite 回收，并验证鹦鹉飞行属性及疾跑倍率。

配置、升级和验证记录见 2026-09-02 商城、飞行加速与回收更新。

2026-09-01 · 0.27.8 · 召唤无响应修复

修复实体任务已受理、却在执行前退休时未结束 Future，导致同一玩家的召唤与后续操作长期排队的问题；旧版配置重载不会重建这条运行时队列。
执行、调度拒绝、退休与同步异常统一结束任务；召唤失败按本次最新已保存的 revision 回滚并释放租约，避免首次外观保存后使用旧版本号恢复失败。首个 ACTIVE 写入冲突或同步/异步失败时只释放租约，不猜测版本号覆盖其他记录。
玩家操作队列不在 Map 原子更新中执行业务；同步依赖错误不会毒化后续队列，取消公开返回值不会提前放行仍在进行的数据写入。
合并查询的占位在成功、失败及同步错误后释放，避免查询失败后永久复用一个未完成的结果。
命令与仓库统一反馈；等待超过 100 tick 仅提示一次，可通过 messages.yml -> pet-call-pending: "" 关闭。提示异常与业务失败分开说明，不会因提示出错误报已经成功的召唤。
默认兼容构建（Paper 1.21.11 API、Java 21 字节码）与 Paper 26.2 Profile 各 306 项测试通过，失败、错误和跳过均为 0。同一最终 Jar 在 Paper 26.1.2 Build 70、26.2 Build 111 与真实 SQLite 验证受理后退休、失败回滚到 STORED revision 4、队列继续运行及无需重载重试成功；26.2 狼骑乘回归也通过。未做真人客户端、真实 MEG 画面或 Folia 实服验证。

升级、配置和完整记录见 2026-09-01 召唤无响应修复。0.27.7 的骑乘名牌与持续视角控制修复继续保留。

2026-09-01 · 0.27.7 · 骑乘名牌与视角转向

骑乘隐藏名牌时对骑手及旁观者统一生效，清空载体原版名称；下马恢复，同一个 TextDisplay 不因普通骑乘隐藏而删除重建。
上马立即启动每 tick 控制，按骑手实时视角与当前按键转向，覆盖原地转头及持续按住前进键的情况。
下马、退出和失效骑乘清理控制任务；单行回退也遵守隐藏规则，已有自定义配置保留。
骑乘临时暂停原版感知/方向控制，保留实体 AI 标志与物理动作；下马、异常或换骑恢复原状态。跟随、战斗和延迟回传会检查嵌套座位骑乘，避免抢方向。
重载保留仍在骑乘的感知/坐下状态；管理员在骑乘中调整 AI 或坐下时，不以旧快照覆盖其选择。
默认兼容构建（Paper 1.21.11 API）与 Paper 26.2 Profile 各 264 项测试通过，失败、错误、跳过均为 0。同一 Jar 在 Paper 26.1.2 Build 70 的狼骑乘、26.2 Build 111 的狼及蝙蝠骑乘探针均通过，覆盖名牌、连续转向、重载和多层座位；本轮未验证真人客户端视觉、真实 MEG 或 Folia 运行。

配置及本版验证记录见 2026-09-01 骑乘名牌与视角转向更新。

2026-08-31 · 0.27.6 · 货币名称配置与热重载

config.yml 新增 PlayerPoints / Vault 显示名称，默认“点券 / 金币”，内置货币默认“宠物币”。
三种名称在 /lipet reload 成功后统一更新；关闭再打开两个商城即可看到新名称，已经打开的菜单不自动重绘。
失败或被拒绝的并发重载不发布候选名称；旧配置仅补缺失节点与注释，自定义值和注释保持不变。
shop.yml 支付 ID 仍为 INTERNAL、VAULT、PLAYERPOINTS；价格 100.00、余额、结算规则和启动时读取的服务器身份/群组/初始余额不变。
默认构建与 Paper 26.2 Profile 各 216 项测试通过，失败、错误、跳过均为 0。同一 Jar 在 Paper 26.1.2 / 26.2 + PlayerPoints 3.3.5 已验证服务端双商城 Lore、真实重载和扣款；这不等于真人客户端视觉实测。

配置示例、升级步骤与验证范围见 2026-08-31 货币名称与重载更新日志。

2026-08-30 · 0.27.5 · 等级模型与随机捕捉

ModelEngine 按等级门槛更换模型；原版捕捉四属性随机并持久保存。
道具商城可通过 item.capture-ball 发放真实捕捉球，附普通及 CraftEngine 配置案例。

详情见 2026-08-30 等级模型与随机捕捉更新日志。

历史记录 · 2026-08-26

适用版本：0.26.10-SNAPSHOT

今天的更新由 0.26.8、0.26.9 和 0.26.10 三次迭代组成，集中解决外部模型显示、CraftEngine 物品喂食以及指令冲突问题。

更新摘要

版本	主要改动	服主需要注意
`0.26.8`	修复 ModelEngine / MEG 模型与原版宠物载体重叠	外部模型建议开启 `hide-base-entity`
`0.26.9`	支持使用 CraftEngine 自定义物品喂食	CE 食物必须填写完整 `namespace:item_id`
`0.26.10`	删除 `/lp` 短指令别名	玩家和后台统一使用 `/lipet`

0.26.8：ModelEngine / MEG 模型重叠修复

使用 ModelEngine 模型后，LiPet 仍然需要一个原版实体承载 AI、寻路、属性和交互。旧实现没有可靠隐藏这个载体，因此会出现模型和原版宠物同时显示。

本次更新加入：

使用 ModelEngine 载体可见性接口隐藏原版实体外观，不使用隐身药水伪装。
隐藏外观不会关闭宠物 AI、感知、寻路和战斗能力。
重复召唤、区块重新加载和运行状态恢复时复用已有模型，避免重复叠加。
/lipet reload 后刷新已召唤宠物的模型配置。
修改模型 ID 时，先卸载本轮运行期记录的旧模型，再挂载新模型。
模型载体隐藏和模型碰撞箱覆盖可以分别控制。

推荐配置：

types:
  wolf:
    model:
      provider: "MODEL_ENGINE"
      id: "magecat"
      # 隐藏原版载体外观，但保留 LiPet AI 与寻路。
      hide-base-entity: true
      # 使用 ModelEngine 蓝图碰撞箱。
      override-hitbox: true

如果仍然出现原版宠物：

确认 provider 为 MODEL_ENGINE。
确认 hide-base-entity: true。
执行 /lipet reload，再重新召唤宠物。
检查 ModelEngine 是否为支持当前 Paper 26.x NMS 的更新构建。

0.26.9：CraftEngine 自定义物品喂食

宠物食物现在同时支持：

原版 Bukkit Material，例如 BEEF、COOKED_BEEF。
CraftEngine 完整自定义物品 ID，例如 default:pet_biscuit。
ID 中含点号的 CraftEngine 物品，例如 my.pack:pet.food。

配置示例：

types:
  wolf:
    foods:
      beef:
        material: "BEEF"
        display-name: "生牛肉"
        experience: 20
        healing: 6.0

      pet-biscuit:
        # 必须填写完整命名空间 ID，不能只写 pet.food。
        item-id: "my.pack:pet.food"
        display-name: "灵宠饼干"
        experience: 35
        healing: 8.0
        attribute-points: 0
        minimum-level: 1
        maximum-level: 0

识别规则：

CraftEngine 物品按完整 ID 精确匹配，不按底材 Material 猜测。
即使 CE 物品和原版物品都使用同一种底材，也只会消耗配置中指定的物品。
简单 ID 可以直接作为食物节点名；ID 含 . 时使用普通节点名并填写 item-id。
未安装 CraftEngine 时不会禁用 LiPet，原版食物继续正常使用。
CraftEngine 重载物品后无需重启 LiPet；插件每次交互都会读取当前物品 ID，不缓存旧物品实例。
不满足等级要求、没有产生有效效果或数据保存失败时，不会吞掉玩家物品。

0.26.10：取消 `/lp` 指令别名

LiPet 现在只注册 /lipet 主指令。

已移除：

/lp
/lipet:lp

保留：

/lipet
Bukkit 命名空间指令 /lipet:lipet
原有全部 /lipet 子指令、权限和 Tab 补全

这样不会再与 LuckPerms 等权限插件常用的 /lp 主指令发生冲突。旧菜单、NPC 或脚本如果仍在执行 /lp，需要改成 /lipet。

兼容与验证记录

检查项	结果
Paper `26.1.2` Build 70	通用 Jar 启动与功能探针通过
Paper `26.2` Build 111	通用 Jar 启动、指令与安全关闭通过
ModelEngine R4.1.0 更新构建	`magecat` 模型载体隐藏、幂等恢复和卸载恢复通过
CraftEngine `26.8-SNAPSHOT`	CE 完整 ID 与同底材原版物品区分通过
`0.26.8` 自动测试	68 项通过
`0.26.9` 自动测试	72 项通过
`0.26.10` 自动测试	73 项通过

ModelEngine 即使显示版本相同，不同构建支持的 NMS 版本也可能不同。若出现 Unsupported NMS Version，需要升级 ModelEngine，而不是关闭 LiPet 的宠物 AI。

升级步骤

停服并备份 plugins/LiPet/、SQLite 文件或 MySQL 数据库。
删除旧 LiPet Jar，只保留 LiPet-0.26.10-SNAPSHOT.jar。
启动服务器，等待配置缺失节点自动补齐。
执行 /lipet status，确认插件版本、数据库目标和外部 Hook 状态。
使用 MEG 模型时检查 hide-base-entity 与 override-hitbox。
使用 CE 食物时检查完整 item-id，再用同底材原版物品做一次反向测试。
检查菜单、NPC 和脚本，确保没有继续调用 /lp。

不要使用插件管理器热卸载或热加载 LiPet。普通配置可使用 /lipet reload，更换 Jar 必须完整重启服务器。

上线前快速检查

召唤 MEG 宠物后只显示模型，不显示脚下原版实体。
宠物仍能跟随、绕障、攻击、召回和收回。
CE 食物可增加经验或生命，未配置的同底材物品不会被消耗。
/lipet 正常，/lp 交还给 LuckPerms 或显示未知指令。
重启服务器后宠物、背包、属性和货币数据仍然存在。