✦ 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.
✨ 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:
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 - Englishpl_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 |
/lb gui |
Open GUI menu |
/lb give <player> [amount] |
Give Lucky Blocks |
/lb setluck <player> <value> |
Set player luck |
/lb addluck <player> <value> |
Add or remove luck |
/lb getluck [player] |
Check luck |
/lb list |
List rewards |
/lb reload |
Reload configuration |
Aliases:
🔑 Permissions
| Permission |
Description |
luckyblock.use |
Basic commands and GUI access |
luckyblock.admin |
Administration features |
📦 Requirements
| Requirement |
Version |
| Java |
21+ |
| Paper / Spigot |
1.21.x |
| PlaceholderAPI |
Optional |
🚀 Installation
- Download LuckyEngine
- Put the jar into:
plugins/
- Restart the server
- Configure:
plugins/LuckyEngine/config.yml
- Reload:
/lb reload
- Create your first Lucky Block:
/le give <player>
✦ Why LuckyEngine?
LuckyEngine combines classic random rewards with modern Minecraft systems, providing servers with a complete event, crate, and minigame-style reward system with deep customization and easy management.
