Information

Features

• Unlimited Pets

• Per Player Pets

• Owner Scrolls

• Inventory or Virtual Pets

• Pet Sorting

• Pet Candies

• Pet Boxes

• Pet Fusion

• Pet Slots

• Pet Storage

• Pet Cooldowns

• Pet Upgrades

• HEX Color Support & more

---

Supported Plugins

RivalHarvesterHoes
RivalPickaxes
RivalMobSwords
RivalFishingRods
SuperMobCoins
ZithiumCollectors
AxGens
VoidChest
CyberLevels
AbyssEconomy
ShopGUIPlus
EDPrison
DeluxeSellwands
EconomyShopGUI & Premium
Scyther
WildTools
AureliumSkills
JobsReborn
OptimalSkills
WarriorMobCoins
ManifestCollector
CoralPrisons
AbyssCollectors
BattlePass
NextGens
WildTools
( Ask for any other to be added)

---

Placeholders

• %rivalpets_boostraw_{buffname}% - Shows the current boost raw double

• %rivalpets_boost_{buffname}% - Shows the current boost formatted decimal

• %rivalpets_boostpercentage_{buffname}% - Shows the current boost as a percentage

• %rivalpets_toggleupgrade_{upgradename}% - Returns true/false if upgrade is toggled on/off

• %rivalpets_togglemessage_{upgradename}% - Returns true/false if upgrade messages are toggled on/off

• %rivalpets_storage% - Shows the current amount of pets in storage

• %rivalpets_storage_max% - Shows the max amount of pets in storage

• %rivalpets_equipped% - Shows the current amount of pets the player has equipped

• %rivalpets_equipped_max% - Shows the max amount of pets the player can have active

• %rivalpets_currency_{name}% - Shows the raw amount of currency

• %rivalpets_currency-formatted_{name}% - Shows the amount of currency 1k, 1m

• %rivalpets_currency-formatted-decimal_{name}% - Shows the amount of currency 1,000

Commands

• /pets give - rivalpets.give

• /pets buffs- rivalpets.buffs

• /pets givecandy- rivalpets.givecandy

• /pets givepetbox - rivalpets.givepetbox

• /pets giveownerscroll- rivalpets.giveownerscroll

• /pets giverarityscroll - rivalpets.giverarityscroll

• /pets givelevelscroll - rivalpets.givelevelscroll

• /pets giveslots- rivalpets.giveslots

• /pets givestorage- rivalpets.givestorage

• /pets hide- rivalpets.hide

• /pets reload- rivalpets.reload

• /pets setowner- rivalpets.setowner

• /pets setslots- rivalpets.setslots

• /pets setstorage- rivalpets.setstorage

• /pets toggle- rivalpets.toggle

• /pets about

Storage Permission "rivalpets.storage.#"

Slots Permission "rivalpets.slots.#"

Chat Display

Permissions:

to use [pets] in chant if enabled permission : rivalpets.show

to click the message in chat if enabled: rivalpets.preview

Chat Format: config.yml - Chat-Display: format:

---

Pet Lore Example

Inventory-Type:
  material: PLAYER_HEAD
  base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2I1M2I5ODJiNDlkYjljYWI4OTY2MzQyNmVjMGI3YjJhYjBkNjM4OTY0ZjkwY2MzYjYzOTE5MGRiNGY3ZmMxYyJ9fX0="
  name: '&c&lIron Man &4&lPet &7[Lvl. {level}]'
  lore:
    - "&8Common Rarity"
    - ""
    - "&7Owner: &f{owner}"
    - ""
    - "&c&lAbility"
    - " &7┣ Increase the chance of essence pouch"
    - " &7you gain by &a{boost-percent:rivalharvesterhoes-enchant-essencepouch}%"
    - ""
    - "&5&lEnhancement"
    - "{enhancement}"
    - ""
    - "&5&lMastery"
    - "&fMastery Level: {mastery}"
    - ''
    - '&5&lBoosts'
    - '{boost_level}'
    - '{boost_buff}'
    - '{boost_experience}'
    - ""
    - "&4&lInformation"
    - " &7┣ Level: &f{level} &8/ &f{max-level}"
    - " &7┣ Experience: &a{exp} &8/ &c{max-exp}"
    - " &7┣ {progress-bar}  &a{percent}%"
    - " &7┣ &7Tier: &fCommon"
    - " "

Example Configs

Pet Config:

```yaml
Settings:
  pet-identifier: "IronMan" # ID of pet
  pet-name: '&c&lIron Man Pet' # Name of pet
  pet-tier: 'Common' # Tier of pet, used for bulk delete
  pet-type: ACTION # or ACTIVATION, ACTION will give EXP when a buff event is triggered, ACTION will give when activated
  owner-locked: true # Locks the pet to the player it was given to
  cooldown: 0 # Cooldown between activating the pet
  allow-same-type: false # Allows the same type of pet to be activated at once
  blacklist: [] # Blocks activation of these pets while this pet is active
Lore-Addon:
  equipped:
    - '&e&lEQUIPPED'
    - '&6Click to unequip this pet'
  unequipped:
    - '&7&lCLICK HERE'
    - '&fClick to equip this pet'
  selected-deletion:
    - '&4&lSELECTED FOR DELETION'
    - '&cClick the confirm button to delete'
  bin-selected:
    - '&4&lSELECTED FOR BIN'
    - '&cClick the confirm button to convert to candy'
  bin-select:
    - '&7&lCLICK HERE'
    - '&fClick to select this pet'
  fusion-select:
    - '&7&lCLICK HERE'
    - '&fClick to select this pet'
  fusion-selected:
    - '&4&lSELECTED FOR FUSION'
    - '&cClick the confirm button to fuse these pets'
  inventory-deposit:
    - '&a&lRIGHT CLICK TO DEPOSIT'
    - '&7Right click to deposit this pet to storage!'
  pet-active:
    - '&a&lPET ACTIVE'
    - '&7Right click to deactivate this pet!'
  pet-inactive:
    - '&c&lPET INACTIVE'
    - '&7Right click to activate this pet!'
  pet-cooldown:
    - '&c&lPET COOLDOWN'
    - '&7This pet is on cooldown!'
Pet-Levels:
  max-level: 100 # The max level the pet can reach not including enchants
  xp-base: 50 # Base XP needed for level up
  xp-increase: 3000 # Increase of xp needed per pet level for level up math for max level xp is xp-base + xp-base * xp-increase
Pet-Display:
  name: '&c&lIron Man Pet &7[Lvl. {level}]'
  name-visiblity: true
  swing-hand: true
  model-engine: example_model
  offSet: 0.0
  equipment:
    chestplate:
      material: LEATHER_CHESTPLATE
      color:
        red: 252
        green: 28
        blue: 3
    helmet:
      material: PLAYER_HEAD
      base64: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2I1M2I5ODJiNDlkYjljYWI4OTY2MzQyNmVjMGI3YjJhYjBkNjM4OTY0ZjkwY2MzYjYzOTE5MGRiNGY3ZmMxYyJ9fX0='
    hand:
      material: DIAMOND_SWORD
      glow: true
Pet-Bin:
  candies:
    'CommonCandy':
      chance: 0.01
      amount: 1-3
      message:
        value: '&3&lPet Bin &8┣  &bYou have found &f{amount} &7&lCommon Pet Candy!'
        sound: 'LEVEL_UP:1:2'
    'RareCandy':
      chance: 0.001
      amount: 1-2
      message:
        value: '&3&lPet Bin &8┣  &bYou have found &f{amount} &b&lRare Pet Candy!'
        sound: 'LEVEL_UP:1:2'
Pet-Experience:
  activation:
    xp: 2
    xp-increase: 0.5
#BuffType:multiplier:multiplier-increase:xp:xp-increase
Buffs:
  - 'rivalharvesterhoes-enchant-essencepouch:0.05:0.01:2:0.2'
Inventory-Type:
  material: PLAYER_HEAD
  base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmMwODQ3NjVjNjJjMDNmMzQ3OWU3NTkyMDhjYTFlN2ZhOTlmNjc0ZDBjOGJlNzhhM2YxMGY1YjFlODY2Y2EyNCJ9fX0="
  name: '&d&lDragon &5&lPet &7[Lvl. {level}]'
  lore:
    - "&8Common Rarity"
    - ""
    - "&7Owner: &f{owner}"
    - ""
    - '&5&lEnhancement'
    - '{enhancement}'
    - ''
    - '&5&lMastery'
    - '&fMaster Level: {mastery}'
    - ''
    - '&5&lBoosts'
    - '{boost_level}'
    - '{boost_buff}'
    - '{boost_experience}'
    -
    - "&d&lAbility"
    - " &7┣ Increase the amount of essence"
    - " &7you gain by &a{boost-percent:rivalharvesterhoes-essence}%"
    - ""
    - "&5&lInformation"
    - " &7┣ Level: &f{level} &8/ &f{max-level}"
    - " &7┣ Experience: &a{exp} &8/ &c{max-exp}"
    - " &7┣ {progress-bar}  &a{percent}%"
    - " &7┣ &7Tier: &fCommon"
    - " "
    
Boost-Settings:
  default-placeholders:
    none-buff: '&#FF0000None'
    none-level: '&#FF0000None'
    none-experience: '&#FF0000None'
  boosts:
    F:
      chance: 10
      types:
        Level:
          minBoost: 1
          maxBoost: 4
          display: "&#979e06Level &8- %boost%% &8- &#808080&lꜰ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 1
          maxBoost: 3
          display: "&#850375Buff &8- %boost%% &8- &#808080&lꜰ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 10
          maxBoost: 20
          display: "&#068f9eExperience &8- %boost%% &8- &#808080&lꜰ ɢʀᴀᴅᴇ"
    E:
      chance: 20
      types:
        Level:
          minBoost: 5
          maxBoost: 9
          display: "&#979e06Level &8- %boost%% &8- &#00FF00&lᴇ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 4
          maxBoost: 6
          display: "&#850375Buff &8- %boost%% &8- &#00FF00&lᴇ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 21
          maxBoost: 30
          display: "&#068f9eExperience &8- %boost%% &8- &#00FF00&lᴇ ɢʀᴀᴅᴇ"
    D:
      chance: 30
      types:
        Level:
          minBoost: 10
          maxBoost: 14
          display: "&#979e06Level &8- %boost%% &8- &#FFFF00&lᴅ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 7
          maxBoost: 9
          display: "&#850375Buff &8- %boost%% &8- &#FFFF00&lᴅ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 31
          maxBoost: 40
          display: "&#068f9eExperience &8- %boost%% &8- &#FFFF00&lᴅ ɢʀᴀᴅᴇ"
    C:
      chance: 20
      types:
        Level:
          minBoost: 15
          maxBoost: 19
          display: "&#979e06Level &8- %boost%% &8- &#1E90FF&lᴄ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 10
          maxBoost: 12
          display: "&#850375Buff &8- %boost%% &8- &#1E90FF&lᴄ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 41
          maxBoost: 50
          display: "&#068f9eExperience &8- %boost%% &8- &#1E90FF&lᴄ ɢʀᴀᴅᴇ"
    B:
      chance: 10
      types:
        Level:
          minBoost: 20
          maxBoost: 24
          display: "&#979e06Level &8- %boost%% &8- &#8A2BE2&lʙ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 13
          maxBoost: 15
          display: "&#850375Buff &8- %boost%% &8- &#8A2BE2&lʙ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 51
          maxBoost: 60
          display: "&#068f9eExperience &8- %boost%% &8- &#8A2BE2&lʙ ɢʀᴀᴅᴇ"
    A:
      chance: 5
      types:
        Level:
          minBoost: 25
          maxBoost: 29
          display: "&#979e06Level &8- %boost%% &8- &#FFA500&lᴀ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 16
          maxBoost: 18
          display: "&#850375Buff &8- %boost%% &8- &#FFA500&lᴀ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 61
          maxBoost: 70
          display: "&#068f9eExperience &8- %boost%% &8- &#FFA500&lᴀ ɢʀᴀᴅᴇ"
    S:
      chance: 3
      types:
        Level:
          minBoost: 30
          maxBoost: 34
          display: "&#979e06Level &8- %boost%% &8- &#FF1493&lѕ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 19
          maxBoost: 22
          display: "&#850375Buff &8- %boost%% &8- &#FF1493&lѕ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 71
          maxBoost: 80
          display: "&#068f9eExperience &8- %boost%% &8- &#FF1493&lѕ ɢʀᴀᴅᴇ"
    SS:
      chance: 1
      types:
        Level:
          minBoost: 35
          maxBoost: 39
          display: "&#979e06Level &8- %boost%% &8- &#00FFFF&lѕѕ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 23
          maxBoost: 26
          display: "&#850375Buff &8- %boost%% &8- &#00FFFF&lѕѕ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 81
          maxBoost: 90
          display: "&#068f9eExperience &8- %boost%% &8- &#00FFFF&lѕѕ ɢʀᴀᴅᴇ"
    SSS:
      chance: 1
      types:
        Level:
          minBoost: 40
          maxBoost: 50
          display: "&#979e06Level &8- %boost%% &8- &#FF4500&lѕѕѕ ɢʀᴀᴅᴇ"
        Buff:
          minBoost: 27
          maxBoost: 30
          display: "&#850375Buff &8- %boost%% &8- &#FF4500&lѕѕѕ ɢʀᴀᴅᴇ"
        Experience:
          minBoost: 91
          maxBoost: 100
          display: "&#068f9eExperience &8- %boost%% &8- &#FF4500&lѕѕѕ ɢʀᴀᴅᴇ"
Pet-Mastery:
  max-prestige: 5
  level-boost-per-prestige: 5
  experience-boost-per-prestige: 0.5
  buff-boost-per-prestige: 0.5
  messages:
    broadcast:
      message:
        value: '&3&lRival&f&lPets &8➛ &3{player} &bhas reached pet mastery {level} for his {pet} pet&b!'
        sound: 'LEVEL_UP:1:2'
    message:
      message:
        value: '&3&lRival&f&lPets &8➛ &3You have reached {level} mastery for your {pet}'
        sound: 'LEVEL_UP:1:2'
  custom-requirements:
    enabled: false
    levels:
      '1':
        level: 100
        broadcast:
          message:
            value: '&3&lRival&f&lPets &8➛ &3{player} &bhas reached pet mastery {level} for his {pet} pet&b!'
            sound: 'LEVEL_UP:1:2'
      '2':
        level: 200
        broadcast:
          message:
            value: '&3&lRival&f&lPets &8➛ &3{player} &bhas reached pet mastery {level} for his {pet} pet&b!'
            sound: 'LEVEL_UP:1:2'
      '3':
        level: 300
        broadcast:
          message:
            value: '&3&lRival&f&lPets &8➛ &3{player} &bhas reached pet mastery {level} for his {pet} pet&b!'
            sound: 'LEVEL_UP:1:2'
      '4':
        level: 400
        broadcast:
          message:
            value: '&3&lRival&f&lPets &8➛ &3{player} &bhas reached pet mastery {level} for his {pet} pet&b!'
            sound: 'LEVEL_UP:1:2'
      '5':
        level: 500
        broadcast:
          message:
            value: '&3&lRival&f&lPets &8➛ &3{player} &bhas reached pet mastery {level} for his {pet} pet&b!'
            sound: 'LEVEL_UP:1:2'
Fusion-Settings:
  fusion-enabled: false #If the pets can be fused
  keep-level: true # Keeps highest level between the two pets
  keep-prestige: false
  keep-boosts: false
  keep-enhancement: false
  fuse-into: 'RareDragon' # Pet type it will be fused into Make sure it exists or some bad things will happen
  chance-increase: 0.3
  cost-increase: 5000
  info-placeholder: '&b&LFusing Tiers: &fCommon &7» &bRare'
  broadcast:
    message:
      value: '&3&lRival&f&lPets &8➛ &3{player} &bhas fused two pets into &9&lRare Tier&b!'
      sound: 'LEVEL_UP:1:2'
  message:
    message:
      value: '&3&lRival&f&lPets &8➛ &bYou have fused two {pet}''s into &9&lRare Tier&b!'
      sound: 'UI_TOAST_CHALLENGE_COMPLETE:0.3:2'
Messages:
  pet-leveled-up:
    message: "&2&l[&a&l!&2&l] &aYour &2{pet} &ahas levelled up to &7[Lvl. {level}]"
    sound: 'UI_TOAST_CHALLENGE_COMPLETE:0.3:2'
  pet-given:
    message: "&2&l[&a&l!&2&l] &aYou have given &f{player} &2{pet} &apet."
    sound: 'LEVEL_UP:1:2'
  pet-received:
    message: "&2&l[&a&l!&2&l] &aYou have been given a &2{pet} &apet."
    sound: 'LEVEL_UP:1:2'
  pet-activated:
    message: "&2&l[&a&l!&2&l] &aYou have activated your &2{pet} &apet."
    sound: 'LEVEL_UP:1:2'
  pet-deactivated:
    message: "&2&l[&a&l!&2&l] &aYou have deactivated your &2{pet} &apet."
    sound: 'GHAST_FIREBALL:1:1.5'
  pet-deposit:
    message: "&2&l[&a&l!&2&l] &aYou have deposited &2{pet} &apet to your storage."
    sound: 'LEVEL_UP:1:2'
  pet-withdraw:
    message: "&2&l[&a&l!&2&l] &aYou have withdrawn a &2{pet} &apet."
    sound: 'ITEM_PICKUP:2:1'
  owner-locked-deposit:
    message: "&c&l[&4&l!&c&l] &cYou are not the owner of this pet!."
    sound: 'GHAST_FIREBALL:1:1.5'
  owner-locked:
    message: '&4&l[!] &cYou can''t activate this pet as you are &4&lNOT &cthe owner of it!'
    sound: 'GHAST_FIREBALL:1:1.5'
  blacklist:
    message: "&c&l[&4&l!&c&l] &cYou can''t activate {current-pet} until you disable {other-pet}!."
    sound: 'GHAST_FIREBALL:1:1.5'
```

Item Available placeholders:

{owner}  {exp} {max-exp} {level} {max-level} {boost-percent:[bufftype]}
{boost:[bufftype]

Helpful Commands:

/pet buffs - Display all currently available buff types

Pet Display

Plugin has 3 different modes config.yml display-mode: to change, MODE-1 is the default displays pets in a circle, MODE-2 is similar to the default one with some pets location changes, MODE-3 is a Hypixel like pet display, you will have to limit the pet slots to 1

display-mode: MODE-1 MODE-2, MODE-3 or MODE-4 

Pet-Display:
  name: '&d&lDragon Pet &7[Lvl. {level}]'
  name-visiblity: true # Toggle the name display of the pet
  swing-hand: true # Swing the hand when holding the same material type as in hand:
  small: true # By default set to false, if true the pet size will increase
  offSet: 0.0 # Adds an offset to the name of the pet when using a big custom model or modelengine
  model-engine: none # You can set a modelengine model, if set equipment below is ignored
  equipment:
    helmet: # chestplate:, leggings:, boots:, off-hand: can also be set
      material: PLAYER_HEAD
      base64: 'eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZmMwODQ3NjVjNjJjMDNmMzQ3OWU3NTkyMDhjYTFlN2ZhOTlmNjc0ZDBjOGJlNzhhM2YxMGY1YjFlODY2Y2EyNCJ9fX0='
    hand:
      material: DIAMOND_HOE

Pet Commands

You can make pets execute commands based on vanilla buffs: block-break, mob-kill, fish-catch

Commands:
  "block-break-exact-stone":
    use-chance: true # when true it will use the chance: below and when it procs it will pick a random command based on the chance (the number after ; is the chance) or if false it will check chances below each time until it procs one of them
    chance: 10
    commands: 
      - 'eco give %player% 1000;10'
      - 'eco give %player% 1000;20'
      - 'eco give %player% 1000;30'

Animated Display Names

Pet-Display:
  name: '&c&lIron Man Pet &7[Lvl. {level}]'
  name-visiblity: true
  frame-interval: 3 # Time in ticks before next frame is selected, each line is a frame that's going to be displayed
  animated-name:
    - "&b&lR"  
    - "&b&lR"  
    - "&b&lRi"  
    - "&b&lRiv"  
    - "&b&lRival"  
    - "&f&lRival"  
    - "&b&lRival"  
    - "&b&lRiva"  
    - "&b&lRiv"  
    - "&b&lRi"  
    - "&b&lR"  

Potion Effects Names for potioneffect-{} Buff

SPEED, SLOW, FAST_DIGGING, SLOW_DIGGING, INCREASE_DAMAGE, HEAL, HARM, JUMP, CONFUSION, REGENERATION, DAMAGE_RESISTANCE, FIRE_RESISTANCE, WATER_BREATHING, INVISIBILITY, BLINDNESS, NIGHT_VISION, HUNGER, WEAKNESS, POISON, WITHER

All Buffs

RivalHarvesterHoes - rivalharvesterhoes-ability-, rivalharvesterhoes-proc-ability, rivalharvesterhoes-enchant-, rivalharvesterhoes-essence, rivalharvesterhoes-expfinder, rivalharvesterhoes-money, rivalharvesterhoes-proc, rivalharvesterhoes-xp

RivalPickaxes - rivalpickaxes-enchant-, rivalpickaxes-essence, rivalpickaxes-money, rivalpickaxes-proc, rivalpickaxes-xp

RivalFishingRods - rivalfishingrods-essence, rivalfishingrods-money

RivalMobSwords - rivalmobswords-money, rivalmobswords-essence, rivalmobswords-xp

Vanilla - block-break, block-break-exact-, damage, experience, fish-catch, mob-kill, mob-kill-exact-, potioneffect-, resistance

WildTools - wildtools-harvesterhoe, wildtools-sellwand

ZithiumCollectors - zithiumcollectors-autosell, zithiumcollectors-sellall, zithiumcollectors-sell

ZithiumMobCoins - zithiummobcoins

AbyssCollectors - abysscollectors-

AbyssEconomy - abysseconomy-

AuraSkills - auraskills-

AureliumSkills - aureliumskills-

AxSellWands - axsellwands

BattlePass - battlepass

CoralPrisons - fake-block-break, coralprisons-

CyberLevels - cyberlevels-xp

DeluxeSellWands - deluxesellwands-money, deluxesellwands-token

EconomyShopGUI - economyshopgui-sell

EDPrison - edprisonbreak, edprison-, edprison-enchant-

InfiniteChestPro - infinitechestpro

JobsReborn - jobs-

NextGens - nextgens-sell, nextgens-sellwand

OptimalSkills - optimalskills-

RivalPets - rivalpets-xp

Scyther - scyther-money

ShopGUIPlus - shopgui-buy shopgui-sell

SuperMobCoins - supermobcoins

AxGens - axgens-sell