NexusClasses

# 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 (https://modrinth.com/plugin/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 ```yaml 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+ - (https://modrinth.com/plugin/crqzys-nexuscore) (required)