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.
Example configs (click to expand) These are example configurations. You can fully customize language, messages, items, timers, voting, LuckyBlocks, scoreboard/tablist, and more.
Code (Text):
# ==============================================================================
# LuckyBlockBattle - Main Configuration
# ==============================================================================
# Base Settings
language: "EN" # DE | EN
testMode: false
# ==============================================================================
# SPAWNS & WORLDS (Please keep at the end of the file)
# ==============================================================================
/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.
Multiple game modes inside one unified match loop (no separate plugins needed)
Built-in kit system with 5 different kits for more gameplay variety
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.
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 if u don`t use single world mode!
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.
/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
5) Optional systems
Database (database.yml): YAML, SQLite, or MySQL (includes one-time YAML to SQL migration when switching backend)
OpenAI (openai.yml): enable only if you want AI questions (enabled + API key) and set luckyQuiz.aiEnabled accordingly
6) Permissions
Tip: The plugin ships with a structured permission system (player, premium, admin).
You can fully control access to gameplay features (vote/team/stats), inventory switch, and all setup/management commands.
luckyblockbattle.admin includes: luckyblockbattle.premium, luckyblockbattle.skip, luckyblockbattle.arena, luckyblockbattle.world, inventoryswitch.give, and all luckyblockbattle.admin.* rights
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. The plugin includes 8 different LuckyBlock colors with over 400 total outcomes, including 10 special items as well as event and structure outcomes. You can also integrate other LuckyBlock plugins (recommended) so external LuckyBlocks can be distributed in matches as well. (See config example below)
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).
Internal LuckyBlocks (fully configurable) Built-in LuckyBlock system with configurable drops, luck upgrades, effects, and optional integrations (give phase, quiz rewards, break trigger).
Code (Text):
# Internal LuckyBlocks (fully configurable)
# File: internal-luckyblocks.yml
# You can add/remove unlimited outcomes under "outcomes".
enabled: true
item:
material: 'YELLOW_STAINED_GLASS'
name: '&e&lLucky Block'
lore:
- '&7Break this block to roll an outcome.'
- '&7Configured in internal-luckyblocks.yml'
luckLoreLine: '&6Luck: &e+{luck}'
glow: true
# Hide enchant line on the Lucky Block item itself.
hideEnchants: true
unbreakable: false
customModelData: -1
# Luck system for internal Lucky Blocks.
# Upgrading works by crafting:
# 1x internal Lucky Block + 1x luck.upgrade.material
# in inventory crafting (2x2) or workbench (3x3).
luck:
enabled: true
default: 0
max: 100
upgrade:
enabled: true
step: 10
material: 'EMERALD'
allowInventoryCrafting: true
allowWorkbenchCrafting: true
# Positive/negative pool split:
# - If enabled, chance for positive outcomes scales with luck.
# - Existing legacy outcomes under "outcomes" are auto-classified by content
# unless category is set manually per outcome.
outcomeSelection:
splitPositiveNegative: true
positiveChanceAtLuck0: 50
positiveChanceAtLuck100: 90
# Default visibility for enchantments on outcome items.
# Per-item override:
# - hideEnchants: true/false
# - showEnchantments: true/false (alias, has priority)
outcomeDefaults:
hideEnchants: false