原创 娱乐 pmPets-头颅宠物 1.1.1

我发现市面上居然没有免费的宠物插件，那我来写一个吧，第一次写，写的不好勿喷啊，



pmPets 宠物插件 Wiki

版本：1.0.0 | 作者：Pm | 适用：Paper 1.20+

一、核心简介

功能完整的自定义宠物插件，支持宠物收集、装备、升级、喂食、商店交易，搭配AttributePlus属性加成、粒子特效、GUI可视化操作，兼容主流附属插件，支持多宠物仓库管理。

二、安装与前置

必需前置

Paper 1.20+ 服务端

可选前置（按需安装）

- PlaceholderAPI（占位符）
- AttributePlus 3.3+（属性加成）
- Vault（经济商店）
- MythicMobs/NeigeItems（自定义饲料）

安装步骤

1. 插件jar放入plugins文件夹
2. 重启服务器/Plugman加载
3. 配置文件编辑后，执行 /pmpets admin reload 重载

三、核心命令

玩家基础命令

- /pmpets ：打开宠物仓库
- /pmpets menu ：打开宠物选择菜单
- /pmpets shop ：宠物商店
- /pmpets shopfood ：饲料商店
- /pmp<宠物名> ：召唤宠物
- /pmpets hide ：隐藏宠物
- /pmpets help ：查看帮助

管理员命令

- /pmpets admin give <玩家> <宠物ID> ：发放宠物
- /pmpets<玩家> 物品ID 数量 ：发放饲料
- /pmpets admin reload ：重载配置
- /pmpets admin set/delete/remove ：强制设置/删除/移除玩家宠物

四、权限节点

- 基础权限： pmpets.player （包含所有玩家功能权限）
- 单宠物权限： p<宠物ID>
- 管理员总权限： pmpets.admin

五、核心配置文件速览

1. config.yml：主配置，设置宠物距离、速度、数据库、消息格式、显示规则
2. pets.yml：宠物核心配置，设置ID、名称、头颅纹理、价格、权限、外观参数
3. levels.yml：等级配置，设置升级经验、AP属性、等级解锁粒子特效
4. feeding.yml：饲料配置，支持原版/MM/NI物品，自定义喂食经验、商店价格
5. groups.yml：宠物组配置，批量统一宠物外观、位置参数
6. messages.yml/menu.yml：自定义消息、GUI布局

六、核心功能说明

宠物系统

- 可拥有多只宠物，同时仅能装备1只
- 获取方式：商店购买、管理员发放、权限解锁
- 操作：仓库左键装备/取下，右键打开宠物详情

升级系统

- 喂食获取经验，满经验自动升级
- 等级属性叠加生效，高等级继承低等级属性
- 指定等级可解锁专属粒子特效，永久生效

喂食系统

- 三种方式：手持饲料右键宠物、GUI内点击喂食、管理员发放
- 支持原版物品、MythicMobs、NeigeItems三类饲料

商店系统

- 宠物商店：购买解锁宠物，支持Vault经济/经验支付
- 饲料商店：直接购买饲料，自动入背包

属性加成（AttributePlus）

- 装备宠物自动生效属性，取下自动移除
- 等级越高属性越强，属性名需与AP注册名完全一致

粒子特效

- 等级解锁，支持彩色粉尘、火焰、符文等20+粒子类型
- 彩色粒子支持自定义配色，高等级可覆盖低等级粒子效果

占位符（PAPI）

核心占位符： %pmpets_pet_name% （当前宠物名）、 %pmpets_has_pet% （是否携带宠物）、 %pmpets_pet_description% （宠物描述）

七、数据库配置

- 默认SQLite：开箱即用，数据存插件目录db文件
- MySQL模式：修改config.yml开启，支持多服数据同步，自动建表

八、常见问题速解

1. 宠物不显示：检查可视距离配置、客户端粒子权限
2. 属性不生效：确认AP版本、属性名匹配、重载后重新装备宠物
3. 商店无法购买：检查经济插件、玩家余额/经验
4. 配置不生效：必须执行admin reload重载
5. 数据安全：备份插件文件夹即可完整备份数据

九、支持渠道
QQ交流群：484612573
插件的wiki
https://www.yuque.com/u66555201/uumqpl/xu3kcw0mlt42yu7n?singleDoc# 《pmPets-Wiki》