Abilities
Guide on abilities with AdvancedPets
  • Over 60 abilities are built into the plugin.
  • Equip players with potion effects when pet is active, give potions when attacking, killing, set players on fire, strike lightning - it's your choice

How to create abilities

Start off by creating a file for mob in plugins/AdvancedPets/abilities folder, name format should be <mob name>.yml, e.g. Dog.yml

Example Abilities file:

1
# Dog Abilities
2
# Pets can give off special abilities to pet owners passively or at events
3
# Effect List: https://ae.advancedplugins.net/enchantments/creating-enchantments/effect-list
4
# Read more here: https://wiki.advancedplugins.net/effects/types
5
​
6
description: "Chance to deal more damage to players & mobs"
7
​
8
ATTACK:
9
chance: 15
10
cooldown: 2
11
effects:
12
- 'ADD_HARM:3 %other%'
Copied!
​
description - text displayed next to pet in /pets menu. Explains what abilities pet has.
Under description is where Ability Types follow. Types can be found in here.

Setting abilities for pets

Abilities can have attributes, such as:
  • chance - chance of ability activating when triggered by owner
  • cooldown - how long after activating ability wont be available (will be on cooldown)

Placeholders

You can assign who ability affects, be it owner (%owner%) or other player/entity (%other%). This way abilities are given towards the assigned player.
Example:
1
effects:
2
- 'POTION:HASTE:0:20 %owner%'
Copied!
In this example, HASTE potion effect will be given to pet owner for 20 ticks = 1 second.
Another example:
1
effects:
2
- 'LIGHTNING %other%'
Copied!
This example would strike lightning at other entity. E.g. when attacking mobs or players, the other entity would be entity getting attacked.

Placeholders

Placeholder list for effects:
Placeholder
Explanation
%owner name%
Inserts pet owner's name
%other name%
Inserts other person's name (e.g. when attacking)
​
​