Content generated with AI — it may contain mistakes.

ExyliaClasses/Getting startedUpdated in v1.9.0

Introduction

What ExyliaClasses does: HCF-style classes a player enters by wearing an armour set, with passives, abilities, hold effects and weapons.

Page 1 of 203 min read

ExyliaClasses is an HCF-style class system. There is no menu and no command for players: a class is entered by wearing the armour set it asks for, and left by taking a piece off. Six classes ship as editable files, and a seventh is a seventh file.

What it does#

Each class is one YAML file in plugins/ExyliaClasses/lang/<language>/classes/, and nothing in the plugin is hardcoded to the six that ship.

ClassArmourWhat it does
ArcherLeatherSpeed III and Resistance II. Arrows stack marks on whoever they hit, up to four levels.
BardGoldEnergy-driven support. Seven items buff the whole clan inside 20 blocks, and holding one applies a weaker version continuously.
MinerIronHaste, Saturation and Night Vision, plus Invisibility whenever they are below Y 40.
RogueChainmailPermanent Invisibility, and a golden sword that backstabs for flat damage and breaks.
SorcererGold helmet and boots, chainmail bodyEnergy-driven offence. Eight items throw a debuff at every enemy inside 25 blocks.
TankTurtle helmet, netherite bodyResistance III at the cost of Slowness III, Weakness II and Mining Fatigue II.

A class file declares any combination of these pieces, and none of them are required:

PieceWhat it is
EquipmentThe armour that puts a player in the class. This is the only trigger there is.
Passive effectsPotion effects held for as long as the class is worn.
Special passivesPotion effects held only while a condition is true, such as being below a Y level.
AbilitiesRight-click an item to fire effects at yourself, your clan or everyone nearby. The item is consumed.
Hold effectsEffects applied continuously while a certain item is in the main hand.
WeaponsA mark weapon or a backstab weapon, each with its own rules.
EnergyAn optional resource abilities spend, regenerating every tick and shown in a boss bar.

What you need#

  • Paper 1.21.1 or newer (Folia needs 1.21.4 or newer) and Java 21.
  • ExyliaLib. The plugin stays off without it.
  • Nothing else. A clan plugin is optional but changes targeting, and PlaceholderAPI is only for showing the class on scoreboards.
Clans are optional but change the targeting

TO_CLAN and TO_ENEMY abilities ask ExyliaLib which players are on your side. With no clan plugin installed, a clan ability reaches only the caster and an enemy ability reaches everyone in range. See Abilities.

What you will have in ten minutes#

You install the jars, start the server and put on a full leather set: after a five-second warmup you are an Archer with Speed and Resistance, and a piece of sugar in your hand is a speed ability. Then you copy a class file, change the armour and the effects, run /classesadmin reload and have a class of your own.

It has no player menus, no database and no per-player storage. A player's class lives in memory and is dropped on death and on quit. The only commands are staff ones: /classesadmin reload and /classesadmin settings.

Something missing on this page? Tell us on Discord