2026-08-29 仓库四键与宠物类型目录

潜行左键真正收回宠物，潜行右键放生，并支持中文目录与多个宠物类型 YML。

日期：2026-08-29

版本：0.26.24-SNAPSHOT

仓库操作提示

仓库宠物图标默认显示四条独立操作：

- "<aqua>左键</aqua><gray> · 召唤宠物伙伴</gray>"
- "<aqua>右键</aqua><gray> · 查看属性与管理</gray>"
- "<aqua>潜行左键</aqua><gray> · 召回宠物</gray>"
- "<red>潜行右键</red><gray> · 放生宠物</gray>"

普通左键继续使用 call:<pet_id> 召唤所选宠物。
潜行左键从旧默认 call:<pet_id> 改为 store，会真正收回当前已召唤宠物。
潜行右键只打开永久放生二次确认，不会首次点击直接删除。
仅精确迁移官方旧 Lore、旧默认潜行左键动作和对应官方注释，服主自定义内容保持不变。

中文目录与多文件读取

pet-types.yml 新增：

type-files:
  enabled: true
  directory: "宠物类型"
  include-subdirectories: true

目录名、文件名和子目录名均支持中文。
读取目录内全部 .yml 与 .yaml；默认递归读取中文子目录。
每个文件使用 types.<英文类型ID> 格式，一个文件可以定义一个或多个宠物类型。
新服务器首次启动会生成 宠物类型/狼.yml 与 宠物类型/猫.yml。
旧服务器目标目录尚不存在时，会把 pet-types.yml 中每个旧类型原样拆成独立文件，再清空兼容 types 节点。
若服主已经创建目标目录，插件不会擅自移动或覆盖；旧单文件格式仍可继续读取。
重复类型 ID、越界目录、无效 YML 或缺少 types 节点都会给出包含来源文件名的错误。

验证

Paper 26.2 Profile 共 131 项自动测试通过，失败、错误和跳过均为 0。
测试覆盖中文目录、中文文件名、递归多文件读取、非递归模式、路径越界拒绝、旧格式拆分、注释保留、官方 Lore/动作/注释迁移和自定义保护。
Paper 26.2 Build 111 + Java 25 + PlayerPoints 3.3.5 的旧服升级验证中，狼、猫配置成功拆为 宠物类型/wolf.yml 与 cat.yml，全局旧 types 清空，仓库四键 Lore、动作和官方注释迁移正确。
同环境全新安装会生成 宠物类型/狼.yml 与 宠物类型/猫.yml，多文件热重载成功，/lipet status 显示 PlayerPoints ONLINE，两轮均安全关闭且 LiPet 自身日志无报错。
当前没有在线客户端，仓库最终视觉和四种实际点击仍需目标测试服确认。

成品

文件：target/LiPet-0.26.24-SNAPSHOT.jar
大小：726809 字节
SHA-256：F57634F05DD8E1C68AD0A405289153DA706F17F93CB94810915B9E386B7169DD