> For the complete documentation index, see [llms.txt](https://mobs.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mobs.advancedplugins.net/advancedpets/abilities.md).

# Abilities

* 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:

```yaml
# Dog Abilities
#  Pets can give off special abilities to pet owners passively or at events
#  Effect List: https://ae.advancedplugins.net/enchantments/creating-enchantments/effect-list
#  Read more here: https://wiki.advancedplugins.net/effects/types

description: "Chance to deal more damage to players & mobs"

ATTACK:
  chance: 15
  cooldown: 2
  effects:
    - 'ADD_HARM:3 @Other'
```

`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](https://wiki.advancedplugins.net/abilities/triggers).

Full list of effects: <https://wiki.advancedplugins.net/abilities/effects>

#### 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*:

```yaml
  effects:
  - 'POTION:HASTE:0:20 @Owner'
```

In this example, HASTE potion effect will be given to pet owner for 20 ticks = 1 second.

*Another example*:

```yaml
  effects:
  - 'LIGHTNING @Other'
```

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) |
|              |                                                   |