Lucky Bar v1.0.0

 

LuckyBar
33 Lucky Games. 5 Modes. 1 Powerful Money Sink. Every Click Keeps Your Economy Alive.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

5 Game Modes ◆ Crash Solo ◆ Ladder Pot ◆ Main Bar ◆ VIP Lounge ◆ Quick Luck ◆ Vault Economy ◆ 2 Languages ◆ Paper 1.21.8+

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

What LuckyBar Solves

Every server with an economy has the same silent killer: inflation. Jobs, quests, farms, mines and shops keep printing money into your server, and sooner or later a single item costs more than your entire spawn. Money stops meaning anything. Your most dedicated players quit because there is nothing left to spend their fortune on.

LuckyBar is the complete economy sink built to solve exactly that. It gives your players a fast, fun and endlessly replayable way to spend their surplus currency - while quietly draining it out of circulation. No awkward donation walls. No forced taxes. Just 33 polished luck games that players genuinely want to play, connected directly to your Vault economy.

The result? A healthier, stabler economy, a daily reason to log in, and real player retention you can measure in your player graph. LuckyBar doesn't just remove money - it turns your money problem into your most popular feature.

· · · MAIN BAR · · ·

• Copper Toss The classic low-stakes coin flip. Fast, friendly, perfect for new players to discover the fun.
• Iron Flip & Golden Coin Steady mid-tier plays with reliable small wins and juicy Grand Prize chances.
• Fortune Cookie & Lucky Flower Luck-themed favorites with boosted Grand Prize odds to keep the excitement rolling.
• Honey Mead, Blaze Rush, Mystic Stone, Amethyst Roll, Ocean Fortune, Phantom Luck A full ladder of medium-stakes games from $500 to $2,000 - the heart of your daily money sink.
• Emerald Spin, Gold Bar Toss, Diamond Dice, Inferno Spin, Redstone Spin, XP Toss, Ender Throw, Netherite Scratch Premium tables for your wealthiest players. High risk, unforgettable broadcasts, and the biggest drains in the plugin.

• Scratch Card, Treasure Map, Skeleton Dice, Witch's Brew, Arrow Shot, Snowball Throw, Seed Toss Micro-games from just $5 to $25. Instant results, constant small wins, and a perfect gateway that gets the whole server playing in seconds.

• Golden Vault, Diamond Heist, All or Nothing, Emerald Empire, Netherite Vault The high-stakes room where whales play. Stakes from $10,000 to $100,000 with MEGA PRIZE broadcasts that turn every big win into server-wide hype.

• Risk-Free Start Pay a small entry fee and start climbing from rung one with a fresh bank.
• Climb or Cash Out Win rungs to grow your bank, then decide: withdraw your winnings, or risk it all on the next rung for a bigger payday.
• Tier Progression Reach the summit and ascend to a higher tier with bigger stakes and bigger payouts - an endless climb your players will keep returning to.
• Grand Prize Summit The final rung can claim the entire global Grand Prize pool. One climb can change a player's fortune forever.

• Pick Your Table Choose a preset stake tier from $100 casual tables to a $10,000 VIP Whale table.
• Launch & Watch The multiplier climbs live on a boss bar while your payout ticks up in real time.
• Cash Out in Time Withdraw before the round crashes and bank the win - or ride it higher and risk everything. Pure adrenaline, fully solo.
• Up to 22x Multipliers reach 22x with payouts capped at $500,000. A single round can be a legendary server event.

LuckyBar is engineered around one goal: removing surplus currency from your economy while players are having fun. It combines multiple, independently configurable drain layers so you can tune exactly how aggressive your sink is.

◆ Winnings Tax

• A configurable percentage taken from every win before it hits the player's balance
• Set it to 0% for a pure entertainment game, or tune it up for a stronger drain

◆ Global Grand Prize Pool (the Jackpot)

• A percentage of every single play feeds a shared, persistent jackpot
• Won on super wins, ladder summits and high crash multipliers - with server-wide broadcasts
• Survives restarts via its own save file, so the pool keeps growing between sessions

◆ Optional Loss Penalty

• An extra fee on losses for servers that want an even stronger economic drain

◆ Mercy & Cold Streak Systems

• A mercy system gently boosts unlucky players so losing streaks never feel hopeless
• A cold streak system rebalances the odds after big wins to keep the economy and the fun in balance

◆ Built-In Player Protections

• Daily play limits - per-player caps with per-rank limits (VIP / MVP / unlimited) to keep things fair
• Cooldowns - configurable anti-spam between plays, with optional persistence

◆ Polished GUI Experience

• A game hub that presents every game in one beautiful selection screen
• Custom item models, rich color lore, click sounds and deny/affirm feedback
• Info panel showing the Grand Prize pool, daily plays remaining and cooldowns
• Live boss bar and particles during crash rounds for real-time excitement

◆ Vault Economy Integration

• Works with any Vault economy provider (EssentialsX, CMI and more)
• Every win and loss hits the real server balance instantly - no separate currency to manage

◆ Full Configuration

• Global settings in a clean config.yml: tax, Grand Prize pool, mercy, streaks, cooldowns, daily limits, hub, language
• One dedicated YAML per game in games/ - add new games by dropping in a new file
• Every value exposed: prices, rewards, odds, stake tiers, multipliers, sound, particles, broadcasts
• Live reload via /luckbar reload - no server restart needed

◆ Multi-Language Support

• 2 built-in languages: English and Polish
• Every message, title and GUI label configurable with hex color support
• Missing keys are auto-patched from the JAR on update - translations never break

◆ Admin & Retention Toolbox

• /luckbar give and /luckbar open to hand games to any player - perfect for events and giveaways
• /luckbar stats for total bets, won and lost - see your money sink working in real numbers
• Configurable super-win broadcasts that turn every big win into free server advertising
• Persistent player state (mercy, cold streak, daily counters) that survives restarts

• Survival, SMP, factions & towns No matter your game mode - if your server runs an economy, LuckyBar fits. Give players a fun place to spend - and drain - their surplus money while keeping the economy healthy.
• Economy-focused networks Add a real money sink with multiple drain layers, per-rank daily limits and a persistent Grand Prize pool that grows between sessions.
• Server owners chasing retention A daily reason to log in. Players return to play a quick round, chase a streak, or claim the Grand Prize - engagement that keeps your community alive.
• Event & giveaway hosts Use /luckbar give and /luckbar open to run instant giveaways and live events without a single line of config.
• Polish & English communities Fully localized out of the box in both languages, with every message editable.

◆ Commands

◆ Permissions