玩家入门

在宠物设置中开关主动攻击

召唤宠物后，潜行空手右键自己的宠物，在管理菜单点击“主动攻击”。按钮显示这只宠物的当前状态；默认开启，选择会单独保存，召回、重进和正常重启后保留。

关闭后宠物继续跟随，停止主动索敌、援助反击和自动战斗技能；再次开启也仍遵守服务器的物种与区域规则。手动技能需要冷却结束并满足原有目标要求。详见 主动攻击开关说明。

本页从 LiPet 0.27.1-SNAPSHOT 完整 Wiki 同步整理；需要连续查阅全部功能时，请返回 LiPet 完整 Wiki。

1. 插件定位

LiPet 是一个面向群组服的宠物插件，目标是提供完整、可配置的宠物体验，同时保持 Paper 26.x 可维护兼容。

当前核心能力：

• 宠物创建、召唤、收回、放生、改名
• 宠物商城、道具商城、宠物仓库 GUI
• 每日领取、宠物战斗、升级与捕捉宠物币奖励
• 捕捉球与捕捉仪式
• 宠物等级、经验、属性点和衍生战斗属性
• 达到指定等级后自动解锁的 MythicMobs 宠物技能
• 宠物喂养、战斗经验、死亡冷却
• 宠物骑乘、坐下 / 跟随切换
• 每只宠物独立背包
• 宠物信号棒
• SQLite / MySQL 持久化
• Redis 群组同步预留
• Vault / PlayerPoints / PlaceholderAPI / ModelEngine / CraftEngine 软兼容

5. 玩家指令

0.26.10-SNAPSHOT 起只注册 /lipet 主指令，不再提供 /lp 别名，也不会再生成 /lipet:lp，避免与 LuckPerms 等权限插件冲突。

指令	说明
/lipet	玩家默认打开宠物中心；控制台默认显示帮助
/lipet menu	打开宠物中心
/lipet shop	打开宠物商城
/lipet itemshop	打开宠物道具商城
/lipet warehouse	打开宠物仓库
/lipet balance	查看宠物币余额
/lipet top <coin|level> [页码]	查看宠物币或宠物等级排行榜
/lipet daily	领取每日宠物币
/lipet call <宠物名称>	召唤仓库中的宠物
/lipet store	收回当前已召唤宠物
/lipet sit	当前宠物坐下 / 继续跟随
/lipet mount	骑乘当前已召唤宠物
/lipet inventory [宠物名称]	打开当前或指定宠物背包
/lipet rename [宠物名称]	进入聊天框改名模式
/lipet release [宠物名称]	永久放生宠物
/lipet delete [宠物名称]	永久删除宠物
/lipet info <宠物名称>	查看宠物属性
/lipet help [页码]	查看帮助

宠物中心主菜单中的入口显示为“我的宠物”，按钮下方提示“➥ 点击打开宠物列表”；点击后进入宠物仓库列表，可召唤、查看、管理或放生自己的宠物。

在宠物仓库中，左键召唤所选宠物，右键打开属性与管理，潜行左键收回当前已召唤宠物，潜行右键进入永久放生二次确认。两条潜行操作默认使用绿色提示，红色 ⚠放生会永久删除全部数据 会独立显示在操作说明下方；放生不会在第一次点击时直接执行。

从宠物管理界面点击“完整属性”或“成长与加点”后，属性面板底部会显示“返回管理界面”；点击后回到同一只宠物的管理页，不需要关闭菜单再潜行右键宠物。从仓库或指令进入属性面板时仍返回宠物仓库。

同一时间只能召唤一只宠物。已有宠物正在跟随时，再使用 /lipet call 或仓库召唤另一只会提示“已达最大召唤数量，请将已召唤的休息后再召唤！”。先执行 /lipet store 或使用仓库收回功能让当前宠物休息，再召唤新的宠物。

0.27.8 起，命令与仓库共用召唤提示。操作未完成超过 100 tick（正常 TPS 下约 5 秒）时才提示一次“正在召唤”，请等待结果，无需重复点击；服主可以关闭这条等待提示。看到“召唤结果提示异常”时，应先检查宠物是否已经出现，再联系管理员查看日志，这条消息不代表宠物一定没有生成。旧版偶发无反应且重载无效的问题需要服主换用新 Jar 后重启，详见 0.27.8 召唤无响应修复。

服主为某种宠物配置 MythicMobs 等级技能后，玩家无需使用额外指令或技能书；宠物达到要求等级便会自动解锁。技能可在主人或宠物战斗、主人交互及定时行为中触发，具体等级、概率和冷却由服务器配置决定。

8. 宠物类型

宠物类型默认存放在 plugins/LiPet/宠物类型/ 目录。目录、文件和子目录均可使用中文，并可同时放置多个 .yml / .yaml；全局开关仍位于 pet-types.yml：

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

宠物类型/狼.yml 示例：

types:
  wolf:
    entity-type: "WOLF"
    display-name: "狼"
    enabled: true
    owner-limit: 1
    model:
      provider: "NATIVE"
      id: ""
      hide-base-entity: true
      override-hitbox: true
    behavior:
      follow-enabled: true
      follow-distance: 10.0
      stop-distance: 3.0
      teleport-distance: 30.0

说明：

• entity-type 必须是当前 Paper 版本存在的 Bukkit 实体类型。
• owner-limit 当前固定用于“一种宠物只能拥有一只”的限制。
• model.provider 支持 NATIVE、MODEL_ENGINE、CRAFT_ENGINE。
• model.hide-base-entity 仅在外部模型提供器中生效；ModelEngine/MEG 建议保持 true，它只隐藏原版载体外观，不会关闭宠物 AI。
• model.override-hitbox 控制 ModelEngine 是否使用模型蓝图碰撞箱；它与隐藏原版外观是两个独立选项。
• auto-register-vanilla: true 时会自动注册可生成的原版实体宠物类型。
• follow-distance 是开始追赶距离，stop-distance 是停止追赶距离；后者必须更小，避免宠物在临界点反复启停。
• 超过 teleport-distance 时只会在主人落地且未飞行、未滑翔时安全回传；回传带有短冷却，避免异步传送失败时连续刷传送。
• 原生寻路连续拒绝路径时，宠物会在主人安全落地后回传，不会停在原地，也不会使用速度强拖穿过障碍。

ModelEngine / MEG 模型

给宠物使用 ModelEngine 模型时，至少填写：

model:
  provider: "MODEL_ENGINE"
  id: "你的模型ID"
  hide-base-entity: true
  override-hitbox: true

hide-base-entity: true 会通过 ModelEngine 的载体可见性接口隐藏脚下的原版生物，同时继续使用该实体承载 LiPet 的 AI、寻路、属性与碰撞。不要用隐身药水代替这个选项。重复召唤、区块重新加载和宠物运行状态恢复都会复用已有同 ID 模型，不会再次叠加；修改模型配置后执行 /lipet reload，当前已召唤宠物也会在其实体线程刷新。若将 id 改成另一个模型，插件会先卸载本轮运行期记录的旧模型再挂载新模型。

ModelEngine 的显示版本同为 R4.1.0 时，不同构建支持的 NMS 版本仍可能不同。Paper 26.x 必须安装包含 Java 25 / 26.x NMS 适配层的更新构建；若控制台出现 Unsupported NMS Version: 26.1.2 或类似错误，是当前 ModelEngine 构建不支持服务端版本，应先升级 ModelEngine。LiPet 不会把 ModelEngine 打进自身 Jar。

双行宠物名牌

召唤后的宠物默认使用两行头顶文字：第一行是宠物名称，第二行是主人玩家名。配置位于 pet-types.yml 顶层：

nameplate:
  enabled: true
  owner-line: "<gradient:#7DD3FC:#C4B5FD>主人：</gradient><white><owner_name></white>"
  vertical-offset: 0.55
  view-range: 1.0
  line-width: 200
  text-opacity: 255
  shadowed: true
  see-through: false
  default-background: false
  background-color: "#00000000"
  hide-while-ridden: true

riding:
  hide-boss-bar-while-ridden: true

• owner-line 支持 MiniMessage、RGB、渐变和 <owner_name> 占位符。
• enabled: false 会删除双行显示实体并恢复原版单行宠物名称。
• hide-while-ridden 只对骑手隐藏原有双行名牌，不再删除重建；riding.hide-boss-bar-while-ridden 控制凋零、末影龙等 Boss 血条，下坐骑后都会自动恢复。
• 修改后执行 /lipet reload，已召唤宠物会在下一轮行为刷新时自动应用新样式。
• 名牌使用独立 PDC 关联宠物实体；区块重新载入时会校验并恢复，传送导致挂载脱离时会自动重建，死亡、收回和放生时会同步删除，不写入宠物数据库。

15. 改名

命令：

/lipet rename [宠物名称]

流程：

1. 执行命令或在管理 GUI 点击改名。
2. 插件提示进入聊天框输入模式。
3. 玩家直接在聊天框输入新名称。
4. 输入 取消 或 cancel 可退出。
5. 60 秒未输入会自动超时。

18. 骑乘

方式：

• 空手右键自己的已召唤宠物。
• 使用 /lipet mount。
• 使用信号棒骑乘模式。

LiPet 会识别末影龙翅膀、头部和身体部件，空手右键可骑乘，潜行空手右键可打开管理界面。0.26.17+ 将末影龙稳定为悬停阶段，骑手可用方向键与视角俯仰控制飞行；骑乘时按配置隐藏名牌和 Boss 血条。

骑乘参数写在对应的 宠物类型/*.yml 中；Boss 血条隐藏总开关位于 pet-types.yml：

behavior:
  riding-speed: 0.35
  jump-velocity: 0.5