⚡ LUCKYGAMES — The Ultimate Lucky Block Battle Royale ⚡

Transform your server into a thrilling, high-stakes battleground! LuckyGames is an advanced, premium mini-game plugin that seamlessly blends the chaotic fun of Lucky Blocks with the intense, shrinking-border mechanics of a Battle Royale. Whether you are running a small community server or hosting massive events, LuckyGames is built for performance, extreme customizability, and pure entertainment.

Core Features

• Dynamic Shrinking WorldBorder: Features a fully configurable, multi-phase border system. The border shrinks progressively (Phase 1, Phase 2, etc.) to force players into epic final showdowns, complete with dynamic BossBar timers.
  
  
• GeyserMC / Bedrock Compatible: Meticulously designed to work flawlessly for both Java and Bedrock players. Uses highly optimized ActionBars and safe packet handling to ensure Bedrock players never crash.
  
  
• Advanced Team & Party System: A built-in GUI for team management. Players can easily invite friends, accept/deny requests, and kick members. Features a dynamic "Faction Check" to ensure the game only starts if there are at least two opposing teams.
  
  
• Unpredictable Lucky Blocks: Breaking a predefined Lucky Block triggers a weighted random event. Everything from Custom Loot Drops and Super Jumps to deadly TNT Traps, Glass Cage Lava traps, and Zombie Ambushes!
  
  
• Bulletproof Anti-Griefing: Includes an incredibly robust "STRICT" block-break and block-place system. Whitelist specific blocks (like TNT, Cobwebs, or Glass) so players can escape traps without destroying your beautiful arenas.
  
  
• In-Game Statistics: Tracks Games Played, Wins, Kills, and Lucky Blocks broken per player, displaying them neatly on the waiting lobby items.
  
  
• Auto-Restoration: Automatically restores broken/placed blocks and removes dropped items and entities after every match with zero server lag.
  

⚔️ Gameplay Mechanics

1. Lobby Phase: Players join the arena, select their kits via GUI, and form teams.
   
   
2. The Drop: Once the countdown finishes, players are teleported to random spawn points. Vanilla advancements are muted to keep chat clean.
   
   
3. The Hunt: Players scramble to find and break Lucky Blocks. Should they risk opening one for a diamond sword, or will it spawn a deadly Meteor Shower?
   
   
4. The Squeeze: The WorldBorder begins its multi-phase shrink, dealing true damage (ignoring invincibility frames) to campers outside the safe zone.
   
   
5. Victory: The last team (or player) standing wins. Stats are saved, blocks are restored, and the arena instantly resets for the next match.
   

Commands & Permissions

• /lg join — Join an arena.
  
  
• /lg leave — Leave your current arena.
  
  
• /lg team — Open the Team Management GUI.
  
  
• /lg stats — View your all-time combat records.
  

Admin Commands (Requires luckygames.admin):

• /lg create — Create a new arena.
  
  
• /lg setlobby / setcenter / addspawn — Setup arena locations.
  
  
• /lg start — Force start a match.
  
  
• /lg reload — Reloads all configs instantly.
  

⚙️ Highly Configurable Everything from BossBar text, UI menus, and chat messages to Trap Probabilities (Weights) and Border Shrink Delays can be customized in the config.yml, messages.yml, and rewards.yml files. You have total control over the loot pool and the exact percentage chance of every trap!






Upcoming Features (Roadmap) (These upcoming additions will take the plugin to the next level. Stay tuned!)

• Citizens NPC Integration: Ditch the command-only joins! Setup clickable NPCs for each arena with live, updating player counts and statuses above their heads.
  
  
• Vault Economy & Cosmetics Menu: Earn coins per kill and win to purchase flashy cosmetic upgrades via a dedicated in-game shop.
  
  
• Custom Kill Effects & Win Dances: Humiliate your enemies with custom death effects (Lightning, Blood, Fireworks) and celebrate your victories with automatic Win Dances.
  
  
• Holographic Leaderboards: Hook into DecentHolograms or HolographicDisplays to automatically showcase your server's top players (Most Wins, Most Kills) in your main lobby.
  
  
• Dynamic Airdrops (Care Packages): High-tier loot crates that drop randomly near the center of the map during the mid-game to force intense PvP encounters and discourage camping.
  
  
• Tracker Compass: A special survival item that points to the nearest enemy player, ensuring action-packed final border phases.
  
  
• Advanced Party System: Queue up for arenas with your friends seamlessly, ensuring you always end up in the same match.
  
  
• New Chaotic Events: Constant updates introducing new unpredictable traps, custom player-head Lucky Blocks, and even more configuration options.

❓ Frequently Asked Questions (FAQ) Q: Does this plugin cause block lag when restoring arenas? A: Not at all. LuckyGames uses an optimized, chunk-safe block tracking system. You can even configure the restore-blocks-per-tick in the config to perfectly balance restoration speed with your server's hardware capacity.

Q: Can I use this alongside my existing survival world? A: Yes! Arenas are entirely self-contained. The block-break restrictions and Border mechanics only apply to players actively inside a running LuckyGames arena.

Q: Are custom items supported in the Lucky Blocks? A: Absolutely. You can drop any custom item (with custom names, lore, and enchantments) directly into the in-game /lg rewards menu. The plugin will serialize and save them automatically.