LuckyEngine

# ✦ LuckyEngine A powerful and fully configurable Lucky Block plugin for **Paper / Spigot 1.21.x** featuring custom rewards, a dynamic luck system, advanced in-game GUI editors, multi-language support, statistics tracking, and full PlaceholderAPI integration. LuckyEngine recreates the classic Lucky Block experience using vanilla Minecraft mechanics without requiring any resource pack. Each Lucky Block uses a real breakable block combined with a visual Block Display core. ### ⚡ Recommended Hosting (https://i.imgur.com/22G8vsG.gif)](https://billing.sparkedhost.com/aff.php?aff=3360) --- # ✨ Features ## 🎲 Lucky Block System * Custom Lucky Block system based on vanilla blocks * No resource pack required * Real breakable Yellow Stained Glass block * Visual Sponge BlockDisplay core inside the block * Tracks placed Lucky Blocks separately from normal world blocks * Naturally generated blocks are ignored * Persistent storage using `lucky_blocks.yml` --- # 🍀 Luck System Every player has an individual luck value from **-100 to +100**. Luck affects reward probability: | Luck | Effect | | ---- | ------------------------------------------------------------------------ | | +100 | GREAT rewards become much more common, BAD rewards become extremely rare | | 0 | Default reward chances | | -100 | BAD rewards become more common, GREAT rewards become almost impossible | Features: * Per-player luck storage * Configurable minimum and maximum luck * Luck changes after breaking blocks * Optional luck reset after death * Luck HUD displayed in chat * PlaceholderAPI support --- # 🎁 Reward System Create unlimited custom rewards with weighted chances and different tiers: * GREAT * GOOD * NEUTRAL * BAD Supported reward types: | Type | Description | | --------------- | ---------------------------------------------- | | `ITEM` | Custom items with enchantments, names and lore | | `MULTI_ITEM` | Multiple item rewards | | `XP` | Give experience points or levels | | `COMMAND` | Execute console commands | | `MOB_SPAWN` | Spawn customized mobs | | `EXPLOSION` | Configurable explosions | | `POTION_EFFECT` | Apply potion effects | | `LIGHTNING` | Lightning strikes | | `MESSAGE` | Private player messages | | `STRUCTURE` | Special structures and traps | | `CHEST_LOOT` | Vanilla loot table rewards | | `ENCHANT_HELD` | Randomly enchant held items | | `FIREWORKS` | Random fireworks | | `TRAP` | Negative effects like dropping hotbar items | --- # 🖥️ In-Game GUI Manage LuckyEngine completely in-game: ``` /lb gui ``` ## Main Menu Includes: * Current luck display * Reward browser * Reward creation * Give Lucky Blocks * Reload configuration ## Reward List Features: * Paginated reward browser * Left click to edit * Right click to delete ## Reward Editor Advanced editors: * Type selector * Enchantment editor * Mob editor * Potion editor * Command editor No manual configuration editing required. --- # ⚙️ Configuration Everything can be customized: * Reward chances * Luck behaviour * Cooldowns * Allowed worlds * Required tools * Sounds * Particles * HUD messages * Broadcast settings * Crafting recipe * Language files Reload changes instantly: ``` /lb reload ``` No restart required. --- # 🌍 Multi-Language Support All player-facing messages are configurable. Included languages: * `en_US` - English * `pl_PL` - Polish Create your own translations by copying existing language files. --- # 📊 Statistics System LuckyEngine tracks player and server activity. ## Personal Statistics * `%luckyblock_breaks_total%` * `%luckyblock_breaks_hourly%` * `%luckyblock_breaks_daily%` * `%luckyblock_breaks_weekly%` * `%luckyblock_breaks_monthly%` ## Global Statistics * `%luckyblock_breaks_global_total%` * `%luckyblock_breaks_global_hourly%` * `%luckyblock_breaks_global_daily%` * `%luckyblock_breaks_global_weekly%` * `%luckyblock_breaks_global_monthly%` Statistics are stored efficiently and old entries are automatically removed. --- # 🔗 PlaceholderAPI Support LuckyEngine automatically integrates with PlaceholderAPI. ## Luck Placeholders * `%luckyblock_luck%` * `%luckyblock_luck_formatted%` * `%luckyblock_luck_bar%` * `%luckyblock_luck_tier%` ## Other * `%luckyblock_total_rewards%` Perfect for: * Scoreboards * Holograms * Menus * Leaderboards * Chat formatting --- # 🛠️ Commands | Command | Description | | ------------------------------ | -------------------- | | `