PetCompanions
AvailableA collection of 230 pets that players find by playing rather than buying — each one levels, bonds, carries an ability and a passive, and can be sent out to gather, entered into duels, or traded away. The kind of feature players stay for rather than try once.
- Cosmetics & Fun
- Gameplay & Progression
- pets
- companions
- buffs
- collection
- progression
What it does
230 pets, found by playing
Pets turn up while mining, fishing, killing mobs, opening ocean loot, earning advancements or just getting on with the day. Every source has its own pool, its own odds and its own cooldown, and a pity counter guarantees a find eventually — so nobody grinds for a week and gets nothing.
They grow with the player
Levels, XP and a separate bond that rises through time spent together. Rarity sets the level cap, so a mythic companion is worth keeping long after a common one has topped out, and a pet somebody raised is not the same as one they were handed.
An ability and a passive each
Every pet carries one triggered ability and one always-on passive — mining luck, damage, speed, extra drops, coin finds. Which pet is out becomes a real decision rather than a cosmetic one.
Send them out to gather
A pet can be sent on a timed expedition and comes back with materials. Rewards earned while the owner is offline are held and handed over on their next login, so a trip is never wasted by logging off.
Duels and leaderboards
Queue a pet for the arena and watch two companions fight it out, with prizes for both sides. Rankings track the collection, the highest level and the arena record, and can be placed in the world as leaderboard displays.
Trading, storage and a journal
Pets change hands through a confirmed two-sided trade with an optional fee. Each one carries its own inventory, and the journal tracks what has been discovered and what is still out there.
Two ladders you hand out yourself
Twenty pets are deliberately unobtainable in play. They exist for you to award from a rank, a prestige tier, a crate or a vote perk with one command — an escalating reward that is worth having because nobody can simply go and find one.
It plays fair with your other plugins
Permanent buffs are claimed rather than assumed, so PetCompanions will not strip a buff another plugin granted, and hands one back instead of removing it. Pet heals are proposed as real events, so a combat plugin can see and scale them.
Compatibility
- Version
- 1.0.0
- Minecraft
- 1.21.3 – 1.26
- Java
- 21+
- Platform
- Paper / Purpur
- Pet types
- 230, across six rarities
- Storage
- SQLite — bundled, no setup
- Dependencies
- None required
- Licence
- Proprietary, per-network
- Updates
- Lifetime, included
Commands
Permissions default to true for player commands and op for admin ones.
| Command | What it does | Permission |
|---|---|---|
/pet | Open your collection | xpets.use |
/pet help | List every subcommand | xpets.help |
/pet spawn (name) | Summon one of your pets | xpets.spawn |
/pet dismiss | Put the active pet away | xpets.dismiss |
/pet stay | Park it here until you call it back | xpets.stay |
/pet call | Bring it to you from anywhere | xpets.stay |
/pet ability | Trigger the active pet's ability | xpets.ability |
/pet gather | Send it out on a timed expedition | xpets.gather |
/pet rename (old) (new) | Rename a pet | xpets.rename |
/pet inventory (name) | Open a pet's storage | xpets.inventory |
/pet journal | Collection progress | xpets.journal |
/pet eggs | Spend shards on mystery eggs | xpets.eggs |
/pet quests | Daily pet quests | xpets.quests |
/pettrade (player) (yours) (theirs) | Trade a pet | xpets.trade |
/petarena join|leave|spectate | Pet duels | xpets.arena.join |
/petrankings | Leaderboards | xpets.rankings |
/petadmin give (player) (petId) | Award any pet | xpets.admin.give |
/petadmin balance | Print every drop chance and price in effect | xpets.admin.balance |
/petadmin reload | Re-read config.yml | xpets.admin.reload |
Before you buy
A new player is not finding any pets. Is it broken?
Almost certainly not: a player gets no discovery rolls until they have claimed their starter pet with /pet starter. That is deliberate - a random find beforehand would fill their list and make the starter picker refuse their choice - but it does mean a brand-new player can mine all day and find nothing. Point them at /pet starter, or set discovery.starter.enabled to false to open discovery from their first block.
Do I need an economy plugin?
No. Vault is optional: with it, coin rewards, arena prizes and trade fees work; without it those are switched off and nothing else changes. The plugin will not tell a player they were paid on a server that has no economy to pay them from.
Do I have to set up a database?
No. Storage is SQLite, bundled in the jar. There is nothing to install and nothing to configure.
Will 230 pets lag my server?
Only one pet per player is ever in the world at a time, and pet types are definitions rather than entities. The tick work is proportional to the number of players with a pet out, not to the size of the collection.
Can I give pets out as rank or crate rewards?
Yes, and twenty of them exist specifically for that. /petadmin give (player) (petId) works from console or a command block, so any rank plugin, crate or vote listener can award one. The ascendant and paragon ladders cannot be found in play, which is what makes them worth awarding.
Will it fight with my other plugins over potion effects?
It is built not to. Permanent buffs are claimed in the player's own data, and PetCompanions will only remove an effect it can prove it granted — if another plugin still wants that effect it is handed back at their strength rather than stripped. This was written after watching two plugins take turns removing each other's buffs.
Does it work on 1.21 and on 1.26?
One jar covers 1.21.3 through 1.26. The build fails if any call in it would behave differently across that range, and each release is boot-tested on both ends before it ships.