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 switch for admins — no GUI, instant switch
• /class list to 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)