Content generated with AI — it may contain mistakes.

ExyliaClasses/How it worksUpdated in v1.9.0

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.

Page 8 of 204 min read
   

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

yaml
energy:
  enabled: true
  name: "Energy"
  symbol: "⚡"
  color: "<#ffd82b>"
  max: 100
  regen-per-tick: 0.08
KeyDefaultWhat it does
enabledfalseMissing or false means the class has no energy at all.
nameEnergyRead 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#ffffffWritten into the bar as %energy_color%. Any colour tag the text module accepts; see Colours.
max100The cap.
regen-per-tick0.1Added 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-tickPer secondZero to 100
0.051100 s
0.081.662.5 s
0.1250 s
0.25520 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.

An ability with a cost on a class with no energy

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#

config.yml
yaml
energy-bar:
  enabled: true
  colour: "YELLOW"
  overlay: "NOTCHED_20"
 
mark-bar:
  enabled: true
  colour: "RED"
  overlay: "PROGRESS"
lang/en/messages.yml
yaml
boss-bars:
  energy: "%energy_color%%symbol% %energy% / %max%"
  mark: "%mark_color%%mark_icon% +%extra_damage%% {muted}(%time%)"
KeyWhat it does
enabledfalse hides that bar. The system still works; only the bar is gone.
colourPINK, BLUE, RED, GREEN, YELLOW, PURPLE or WHITE.
overlayPROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 or NOTCHED_20.
boss-bars.energy / boss-bars.markThe 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.energyValue
%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.markValue
%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.

Hiding the mark bar leaves marks with no timer

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