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.