Astral Realms Documentation Help

Configuration

AstralClasses is configured via plugins/AstralClasses/config.yml. Reload with /class reload (permission: class.command.reload).

config.yml

The main configuration file controls class system behaviour and which server groups have access to skills and double-jump.

default-class: "mage" starting-level: 1 double-jump-enable-groups: - tower skill-enable-groups: - tower

Key

Type

Default

Description

default-class

String

—

The class assigned to new players. Must be a valid class defined in classes/.

starting-level

int

—

Initial level for new players joining a class.

double-jump-enable-groups

List\<String\>

[]

Server groups (from AstralPaperAPI) where double-jump is enabled. If the current server's group appears here, double-jump features are active.

skill-enable-groups

List\<String\>

[]

Server groups where skills are enabled. If the current server's group appears here, the skill system (skill service, listeners, and casting) is initialized.

verbose-running

boolean

false

Optional. When true, enables debug logging to help troubleshoot class system issues.

Enable-groups semantics

The double-jump-enable-groups and skill-enable-groups keys use server group filtering. The plugin queries the current server's group via AstralPaperAPI.serverInformation().group() at startup:

  • If the group is in skill-enable-groups, SkillService is constructed and loaded (which also loads double-jump.yml), the input packet listener is registered, and ability/skill casting is live.

  • If the group is not in skill-enable-groups, SkillService is never constructed at all — abilities, cooldowns, and (see below) double jump are all unavailable, regardless of double-jump-enable-groups.

  • double-jump-enable-groups is a second, narrower gate checked inside SkillService.tryTriggerSpace() — it only takes effect for groups that already passed the skill-enable-groups check.

For example, if your server group is tower and skill-enable-groups: [tower], skills are enabled; if the group is survival and only [tower] is listed, skills (and double jump) remain disabled.

Reloading configuration

The /class reload command reloads config.yml and refreshes:

  • Class definitions from classes/

  • Menu configuration from menus/main.yml

  • Double-jump settings from double-jump.yml, and skill/ability state — both only if SkillService was already constructed at plugin startup (i.e. the group was in skill-enable-groups on enable; see Commands — /class reload)

  • The weapon class item supplier

  • Classes — Individual class definitions are documented at Classes. Class files reside in plugins/AstralClasses/classes/ and are loaded by the class service.

  • Double-jump — Double-jump feature settings are documented at Double Jump. Configuration is stored in plugins/AstralClasses/double-jump.yml.

  • Menus — The main class menu is configured in plugins/AstralClasses/menus/main.yml and opened via /class (permission: class.command.open).

Last modified: 25 July 2026
InstallationClasses