Mace Roulette Plugin

Heus Mace Roulette — Plugin Edition

The Mace spins. The arena waits. One player walks away.

A multiplayer Mace Roulette minigame for Minecraft Java 1.21.11.

10 independent rooms · 2–12 players per room · Spinning Mace selection · Optional round events

🔥 Why the Plugin Edition?

This is a fresh server-plugin version of the original Mace Roulette datapack. It keeps the roulette match at the center of the experience while making the lobby and controls feel more like a multiplayer server minigame:

• Click room items in a real inventory GUI instead of navigating a chat-only menu.
• Enter a compact iron lobby without importing hundreds of structure pieces.
• Adjust game rules in one admin menu instead of memorizing every setting command.

The plugin is installed as a JAR and does not require the datapack.

⚒️ How it works

1. Choose a room. Right-click the lobby compass and select one of ten rooms from a real chest-style menu.
2. Watch the Mace spin. Players are placed around the arena while the Mace display turns toward its chosen player.
3. Fight or survive. After a short grace period, the selected player receives a Mace and configurable Wind Charges. The Mace deals normal Minecraft damage.
4. Stay in the game. Eliminated players become Spectators. The last survivor wins.

The queue starts counting down when 2 players join. At 4 players, the remaining wait drops to at most 15 seconds. Joining a room that is already playing lets you spectate it.

✨ What the plugin adds

Feature · In game
10 separate rooms · Multiple matches can run without sharing their queues.
Spinning Mace selector · A physical Mace display spins in the arena before each selection.
Lightweight lobby · A circular iron-block floor within 20×20 blocks, surrounded by tall barrier walls.
Chest-style room menu · Click an item to queue for a room or watch a live match.
Admin settings GUI · Change time, Mace count, Wind Charges, arena rules, and events by clicking items.
English and Turkish · Players can choose their message language.

🎲 Seven optional round events

Anvil Rain · Glowing Silverfish · Safe Color · Crumbling Floor · Slime Floor · Ice Floor · Broken Arena

Turn events on or off from /heus settings. The same menu also controls safe borders, Mace-holder-only PvP, and arena shrinking.

🚀 Installation

1. Download the plugin JAR and put it in your server's plugins/ folder.
2. Restart the server.
3. As an operator, run /heus world. The iron lobby is created and players receive a room-selection compass.
4. Open /heus settings to adjust the game before playing.

Requires Java 21 and Minecraft Java 1.21.11. The plugin is built against the Spigot API and tested on Paper 1.21.11. It runs server-side; players do not need a client mod or resource pack. Spigot and CraftBukkit runtime testing has not been completed.

Important: This is a plugin JAR, not a datapack ZIP. Install it in plugins/, not in a world's datapacks/ folder. Do not run the datapack edition alongside the plugin in the same world.

🧭 Commands

Players

Command · What it does
/heus menu · Open the room menu without using the compass.
/heus join · Join or leave a room queue; spectate if the room is live.
/heus watch · Watch an active match.
/heus leave · Leave a queue or spectator view.
/heus lobby · Return to the lobby when available.
/heus lang en / /heus lang tr · Change message language.

Operators

Command · What it does
/heus world · Enable or disable the lobby mode.
/heus settings · Open the clickable settings menu.
/heus setup · Prepare a room manually.
/heus start · Start a prepared room.
/heus stop · Stop one room.
/heus stopall · Stop all rooms.

Direct settings commands

Command · Range / effect
/heus set time 10 · Mace round time: 1–300 seconds; default 5.
/heus set maces 2 · Mace holders per round: 1–12.
/heus set wind 3 · Wind Charges per holder: 0–64.
/heus set shrinkafter 3 · Rounds before shrinking: 1–100.
/heus toggle border · Toggle the arena's safe border.
/heus toggle maceonly · Toggle Mace-holder-only PvP.
/heus toggle shrink · Toggle arena shrinking.
/heus toggle addons · Toggle random round events.

Operator permissions: heus.admin is granted to server operators by default.

🇹🇷 Türkçe kısa rehber

Heus Mace Roulette, 10 ayrı odada oynanan çok oyunculu bir Mace minigame'idir. Lobideki pusulaya sağ tıkla, sandık menüsünden bir odaya katıl ve ortadaki Mace'in kimi seçeceğini izle. Elenenler Spectator olur; son kalan kazanır.

Kurulum: JAR dosyasını sunucunun plugins/ klasörüne koy, sunucuyu yeniden başlat ve OP olarak /heus world yaz. Ayarları /heus settings menüsünden değiştirebilirsin. İstemcide mod veya resource pack gerekmez.

0.1.x sürümünden geçiyorsan: Eski plugin JAR'ını kaldır. Büyük yapı tabanlı lobi artık yüklenmez; oyuncular yeni demir lobiye taşınır. Eski lobi blokları veri güvenliği için dünya dosyasından otomatik silinmez.