Polymart is now Voxel Shop! We're upgrading many features of the site, and during this open beta you will experience occasional bugs. Learn more
Ultimate LuckyBlockBattle Plugin, fully customizable, Map / Mode Vote, 4 Modes, [1.16.5 - 1.21.X]

The ultimate LuckyBlock Battle plugin for your server: a complete lobby-to-finale arcade match system built for fast, repeatable rounds with maximum variety and minimal admin effort.Play solo or in teams, vote maps and modes, and choose exactly which content is available in your rotation. Get four distinct modes in one unified flow, including a truly unique LuckyQuiz mode you won’t find anywhere else, optionally powered by AI questions or fully playable offline with large local question pools.
What is LuckyBlockBattle?
LuckyBlockBattle is an all-in-one minigame plugin that handles everything from lobby, countdown, and voting to the active mode, spectators, and the final decision. It features an internal LuckyBlock system with configurable drops, supports crafting “Lucky” onto blocks, and can integrate external LuckyBlock plugins (recommended) so those LuckyBlocks can be distributed as well.
Every module is toggleable, including scoreboard, tablist, holograms for stats (Top Wins, Top Kills), and database-backed stats storage. A built-in permissions system controls access to setup and management features, while customizable messages and item names let you match your server’s branding perfectly.

- Multiple game modes inside one unified match loop (no separate plugins needed)
- Guided in-game setup wizard that walks you step by step through the initial configuration
- Lobby and countdown orchestration (bossbars, sounds, messages, player state handling)
- Voting system for categories and maps, including weighted votes
- Team mode (team selection GUI, auto-assignment, configurable team sizes, colors, and names)
- Spectator system (join full or running rounds, visibility and chat controls)
- Final Arena phase as the decisive PvP endgame with clean winner detection (solo and teams)
- Network-ready flow with BungeeCord lobby sending and configurable fallback servers
- Stats system with multiple storage backends: YAML, SQLite, MySQL
- Full localization: German and English via central language files
- Extensive admin setup tools via commands (spawns, worlds, checkpoints, finishes, quiz buttons, border, and more)

LuckyBattle
Start with a pure LuckyBlock farming phase (for example 10 minutes) where players break LuckyBlocks to gear up fast. When the timer ends, everyone gets teleported into the Final Arena for the real fight and clean winner decision.

LuckyRace
A fast-paced run with lanes and checkpoints, built for jump and run maps or straight sprint tracks. Players race forward, break LuckyBlocks on the way, and secure progress via checkpoints. Hit the goal buttons to end the race, then it’s straight into the Final Arena for the final battle.

LuckyQuiz
Answer 15 questions (General Knowledge or Minecraft, selectable via lobby voting). After the quiz, players get a risk-reward offer, for example halve your LuckyBlocks by X% or double them by Y%. Then you enter a separate LuckyBlock farming map to cash in your strategy, and when the timer runs out, everyone moves to the Final Arena for the showdown.

AirBattle
Spawn above the action on a platform high over an island made of LuckyBlocks. Drop in, break LuckyBlocks, and build your advantage from the sky-down start. After the mode timer ends, players are teleported into the Final Arena for the decisive PvP endgame.


Quick setup (essentials)
Requirements:
Java 17+
Spigot/Paper compatible
Minecraft 1.16.5 to 1.21.X
Recommended: BungeeCord network (lobby flow)
Install:
Put LuckyBlockBattle.jar into plugins/
Start once, stop, edit configs in plugins/LuckyBlockBattle/, then run /lbb setup start
Mode selection:
Choose Bungee or Multi-Arena in config.yml. For Bungee, use a separate world for each map. For Multi-Arena, choose Multi-World or Single-World before running the setup.
Must set in-game:
Lobby spawn
Min/max players
Arena spawns (at least 2)
Spectator spawn
Plus mode-specific spawns (Race, Quiz)
Use a different world for each Map!
Setup guide:
Use /lbb setup start to begin the guided setup for the selected mode in config.yml. The setup guide walks you through all required locations and settings step by step. Use /lbb setup stop to end it at any time.
Suggested command order:
/lbb set lobbyspawn
/lbb minplayers {number}
/lbb maxplayers {number}
/lbb set arenaspawn {1-16} (set at least 2 slots)
/lbb set spectatorspawn
LuckyRace (per race map):
/lbb set finish LUCKY_RACE_MAP1|2|3 {1-16}
/lbb set checkpoint LUCKY_RACE_MAP1|2|3 {1-16} {1-10}
LuckyQuiz:
/lbb set modespawn LUCKY_QUIZ {1-16}
/lbb set quizbutton {slot} A|B|C|D|5050
Setup wizard:
/lbb setup start

Premium Feature Highlights (What makes it different)
InventorySwitch (2nd inventory):
Players can use a dedicated switch item (and/or command) to access a second in-game inventory. Perfect for minigames where you want "kit space" and "loot space" separated. Fully permission-based (toggle + give).
LuckyBlock ecosystem (internal + external support):
Built-in LuckyBlock system with configurable drop tables, plus crafting support to apply "Lucky" onto blocks. You can also integrate other LuckyBlock plugins (recommended) so external LuckyBlocks can be distributed in matches as well.
Everything is toggleable:
Enable or disable individual modules to fit your server style and performance goals: scoreboard, tablist, holograms, AI questions, game modes, and PvP per mode (Final Arena remains the decisive endgame).
Stats + Holograms (Top lists):
Track and display player performance with database-backed stats (YAML, SQLite, MySQL) and optional holograms like Top Wins and Top Kills. Includes a one-time YAML-to-SQL migration when switching storage backends (no repeated imports).
Final test checklist
- /lbb reload
- Run 1 to 2 test rounds (optional: /lbb testmode)
- Verify: countdown, teleports, mode phase, arena end, stats saving, language/messages

Example configs:
These are example configurations.
You can fully customize language, messages, items, timers, voting, LuckyBlocks, scoreboard/tablist, and more.
Minimal example config (config.yml):
This is a minimal starting point.
The plugin generates the full config with all options.
# ==============================================================================
# LuckyBlockBattle - Main Configuration (minimal example)
# ==============================================================================
language: "EN" # DE | EN
testMode: false
players:
minToStart: 2
maxPlayers: 16
countdown:
seconds: 60
network:
lobbyServer: "Lobby"
lobbyFallbackServers: []
# Main phase timers (seconds)
timers:
abbau:
seconds: 540
airBattle:
seconds: 540
luckyQuizArena:
seconds: 540
arena:
seconds: 600
# Arena winner decision is always PvP.
# You can enable/disable PvP per mode here.
pvp:
luckyBattle:
enabled: false
luckyRace:
enabled: false
airBattle:
enabled: false
luckyQuiz:
enabled: false
# Stats storage is configured in database.yml.
stats:
enabled: true
Commands:
Short help-style overview of all commands included in the current version.
Player commands:
- /lbb help [page] - Show the LuckyBlockBattle help pages (1-3).
- /arena - Skip the farming phase and start the PvP/Arena transition.
- /skip - Shorten the currently running countdown.
- /stats - View your stats (Kills, Deaths, K/D, Wins, Matches).
- /world {world} - Teleport to a world.
- /world list - List available worlds.
- /inventarswitcher - Receive the Inventory Switcher item.
- /inventarswitcher {player} - Give the Inventory Switcher to another player.
- /invswitch - Alias of /inventarswitcher.
- /is on|off - Enable or disable the Inventory Switcher for yourself.
Admin and setup commands (/lbb):
- /lbb setup start|stop|status|next|skip|reset|resetprompts - Control the guided in-game setup wizard.
- /lbb reload - Reload plugin configuration.
- /lbb testmode - Toggle test mode.
- /lbb skip - Shorten the countdown via LBB command.
- /lbb giveinternal {player} [amount] - Give internal LuckyBlocks.
- /lbb minplayers {number} - Set minimum players to start.
- /lbb maxplayers {number} - Set maximum players.
- /lbb set lobbyspawn - Set the lobby spawn.
- /lbb set modespawn {mode} {slot} - Set a spawn point for a mode.
- /lbb set modeworld {mode} {world} - Set the world used for a mode.
- /lbb set arenaspawn {slot} - Set an arena spawn.
- /lbb set arenaworld {world} - Set the arena world.
- /lbb set spectatorspawn - Set spectator spawn for the current world.
- /lbb set finish {map} {slot} - Start LuckyRace finish binding.
- /lbb set checkpoint {map} {slot} {index} - Set a LuckyRace checkpoint (stand on a pressure plate).
- /lbb set quizbutton {slot} A|B|C|D|5050 - Start quiz button binding.
- /lbb set holo personal|topkills|topwins - Set hologram position.
- /lbb del modespawn {mode} {slot} - Delete a mode spawn.
- /lbb del arenaspawn {slot} - Delete an arena spawn.
- /lbb del finish {map} {slot} - Delete a race finish.
- /lbb del checkpoint {map} - Delete the checkpoint on the current pressure plate.
- /lbb del checkpoint {map} {slot} {index} - Legacy checkpoint delete mode.
- /lbb del holo personal|topkills|topwins - Delete a hologram.
lbb arena ... (LOCAL_MULTI only)
- /lbb arena list - Show all available arenas.
- /lbb arena join {name} - Join the selected arena.
- /lbb arena leave {name} - Leave the selected arena.
- /lbb arena create {name} - Create a new arena.
- /lbb arena delete {name} - Delete an existing arena.
- /lbb arena select {name} - Select an arena for setup or editing.
- /lbb arena sign {name} - Create a join sign for the selected arena.
- /lbb arena return {name} - Return to the selected arena after setup.
Border commands:
- /lbb borderpos1 - Set the first border corner.
- /lbb borderpos2 - Set the second border corner.
- /lbb borderset - Save and enable the border.
- /lbb borderclear - Remove the border in the current world.
Permissions:
Base tier
- luckyblockbattle.player
Premium tier
- luckyblockbattle.premium
Admin tier
- luckyblockbattle.admin
Full permission list:
- luckyblockbattle.player
- luckyblockbattle.premium
- luckyblockbattle.admin
- luckyblockbattle.admin.setup
- luckyblockbattle.admin.reload
- luckyblockbattle.admin.testmode
- luckyblockbattle.admin.giveinternal
- luckyblockbattle.admin.minplayers
- luckyblockbattle.admin.maxplayers
- luckyblockbattle.admin.set
- luckyblockbattle.admin.set.lobbyspawn
- luckyblockbattle.admin.set.modespawn
- luckyblockbattle.admin.set.modeworld
- luckyblockbattle.admin.set.finish
- luckyblockbattle.admin.set.checkpoint
- luckyblockbattle.admin.set.quizbutton
- luckyblockbattle.admin.set.arenaspawn
- luckyblockbattle.admin.set.arenaworld
- luckyblockbattle.admin.set.spectatorspawn
- luckyblockbattle.admin.set.holo
- luckyblockbattle.admin.del
- luckyblockbattle.admin.del.modespawn
- luckyblockbattle.admin.del.arenaspawn
- luckyblockbattle.admin.del.holo
- luckyblockbattle.admin.del.finish
- luckyblockbattle.admin.del.checkpoint
- luckyblockbattle.admin.borderpos
- luckyblockbattle.admin.borderset
- luckyblockbattle.admin.borderclear
- luckyblockbattle.vote
- luckyblockbattle.team
- luckyblockbattle.skip
- luckyblockbattle.arena
- luckyblockbattle.stats
- luckyblockbattle.coins
- luckyblockbattle.kits
- luckyblockbattle.world
- inventoryswitch.give
- inventoryswitch.toggle
- luckyblockbattle.coins
- luckyblockbattle.kits
More Pictures:




Have fun!
-------------