# Drwei’s PetManager<\/p>\n
A powerful and feature-rich pet management plugin for Paper Minecraft servers. This plugin allows players to bind mobs as pets with custom names, colors, behaviors, potion effects, attributes, team sharing, and advanced features like TRUCK collision damage mode and RIDEABLE mode.<\/p>\n
## Features<\/p>\n
### Core Features
\n– **Pet Binding**: Bind any living entity as your pet with custom name and color
\n– **Custom Names & Colors**: Support for Minecraft color codes, color names, and hex colors
\n– **Behavior Modes**: follow, stay, attack, guard, wander
\n– **Potion Effects**: Apply custom potion effects to pets
\n– **Attribute Modification**: Modify pet attributes like health, speed, damage, etc.
\n– **Pet Respawn**: Respawn dead pets with all their data preserved
\n– **Team System**: Share pets with team members<\/p>\n
### Advanced Features
\n– **TRUCK Mode**: Collision damage system when riding pets
\n – Normal mode: Damage based on speed (0-255)
\n – SECKILL mode: Always 255 damage
\n– **RIDEABLE Mode**: Ride any mob, including flying creatures
\n – WASD controls for movement
\n – Space to jump\/fly up
\n – Shift to exit
\n – Flying creatures support vertical movement
\n– **Invincible Mode**: Apply all positive potion effects and set max health to 2048
\n– **Auto-Save**: Automatic data persistence every 5 minutes
\n– **Dynamic Configuration**: Adjust settings without server restart
\n– **Multi-language Support**: English and Chinese<\/p>\n
## Installation<\/p>\n
1. Download the latest version from the Releases page or this Modrinth page. ## Requirements<\/p>\n – **Minecraft Version**: 1.21.1 ## Commands<\/p>\n ### Player Commands<\/p>\n | Command | Description | Permission | ### Admin Commands<\/p>\n | Command | Description | Permission | ## Configuration<\/p>\n ### Basic Configuration<\/p>\n “`yaml ### Permissions & Limits<\/p>\n “`yaml ## Usage Examples<\/p>\n ### Binding a Pet<\/p>\n “` This binds the nearest mob within 10 blocks as a pet named “MyPet” with green color.<\/p>\n ### Setting Pet Behavior<\/p>\n “` This sets pet #1 to follow mode.<\/p>\n ### Making Pet Invincible<\/p>\n “` This applies all positive potion effects to pet #1.<\/p>\n ### Enabling TRUCK Mode<\/p>\n “` This enables TRUCK mode for pet #1 with minimum speed 0.5 blocks\/sec.<\/p>\n ### Enabling SECKILL Mode<\/p>\n “` This enables SECKILL mode (always 255 damage) for pet #1.<\/p>\n ### Making Pet Rideable<\/p>\n “` This enables rideable mode for pet #1.<\/p>\n ### Creating a Team<\/p>\n “` This creates a new team named “MyTeam”.<\/p>\n ### Adding Pet to Team<\/p>\n “` This adds pet #1 to the team “MyTeam”.<\/p>\n ## Data Persistence<\/p>\n The plugin uses dual storage mechanism:<\/p>\n 1. **NBT Persistence**: Real-time storage in entity NBT data Auto-save runs every 5 minutes. You can also manually save\/load using admin commands.<\/p>\n ## Building from Source<\/p>\n ### Prerequisites<\/p>\n – Java 21 ### Build Commands<\/p>\n “`bash # Build the plugin # The JAR file will be in target\/DrweiPetManager-Beta0.1.0.jar ## Permissions<\/p>\n All permissions use the prefix `petbinder.`:<\/p>\n – `petbinder.use` – Basic usage permission ## Support<\/p>\n – **Issues**: Report bugs and feature requests on GitHub Issues or [my Email](weishixvn@outlook.com)<\/p>\n ## License<\/p>\n This project is licensed under the MIT License – see the LICENSE file for details.<\/p>\n ## Credits<\/p>\n – **Author**: Drwei ## Changelog<\/p>\n ### Beta0.1.0 A powerful and feature-rich pet management plugin for Paper Minecraft servers. This plugin allows players to bind mobs as pets with custom names, colors, behaviors, potion effects, attributes, team sharing, and advanced features.<\/p>\n","protected":false},"featured_media":59284,"template":"","meta":{"_minecraft_slug":"drweis-petmanager","_minecraft_project_id":"cGcazlNZ","_minecraft_author":"Drwei","_minecraft_license":"MIT","_minecraft_downloads":15,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"drweis-petmanager.zip","_minecraft_size_bytes":64738,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:50:37.469827Z","_minecraft_date_created":"2026-01-17T23:41:21.184237Z","_minecraft_date_modified":"2026-01-13T09:57:57.346279Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/drweis-petmanager","_minecraft_icon_attachment_id":59284,"_minecraft_imported_at":"2026-06-03T05:55:54+00:00","_minecraft_import_hash":"0fa4f8b735e84305e25fcf58f4b11ed7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[137,127,128,129],"mod_loader":[132,133,134],"minecraft_version":[37],"class_list":["post-59283","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-mobs","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-1"],"yoast_head":"\n
\n2. Place the `DrweiPetManager-
\n3. Restart your server
\n4. Configure the plugin in `plugins\/DrweiPetManager\/config.yml`<\/p>\n
\n– **Server Type**: Paper API 1.21.1 or higher
\n– **Java Version**: 21<\/p>\n
\n|———|————-|————|
\n| `\/pet` | Show help message | `petbinder.use` |
\n| `\/pet bind
\n| `\/pet list` | List your pets | `petbinder.list` |
\n| `\/pet portal [index]` | Teleport pet to you | `petbinder.portal` |
\n| `\/pet rename
\n| `\/pet team
\n| `\/pet behavior
\n| `\/pet effect
\n| `\/pet attribute
\n| `\/pet unbind [index]` | Release pet | `petbinder.unbind` |
\n| `\/pet respawn` | Respawn dead pet | `petbinder.respawn` |
\n| `\/pet version` | Show plugin version | `petbinder.use` |<\/p>\n
\n|———|————-|————|
\n| `\/pet op list` | List all pets on server | `petbinder.op` |
\n| `\/pet op remove
\n| `\/pet op config
\n| `\/pet op reload` | Reload configuration | `petbinder.op` |
\n| `\/pet op save` | Save pet data manually | `petbinder.op` |
\n| `\/pet op load` | Load pet data manually | `petbinder.op` |<\/p>\n
\nlanguage: zh # Language: en or zh
\nmax-bind-distance: 10 # Maximum binding distance in blocks
\nteleport-with-owner: true # Pets teleport with owner
\nprotect-from-all-damage: false # Protect pets from all damage
\nremove-on-quit: false # Remove pets when owner quits
\n“`<\/p>\n
\npermissions:
\n max-pets-per-player: 0 # 0 = unlimited
\n allowed-commands:
\n bind: true
\n list: true
\n portal: true
\n rename: true
\n team: true
\n behavior: true
\n effect: true
\n attribute: true
\n unbind: true
\n respawn: true
\n allowed-features:
\n truck: true
\n rideable: true
\n invincible: true
\n seckill: true
\n public-pets: true
\n team-system: true
\n blocked-entity-types: [] # Entities that cannot be bound
\n max-truck-damage: 0 # 0 = unlimited
\n“`<\/p>\n
\n\/pet bind nearest 10 MyPet public &a
\n“`<\/p>\n
\n\/pet behavior 1 follow
\n“`<\/p>\n
\n\/pet effect 1 invincible
\n“`<\/p>\n
\n\/pet attribute 1 truck 0.5 false
\n“`<\/p>\n
\n\/pet attribute 1 truck 0.5 true
\n“`<\/p>\n
\n\/pet attribute 1 rideable
\n“`<\/p>\n
\n\/pet team create MyTeam
\n“`<\/p>\n
\n\/pet team addpet MyTeam 1
\n“`<\/p>\n
\n2. **File Persistence**: YAML file storage at `plugins\/DrweiPetManager\/pets.yml`<\/p>\n
\n– Maven 3.6+<\/p>\n
\n# Clone the repository
\ngit clone https:\/\/github.com\/herbrine8403\/DrweiPetManager.git
\ncd DrweiPetManager<\/p>\n
\nmvn clean package<\/p>\n
\n“`<\/p>\n
\n– `petbinder.bind` – Bind pets
\n– `petbinder.list` – List pets
\n– `petbinder.portal` – Teleport pets
\n– `petbinder.rename` – Rename pets
\n– `petbinder.team` – Manage teams
\n– `petbinder.respawn` – Respawn pets
\n– `petbinder.behavior` – Set pet behavior
\n– `petbinder.effect` – Add potion effects
\n– `petbinder.attribute` – Modify attributes
\n– `petbinder.unbind` – Release pets
\n– `petbinder.op` – Admin commands (default: OP only)<\/p>\n
\n– **Paper API**: PaperMC<\/p>\n
\n– Initial beta release
\n– Core pet binding and management features
\n– Team system
\n– TRUCK mode with SECKILL support
\n– RIDEABLE mode
\n– Auto-save mechanism
\n– Dynamic configuration
\n– Multi-language support (English\/Chinese)<\/p>\n","protected":false},"excerpt":{"rendered":"