Sueta

LuckyBlockBattle [Free] ⭐ | Solo or Teams ⚔️ | 1 Mode ✅ | 1

2.3

Ultimate LuckyBlockBattle Plugin - Bungee / Multi-Arena - Customizable

·Plugin
DescriptionUpdates10Version history10AddonsDiscussionReviews
Tested MC versions
1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 26.1, 26.2, 26.3

Screenshot 2026-03-02 145828.jpg
Screenshot 2026-03-08 2344gfgdf10.png

This is the free version of LuckyBlock Battle. It comes with one game mode, LuckyBattle, and one map. In local mode, only one arena is available. This version also does not support MySQL or SQLite. If you enjoy the plugin and would like to support the project, feel free to check out the Premium version, which includes 3 additional exclusive modes :D:
https://www.spigotmc.org/resources/luckyblockbattle-⭐-solo-or-teams-⚔️-4-modes-✅-1-16-5-1-21-x-⭕.133064/

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.

config.yml (main configuration)
1) Base + Network
# ==============================================================================
# LuckyBlockBattle - Main Configuration
# ==============================================================================

# Base Settings
language: "EN" # DE | EN
testMode: false

# Network Settings (BungeeCord)
network:
  lobbyServer: "Lobby"
  lobbyFallbackServers: []
  statusMotd:
    lobby: "LOBBY"
    countdown: "LOBBY"
    ingame: "INGAME"
    restarting: "RESTARTING"
    resetting: "RESTARTING"
    disabled: "OFFLINE"
2) Players + Countdown + Timers
# Player Settings
players:
  minToStart: 2
  minWhileCounting: 2
  shortenAt: 3
  maxPlayers: 16

# Countdown Settings
countdown:
  seconds: 60
  shortenToSeconds: 12
  waitingMessageDelayTicks: 40

# Timer Settings (Duration of phases in seconds)
timers:
  abbau:
    seconds: 540
  airBattle:
    seconds: 540
  luckyQuizArena:
    seconds: 540
  toArena:
    announceAt: [60, 20, 10, 5, 4, 3, 2, 1]
  arena:
    seconds: 600
    announceAt: [60, 20, 10, 5, 4, 3, 2, 1]
3) Round end + Spectators
# Round End Settings
roundEnd:
  delaySeconds: 10
  winnerCelebrationSeconds: 8
  restartCommand: "restart"
  autoEndAfterSeconds: 0

round:
  allowMultiplePerBoot: false

# Spectator System
spectator:
  joinIfFull: true
  joinIfLive: true
  showScoreboard: true
  showCountdown: true
  chatOnly: false
4) Voting (categories, maps, weights, items)
# Voting System
vote:
  guiTitle: "&9Map Vote"
  confirm:
    enabled: true
    message: "&7You voted for &9{map}&7."
  premiumWeightEnabled: true
  premiumWeight: 2

  # Manual slot configuration (-1 for automatic symmetry)
  slots:
    categories:
      LUCKY_BATTLE: -1
      LUCKY_RACE: -1
      AIR_BATTLE: -1
    maps:
      LUCKY_BATTLE_MAP1: -1
      LUCKY_BATTLE_MAP2: -1
      LUCKY_BATTLE_MAP3: -1
      LUCKY_RACE_MAP1: -1
      LUCKY_RACE_MAP2: -1
      LUCKY_RACE_MAP3: -1
      AIR_BATTLE_MAP1: -1
      AIR_BATTLE_MAP2: -1
      AIR_BATTLE_MAP3: -1
      LUCKY_QUIZ: -1

  # Item Material configuration
  materials:
    categories:
      LUCKY_BATTLE: "SPONGE"
      LUCKY_RACE: "GOLDEN_BOOTS"
      AIR_BATTLE: "FEATHER"
    maps:
      LUCKY_BATTLE_MAP1: "GRASS_BLOCK"
      LUCKY_BATTLE_MAP2: "GRASS_BLOCK"
      LUCKY_BATTLE_MAP3: "GRASS_BLOCK"
      LUCKY_RACE_MAP1: "DIAMOND_BOOTS"
      LUCKY_RACE_MAP2: "DIAMOND_BOOTS"
      LUCKY_RACE_MAP3: "DIAMOND_BOOTS"
      AIR_BATTLE_MAP1: "FEATHER"
      AIR_BATTLE_MAP2: "FEATHER"
      AIR_BATTLE_MAP3: "FEATHER"
      LUCKY_QUIZ: "BOOK"

  weightsNoVotes:
    LUCKY_BATTLE_MAP1: 10
    LUCKY_BATTLE_MAP2: 10
    LUCKY_BATTLE_MAP3: 10
    LUCKY_RACE_MAP1: 10
    LUCKY_RACE_MAP2: 10
    LUCKY_RACE_MAP3: 10
    AIR_BATTLE_MAP1: 10
    AIR_BATTLE_MAP2: 10
    AIR_BATTLE_MAP3: 10
    LUCKY_QUIZ: 10

  mapDisplayNames:
    LUCKY_BATTLE_MAP1: "&aLuckyBattle"
    LUCKY_BATTLE_MAP2: "&bLucky Battle 2"
    LUCKY_BATTLE_MAP3: "&eLucky Battle 3"
    LUCKY_RACE_MAP1: "&6Lucky Race"
    LUCKY_RACE_MAP2: "&eLucky Race 2"
    LUCKY_RACE_MAP3: "&cLucky Race 3"
    AIR_BATTLE_MAP1: "&bAirBattle"
    AIR_BATTLE_MAP2: "&3AirBattle 2"
    AIR_BATTLE_MAP3: "&1AirBattle 3"
    LUCKY_QUIZ: "&dLuckyQuiz"
5) LuckyBlocks (external give commands)
# LuckyBlock Settings
luckyBlocks:
  distributeMessageDelaySeconds: 2
  giveAfterSeconds: 10
  amountPerPlayer: 25
  giveCommands:
    # Placeholders: {player}, {amount}, {luckyblocks_amount}
    - "nalb give default {amount} {player}"
    - "give {player} minecraft:sponge{display:{Name:'{\\"text\\":\\"LuckyBlock\\",\\"italic\\":false,\\"color\\":\\"gold\\"}'}} 10"
    - "lb give {player} black"
    - "lb give {player} blue"
    - "lb give {player} brown"
    - "lb give {player} cyan"
    - "lb give {player} gray"
    - "lb give {player} green"
    - "lb give {player} light_blue"
    - "lb give {player} light_gray"
    - "lb give {player} lime"
    - "lb give {player} magenta"
    - "lb give {player} orange"
    - "lb give {player} pink"
    - "lb give {player} purple"
    - "lb give {player} red"
    - "lb give {player} white"
    - "lb give {player} yellow"
    - "slb give default {player} 5"
6) Mode settings (Race, AirBattle, Quiz)
# Mode-Specific Settings
luckyRace:
  teleportDelaySeconds: 20

airBattle:
  keepInventory: true
  spawnBlockProtection:
    enabled: true
    radius: 4

luckyQuiz:
  offersEnabled: true
  nextMapWeights:
    LUCKY_BATTLE_MAP1: 34
    LUCKY_BATTLE_MAP2: 33
    LUCKY_BATTLE_MAP3: 33
  rewards:
    blocksCorrect: 1
    blocksCorrectFirst: 2
    items:
      sponge:
        type: "COMMAND"
        baseAmount: 3
        questionWeight: 10
       command: "give {player} minecraft:sponge{display:{Name:'{\\"text\\":\\"LuckyBlock\\",\\"italic\\":false,\\"color\\":\\"gold\\"}'}} {amount}"
      nalb:
        type: "COMMAND"
        baseAmount: 8
        questionWeight: 50
        command: "nalb give default {amount} {player}"
      lb:
        type: "COMMAND"
        baseAmount: 6
        questionWeight: 40
        command: "lb give {player} {random_color}"
      internal_lucky_block:
        type: "INTERNAL_LUCKY_BLOCK"
        baseAmount: 3
        questionWeight: 35
        command: ""
      slb:
        type: "COMMAND"
        baseAmount: 2
        questionWeight: 0
        command: "slb give default {player} {amount}"
7) PvP + Bossbars
# PvP Settings per mode (Arena is always enabled)
pvp:
  luckyBattle:
    enabled: false
  luckyRace:
    enabled: false
  airBattle:
    enabled: false
  luckyQuiz:
    enabled: false

# Bossbar Settings
bossbar:
  abbau:
    enabled: true
    title: "&9Farming Phase&7: &f{time} &7until Arena"
    color: "BLUE"
    style: "SOLID"
  airBattle:
    enabled: true
    title: "&9AirBattle&7: &f{time} &7until Arena"
    color: "BLUE"
    style: "SOLID"
  luckyQuizArena:
    enabled: true
    title: "&9LuckyQuiz&7: &f{time} &7until Arena"
    color: "BLUE"
    style: "SOLID"
  arena:
    enabled: true
    title: "&9Arena&7: &f{time} &7until decision"
    color: "BLUE"
    style: "SOLID"
8) Stats + Holograms + InventorySwitch + TeamMode
# Statistics & Holograms
stats:
  enabled: true

statsCommand:
  enabled: true
  permission: "luckyblockbattle.stats"
  messages:
    playersOnly: "&cPlayers only."
    disabled: "&cThe /stats command is disabled."
  lines:
    - "&9Your Stats"
    - "&7Kills: &f{kills}"
    - "&7Deaths: &f{deaths}"
    - "&7K/D: &f{kd}"
    - "&7Wins: &f{wins}"
    - "&7Matches: &f{matches}"

hologram:
  enabled: true
  updateTicks: 20
  visibleRange: 20

# Features
inventorySwitcher:
  enabled: true
  item:
    slot: 8
    inv1: "&9Inventory 1"
    inv2: "&cInventory 2"

lobbyItems:
  mapVote:
    slot: 0
  invSwitch:
    slot: 1
  back:
    slot: 8

teamMode:
  enabled: false
  teamSize: 2
  teamCount: 2
  item:
    material: "MAGMA_CREAM"
    slot: 2
    name: "&cTeam Selection"
    lore:
      - "&7Right-click to select a team"
  gui:
    title: "&9Team Selection"
    teamNameFormat: "{team_color}{team_name}"
    teamLore:
      - "&7Players: &f{players_count}&7/&f{players_max}"
      - "&7Members: &f{players_list}"
  teams:
    - name: "&cTeam Red"
      color: "RED"
    - name: "&9Team Blue"
      color: "BLUE"
    - name: "&aTeam Green"
      color: "GREEN"
    - name: "&eTeam Yellow"
      color: "YELLOW"
9) System + World reset + Setup guide marker
# System Settings
sound:
  enabled: true
  name: "BLOCK_NOTE_BLOCK_PLING"
  volume: 0.8
  pitch: 1.2

commands:
  invSwitcher: "inventarswitcher {player}"
  backServer: "server LuckyBattle"

worldReset:
  enabled: false
  resetOnEnable: false
  templateFolder: "world-templates"
  useTemplateFolderWorldList: true
  keepWorlds:
    - "Lobby"
  worlds:
    - "LuckyBattle"
    - "LuckyIslands"
    - "LuckyRace"
    - "AirBattle"
    - "Quiz"
    - "Arena"
  multiverse:
    autoImport: false
    autoLoad: false

mapBorder:
  messageEnabled: true

setupGuide:
  askOnJoin: true
  completed: false
  promptedAdmins: []
10) Spawns & Worlds (keep at end)
# ==============================================================================
# SPAWNS & WORLDS (Please keep at the end of the file)
# ==============================================================================

worlds:
  lobby: "Lobby"

lobbySpawn:
  world: "Lobby"
  x: 0
  y: 64
  z: 0
  yaw: 0.0
  pitch: 0.0

spectatorSpawns: {}

modes:
  LUCKY_BATTLE_MAP1:
    world: "LuckyBattle"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}
  LUCKY_BATTLE_MAP2:
    world: "LuckyIslands"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}
  LUCKY_BATTLE_MAP3:
    world: "LuckyBattle3"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}
  LUCKY_RACE_MAP1:
    world: "LuckyRace"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}
  LUCKY_RACE_MAP2:
    world: "LuckyRace2"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}
  LUCKY_RACE_MAP3:
    world: "LuckyRace3"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}
  AIR_BATTLE_MAP1:
    world: "AirBattle"
    wrapAroundIfMorePlayersThanSpawns: true
    spawns: {}
  AIR_BATTLE_MAP2:
    world: "AirBattle2"
    wrapAroundIfMorePlayersThanSpawns: true
    spawns: {}
  AIR_BATTLE_MAP3:
    world: "AirBattle3"
    wrapAroundIfMorePlayersThanSpawns: true
    spawns: {}
  LUCKY_QUIZ:
    world: "Quiz"
    wrapAroundIfMorePlayersThanSpawns: false
    spawns: {}

hologram_locations:
  personal:
    set: false
    world: "Lobby"
    x: 0
    y: 65
    z: 0
  topKills:
    set: false
    world: "Lobby"
    x: 5
    y: 65
    z: 0
  topWins:
    set: false
    world: "Lobby"
    x: -5
    y: 65
    z: 0

Commands (click to expand)
Short help-style overview of all commands included in the current version.

All commands (Player + Admin/Setup + Border)

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).
  • /coins - View your current amount of Coins.
  • /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 ... (setup positions)

  • /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) (slot 2, index 1 = first checkpoint for player 2).
  • /lbb set quizbutton {slot} A|B|C|D|5050 - Start quiz button binding.
  • /lbb set holo personal|topkills|topwins - Set hologram position.

/lbb del ... (also /lbb delete)

  • /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.

Screenshot 2026-03-02 151007.png

  • Multiple game modes inside one unified match loop (no separate plugins needed) (Full Version)

Similar projects

Plugin →

Let Me Despawn

Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.

25MSueta

JourneyMap

Real-time map used for mapping in-game or your browser as you explore.

14.7MSueta

Emotecraft

Create your own emotes in Minecraft.

7.5MSueta

Simple Tpa

A simple tpa plugin which sends requests

5.4MSueta

Common Network

Forge and Fabric Unified Networking Solution

3.9MSueta

Set Home

A lightweight plugin for players to set their homes.

3.8MSueta