Omnipet

OmniPets - Pet System for Paper 1.21+
Overview
OmniPets is a Minecraft Paper 1.21+ plugin that allows you to create a complete pet system for Roleplay, Survival, Economy, and PvE servers. It delivers a full RPG-style pet experience where pets can be tamed, leveled up, assigned behaviors, equipped with skills, and interacted with in many different ways. The plugin also includes advanced customization options such as animations, custom effects, a web editor, and database support.

If you want your server to feature a rich, lively, and highly customizable pet system, OmniPets is a strong choice.

Key Features
1. Diverse Pet System

• Tame and use pets
  
  
• Switch between multiple pets
  
  
• Rename pets
  
  
• Choose pet types based on your server theme
  
  
• Track pet data such as level, experience, behavior, and status

2. Rich Skill System

• Pets have their own skill trees
  
  
• Supports multiple skill patterns and mechanics
  
  
• Can be customized by pet type and role
  
  
• Includes many skill types such as offense, buffs, defense, farming, healing, and aura effects

3. Customizable Pet Behavior
The plugin supports the following behaviors:

• aggressive
  
  
• farm
  
  
• protect
  
  
• friendly
  
  
• aura-farming

Players can control how their pets behave, making the system suitable for many server styles.

4. Player Interaction

• Ride pets
  
  
• Fly with pets
  
  
• Feed pets
  
  
• Change behavior through a menu
  
  
• Use pets in many gameplay situations

5. Effects and Animation System

• Supports visual effects, particles, sounds, and animation
  
  
• Includes animation types such as RING, SPIRAL, HELIX, BURST, SPHERE, PILLAR, and BEAM
  
  
• Allows animations to be attached to events like summon, store, level-up, evolve, tame, unlock, hit, fire-hit, slow-hit, heal-owner, aura-pulse, harvest, and mount
  
  
• Supports custom effects and per-pet configuration overrides (pets.<type>.animations.<event>)
  
  
• Allows testing in-game using /omnipets anim <id> with lag-prevention limits (animation.max-active)

6. Integrated Web Editor
The plugin includes a web editor for:

• Skill trees
  
  
• Effects
  
  
• Animations
  
  
• Server-based configuration data

This makes it easier for server admins to edit settings without manually handling complex YAML files.

7. Multi-language Support

• Includes language support such as vi and en
  
  
• New languages can be added by creating language files
  
  
• Makes the interface easier to translate and customize

8. MySQL and Advanced Integration

• Supports MySQL databases
  
  
• Suitable for multi-server environments or setups that require synchronized data
  
  
• Integrates with PlaceholderAPI
  
  
• Supports multiple 3D pet model providers, including:
  • ModelEngine
    
    
  • BetterModel
    
    
  • MythicMobs
    
    
  • ItemsAdder

9. Pet Trading

• Supports player-to-player pet trading
  
  
• Includes commands like /pettrade
  
  
• Allows accept and deny actions
  
  
• Supports trade value when Vault is enabled

10. Powerful Admin Tools
The plugin includes admin commands such as:

• /omnipets reload
  
  
• /omnipets types
  
  
• /omnipets give <player> <type> [name]
  
  
• /omnipets setlevel <player> <level>
  
  
• /omnipets editor

Main Commands
Player Commands

• /petinfo
  
  
• /petinventory
  
  
• /petbehavior
  
  
• /petswitch
  
  
• /petstore
  
  
• /petname
  
  
• /petskills
  
  
• /petride
  
  
• /petfly
  
  
• /petlang
  
  
• /pettrade

Admin Commands

• /omnipets reload
  
  
• /omnipets types
  
  
• /omnipets give <player> <type> [name]
  
  
• /omnipets setlevel <player> <level>
  
  
• /omnipets editor

System Requirements

• Minecraft: Paper 1.21+
  
  
• Java: 21
  
  
• Maven build project
  
  
• Can run on a Paper-based server with suitable configuration

Recommended Use Cases
OmniPets is ideal for:

• Survival servers
  
  
• RPG servers
  
  
• Economy servers
  
  
• PvE servers
  
  
• Roleplay servers
  
  
• Companion or pet progression systems

What Makes It Different

• More than just a pet plugin; it is a full RPG progression system
  
  
• Includes skill trees, effects, animations, and a dedicated editor
  
  
• Highly configurable for each pet type
  
  
• Supports large servers through MySQL and flexible configuration
  
  
• Easy to deploy and manage for admins

Installation

1. Build the plugin with Maven
   
   
2. Generate the jar file
   
   
3. Place the jar in the plugins/ folder
   
   
4. Start the server
   
   
5. Configure the plugin and pet data according to your server needs

Project Goal
OmniPets aims to improve the player experience by adding a lively and game-like companion system. It adds depth, visual appeal, and progression to the server while creating more opportunities for customization and content development.

Conclusion
OmniPets is a powerful, deep, and expandable pet system for Minecraft Paper servers. With a focus on pet management, combat, skills, visual effects, and player interaction, it is an excellent choice for servers that want a truly impressive and functional pet system.

Notes

• Main version: 1.3
  
  
• Supported Paper version: 1.21+
  
  
• Java version: 21
  
  
• Designed for users who want to build a professional pet system for their server

Wiki: https://omnipet-wiki.vercel.app/