StaffSMP

适用于 SMP 服务器的基于职业的法杖模组。 五种截然不同的职业,每种职业拥有独特的 3D 法杖、两个主动技能以及一个定义该职业的被动态。使用 /class 手动选择你的职业,或者运行 /staffsmp start 为服务器上的每位玩家随机分配一个职业。不喜欢当前职业?制作一个 Reroller(重选器) 来更换其他职业。
专为 Paper 1.21.x 构建,并附带配套资源包(1.21.4+)以支持自定义法杖和投射物模型 —— 获取地址:StaffSMP Resource Pack。
五大职业
| 职业 |
右键点击 |
Shift + 右键点击 |
被动效果 |
| Electric Wizard |
向准星方向召唤闪电(60 格距离) |
进行空间传送,路径上伤害任何实体 |
— |
| Mage |
发射带有自定义 3D 模型的火球 |
短暂悬浮,随后缓慢下落以便瞄准射击 |
— |
| Monk |
快速向前冲刺(0.4 秒冷却) |
向最近的玩家跳跃;落地时产生冲击波击退 + 伤害 |
二段跳 · 无摔落伤害 |
| Druid |
投掷一个治疗 AOE 球,爆炸后变为心形图标 |
为目标(或自身)施加速度 + 急迫增益 |
最大生命值 +2 颗心 |
| Ranger |
引导一道细激光束,持续对目标造成伤害 |
在你脚下释放风之充能 —— 径向击退 + 确保火箭跳跃成功 |
— |
所有技能均可配置冷却时间、范围和伤害值。
功能特性
职业锁定
首次通过 /class 选择职业后,即被锁定。只有操作员(Operator)可以通过 /staffadmin give 更改你的职业。
随机 SMP 模式
运行 /staffsmp start,所有在线玩家将立即被重新随机分配到一个职业,并伴随不死图腾屏幕闪烁音效与末影龙死亡咆哮音效。此后新加入的玩家在连接时也会自动随机分配职业。这些特效仅在每个玩家首次获得法杖时播放 —— 重选时不会造成声音混乱。
职业重选器 (Class Reroller)
制作一个 Class Reroller 以更改你的职业:
Netherite Diamond Netherite
Diamond Heart of the Sea Diamond
Netherite Diamond Netherite
右键点击重选器打开职业选择 GUI,显示全部 5 种法杖 —— 点击你想变成的那个职业。重选器在使用后会被消耗,且受可配置的冷却时间限制。
不想使用 GUI?在配置文件中设置 reroller.gui: false,则重选器将立即随机分配一个职业(每个职业概率为 20%,包含当前职业)。
按技能的 Boss Bar 冷却提示
每个技能的冷却时间都会以独立的彩色 Boss Bar 形式显示在屏幕顶部 —— 并可与其他活跃技能的冷却条叠加,让你始终清楚哪些技能可用。颜色按职业区分:
- ? Wizard —— 蓝色
- ? Mage —— 红色
- ? Monk —— 黄色
- ? Druid —— 绿色
- ⬜ Ranger —— 白色
- ? Reroller —— 紫色
信任系统
/staff trust <player> 使你的法杖技能对该玩家无害。/staff untrust <player> 撤销信任。/staff list 显示你正在信任的玩家列表。信任关系是单向的,并在重启后持久保存。
禁止掉落法杖
法杖和重选器无法通过 Q 键丢弃、拖入箱子、Shift 点击放入容器、放置在物品展示框中,也无法挂在盔甲架上。此限制是绝对的 —— 即使是操作员也无法丢弃它们(请使用 /staffadmin reset 清理玩家的物品栏)。合成台不受此限制,以便你能正常使用重选器的配方。
死亡保留
带着法杖死亡后,它会在你重生时自动归还给你。法杖会从你的死亡掉落物中移除,防止被拾取。
自伤免疫
你自己的技能永远不会伤害到你 —— 避免意外火箭跳跃掉入虚空,或在近距离攻击时被闪电击中。
每玩家一柄法杖
职业变更时会清除旧法杖并干净地给予新法杖。如果你希望法杖可堆叠,可在配置文件中切换此选项。
命令
玩家命令
/class <wizard|mage|monk|druid|ranger> —— 选择起始职业(一次性操作)
/staff trust <player> —— 信任某玩家;你的法杖不会对其造成伤害
/staff untrust <player> —— 撤销信任
/staff list —— 显示你正在信任的玩家列表
操作员命令 (staffsmp.admin, 默认 OP)
/staffsmp start —— 启动 SMP 模式:为所有在线玩家随机分配 + 新加入者自动随机分配
/staffsmp stop —— 停止加入时自动随机分配(现有职业保持不变)
/staffsmp status —— 检查 SMP 模式状态
/staffadmin give <player> <class|reroller> —— 强制分配职业或授予重选器
/staffadmin reset <player> —— 清除玩家的职业、被动效果和法杖
/staffadmin info <player> —— 查看玩家当前职业
/staffadmin reload —— 重载 config.yml
配置
所有设置均可在 plugins/StaffSMP/config.yml 中调整:
- 各技能的冷却时间、范围、伤害值、投射物数量
- 重选器的冷却时间及是否开启 GUI 或直接随机分配
- 掉落限制(
no-drop、one-staff、keep-on-death)—— 各项均可单独开关
- 巫师闪电伤害与半径、法师火球产量、武僧冲击波击退力度、游侠激光持续时间、德鲁伊治疗量等
安装步骤
- 将
StaffSMP-1.0.0.jar 放入服务器的 plugins/ 文件夹
- 启动服务器(生成
plugins/StaffSMP/config.yml)
- 为了视觉效果:安装 StaffSMP Resource Pack 到你的客户端(或通过服务器资源包分发)。该资源包使用新的 1.21.4+ 物品模型格式,并包含:
- 绑定到
minecraft:blaze_rod 的 5 个独特 3D 法杖模型(通过自定义模型数据实现)
- 自定义的火球与治疗球投射物模型,在飞行过程中跟随法术实体
- 3D Class Reroller 模型
- 执行
/class wizard(或其他任意职业)—— 获得你的烈焰棒法杖
- 若要启动随机分配 SMP 模式:执行
/staffsmp start
要求
- Paper 1.21.x(基于 1.21.1 API 构建;可在后续 1.21.x 版本中运行)
- 资源包需要 Minecraft 1.21.4+(使用现代的
items/ 模型选择器)
- Java 21
致谢
感谢 Yoink1975 提供创意和模型。
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
- Drop
StaffSMP-1.0.0.jar into your server's plugins/ folder
- Start the server (generates
plugins/StaffSMP/config.yml)
- 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
/class wizard (or any class) — receive your blaze-rod staff
- 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧