Logo
NexusClasses
PluginLicenseRef-All-Rights-Reserved

NexusClasses

NexusCore addon that forces players to pick a class on first join via a GUI, freezing them until they choose. Class switching costs configurable items.

30
Downloads
0
Followers
1 months ago
Updated
📦
1
Versions
adventuregame-mechanicsmagicpaper
Download Latestv1.0View on Modrinth

📖About 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 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