# v2.1 — Multi-Action Rewards, Economy & Events A major update focused on **reward flexibility, Lucky Coins, server-wide events, challenges, leaderboards, and performance improvements**. ## ✨ Multi-Action Rewards * Added a new `MULTI_ACTION` reward type that lets you combine multiple actions into a single reward. * Create rewards that can, for example, **give diamonds, run a money command, and send an action bar message** all at once. * Each action uses the same configuration fields as its standalone reward type. * Supported action types: * `ITEM` * `COMMAND` * `XP` * `MESSAGE` * `ACTIONBAR` * `TITLE` * `SOUND` * `FIREWORKS` * Added a dedicated **Actions Editor GUI** for adding, editing, and removing actions with guided chat prompts. * Added a **"+ Add Another Action"** button to every reward type. * Converts the reward you are currently editing into the first action of a `MULTI_ACTION` reward. * Your existing configuration is preserved, so you never have to recreate a reward from scratch. * Added two ready-made examples to `rewards.yml`: * `diamonds_and_money` * `legendary_jackpot` ## 💰 Lucky Coins Lucky Coins are now a built-in currency earned by breaking Lucky Blocks. * Players earn coins based on the tier of the reward they receive. * Default rewards: * **Legendary:** 10 coins * **Good:** 5 coins * **Neutral:** 2 coins * **Bad:** 1 coin * Check your balance with `/lb coins`. * Added a **Lucky Coins** button to the Main Menu. * Configurable through: * `coins.enabled` * `coins.per-break.*` * `coins.notify-player` ## 🛒 Coin Shop Added a complete shop system for spending Lucky Coins. * New `/lb shop` command. * Shop is also accessible directly from the Main Menu. * All shop items are configured through `shop.yml`. * Add, remove, or reprice items without changing the plugin code. * Added four purchase types: * `GIVE_LUCKY_BLOCK` — gives a guaranteed Lucky Block rarity without RNG. * `ADD_LUCK` — instantly increases the player's luck. * `GIVE_ITEM` — gives an item with optional enchantments. * `RUN_COMMAND` — executes a command for integrations with economy and other plugins. * Includes 8 default shop items: * Rare Lucky Block * Epic Lucky Block * Legendary Lucky Block * Small Luck Boost * Large Luck Boost * Diamonds * Netherite * Enchanted Sword * Added optional **daily purchase limits** for individual items. * Items automatically appear unavailable when: * The player cannot afford them. * The daily purchase limit has been reached. ## 🎉 Lucky Events Added server-wide timed events that temporarily modify gameplay. * Start events with `/lb event start <name>` or through the Events GUI. * Events can apply: * A global luck bonus. * A global Lucky Coin multiplier. * A configurable duration. * Added 3 default events: * **Double Luck Weekend** — +30 Luck, 2x Coins, 1 hour. * **Coin Rush** — 3x Coins, 15 minutes. * **Legendary Hour** — +50 Luck, 1.5x Coins, 30 minutes. * Fully configurable through `lucky-events:` in `config.yml`. * Events automatically announce their start and end to the entire server. * Use `/lb event stop` to end the active event early. ## 🎯 Daily & Weekly Challenges Added challenges that reward players for completing different Lucky Block objectives. * 7 challenges included by default. * Supported challenge types: * `BREAK_BLOCKS` * `GET_TIER` * `REACH_COMBO` * `EARN_COINS` * Completing a challenge automatically awards Lucky Coins. * Added `/lb challenges` to view challenge progress. * Progress is displayed with a visual progress bar. * Supports: * `DAILY` * `WEEKLY` * Challenge progress persists in `challenge_progress.yml`. * Goals, rewards, and reset periods are fully configurable. ## 🏆 Leaderboards Added a dedicated leaderboard GUI with four separate rankings: * **All-Time Breaks** * **Weekly Breaks** * **Lucky Coins** * **Highest Luck** Additional features: * `/lb leaderboard` and `/lb top` * Top 27 players displayed per leaderboard. * Gold, silver, and bronze medal icons for the top 3. * Automatic refresh every 5 minutes by default. * Refresh interval configurable with `leaderboard.refresh-minutes`. * Added a manual refresh button. * Leaderboard data is cached to prevent unnecessary server load. ## 🎁 Lucky Chest Added a new `LUCKY_CHEST` reward type. * Opens a GUI containing multiple randomly selected rewards. * The player chooses exactly **one** reward. * All other rewards are discarded. * Creates a more interactive alternative to standard RNG rewards. * The number of choices is configurable with the `choices` field. * Supports 2 or 3 choices. ## 🎨 Creative Mode Lucky Blocks placed in Creative Mode are now fully functional. * Players can place normal Lucky Blocks while in Creative. * Previously, Creative placement created a non-functional decorative copy. * The existing `creative-bypass` option still controls Creative-mode breaking. * When enabled, Creative players can break Lucky Blocks without triggering a reward. * Useful for building, testing, and server setup. ## 🎁 Starter Reward Pack Added a separate lightweight reward pack for smaller or more conservative servers. * New `rewards-starter.yml`. * Contains approximately 25 modest rewards. * Focused primarily on common and practical rewards. * Does not include: * Legendary structures. * Jackpot-style rewards. * Complex `MULTI_ACTION` rewards. * The full `rewards.yml` still contains **245 rewards**. To use the starter pack: 1. Back up your existing `rewards.yml`. 2. Rename `rewards-starter.yml` to `rewards.yml`. 3. Run `/lb reload`. ## 🖥️ Main Menu Improvements The Main Menu has been expanded with the new v2.1 features. Added access to: * Lucky Coins * Coin Shop * Challenges * Leaderboards * Events The Events button also displays an **"Event Active!"** indicator while an event is running. Giving yourself a Lucky Block from the Main Menu now keeps the GUI open, allowing you to collect multiple rarities without reopening the menu. ## 🗄️ Optional Database Backend Added an optional SQL backend for persistent player data. * Added `DatabaseManager`. * Supported databases: * SQLite * MySQL * SQLite requires no external database setup. * When enabled, the following data can be stored in SQL: * Luck * Lucky Coins * Lucky Block breaks * Useful for **BungeeCord/Velocity networks** that share player data across multiple servers. * SQLite JDBC is bundled directly into the plugin. New configuration: ```yaml database: enabled: false type: sqlite sqlite-file: luckyblock.db mysql: host: port: name: user: password: table-prefix: ``` ## 🧩 New Commands | Command | Permission | Description | | ------------------------ | ------------------ | ----------------------------- | | `/lb leaderboard` | `luckyblock.use` | Open the leaderboard | | `/lb top` | `luckyblock.use` | Open the leaderboard | | `/lb challenges` | `luckyblock.use` | View challenge progress | | `/lb event` | `luckyblock.use` | View active/available events | | `/lb event start <name>` | `luckyblock.admin` | Start a Lucky Event | | `/lb event stop` | `luckyblock.admin` | Stop the active Lucky Event | | `/lb coins` | `luckyblock.use` | Check your Lucky Coin balance | | `/lb shop` | `luckyblock.use` | Open the Coin Shop | ## ⚙️ Configuration Additions ```yaml database: enabled: false type: sqlite sqlite-file: luckyblock.db mysql: host: port: name: user: password: table-prefix: coins: enabled: true notify-player: true per-break: great: 10 good: 5 neutral: 2 bad: 1 leaderboard: refresh-minutes: 5 lucky-events: double_luck_weekend: # ... coin_rush: # ... legendary_hour: # ... challenges: daily_break_5: # ... daily_break_15: # ... daily_good_drop: # ... daily_combo_5: # ... weekly_break_50: # ... weekly_legendary: # ... weekly_earn_500_coins: # ... ``` ## 🔧 Bug Fixes & Performance ### Fixed: Main Menu not opening The Main Menu attempted to create a 7-row chest inventory containing 63 slots. Minecraft chests support a maximum of 6 rows (54 slots), causing Bukkit to throw an `IllegalArgumentException` whenever `/lb gui` was used. * Reduced the Main Menu to 6 rows. * All existing content fits within the new layout. * Added a permanent safety clamp to the base GUI system to prevent invalid inventory sizes from causing the same class of issue again. ### Fixed: Leaderboard freezing or crashing the server Leaderboard refreshes previously called `Bukkit.getOfflinePlayers()` synchronously on the main server thread. This could trigger a blocking disk read involving player data files. * Leaderboard refreshes now run asynchronously. * Results are cached. * Opening the leaderboard no longer blocks the main thread. * First-time users see a **"Loading..."** placeholder while data is being prepared. ### Fixed: Chat prompt cancellation Cancelling a chat prompt by typing `cancel` could send the player to the wrong GUI. The system previously always returned to the Reward Editor, even when the prompt originated from another feature such as the Main Menu's luck-setting flow. * Every chat prompt now defines its own cancellation destination. * Cancelling a prompt always returns the player to the correct screen. * Prevents related `NullPointerException` crashes. ### Fixed: Reward Editor debug text Removed leftover debug text from the **ID** and **Weight** field tooltips in the Reward Editor. ## 🔌 API `LuckyBlockAPI` receives **no breaking changes** in v2.1. Coins, events, and challenges are currently accessible through the corresponding manager getters on `LuckyBlockPlugin` for plugins that directly depend on LuckyBlock. The new functionality will be added to the public API interface once it has been fully stabilized. --- **LuckyBlock v2.1** brings a much more flexible reward system, a complete Lucky Coin economy, server-wide events, challenges, leaderboards, a configurable shop, and major GUI/performance fixes — while keeping the existing API backward compatible.

# LuckyBlock 2.0 A massive update introducing a public Developer API, new gameplay mechanics, over 240 rewards, improved GUIs, new structures, traps, and many quality-of-life improvements. --- # ✨ New Gameplay Systems ## 🔥 Combo System Build a combo by breaking multiple Lucky Blocks within a configurable time window. **Luck bonuses** * x2 Combo → +5 Luck * x3 Combo → +10 Luck * x5 Combo → +20 Luck * x10 Combo → +40 Luck **Features** * Live combo displayed in the Action Bar * Automatically resets when the timer expires * Fully configurable --- ## 🍀 Hot Streak & Curse Your recent reward history now affects your luck. ### Hot Streak Receive **3 GREAT rewards in a row** to gain: * +25 Luck * Duration: 5 minutes ### Curse Receive **3 BAD rewards in a row** to receive: * -20 Luck * Duration: 3 minutes Players are notified when both effects start and expire. --- ## ✨ Lucky Block Aura Placed Lucky Blocks now emit ambient particles. | Rarity | Particle | | --------- | --------------- | | Common | End Rod | | Rare | Soul Fire Flame | | Epic | Witch | | Legendary | Flame | Uses a single optimized scheduler for excellent performance. --- ## 📜 Reward History Every Lucky Block opening is now recorded. Stored information includes: * Reward ID * Reward name * Reward tier * Reward type * Reward rarity * Timestamp Features: * Stores the last **15 rewards** per player * Saved in `history.yml` * Accessible via GUI or command --- ## 👋 Join Listener Players now receive a welcome message after joining containing: * Current Luck * Luck Tier * Hot Streak / Curse status Admins additionally receive update notifications when a new version is available. --- # 🧩 Developer API LuckyBlock now provides a complete public API for third-party plugins. ## Luck API * getLuck() * setLuck() * addLuck() * resetLuck() * formatLuck() ## Lucky Block API * isLuckyBlockItem() * isLuckyBlock() * getLuckyBlockRarity() * placeLuckyBlock() * removeLuckyBlock() * buildLuckyBlockItem() ## Reward API * getRewards() * getRewardById() * executeReward() * triggerBreak() ## Statistics API * getTotalBreaks() * getBreaksInPeriod() * getGlobalTotalBreaks() * getGlobalBreaksInPeriod() ## Additional API * getHistory() * getCombo() * getComboLuckBonus() * hasHotStreak() * isCursed() ### New Bukkit Events * LuckyBlockBreakEvent * LuckyBlockRewardEvent * LuckyBlockLuckChangeEvent All events are cancellable and fully editable. --- # 🎁 New Reward Types Three completely new reward types have been added. ### TITLE Display customizable titles and subtitles. ### ACTIONBAR Send Action Bar messages. ### SOUND Play private sounds only for the player. **Total reward types: 17** --- # 🏗️ New Structures Added **9 new structures**: * Treasure Room Small * Ancient Vault * Mini Maze * Copper Ore Vein * Iron Ore Vein * Gravel Drop * Magma Trap * Lava Drop * Large Cobweb Trap --- # ☠️ New Trap Types Added **5 new traps**: * Drop Held Item * Scramble Inventory * Ignite Player * Short Random Teleport * Dye Leather Armor --- # 🖥️ GUI Improvements ## Type Selector Completely redesigned. Features: * 6-row interface * Categories * Reward count per type * Required YAML fields * Current selection highlighting * All 17 reward types displayed --- ## Reward Editor Added smart default values: * Automatic unique IDs * Diamond material * Default mob count * Explosion power * XP values * Fireworks * Default title * Default sound volume --- ## Main Menu Expanded to **6 rows**. Added: * Reward History * Reward Preview * Rarity give buttons * HUD toggle * Broadcast toggle --- ## Reward Preview GUI New command: `/lb preview` Features: * Shows exact drop chances * Uses player's current effective luck * Sorted by highest chance * Rarity switch buttons * Pagination Also fixed the beta slot overflow crash. --- ## Reward History GUI New interface displaying: * Last 15 rewards * Tier-colored icons * Formatted timestamps * Reward IDs --- # 💬 New Commands * `/lb history [player]` * `/lb preview [rarity]` --- # 🔊 Sound Improvements * Sounds are now player-only * Default volume reduced from **1.0 → 0.5** * Per-rarity sound configuration * Per-rarity particle configuration --- # 🎲 Reward Pool Expansion The reward system has been massively expanded. ## Rewards * **242 total rewards** *(previously 43)* Includes: * New structures * New traps * Sounds * Titles * Action Bars ### New Mobs * Allay * Fox * Phantom * Cave Spider * Drowned * Turtle ### New Bundles * Food Bundle * Building Bundle * Nether Bundle ### New XP Rewards * 1000 XP Windfall * 10 Level Boost ### Vanilla Loot Tables * Bastion Treasure * Village Weaponsmith --- # 🛠️ Configuration Added numerous new configuration options including: * Creative bypass * Lucky Block Aura * Combo System * Hot Streak & Curse * Per-rarity particles * Per-rarity sounds * Join messages * Update Checker * Sound volume controls Everything is fully configurable.

updatechcker added

# Changelog — LuckyBlock ## v1.0.0 — Initial Release ### Core Features - Lucky Block system using Yellow Stained Glass as the real block with a half-scale Sponge `BlockDisplay` entity centred inside - Block placement tracking persisted in `lucky_blocks.yml` — only placed Lucky Blocks trigger rewards, naturally-generated glass is untouched - Weighted random reward selection with four tiers: **GREAT**, **GOOD**, **NEUTRAL**, **BAD** ### Luck System - Per-player luck value (−100 → +100) stored in `luck.yml` - Luck biases the weighted random roll — positive luck amplifies GREAT/GOOD weights, negative luck amplifies BAD weights - Configurable `default-luck`, `luck-min`, `luck-max`, `luck-drift-after-break`, `luck-reset-on-death` ### Reward Types | Type | Description | |---|---| | `ITEM` | Drop one item with optional enchantments, custom name, lore | | `MULTI_ITEM` | Drop several different items at once | | `XP` | Give XP points/levels directly via API (no Essentials conflict) | | `COMMAND` | Run console commands (`%player%` supported) | | `MOB_SPAWN` | Spawn mobs with options: powered, tamed, with-gear, drop-from-sky | | `EXPLOSION` | Configurable power + break-blocks toggle | | `POTION_EFFECT` | Multiple simultaneous effects with per-effect duration and amplifier | | `LIGHTNING` | Multiple lightning strikes scattered around the block | | `MESSAGE` | Private chat message to the player | | `STRUCTURE` | `OBSIDIAN_CAGE`, `COBWEB_TRAP`, `TREASURE_VAULT`, `ORE_VEIN_DIAMOND` | | `CHEST_LOOT` | Drops from any vanilla loot table | | `ENCHANT_HELD` | Randomly enchants the held item | | `FIREWORKS` | Launches colourful random fireworks | | `TRAP` | `DROP_HOTBAR` — scatters hotbar items on the ground | ### Crafting - Fully configurable 3×3 shaped recipe (default: 8 Glass + 1 Sponge) - Live recipe re-registration on `/lb reload` ### In-Game GUI (`/lb gui`) - **Main Menu** — luck bar, browse, create, give, reload - **Reward List** — paginated grid, left-click to edit, right-click to delete - **Reward Editor** — all fields visible at once; sub-GUIs for complex fields: - **Type Selector** — icon grid of all 14 reward types - **Enchantment Editor** — full enchantment browser, level +/− per enchant, applied-list with remove - **Mob Selector** — 36-mob icon grid + toggle buttons (powered, tamed, gear, sky) + count adjuster - **Potion Effect Editor** — all 33 effect types, click to add/edit duration+amp, right-click to remove - **Command Editor** — up to 18 command slots, 8 placeholder buttons, 12 template commands - GUI navigation uses a transitioning flag to prevent `InventoryCloseEvent` clearing screen state mid-switch ### Localisation - Full multi-language support via `plugins/LuckyBlock/lang/<locale>.yml` - Bundled: **en_US** (English) and **pl_PL** (Polish) - Every player-facing string is in the lang file — prefix, HUD lines, tier names, GUI titles/buttons, command feedback, item names - Set `language: en_US` (or `pl_PL`) in `config.yml` ### PlaceholderAPI Integration (optional soft-depend) | Placeholder | Returns | |---|---| | `%luckyblock_luck%` | Raw luck number | | `%luckyblock_luck_formatted%` | Coloured luck string | | `%luckyblock_luck_bar%` | 10-segment `■` bar | | `%luckyblock_luck_tier%` | Tier name string | | `%luckyblock_total_rewards%` | Number of loaded rewards | ### Commands | Command | Permission | |---|---| | `/lb gui` | `luckyblock.use` | | `/lb give <player> [amt]` | `luckyblock.admin` | | `/lb setluck <player> <n>` | `luckyblock.admin` | | `/lb addluck <player> <n>` | `luckyblock.admin` | | `/lb getluck [player]` | `luckyblock.use` | | `/lb list` | `luckyblock.use` | | `/lb reload` | `luckyblock.admin` | ### Config Additions - `language` — select locale - `luck-min` / `luck-max` — clamp luck range - `luck-reset-on-death` — reset luck on player death - `cooldown-seconds` — per-player break cooldown - `cooldown-message` — customisable cooldown message - `allowed-worlds` — whitelist worlds (empty = all worlds) - `required-tool` — restrict breaking to a specific tool - `effects.sound-volume` / `effects.sound-pitch` — fine-tune break sound - `effects.particle-count` — control particle density - `hud.enabled` — toggle the in-chat HUD box