理念
转盘为服务器上的每位玩家提供恰好一次旋转机会。无论指针停在何处,那都将成为本局你的专属特性——它会在死亡、退出和重启后继续生效,除非管理员清除或开启新一轮,否则不会消失。有些特质是你想要炫耀的馈赠;有些则是你需要熬过整晚去规避的惩罚。大多数则介于两者之间,悄然重塑你的玩法:那个无法跳跃的人、被所有怪物追杀的目标、人人忌惮的玻璃大炮,以及连自家前门都挤不进去的巨人。
由于特性是固定且公开的,它会成为茶余饭后的谈资。人们会交易这些特性,联合起来欺负那些运气不佳的玩家,围绕某种祝福建造农场,或者恳求管理员进行重掷。在生存多人游戏(SMP)中,它为这一周增添了独特的风味;在活动模式中,它是一个快速易懂的 handicap(障碍/劣势)系统,无需任何解释即可上手。
旋转体验
输入 /wheel spin,一个老虎机滚轮会在你的动作栏上滚动显示 —— ❮ decoy ┃ TRAIT ┃ decoy ❯ —— 同时“转盘” Boss 条逐渐消耗,滴答声的音调不断升高。随着滚动进行,帧与帧之间的间隔拉长,使其视觉上减速并最终点击停止在你的特性上,而不是直接冻结。随后,标题毫无过渡地猛然出现,彩色粒子爆发出来(绿色图腾火花代表祝福,黑烟代表诅咒,附魔符文代表混合),并伴随匹配的声音响起—— triumphant(凯旋)、cursed(被诅咒)或 arcane(神秘)。
更喜欢技巧而非运气?将 spin-mode 切换为 draft(选秀模式),滚轮变为三张卡牌的 GUI:从三个候选项中选择一个,或由计时器为你随机选择。完全不想看表演?设置 animation.enabled: false 可瞬间完成旋转。
特性列表(共34个)
特性分为三个层级,每个层级由可配置的稀有度权重(普通 » 罕见 » 稀有)和每层级的乘数决定。每个特性还会共鸣:你持有它的时间越长,它就越强大——药水类特性获得更强的效果等级,数值类特性放大其数值,分别在 5 / 15 / 30 分钟时触发(均可调整)。
祝福 — 13个
swift 永久速度提升 · stone_skin 永久抗性提升 · night_owl 永久夜视 · quick_hands 永久急迫 II · lucky 幸运 + 村庄英雄 · ghostly 生物永远不会攻击你 · spiky 攻击者会受到反伤 · magnetic 附近的掉落物会自动向你飘移 · bloodhound 敌对生物穿透墙壁发光可见 · iron_gut 饥饿值永不下降 · vampiric 近战生命窃取 · adrenaline 低生命值时爆发速度与力量增益 · second_wind 每局存活一次致命打击
诅咒 — 10个
molasses 永久缓慢 · grounded 无法跳跃 · glass_bones 受到的伤害增加 50% · pacifist 你的近战造成零伤害 · spotlight 你始终对所有人生光 · hunted 怪物会锁定你 · bottomless_pit 饥饿值消耗速度加倍 · brittle 无自然恢复 · clumsy 攻击可能将你手中的物品击落 · explosive_end 死亡时会爆炸
混合 — 11个
moon_walker 跳跃 II + 无摔落伤害,但无法冲刺 · berserker 造成伤害 +50% / 受到伤害 +25% · photosynthetic 白天恢复,黑暗处挨饿 · nocturnal 夜间强大,白天虚弱 · featherweight 跳得更高,-2 颗心 · heavyweight 免疫击退,移动速度 -15% · giant 体型更大,更抗揍,攻击力更强 —— 但也更容易成为目标 · tiny 体型小且闪避高,脆弱且弱小 · pyromaniac 免疫火焰,遇水燃烧 · aquatic 在水中占优,陆地上迟缓 · glass_cannon 伤害翻倍,生命值减半
新增特性只需创建一个 Kotlin object —— 包含 ID、层级、稀有度、图标以及所需的钩子函数(onAssign / onTick / onRemove / onDeath,或响应式钩子如 onIncomingDamage、onJump、onFoodChange)。
运行方式
- 回合制 —
/wheel start 会在 Boss 条倒计时后同时为所有人旋转;/wheel start mirror 将整个服务器绑定到同一个共享特性。
- 全局事件 — Blood Moon(血月)向转盘注入大量诅咒(并强化它们),Golden Hour(黄金时刻)对祝福做同样的操作,Frenzy(狂热)每 30 秒重新旋转所有人的特性,Reshuffle(洗牌)将每个特性分配给不同的玩家。可以设置定时器,或通过
/wheel event 触发。
- 过期与轮换 — 让特性超时并重掷单个玩家的特性,或在固定时间间隔内重新旋转整个服务器的特性。
- 重掷 — 消耗经验等级进行再次旋转,可选设置每局上限。发放转盘代币作为任务/投票奖励:右键物品即可免费旋转。
- 交换 —
/wheel swap <player> 在两名自愿的玩家之间交换特性。
- 保底机制 — 连续三次抽到诅咒,下一次旋转将从祝福池中抽取。
- 屏幕 HUD — 可选的动作栏或 Boss 条显示,展示你的特性、共鸣星级和剩余时间。
底层实现
- Paper 26.2 API,基于 Kotlin 2.4 编写,专为 JDK 25 构建。单 jar 包,无外部运行时依赖;PlaceholderAPI 为可选软钩子。
- 事件驱动特性。每个特性实现一个小型
Trait 接口;一个监听器将 Bukkit/Paper 事件(PlayerJumpEvent、EntityDamageByEntityEvent、EntityTargetLivingEntityEvent、FoodLevelChangeEvent、世界变更、重生、退出……)分发给持有者的特性,并由一个每秒执行的任务驱动周期性效果。
- 属性修饰符,而非仅仅药水 —— Giant/Tiny/Glass Cannon/Heavyweight/Featherweight 通过命名空间的
AttributeModifier 调整 SCALE、MAX_HEALTH、ATTACK_DAMAGE、KNOCKBACK_RESISTANCE 和 MOVEMENT_SPEED,这些修饰符被干净地添加和移除,并在移除时重新钳制生命值。
- 加权随机数生成。抽取过程结合每个特性的稀有度权重、每层级的配置乘数、每稀有度的配置乘数以及任何激活的事件,然后进行单次加权选择(或在草案模式下进行三次独立选择)。
- 低成本持久化。分配情况和生命周期统计信息保存在内存中,并通过脏标志在定时器(及关闭时)刷新到 YAML 文件——一场 30 人局仅写入一次文件,而非三十次。分配情况携带时间戳,以便调谐和过期状态在重启后得以保留;旧的扁平存储格式仍可加载。
- 全程 Adventure UI —— 所有字符串均使用 MiniMessage,卷轴/倒计时/事件/HUD 使用 Boss Bar,结算画面使用标题和操作栏,广播消息包含悬停提示工具。
- 集成支持。提供 PlaceholderAPI 扩展(
%wheel_trait%、%wheel_tier%、%wheel_rarity%、%wheel_stage_stars%、%wheel_streak%、%wheel_event%、%wheel_spins%、%wheel_total_spins%、…),供其他插件使用的轻量级 WheelAPI,以及在每次分配时触发的不可取消的 TraitChangeEvent(包含 player、previous、trait、cause 字段)。集成 bStats 指标,可通过配置选择退出。
命令
/wheel(别名 /thewheel)
- 普通玩家:
spin、reroll、swap <player> / swap accept、menu、mine、list、traits [tier]、stats [player]、top、history
- 管理员:
start [now|mirror]、set <player> <trait>、token [player] [n]、event <kind|stop>、clear [player]、clearall、reload
权限
| 节点 |
默认值 |
|
wheel.spin |
所有人 |
旋转、打开菜单、查看特性 |
wheel.admin |
OP |
轮次、设置/清除、令牌、事件、重载 |
wheel.exempt |
— |
该玩家不受特性影响 |
wheel.trait.* |
所有人 |
按特性访问(仅在开启 per-trait-permissions 时检查) |
配置亮点
各层级和各稀有度的抽取权重 · 池中包含哪些特性 · per-trait-permissions · spin-mode(卷轴/草案模式) · animation(开/关/无粒子) · trait-duration-minutes(过期时间) · rotate(全服重抽) · attunement.stage-minutes · pity(保底机制) · hud.mode · events(池、间隔、每种事件的持续时间) · worlds 白名单/黑名单 · combat-lock-seconds · reroll 成本与上限 · spin-grace-seconds · metrics。
兼容性
适用于 Minecraft 26.2 上的 Paper(或其分支)及 Java 25。可独立运行;若存在则自动挂钩 PlaceholderAPI。按世界划分的特性作用域使其能够与大厅/创造世界无缝共存。
The idea
The Wheel hands everyone on your server exactly one spin. Whatever it lands on
becomes your thing for the session — it survives death, logout and restarts,
and only leaves when an admin clears it or starts a fresh round. Some traits
are gifts you'll want to show off. Some are punishments you'll spend the night
working around. Most sit in between and quietly reshape how you play: the
person who can't jump, the one every monster hunts, the glass cannon everybody
is scared to touch, the giant who can't fit through their own front door.
Because the trait is fixed and public, it turns into table talk. People trade
them, gang up on the unlucky ones, build farms around a blessing, or beg an
admin for a reroll. On an SMP it gives a week its own flavour; in an event it's
a fast, readable handicap system that needs zero explaining.
How a spin feels
Type /wheel spin and a slot-machine reel scrolls across your action bar —
❮ decoy ┃ TRAIT ┃ decoy ❯ — while a "wheel" boss bar drains and the tick
sound climbs in pitch. The gaps between frames stretch out as it goes, so it
visibly decelerates and clicks to a stop on your trait instead of just
freezing. Then a title slams in with no fade, a coloured particle burst fires
off (green totem sparks for a blessing, black smoke for a curse, enchant glyphs
for mixed) and you hear a sound that matches — triumphant, cursed, or arcane.
Prefer skill to luck? Flip spin-mode to draft and the reel becomes a
three-card GUI: pick one of three candidates, or let the timer pick for you.
Don't want the show at all? animation.enabled: false resolves spins instantly.
The traits (34)
Traits are grouped into three tiers, each drawn by a configurable
rarity weight (Common » Uncommon » Rare) and a per-tier multiplier. Every
trait also attunes: the longer you hold it, the stronger it gets — potion
traits gain amplifier levels, numeric traits scale their numbers, at the
5 / 15 / 30-minute marks (all tunable).
Blessings — 13
swift permanent Speed · stone_skin permanent Resistance · night_owl
permanent Night Vision · quick_hands permanent Haste II · lucky Luck +
Hero of the Village · ghostly mobs never target you · spiky attackers take
damage back · magnetic nearby drops drift to you · bloodhound hostile mobs
glow through walls · iron_gut hunger never drains · vampiric melee lifesteal
· adrenaline low-health Speed + Strength burst · second_wind survive one
killing blow per session
Curses — 10
molasses permanent Slowness · grounded you cannot jump · glass_bones
+50% damage taken · pacifist your melee deals zero · spotlight you glow for
everyone, always · hunted monsters home in on you · bottomless_pit hunger
drains twice as fast · brittle no natural regeneration · clumsy hits may
knock the item out of your hand · explosive_end you detonate when you die
Mixed — 11
moon_walker Jump II + no fall damage, but no sprint · berserker +50%
dealt / +25% taken · photosynthetic regen in daylight, starve in the dark ·
nocturnal strong at night, weak by day · featherweight jump higher, −2
hearts · heavyweight knockback-immune, 15% slower · giant bigger, tankier,
harder-hitting — and a bigger target · tiny small and evasive, frail and
weak · pyromaniac immune to fire, burned by water · aquatic dominant in
water, sluggish on land · glass_cannon double damage, half health
New traits are a single Kotlin object — an id, a tier, a rarity, an icon,
and whichever hooks it needs (onAssign / onTick / onRemove / onDeath,
or reactive ones like onIncomingDamage, onJump, onFoodChange).
Ways to run it
- Rounds —
/wheel start spins everyone at once behind a boss-bar
countdown; /wheel start mirror binds the whole server to one shared trait.
- Global events — Blood Moon floods the Wheel with curses (and buffs
them), Golden Hour does the same for blessings, Frenzy re-spins everyone
every 30 seconds, Reshuffle deals every trait to a different player. On a
timer, or fired with
/wheel event.
- Expiry & rotation — let traits time out and re-roll per player, or
re-spin the entire server on a fixed interval.
- Rerolls — spend XP levels for another go, with an optional per-session
cap. Hand out Wheel Tokens as quest / vote rewards: a right-click item
that spins for free.
- Swaps —
/wheel swap <player> trades traits between two consenting
players.
- Pity — draw three curses in a row and your next spin is pulled from the
blessing pool.
- On-screen HUD — an optional action-bar or boss-bar readout of your
trait, attunement stars and time remaining.
Under the hood
- Paper 26.2 API, written in Kotlin 2.4, built for JDK 25. Single
jar, no external runtime dependencies; PlaceholderAPI is an optional soft
hook.
- Event-driven traits. Each trait implements a small
Trait interface;
one listener fans Bukkit/Paper events (PlayerJumpEvent,
EntityDamageByEntityEvent, EntityTargetLivingEntityEvent,
FoodLevelChangeEvent, world-change, respawn, quit…) out to the holder's
trait, and a 1-second task drives the periodic effects.
- Attribute modifiers, not just potions — Giant/Tiny/Glass Cannon/
Heavyweight/Featherweight adjust
SCALE, MAX_HEALTH, ATTACK_DAMAGE,
KNOCKBACK_RESISTANCE and MOVEMENT_SPEED through namespaced
AttributeModifiers that are cleanly added and removed, with health
re-clamped on removal.
- Weighted RNG. The draw combines each trait's rarity weight with
per-tier and per-rarity config multipliers and any active event, then does a
single weighted pick (or three distinct picks for draft mode).
- Cheap persistence. Assignments and lifetime stats are held in memory and
flushed to YAML on a timer (and on shutdown) behind a dirty flag — a
30-player round is one file write, not thirty. Assignments carry a timestamp
so attunement and expiry survive a restart; the old flat save format still
loads.
- Adventure UI throughout — MiniMessage for every string, boss bars for
the reel / countdown / events / HUD, titles and action bars for the payoff,
hover tooltips on broadcasts.
- Integration. A PlaceholderAPI expansion (
%wheel_trait%, %wheel_tier%,
%wheel_rarity%, %wheel_stage_stars%, %wheel_streak%, %wheel_event%,
%wheel_spins%, %wheel_total_spins%, …), a small WheelAPI for other
plugins, and a cancellable-free TraitChangeEvent (player, previous,
trait, cause) fired on every assignment. bStats metrics, opt-out via
config.
Commands
/wheel (alias /thewheel)
- Anyone:
spin, reroll, swap <player> / swap accept, menu,
mine, list, traits [tier], stats [player], top, history
- Admin:
start [now|mirror], set <player> <trait>,
token [player] [n], event <kind|stop>, clear [player], clearall,
reload
Permissions
| Node |
Default |
|
wheel.spin |
everyone |
spin, open the menu, view traits |
wheel.admin |
op |
rounds, set/clear, tokens, events, reload |
wheel.exempt |
— |
traits have no effect on this player |
wheel.trait.* |
everyone |
per-trait access (checked only when per-trait-permissions is on) |
Config highlights
Draw weights per tier and per rarity · which traits are in the pool ·
per-trait-permissions · spin-mode (reel / draft) · animation (on / off /
particle-free) · trait-duration-minutes (expiry) · rotate (whole-server
re-spin) · attunement.stage-minutes · pity · hud.mode · events (pool,
interval, per-kind duration) · worlds whitelist/blacklist ·
combat-lock-seconds · reroll cost & cap · spin-grace-seconds · metrics.
Compatibility
Paper (or forks) on Minecraft 26.2, Java 25. Works standalone; hooks
PlaceholderAPI automatically if present. Per-world trait scoping means it
coexists with lobby/creative worlds out of the box.
评论 0
登录后参与评分
还没有评论,来抢沙发吧