Pet Configuration

Pets are configured in pets.yml under the pets section.

Basic Structure

pets:
  PHOENIX:
    name: "&cPhoenix Ember"
    texture: "base64 texture"
    stat: "MAGIC_DAMAGE"
    formula: "3 + (level * 0.8)"
    max_xp_formula: "150 + (level * 75)"
    attack:
      range: 5.5
      cooldown: 1.2
      damage_formula: "12 + (level * 3.5)"
      inheritance: 0.55
    ride:
      enabled: true
      can_fly: true

Pet ID

PHOENIX is the pet ID. It is used for:

• Permissions: pet.PHOENIX
• Admin commands
• Saved player data

Do not rename pet IDs on a live server unless you are okay with old saved levels no longer matching the renamed pet.

Texture

texture is a base64 Minecraft head texture.

If the texture is empty, the GUI falls back to a paper item for collection icons.

Stat Bonus

stat: "MAGIC_DAMAGE"
formula: "3 + (level * 0.8)"

stat must be a MythicLib stat name. formula calculates the flat stat value granted by the pet.

The formula currently uses level as the variable. The Java code internally replaces <level> too, so both of these styles are accepted by the current calculator usage:

formula: "2 + (level * 1)"
formula: "2 + (<level> * 1)"

XP Formula

max_xp_formula: "150 + (level * 75)"

This controls the XP required for the next pet level.

Attack

attack:
  range: 5.5
  cooldown: 1.2
  damage_formula: "12 + (level * 3.5)"
  inheritance: 0.55

Ride

ride:
  enabled: true
  can_fly: true

enabled controls whether the pet can be ridden. can_fly allows flying movement while riding, if WorldGuard also allows pet flying in the current region.