Update Notice
I've decided to stop updating my plugins on CurseForge due to the low download activity here.
All future updates will be available on Modrinth, so please download the latest versions from there:
🔗 Modrinth: https://modrinth.com/plugin/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
✨ 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.
