Active abilities

Powers players activate at will: for a few seconds they give large stats and then go on cooldown. They are unlocked and upgraded with currencies.


Configuration	`abilities.yml`
Menu	`menus/abilities.yml`
Command	`/ability` (aliases `/abilities`, `/habilidad`, `/poderes`)
Module	`abilities`

How they are used

In /ability, right click unlocks or upgrades an ability.
Left click selects it.
Sneak + right click with the pickaxe activates the selected one. Also with /ability use or shift + left click in the menu.
The action bar shows the remaining time. When it ends, the cooldown starts.

Configuration

yaml

settings:
  trigger: sneak-right-click     # or none to only use /ability use
  select-on-unlock: true

abilities:
  gold-rush:
    enabled: true
    name: "@abilities.names.gold-rush"
    description: "@abilities.names.gold-rush-description"
    icon: GOLD_BLOCK
    slot: 11
    max-level: 5
    currency: tokens
    cost: "25000 * 2.5 ^ {level}"          # {level} is the current level, 0 when locked
    required-pickaxe-level: 0
    permission: ""
    duration-seconds: "10 + {level} * 4"
    cooldown-seconds: "180 - {level} * 15"
    bonuses:
      sell: "0.5 + {level} * 0.25"
    activate-actions:
      - "[sound] ENTITY_PLAYER_LEVELUP 1 0.8"
      - "[title] &6&lGOLD RUSH;&7Sell value boosted for {time}"
    end-actions: []

Option	Does
`max-level` · `currency` · `cost`	Levels and unlock or upgrade price
`required-pickaxe-level` · `permission`	Requirements
`duration-seconds` · `cooldown-seconds`	Formulas of `{level}`
`bonuses`	Stats while active
`activate-actions` · `end-actions`	Actions on activation and on end, with `{player}`, `{ability}`, `{level}` and `{time}`

Included: gold-rush (selling), enchanted-frenzy (enchant chance) and scholar-focus (experience).

Commands

Command	Permission	Does
`/ability`	everyone	Menu
`/ability use`	everyone	Activates the selected ability
`/ability set <player> <ability> <level>`	`pulseprison.abilities.admin`	Sets a level
`/ability resetcooldown <player>`	`pulseprison.abilities.admin`	Clears the cooldown
`/ability reload`	`pulseprison.abilities.admin`	Reloads `abilities.yml`

Stats

/stats [player] (aliases /bonuses, /estadisticas) shows the total of every active bonus: attributes, boosters, crystals, armor, skins, masteries and abilities. See Stats.