NexusClasses — Class Selection & Switching for NexusCore
Give every player a class from the moment they join — with a beautiful GUI, a configurable switch cost, and full admin control.
NexusClasses is the first official addon for NexusCore. It adds a complete class selection and switching system on top of NexusCore's class framework — no config nightmare, no bloat.
Requires NexusCore to be installed on the server.
How it works
First join
When a player joins for the first time without a class, they are immediately frozen — they cannot move, take damage, deal damage, open their inventory, or interact with anything. A GUI opens automatically after a short delay (configurable) and stays open until they make a choice. There's no escaping it.
Class selection GUI
A clean inventory GUI shows all available classes (including any registered by other NexusCore addons) with their stats and description. One click — done. The player is unlocked and ready to play.
Switching classes
Players who already have a class can use /class switch to open the switch GUI. Switching costs items — by default 5 Diamonds, fully configurable per material and amount. Admins can switch for free, either through the GUI or directly via /class switch .
Features
- Inventory GUI for class selection with stat previews
- Automatic GUI on first join — player is fully locked until they choose
- No movement, no damage, no interactions while classless
- Configurable item cost to switch classes (material + amount)
- Free switching for admins via permission or direct command
- Works with any class registered by other NexusCore addons — not hardcoded to Warrior/Mage/Archer
/class switchfor admins — no GUI, instant switch/class listto see all available classes- Tab-completion for all commands
Commands
| Command | Description |
|---|---|
/class info |
Show your current class and stats |
/class select |
Open class selection GUI (first time only) |
/class switch |
Open class switch GUI (costs items) |
/class switch |
Switch instantly, no cost (admin) |
/class list |
List all available classes |
Permissions
| Permission | Default | Description |
|---|---|---|
nexusclasses.use |
everyone | Use /class commands |
nexusclasses.admin |
op | Free class switching, bypass cost |
Configuration
class-switch-cost:
enabled: true
material: DIAMOND # Any valid Bukkit material
amount: 5
no-class-message: "&cYou must choose a class before playing!"
gui-open-delay-ticks: 40 # 20 ticks = 1 second
Requirements
- Paper 1.21+
- Java 21+
- NexusCore (required)
