- 版权类型
- 原创
- 插件中文名称
- 灵宠插件
- 插件英文名称
- LingPet-Original-3.0.0
- 原帖地址
- #
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 适配版本（Java）
- 1.12
功能特点
- 在 pets.yml 中创建任意数量的实体灵宠；
- 灵宠协同攻击主人目标，不攻击玩家；
- 六个独立装备槽及实体装备外观同步；
- 从Lore读取生命、攻击、防御、恢复和等级要求；
- 装备标签和每个槽位允许的类型均可配置；
- 原版等级、PAPI等级、固定等级或关闭限制；
- 默认内置伤害结算，可选接入AttributePlus；
- 玩家与灵宠双向防误伤，灵宠关闭实体碰撞；
- 目标实体类型和Metadata黑名单可配置；
- 每名玩家独立YAML、原子替换、备份回退；
- 仅更新已召唤的灵宠，不扫描全世界实体；
- 玩家离线立即保存并卸载缓存；
- 无联网、无QQ验证、无机器码、无遥测、无远程控制。
环境与依赖
- 服务端：Spigot/Paper 1.12.2
- Java字节码：Java 8
- 必须前置：无
- 可选前置：PlaceholderAPI、AttributePlus
完整指令
主命令为 /lingpet，可以使用简写 /lpet
| 指令 | 使用者 | 功能 |
|---|---|---|
| /lpet | 玩家/控制台 | 查看当前可用的指令帮助 |
| /lpet summon | 玩家 | 召唤当前已经选择的灵宠 |
| /lpet recall`| 玩家 | 主动收回当前灵宠，不会触发重伤冷却 |
| /lpet menu | 玩家 | 打开当前灵宠的六槽装备界面 |
| /lpet status | 玩家 | 查看当前灵宠的生命、攻击、防御和装备数量 |
| /lpet give <玩家> <灵宠ID>`| 管理员/控制台 | 向在线玩家发放指定灵宠的契约 |
| /lpet reload | 管理员/控制台 | 重载 config.yml 与 pets.yml，并安全保存已经变更的数据 |
示例：
/lpet give Steve forest_wolf
/lpet summon
/lpet menu
/lpet status
/lpet recall
/lpet reload
权限节点
| 权限 | 默认拥有者 | 作用 |
|---|---|---|
| lingpet.use | 所有玩家 | 使用契约、召唤、收回、查看状态和装备界面 |
| lingpet.admin`| OP | 发放契约和重载插件 |
如果使用权限插件，可以直接将 lingpet.use 给予普通玩家，将 lingpet.admin 仅给予管理组。
配置文件
- config.yml：战斗后端、等级来源、装备Lore标签、槽位类型、冷却、性能周期、消息与目标过滤。
- pets.yml：灵宠ID、实体类型、名称、基础属性、跟随参数、攻击距离和契约物品。
- players/<UUID>.yml：玩家选择、灵宠生命、冷却和六槽装备，由插件自动维护。
- players/<UUID>.bak：玩家数据自动备份，不需要手动编辑。
新增灵宠后，可以通过 `/lpet reload` 载入，无需重启服务器。
装备Lore格式
LingPet不强制依赖任何物品插件。SX-Item、MMOItems、自制物品或指令生成物品，只要Lore符合配置即可识别：
默认提供主武器、头部、身体、腿部、足部和副手六个槽位。属性名称和槽位允许的类型都能在 config.yml 修改。
PlaceholderAPI变量
安装PlaceholderAPI后自动注册以下变量，同时支持 lingpet 与 lpet 两个标识：
| 变量 | 内容 |
|---|---|
| %lingpet_name% | 当前灵宠名称 |
| %lingpet_level% | 当前读取到的装备等级 |
| %lingpet_summoned% | 是否已经召唤，返回 true 或 false |
| %lingpet_health% | 当前生命 |
| %lingpet_max_health% | 最大生命 |
| %lingpet_attack% | 总攻击力 |
| %lingpet_defense% | 总防御力 |
| %lingpet_regeneration% | 每秒生命恢复 |
| %lingpet_rating%`| 综合属性评分 |
| %lingpet_gear_count% | 已穿戴装备数量 |
例如 %lpet_attack%` 与 `%lingpet_attack%` 的结果相同。
## 灵宠契约说明
管理员通过 `give` 指令发放契约。玩家右键契约时会选择对应灵宠：
- 当前未召唤：选择并召唤该灵宠；
- 当前已经召唤同一只灵宠：将其收回；
- 使用另一种契约：先安全收回旧灵宠，再选择并召唤新灵宠；
- 主动收回和切换不会触发死亡冷却；
- 只有生命归零、真正被击败才会进入配置的休养时间。
压缩包包含配置示例、使用文档、源码和独立实现说明，便于服主进行安全审计。
- 在 pets.yml 中创建任意数量的实体灵宠；
- 灵宠协同攻击主人目标，不攻击玩家；
- 六个独立装备槽及实体装备外观同步；
- 从Lore读取生命、攻击、防御、恢复和等级要求；
- 装备标签和每个槽位允许的类型均可配置；
- 原版等级、PAPI等级、固定等级或关闭限制；
- 默认内置伤害结算，可选接入AttributePlus；
- 玩家与灵宠双向防误伤，灵宠关闭实体碰撞；
- 目标实体类型和Metadata黑名单可配置；
- 每名玩家独立YAML、原子替换、备份回退；
- 仅更新已召唤的灵宠，不扫描全世界实体；
- 玩家离线立即保存并卸载缓存；
- 无联网、无QQ验证、无机器码、无遥测、无远程控制。
环境与依赖
- 服务端：Spigot/Paper 1.12.2
- Java字节码：Java 8
- 必须前置：无
- 可选前置：PlaceholderAPI、AttributePlus
完整指令
主命令为 /lingpet，可以使用简写 /lpet
| 指令 | 使用者 | 功能 |
|---|---|---|
| /lpet | 玩家/控制台 | 查看当前可用的指令帮助 |
| /lpet summon | 玩家 | 召唤当前已经选择的灵宠 |
| /lpet recall`| 玩家 | 主动收回当前灵宠，不会触发重伤冷却 |
| /lpet menu | 玩家 | 打开当前灵宠的六槽装备界面 |
| /lpet status | 玩家 | 查看当前灵宠的生命、攻击、防御和装备数量 |
| /lpet give <玩家> <灵宠ID>`| 管理员/控制台 | 向在线玩家发放指定灵宠的契约 |
| /lpet reload | 管理员/控制台 | 重载 config.yml 与 pets.yml，并安全保存已经变更的数据 |
示例：
/lpet give Steve forest_wolf
/lpet summon
/lpet menu
/lpet status
/lpet recall
/lpet reload
权限节点
| 权限 | 默认拥有者 | 作用 |
|---|---|---|
| lingpet.use | 所有玩家 | 使用契约、召唤、收回、查看状态和装备界面 |
| lingpet.admin`| OP | 发放契约和重载插件 |
如果使用权限插件，可以直接将 lingpet.use 给予普通玩家，将 lingpet.admin 仅给予管理组。
配置文件
- config.yml：战斗后端、等级来源、装备Lore标签、槽位类型、冷却、性能周期、消息与目标过滤。
- pets.yml：灵宠ID、实体类型、名称、基础属性、跟随参数、攻击距离和契约物品。
- players/<UUID>.yml：玩家选择、灵宠生命、冷却和六槽装备，由插件自动维护。
- players/<UUID>.bak：玩家数据自动备份，不需要手动编辑。
新增灵宠后，可以通过 `/lpet reload` 载入，无需重启服务器。
装备Lore格式
LingPet不强制依赖任何物品插件。SX-Item、MMOItems、自制物品或指令生成物品，只要Lore符合配置即可识别：
默认提供主武器、头部、身体、腿部、足部和副手六个槽位。属性名称和槽位允许的类型都能在 config.yml 修改。
PlaceholderAPI变量
安装PlaceholderAPI后自动注册以下变量，同时支持 lingpet 与 lpet 两个标识：
| 变量 | 内容 |
|---|---|
| %lingpet_name% | 当前灵宠名称 |
| %lingpet_level% | 当前读取到的装备等级 |
| %lingpet_summoned% | 是否已经召唤，返回 true 或 false |
| %lingpet_health% | 当前生命 |
| %lingpet_max_health% | 最大生命 |
| %lingpet_attack% | 总攻击力 |
| %lingpet_defense% | 总防御力 |
| %lingpet_regeneration% | 每秒生命恢复 |
| %lingpet_rating%`| 综合属性评分 |
| %lingpet_gear_count% | 已穿戴装备数量 |
例如 %lpet_attack%` 与 `%lingpet_attack%` 的结果相同。
## 灵宠契约说明
管理员通过 `give` 指令发放契约。玩家右键契约时会选择对应灵宠：
- 当前未召唤：选择并召唤该灵宠；
- 当前已经召唤同一只灵宠：将其收回；
- 使用另一种契约：先安全收回旧灵宠，再选择并召唤新灵宠；
- 主动收回和切换不会触发死亡冷却；
- 只有生命归零、真正被击败才会进入配置的休养时间。
压缩包包含配置示例、使用文档、源码和独立实现说明，便于服主进行安全审计。
