StaffSMP

Class-based magic staves for SMP servers. Five distinct classes, each with a unique 3D staff, two active abilities, and a class-defining passive. Pick your class manually with /class, or fire up /staffsmp start to randomly roll one for every player on the server. Don't like your class? Craft a Reroller to swap into another.

Built for Paper 1.21.x with a companion resource pack (1.21.4+) for the custom staff and projectile models — grab it here: StaffSMP Resource Pack.

---

The five classes

Class	Right-click	Shift + Right-click	Passive
Electric Wizard	Strike a lightning bolt at your crosshair (60 blocks)	Teleport through space, damaging any entity caught in the path	—
Mage	Launch a fireball with a custom 3D model	Brief levitation, then slow-falling for aimed fire	—
Monk	Quick forward dash (0.4s cooldown)	Leap toward the nearest player; shockwave knockback + damage on landing	Double jump · No fall damage
Druid	Throw a healing AOE ball that explodes into hearts	Buff your target (or self) with Speed + Haste	+2 hearts max health
Ranger	Channel a thin laser beam that ticks damage on target	Drop a wind-charge under you — radial knockback + guaranteed rocket-jump	—

All abilities have configurable cooldowns, ranges, and damage values.

---

Features

Class locking

After your first /class pick, you're committed. Only operators can change your class via /staffadmin give.

Random SMP mode

Run /staffsmp start and every online player is instantly re-rolled into a random class with a totem-of-undying screen flash and the Ender Dragon death roar. Every new joiner from that point on is auto-rolled on connect. Effects only play on each player's first-ever staff give — no cacophony on rerolls.

Class Reroller

Craft a Class Reroller to change your class:

Netherite    Diamond            Netherite
Diamond      Heart of the Sea   Diamond
Netherite    Diamond            Netherite

Right-click the reroller to open a class-picker GUI showing all 5 staves — click the one you want to become. The reroller is consumed on use and respects a configurable cooldown.

Don't want the GUI? Set reroller.gui: false in config and the reroller will instantly roll a random class (20% chance per class, current class included).

Per-ability boss bar cooldowns

Every ability cooldown shows as its own colored boss bar at the top of your screen — and stacks alongside other active cooldowns, so you always know exactly what's available. Color-coded by class:

• 🟦 Wizard — blue
• 🟥 Mage — red
• 🟨 Monk — yellow
• 🟩 Druid — green
• ⬜ Ranger — white
• 🟪 Reroller — purple

Trust system

/staff trust <player> makes your staff abilities pass through that player harmlessly. /staff untrust <player> reverses it. /staff list shows who you're trusting. Trust is directional and persists across restarts.

No more dropped staves

Staves and rerollers can't be dropped via Q, drag-and-dropped into chests, shift-clicked into containers, placed in item frames, or stuck on armor stands. The restriction is absolute — even operators can't drop them (use /staffadmin reset to clean a player's inventory instead). The crafting table is exempt so you can actually use the reroller recipe.

Keep on death

Die with your staff and it's automatically returned to you on respawn. The staff is stripped from your death drops so it can't be looted.

Self-damage immunity

Your own abilities never hurt you — no rocket-jumping yourself into the void by accident, no lightning-bolting yourself on close-range strikes.

One staff per player

Class changes always strip old staves and give a new one cleanly. Toggleable in config if you want stackable staves.

---

Commands

Player

• /class <wizard|mage|monk|druid|ranger> — Pick your starting class (one-shot)
• /staff trust <player> — Trust a player; your staff won't damage them
• /staff untrust <player> — Revoke trust
• /staff list — Show who you're trusting

Operator (staffsmp.admin, default op)

• /staffsmp start — Begin SMP mode: roll all online players + auto-roll joiners
• /staffsmp stop — Halt auto-rolling on join (existing classes preserved)
• /staffsmp status — Check SMP mode state
• /staffadmin give <player> <class|reroller> — Force-assign a class or grant a reroller
• /staffadmin reset <player> — Wipe a player's class, passives, and staves
• /staffadmin info <player> — View a player's current class
• /staffadmin reload — Reload config.yml

---

Configuration

Everything is tunable in plugins/StaffSMP/config.yml:

• Per-ability cooldowns, ranges, damage values, projectile counts
• Reroller cooldown and whether the GUI opens or instant-rolls
• Drop restrictions (no-drop, one-staff, keep-on-death) — each individually toggleable
• Wizard bolt damage and radius, mage fireball yield, monk shockwave knockback, ranger laser duration, druid heal amount, etc.

---

Installation

1. Drop StaffSMP-1.0.0.jar into your server's plugins/ folder
2. Start the server (generates plugins/StaffSMP/config.yml)
3. For the visuals: install the StaffSMP Resource Pack on your client (or distribute via server resource pack). The pack uses the new 1.21.4+ item-model format and includes:
   • 5 unique 3D staff models bound to minecraft:blaze_rod via custom model data
   • Custom fireball + healing-ball projectile models that follow the spell entities in flight
   • 3D Class Reroller model
4. /class wizard (or any class) — receive your blaze-rod staff
5. To kick off random-roll SMP mode: /staffsmp start

---

Requirements

• Paper 1.21.x (built against 1.21.1 API; runs on later 1.21.x versions)
• Resource pack requires Minecraft 1.21.4+ (uses the modern items/ model selector)
• Java 21

---

Credits

Thanks to Yoink1975 for the idea and models.