Class Selection banner
Class Selection icon

Class Selection

when a player joins for the first time: they cannot move a class selection screen appears they must choose one class: warrior (tank) assassin (melee dps)...

20
paperServer1.21.1mod

Class Selection plugin for Paper 1.21.1

  • Forces new players to pick a class before moving: joins without a saved class open a 27-slot GUI, movement is blocked, and the menu reopens if closed until a class is chosen.
  • Uses ItemsAdder icons for the GUI (classselection:warrior_icon, classselection:assassin_icon, classselection:archer_icon, classselection:mage_icon, with an optional classselection:menu_frame filler). Vanilla items are used as fallbacks if the IDs are missing or ItemsAdder is absent.
  • On selection, the choice is stored in classes.yml, players regain movement, and MMOCore is invoked to set the class (API reflection first, then the fallback console command mmocore admin class set <player> <class>).
  • If MMOCore already knows a player’s class (e.g., before installing this plugin), it is detected on join and saved to skip forcing a new pick.
  • Class buttons: Warrior (tank), Assassin (melee DPS), Archer (ranged DPS), Mage (magic DPS). Text components are used for modern chat titles.
  • Limitations: MMOCore class IDs must match the configured values; adjust the fallback command if your MMOCore command layout differs. Ensure the ItemsAdder assets exist so the GUI shows custom icons instead of vanilla placeholders.

Server Validation

Server validation passed - The mod was tested on a real Minecraft server and loaded successfully.