How energy works
How a class's energy bar fills and is spent by abilities, how fast it refills, and how to style the energy and mark boss bars.
Energy is a resource a class can have. Abilities spend it, it refills on its own, and a boss bar shows it. It is per class and optional: without it, abilities are limited by cooldown alone. This page explains how it behaves and how to style the two bars (energy and mark).
Turning it on for a class#
Add an energy block to the class file (see Edit or add a class), then give abilities an energy-cost (see Abilities):
energy:
enabled: true
name: "Energy"
symbol: "⚡"
color: "<#ffd82b>"
max: 100
regen-per-tick: 0.08| Key | Default | What it does |
|---|---|---|
enabled | false | Missing or false means the class has no energy at all. |
name | Energy | Read from the file, but not printed anywhere by the plugin today. |
symbol | ⚡ | Written into the bar below as %symbol%, which is a value the bar is given rather than a registered placeholder. Anything outside the plugin reads the same character as %exyliaclasses_classes_energy_symbol%. |
color | #ffffff | Written into the bar as %energy_color%. Any colour tag the text module accepts; see Colours. |
max | 100 | The cap. |
regen-per-tick | 0.1 | Added every tick, so multiply by 20 for per second. |
How it behaves#
Energy starts at zero when the class activates, so a player who swaps into a Bard cannot immediately cast. It then fills at regen-per-tick every tick until it reaches max.
regen-per-tick | Per second | Zero to 100 |
|---|---|---|
0.05 | 1 | 100 s |
0.08 | 1.6 | 62.5 s |
0.1 | 2 | 50 s |
0.25 | 5 | 20 s |
An ability's energy-cost is checked before its effects run. Not enough and the player is told what they need and what they have, the cooldown does not start, and the item is not consumed. Energy is reset to zero and its bar removed when the class ends, on death and on quit.
The class has no energy, so the player's energy is zero, so any energy-cost above zero can never be paid. Either give the class an energy block or leave the cost at 0.
The bars#
There are two boss bars: the energy bar and the mark bar (shown on a player who has been hit by a mark weapon; see Weapons). Their look is shared by every class and lives in config.yml; their titles are text and live in messages.yml.
Change them in game#
Run /classesadmin settings (needs exyliaclasses.admin.settings). The menu shows one card per bar: Energy bar and Mark bar. Open one and click Show bar, Colour or Segments to change that setting; Back returns to the list. See Edit menus for how these cards behave.
Change them in the files#
energy-bar:
enabled: true
colour: "YELLOW"
overlay: "NOTCHED_20"
mark-bar:
enabled: true
colour: "RED"
overlay: "PROGRESS"boss-bars:
energy: "%energy_color%%symbol% %energy% / %max%"
mark: "%mark_color%%mark_icon% +%extra_damage%% {muted}(%time%)"| Key | What it does |
|---|---|
enabled | false hides that bar. The system still works; only the bar is gone. |
colour | PINK, BLUE, RED, GREEN, YELLOW, PURPLE or WHITE. |
overlay | PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 or NOTCHED_20. |
boss-bars.energy / boss-bars.mark | The titles, in messages.yml. Palette tokens, colour tags and placeholders all work; see Messages and languages. |
Values available in each bar#
These are supplied to the bar itself, and are not the same thing as the plugin's placeholders: they only work inside these two titles.
In boss-bars.energy | Value |
|---|---|
%energy_color% | The class's energy.color. |
%symbol% | The class's energy.symbol. |
%energy% | Current energy, one decimal. |
%max% | The cap, whole. |
In boss-bars.mark | Value |
|---|---|
%mark_color% | The current mark level's color. |
%mark_icon% | Its icon. |
%extra_damage% | Its extra-damage, whole. |
%time% | Seconds left on the mark, counted down by the bar. |
The energy bar's fill is energy over max. The mark bar's fill is the countdown over mark-duration, and reaching the end is what expires the marks.
Turning the mark bar off with enabled: false leaves marks with nothing to expire them until the player dies, quits or leaves the class.
Something missing on this page? Tell us on Discord