功能路线图

0.29.0 养成扩展进度

已完成骑乘迈步/朝向、命名规则、多行名牌，以及捕捉品质、性格与闪光持久化。 材料进化和挖矿/伐木/采集派遣仍为后续批次，尚未包含在当前成品。

已纳入的目标

• MySQL 群组存储与 SQLite 单服存储。
• 99% 配置化 GUI。
• 原生实体与 ModelEngine 活体模型提供器；CraftEngine 完整物品提供器。
• MiniMessage 与 RGB 宠物名称。
• 双行主人名牌与宠物传送后的 TextDisplay 生命周期修复。
• 单宠召唤上限的独立中文反馈与官方旧语言安全迁移。
• 主菜单“我的宠物”入口与“打开宠物列表”语义化文案迁移。
• 仓库左键召唤、右键管理、潜行左键收回、潜行右键放生的四键独立动作与提示；潜行操作统一绿色，永久删除警告独立为红色段落。
• 管理页打开的完整属性与成长加点面板会保留宠物上下文，返回时回到同一只宠物的管理页。
• 支持中文命名目录、中文子目录和多个 YML 的宠物类型配置存储。
• 每个宠物类型可独立配置 MythicMobs 技能，按宠物等级解锁，并支持触发器、概率、独立冷却、失败退避与 power 成长。
• 被动药水、攻击、防御、跳跃、飞行、火球、定时命令等能力。
• 宠物商城、仓库、升级、物品、箱子抽取和玩家交易。
• 内置货币、Vault 和 PlayerPoints 多货币，商城展示名称与配置 ID 分离。
• 权限自动发放与权限失效回收。
• PlaceholderAPI 变量。
• 全量数据自动备份。

模块边界

catalog     宠物商品定义和上架规则
warehouse   玩家拥有的宠物和仓库容量
currency    内置/Vault/PlayerPoints 统一交易接口
ability     触发器、冷却、概率和能力执行器
model       Native/ModelEngine 活体模型适配
item        Bukkit/CraftEngine 物品识别、生成、索引与重载适配
gui         配置化页面、元素和动作
crate       宠物箱和权重随机
trade       玩家交易会话与双向确认
backup      SQLite/MySQL 全量备份与保留策略

模型配置

每个宠物类型使用统一模型配置：

model:
  provider: "MODEL_ENGINE"
  id: "dragon_pet"

NATIVE 不需要模型 ID。ModelEngine 通过反射适配，API 不打入 LiPet。 CraftEngine 26.8.1 的稳定 API 当前提供物品、方块与家具能力，没有 LiPet 活体宠物模型控制接口，因此不再把它列为宠物模型提供器。CE 使用独立物品 Provider，已完成识别、生成、索引、重载事件及全部 LiPet 物品入口的实服适配；活体外观继续使用 NATIVE 或 MODEL_ENGINE。

能力设计

能力通过触发器组合，而不是写死在宠物类中：

• PASSIVE：持续药水效果。
• OWNER_ATTACK：主人攻击时触发。
• OWNER_DEFEND：主人受伤时触发。
• PET_ATTACK：宠物攻击时触发。
• PET_DEFEND：宠物受伤时触发。
• INTERACT：玩家主动交互。
• INTERVAL：按周期执行。

每项能力统一支持：

chance       触发概率
cooldown     冷却时间
conditions   世界、权限、目标类型等条件
actions      药水、伤害、位移、火球、飞行、命令等动作

MythicMobs 技能作为可选外部动作接入，不把 MM API 打入 LiPet。技能直接放在对应的 宠物类型/*.yml 中，支持用 unlock-level 控制解锁等级，并通过 power-per-level 让 MM 技能威力随宠物等级成长。冷却判断位于概率抽取前，定时触发一次扫描两种周期规则；失败技能保留配置冷却并有最短退避，状态指令可查看已载入类型数和规则数。

实施顺序

1. SQLite Repository 与存储迁移。
2. ModelEngine 实服适配和模型配置。
3. 宠物目录、仓库及数据库表。
4. 内置货币与统一多货币接口。
5. 配置化 GUI 和商城。
6. 能力触发器及预装能力。
7. 升级、宠物物品和权限宠物。
8. 宠物箱与玩家交易。
9. 自动备份和恢复验证。
10. CraftEngine 26.8.1 完整物品挂钩与 Paper 26.1.2 / 26.2 实服验证（已完成）。