Companion Abilities

Configure multiple abilities line by line using abilityList under the companion node; use abilityList: [] when no ability is needed. The legacy ability semicolon format is still compatible.

yaml

abilityList:
  - FIREBALL
  - LIGHTNING
  - LEAP

Ability	Description
COMMAND	Command
FLY	Flight
DODGE	Chance to dodge when hit
LEAP	Dash
LIGHTNING	Lightning
MINING_VISION	Mining night vision
SPEED_BURST	Chance for speed boost when hit
FLING	Fling
ENDERMAN	Chance to teleport when hit
FIREBALL	Launch fireball
DRAGON_FIREBALL	Launch ender dragon fireball (1.9.1+)
WITHER_SKULL	Launch wither skull (1.9.1+)
WIND_CHARGE	Launch wind charge (server 1.20.5+)
EGG	Launch egg (1.9.1+)
SNOW_BALL	Launch snowball (1.9.1+)
COMMAND_ATTACK_CHANCE	Chance to trigger command on attack (1.10.0+)

How to use the COMMAND ability.

Format: COMMAND/INTERVAL/CHANCE/EXECUTED_COMMAND/PLAYER_MESSAGE/BROADCAST_MESSAGE

This ability can increase its chance as the companion level rises

Separate parts with /
COMMAND is a fixed prefix
INTERVAL is the interval (in minutes)
CHANCE is the probability
EXECUTED_COMMAND is the command to execute (1.7.5+ supports parsing PAPI variables)
PLAYER_MESSAGE is the message sent to the player (optional)
BROADCAST_MESSAGE is the broadcast message (optional)

yaml

abilityList:
  - "COMMAND/15/25/eco give %player% 150/&6You received $150!/&a %player% &6received $150 from the companion &dCyber&bEra&6!"

At companion level 1, there is a 25% chance every 15 minutes to receive 150 coins.

How to use the COMMAND_ATTACK_CHANCE ability.

Format: COMMAND_ATTACK_CHANCE/CHANCE/EXECUTED_COMMAND/PLAYER_MESSAGE/BROADCAST_MESSAGE

This ability can increase its chance as the companion level rises

Separate parts with /
COMMAND_ATTACK_CHANCE is a fixed prefix
CHANCE is the probability
EXECUTED_COMMAND is the command to execute (1.7.5+ supports parsing PAPI variables)
PLAYER_MESSAGE is the message sent to the player (optional)
BROADCAST_MESSAGE is the broadcast message (optional)

yaml

abilityList:
  - "COMMAND_ATTACK_CHANCE/25/eco give %player% 249/&6You received $249!/&a %player% &6received $249 from the companion &bPolaris Creator&6!"

At companion level 1, the owner has a 25% chance on attack to receive 249 coins. You can also configure an mm skill in the command part to trigger a skill on attack.

Both command abilities support %player% (player name), %companion% (companion key) and PAPI variables. The actual chance is the base chance + (level - 1) × ability.command.increaseChanceByLevel.

Cooldown configuration for other abilities

Config file: customability.yml

yaml

# Ability configuration
ability:
  # Potion ability message display mode, options: actionbar/message
  potionMessageType: "actionbar"
  # Mining night vision
  mining_vision:
    # Trigger height
    yLevel: 55
    # Blacklisted worlds
    blWorlds: [ ]
  # Unified chance for launch abilities
  launch:
    # Trigger chance, companion level * 5%
    chance: 5
    blWorlds: [ ]
  # Dash
  leap:
    # Play sound
    sound: ENTITY_MAGMA_CUBE_JUMP
    # Cooldown time
    cooldown: 30
    # Movement distance per level
    distanceMultiplier: 1
    blWorlds: [ ]
  # Fling
  fling:
    # Trigger chance, companion level * 5%
    chance: 5
    # Fling height
    distance: 0.8
    blWorlds: [ ]
  # Lightning
  lightning:
    # Cooldown time
    cooldown: 30
    blWorlds: [ ]
  # Chance to dodge when hit
  dodge:
    # Trigger chance, companion level * 5%
    chance: 5
    blWorlds: [ ]
  # Chance for speed boost when hit
  speed_burst:
    # Trigger chance, companion level * 5%
    chance: 5
    # Duration, companion level * value
    duration: 2
    blWorlds: [ ]
  # Chance to teleport when hit (throw ender pearl)
  enderMan:
    # Trigger chance, companion level * 5%
    chance: 5
    blWorlds: [ ]
  # Command type
  command:
    # Chance increase per level
    increaseChanceByLevel: 5
  # Potion types triggered on attack/being hit; the name, trigger chance, duration and cooldown can be customized per potion
  # Format: use the potion name as the key; if not configured, defaults are 5% chance per level, duration 5, cooldown 60 seconds
  speed:
    # Potion ability name shown in messages
    name: "Speed Boost"
    # Trigger chance, companion level * 5%
    chance: 5
    # Duration, companion level * value
    duration: 5
    # Cooldown after triggering (seconds)
    cooldown: 60

blWorlds is the list of worlds where the corresponding ability is disabled. Dash requires left-clicking air with an empty hand, and lightning requires attacking with an empty hand; the actual cooldown for both is the configured seconds divided by the companion level.

Potion trigger abilities can be configured individually with name, chance, duration and cooldown; ability.potionMessageType supports actionbar (action bar) and message (chat).

Companion Abilities ​