# Drwei 的宠物管理器 (Drwei's PetManager) 一个功能强大的 Paper Minecraft 服务器宠物管理插件。该插件允许玩家绑定生物作为宠物，支持自定义名称、颜色、行为模式、药水效果、属性修改、团队共享，以及 TRUCK 碰撞伤害模式和 RIDEABLE 骑乘模式等高级功能。 ## 功能特性 ### 核心功能 - **宠物绑定**: 绑定任何活体生物作为你的宠物，支持自定义名称和颜色 - **自定义名称和颜色**: 支持 Minecraft 颜色代码、颜色名称和十六进制颜色 - **行为模式**: 跟随、停留、攻击、守护、游荡 - **药水效果**: 为宠物应用自定义药水效果 - **属性修改**: 修改宠物属性，如生命值、速度、伤害等 - **宠物重生**: 重生死亡的宠物并保留所有数据 - **团队系统**: 与团队成员共享宠物 ### 高级功能 - **TRUCK 模式（大运模式）**: 骑乘宠物时的碰撞伤害系统 - 普通模式: 基于速度的伤害（0-255） - 秒杀模式（颗秒模式）: 始终造成 255 伤害 - **RIDEABLE 模式**: 骑乘任何生物，包括飞行生物 - WASD 控制移动 - 空格键跳跃/上升 - Shift 键退出骑乘 - 飞行生物支持垂直移动 - **无敌模式**: 应用所有正面药水效果并设置最大生命值为 2048 - **自动保存**: 每 5 分钟自动保存数据 - **动态配置**: 无需重启服务器即可调整设置 - **多语言支持**: 英语和中文 ## 安装 1. 从 [发布页面](https://github.com/herbrine8403/DrweiPetManager/releases) 下载最新版本 2. 将 `DrweiPetManager-<版本>.jar` 文件放入服务器的 `plugins` 文件夹 3. 重启服务器 4. 在 `plugins/DrweiPetManager/config.yml` 中配置插件 ## 系统要求 - **Minecraft 版本**: 1.21.1 - **服务器类型**: Paper API 1.21.1 或更高版本 - **Java 版本**: 21 ## 命令 ### 玩家命令 | 命令 | 描述 | 权限 | |------|------|------| | `/pet` | 显示帮助信息 | `petbinder.use` | | `/pet bind [public] [color]` | 绑定生物作为宠物 | `petbinder.bind` | | `/pet list` | 列出你的宠物 | `petbinder.list` | | `/pet portal [index]` | 将宠物传送到你身边 | `petbinder.portal` | | `/pet rename [color]` | 重命名宠物 | `petbinder.rename` | | `/pet team [args]` | 管理宠物团队 | `petbinder.team` | | `/pet behavior ` | 设置宠物行为 | `petbinder.behavior` | | `/pet effect [duration] [amplifier]` | 应用药水效果 | `petbinder.effect` | | `/pet attribute [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 ` | 移除指定玩家的所有宠物 | `petbinder.op` | | `/pet op config [args]` | 动态配置 | `petbinder.op` | | `/pet op reload` | 重新加载配置 | `petbinder.op` | | `/pet op save` | 手动保存宠物数据 | `petbinder.op` | | `/pet op load` | 手动加载宠物数据 | `petbinder.op` | ## 配置 ### 基本配置 ```yaml language: zh # 语言: en 或 zh max-bind-distance: 10 # 最大绑定距离（方块） teleport-with-owner: true # 宠物随主人传送 protect-from-all-damage: false # 宠物受到全伤害保护 remove-on-quit: false # 主人退出时移除宠物 ``` ### 权限和限制 ```yaml 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 添加到团队"我的团队"。 ## 数据持久化插件使用双重存储机制： 1. **NBT 持久化**: 实时存储在实体 NBT 数据中 2. **文件持久化**: YAML 文件存储在 `plugins/DrweiPetManager/pets.yml` 自动保存每 5 分钟运行一次。你也可以使用管理员命令手动保存/加载。 ## 从源代码构建 ### 前置要求 - Java 21 - Maven 3.6+ ### 构建命令 ```bash # 克隆仓库 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](https://github.com/herbrine8403/DrweiPetManager/issues) 报告错误和功能请求 ## 许可证本项目采用 MIT 许可证 - 详见 LICENSE 文件。 ## 致谢 - **作者**: Drwei(herbrine8403) - **Paper API**: [PaperMC](https://papermc.io/) ## 更新日志 ### Beta0.1.0 - 初始 Beta 版本发布 - 核心宠物绑定和管理功能 - 团队系统 - TRUCK 模式（支持秒杀） - RIDEABLE 模式 - 自动保存机制 - 动态配置 - 多语言支持（英语/中文）

Drwei

Drwei的宠物管理器