Grimoirepets - RPG Companions v1.0.1

GrimoirePets is a full RPG companion system for Minecraft servers. Players can collect pets, summon them, level them, evolve them, fuse duplicates, feed them, revive them, and use active combat abilities.

Core Features​

Pet Collection System​

Players can collect different pets and view them in a clean GUI.

• Only owned pets are shown to the player
• Pet copies are supported
• Duplicate pets can be collected from eggs or admin grants
• Favorite pets can be marked
• Pets can be summoned from the GUI or with commands
• Admins can grant, revoke, level, revive, and manage pets

mythicmob-id: "YourMythicMob"

When enabled, GrimoirePets spawns the real MythicMob through the MythicMobs API. This allows your companion to use its MythicMobs skills, attack animations, sounds, projectiles, AI, and ModelEngine setup, while GrimoirePets still handles ownership, summoning, leveling, XP, feeding, fainting, reviving, evolution, fusion, and the collection GUI.

Pet stats can also be synced with GrimoirePets level scaling:

mythic-use-grimoire-stats: true
This lets the MythicMob’s HP, melee damage, and speed scale with the pet’s level.

MythicMobs drop tables can also reward pet XP directly:

Drops:
- pet-exp 35
Perfect for creating custom companions such as robots, dragons, demons, wolves, golems, or any fully animated MythicMobs creature.

Pet Summoning​

Players can summon one active pet at a time.

• Follow the owner
• Teleport if too far away
• Fight enemies
• Defend the owner
• Use custom stats
• Use vanilla mobs, MythicMobs, or ModelEngine models

Combat System​

Pets are not just cosmetic. They can fight beside the player.

• Pets attack what the owner attacks
• Pets defend their owner when attacked
• Pet damage scales from YAML stats
• Combat can be enabled or disabled in config
• Hungry pets can deal reduced damage

Active Abilities​

Pets can have active abilities triggered by pressing the swap-hand key.

• Dash
• Heal owner
• Shockwave
• Shield
• Speed burst
• Leap
• Fire breath
• Poison cloud
• Lightning strike
• Stealth

• Custom names
• Descriptions
• Cooldowns
• Unlock levels
• Power values

Leveling & XP​

Pets gain XP and level up automatically.

• Normal mob kill assists
• MythicMobs drop tables

Drops:
- pet-exp 35
Or with chance:

Drops:
- pet-exp{amount=100} 1 0.10
Server owners can configure:

• XP per normal kill
• XP needed per level
• XP scaling multiplier
• XP gain messages

Bond & Hunger​

Pets grow closer to their owner over time.

• Bond increases while summoned
• Hunger decreases over time
• Feeding restores hunger
• Feeding restores pet health
• Feeding increases bond
• Food items are configured per pet

food:
materials:
- BEEF
- CHICKEN
hunger-restore: 25.0
health-restore: 6.0
bond-bonus: 2.0

Fainting & Revive​

Pets can faint when defeated.

• It is dismissed
• It cannot be summoned until the timer ends
• The player can revive it early with a revive item

• Vanilla items
• Custom model data
• MythicMobs items
• MMOItems items

pet:
revive-item:
type: MYTHIC
amount: 1
mythic-item-id: "PetReviveScroll"
Player command:

/gpet revive <petId>

Pet Eggs​

Pets can be obtained through eggs.

Eggs support rarity-weighted hatching, allowing server owners to create common, rare, epic, and legendary egg pools.

• Custom egg items
• Rarity weights
• Duplicate pet copies supported
• Hatch particles and sounds

Evolution System​

Pets can evolve when they reach the required level.

• Multiple evolution paths
• Branching choices
• Currency costs
• Vanilla item requirements
• MythicMobs item requirements
• MMOItems item requirements
• Bonus rewards on successful evolution
• Confirmation GUI before evolving

evolution:
enabled: true
min-level: 20
paths:
alpha_path:
target: alpha_wolf
requirement-material: BONE_BLOCK
requirement-amount: 4
currency-cost: 500

Fusion System​

Duplicate pets are useful.

Players can fuse multiple same-rarity pets into a random pet of the next rarity.

• Same-rarity requirement
• Duplicate pet copies
• Selection GUI
• Rarity lock
• Confirmation screen
• Result preview
• Bonus fusion drops
• Configurable duplicate handling
• Particles and sounds

• 3 Common pets → 1 random Uncommon pet
• 3 Rare pets → 1 random Epic pet

Commands​

Player Commands​

/gpet
Open the pet collection GUI.

/gpet summon <petId>
Summon a pet.

/gpet dismiss
Dismiss the active pet.

/gpet list
List owned pets.

/gpet info <petId>
View pet details.

/gpet levelup <petId>
Manually level up a pet using currency.

/gpet feed
Feed the active pet with the item in hand.

/gpet revive <petId>
Revive a fainted pet using the configured revive item.

/gpet balance
Check pet currency balance.

Admin Commands​

/petsadmin reload
Reload configuration, pets, and eggs.

/petsadmin grantpet <player> <petId>
Give a pet to a player.

/petsadmin revokepet <player> <petId>
Remove one copy of a pet from a player.

/petsadmin setlevel <player> <petId> <level>
Set a pet's level.

/petsadmin giveegg <player> <eggId> <amount>
Give pet eggs.

/petsadmin revivepet <player> <petId>
Force revive a fainted pet.

/petsadmin give <player> <amount> <chance>
Give pet currency with a chance roll.

/petsadmin take <player> <amount>
Take pet currency.

/petsadmin set <player> <amount>
Set pet currency.

/petsadmin balance <player>
Check another player's pet currency.