Drwei 的宠物管理器 (Drwei's PetManager)

一个功能强大的 Paper Minecraft 服务器宠物管理插件。该插件允许玩家绑定生物作为宠物，支持自定义名称、颜色、行为模式、药水效果、属性修改、团队共享，以及 TRUCK 碰撞伤害模式和 RIDEABLE 骑乘模式等高级功能。

功能特性

核心功能

宠物绑定: 绑定任何活体生物作为你的宠物，支持自定义名称和颜色
自定义名称和颜色: 支持 Minecraft 颜色代码、颜色名称和十六进制颜色
行为模式: 跟随、停留、攻击、守护、游荡
药水效果: 为宠物应用自定义药水效果
属性修改: 修改宠物属性，如生命值、速度、伤害等
宠物重生: 重生死亡的宠物并保留所有数据
团队系统: 与团队成员共享宠物

高级功能

TRUCK 模式（大运模式）: 骑乘宠物时的碰撞伤害系统
- 普通模式: 基于速度的伤害（0-255）
- 秒杀模式（颗秒模式）: 始终造成 255 伤害
RIDEABLE 模式: 骑乘任何生物，包括飞行生物
- WASD 控制移动
- 空格键跳跃/上升
- Shift 键退出骑乘
- 飞行生物支持垂直移动
无敌模式: 应用所有正面药水效果并设置最大生命值为 2048
自动保存: 每 5 分钟自动保存数据
动态配置: 无需重启服务器即可调整设置
多语言支持: 英语和中文

安装

从发布页面下载最新版本
将 DrweiPetManager-<版本>.jar 文件放入服务器的 plugins 文件夹
重启服务器
在 plugins/DrweiPetManager/config.yml 中配置插件

系统要求

Minecraft 版本: 1.21.1
服务器类型: Paper API 1.21.1 或更高版本
Java 版本: 21

命令

玩家命令

命令	描述	权限
`/pet`	显示帮助信息	`petbinder.use`
`/pet bind <type> <distance> <name> [public] [color]`	绑定生物作为宠物	`petbinder.bind`
`/pet list`	列出你的宠物	`petbinder.list`
`/pet portal [index]`	将宠物传送到你身边	`petbinder.portal`
`/pet rename <index> <name> [color]`	重命名宠物	`petbinder.rename`
`/pet team <create	join	leave
`/pet behavior <index> <follow	stay	attack
`/pet effect <index> <effect\|invincible> [duration] [amplifier]`	应用药水效果	`petbinder.effect`
`/pet attribute <index> [attribute] [value]`	修改宠物属性	`petbinder.attribute`
`/pet unbind [index]`	释放宠物	`petbinder.unbind`
`/pet respawn`	重生死亡的宠物	`petbinder.respawn`
`/pet version`	显示插件版本	`petbinder.use`

管理员命令

命令	描述	权限
`/pet op list`	列出服务器上所有宠物	`petbinder.op`
`/pet op remove <player>`	移除指定玩家的所有宠物	`petbinder.op`
`/pet op config <action> [args]`	动态配置	`petbinder.op`
`/pet op reload`	重新加载配置	`petbinder.op`
`/pet op save`	手动保存宠物数据	`petbinder.op`
`/pet op load`	手动加载宠物数据	`petbinder.op`

配置

基本配置

language: zh                    # 语言: en 或 zh
max-bind-distance: 10          # 最大绑定距离（方块）
teleport-with-owner: true      # 宠物随主人传送
protect-from-all-damage: false # 宠物受到全伤害保护
remove-on-quit: false          # 主人退出时移除宠物

权限和限制

permissions:
  max-pets-per-player: 0       # 0 = 无限制
  allowed-commands:
    bind: true
    list: true
    portal: true
    rename: true
    team: true
    behavior: true
    effect: true
    attribute: true
    unbind: true
    respawn: true
  allowed-features:
    truck: true
    rideable: true
    invincible: true
    seckill: true
    public-pets: true
    team-system: true
  blocked-entity-types: []     # 禁止绑定的实体类型
  max-truck-damage: 0          # 0 = 无限制

使用示例

绑定宠物

/pet bind nearest 10 我的宠物 public &a

这将 10 方块内最近的生物绑定为名为"我的宠物"的绿色宠物。

设置宠物行为

/pet behavior 1 follow

这将宠物 #1 设置为跟随模式。

使宠物无敌

/pet effect 1 invincible

这将为宠物 #1 应用所有正面药水效果。

启用 TRUCK 模式

/pet attribute 1 truck 0.5 false

这将为宠物 #1 启用 TRUCK 模式，最小速度为 0.5 方块/秒。

启用秒杀模式

/pet attribute 1 truck 0.5 true

这将为宠物 #1 启用秒杀模式（始终 255 伤害）。

使宠物可骑乘

/pet attribute 1 rideable

这将为宠物 #1 启用骑乘模式。

创建团队

/pet team create 我的团队

这将创建一个名为"我的团队"的新团队。

将宠物添加到团队

/pet team addpet 我的团队 1

这将宠物 #1 添加到团队"我的团队"。

数据持久化

插件使用双重存储机制：

NBT 持久化: 实时存储在实体 NBT 数据中
文件持久化: YAML 文件存储在 plugins/DrweiPetManager/pets.yml

自动保存每 5 分钟运行一次。你也可以使用管理员命令手动保存/加载。

从源代码构建

前置要求

Java 21
Maven 3.6+

构建命令

# 克隆仓库
git clone https://github.com/herbrine8403/DrweiPetManager.git
cd DrweiPetManager

# 构建插件
mvn clean package

# JAR 文件将在 target/DrweiPetManager-Beta0.1.0.jar

权限

所有权限使用前缀 petbinder.：

petbinder.use - 基本使用权限
petbinder.bind - 绑定宠物
petbinder.list - 列出宠物
petbinder.portal - 传送宠物
petbinder.rename - 重命名宠物
petbinder.team - 管理团队
petbinder.respawn - 重生宠物
petbinder.behavior - 设置宠物行为
petbinder.effect - 添加药水效果
petbinder.attribute - 修改属性
petbinder.unbind - 释放宠物
petbinder.op - 管理员命令（默认：仅 OP）

支持

问题反馈: 在 GitHub Issues 报告错误和功能请求

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

致谢

作者: Drwei(herbrine8403)
Paper API: PaperMC

更新日志

Beta0.1.0

初始 Beta 版本发布
核心宠物绑定和管理功能
团队系统
TRUCK 模式（支持秒杀）
RIDEABLE 模式
自动保存机制
动态配置
多语言支持（英语/中文）

Drwei的宠物管理器