LuckyEngine
A modern and highly configurable LuckyBlock/luckyblocks plugin for Paper/Spigot 1.21.x featuring a dynamic luck system, powerful in-game reward editor, multi-language support, PlaceholderAPI integration, and 14 unique reward types.
LuckyEngine
LuckyEngine is a powerful and fully configurable Lucky Block plugin for Paper and Spigot 1.21.x, designed to provide customizable rewards, dynamic player luck, advanced in-game editors, statistics, and multi-language support.
Built around vanilla Minecraft mechanics, LuckyEngine recreates the classic Lucky Block experience without requiring a resource pack. Each Lucky Block uses a real breakable block combined with a visual Block Display core, allowing the system to remain lightweight while providing a unique visual experience.
⚡ Recommended Hosting
⚙️ Dependencies
REQUIRED
Paper / Spigot 1.21.x LuckyEngine is designed for Minecraft 1.21.x server environments.
Java 21+ Required to run LuckyEngine.
OPTIONAL (Soft Dependency)
PlaceholderAPI Provides expanded placeholder support for luck, statistics, and reward-related information.
✨ Features
- Fully configurable Lucky Block system
- No resource pack required
- Vanilla-based Lucky Block mechanics
- Visual Block Display cores
- Dynamic per-player luck system
- Luck values from -100 to +100
- Custom reward tiers and weighted chances
- Multiple reward types
- Advanced in-game GUI editors
- Reward browser and management tools
- Multi-language support
- Personal and global statistics
- PlaceholderAPI integration
- Configurable cooldowns and restrictions
- Custom sounds and particles
- Configurable HUD messages
- Broadcast system
- Custom crafting recipe
- Persistent Lucky Block storage
- Lightweight and optimized architecture
🎲 Lucky Block System
LuckyEngine uses real Minecraft blocks as the physical Lucky Block while keeping track of placed Lucky Blocks separately from normal world blocks.
The system includes:
- Real breakable Yellow Stained Glass blocks
- Visual Sponge BlockDisplay cores
- Persistent Lucky Block tracking
- Separate storage from normal world blocks
- Automatic ignoring of naturally generated blocks
- Persistent storage using
lucky_blocks.yml
No resource pack is required, allowing LuckyEngine to work immediately with standard Minecraft clients.
🍀 Luck System
Every player has an individual luck value ranging from -100 to +100.
Luck dynamically affects the probability of receiving different reward tiers.
| Luck | Effect |
|---|---|
+100 | GREAT rewards become much more common and BAD rewards become extremely rare |
0 | Uses the default reward chances |
-100 | BAD rewards become more common and GREAT rewards become almost impossible |
The system supports:
- Per-player luck storage
- Configurable minimum and maximum values
- Luck changes after breaking Lucky Blocks
- Optional luck reset after death
- Luck HUD displayed in chat
- PlaceholderAPI integration
This creates a dynamic reward system where player luck can change the outcome of future Lucky Blocks.
🎁 Reward System
LuckyEngine allows unlimited custom rewards with configurable weights and reward tiers.
Available tiers include:
- GREAT
- GOOD
- NEUTRAL
- BAD
Supported reward types include:
| 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 | Create configurable explosions |
POTION_EFFECT | Apply potion effects |
LIGHTNING | Create lightning strikes |
MESSAGE | Send private player messages |
STRUCTURE | Generate special structures and traps |
CHEST_LOOT | Generate rewards from vanilla loot tables |
ENCHANT_HELD | Randomly enchant the player's held item |
FIREWORKS | Create random fireworks |
TRAP | Apply negative effects such as dropping hotbar items |
Reward chances, tiers, and behaviour can be configured without modifying the plugin itself.
🖥️ In-Game GUI
LuckyEngine provides in-game tools for managing rewards and plugin settings.
Open the main interface with:
/lb gui
Main Menu
The main menu provides access to:
- Current luck information
- Reward browser
- Reward creation
- Lucky Block management
- Configuration reload
Reward List
The reward browser provides:
- Paginated reward lists
- Left-click editing
- Right-click deletion
- Quick reward management
Reward Editor
Advanced editors are available for:
- Reward type selection
- Enchantments
- Mob configuration
- Potion effects
- Commands
This allows server administrators to manage rewards directly in-game without manually editing configuration files.
⚙️ Configuration
LuckyEngine provides extensive configuration options for different server setups.
Configurable systems include:
- Reward chances
- Luck behaviour
- Cooldowns
- Allowed worlds
- Required tools
- Sounds
- Particles
- HUD messages
- Broadcast settings
- Crafting recipes
- Language files
- Lucky Block behaviour
Configuration changes can be applied using:
/lb reload
A full server restart is not required for reloadable configuration changes.
🌍 Multi-Language Support
All player-facing messages can be customized through language files.
Included languages:
en_US- Englishpl_PL- Polish
Additional translations can be created by copying an existing language file and translating its messages.
This allows LuckyEngine to be adapted to different server communities without modifying the plugin itself.
📊 Statistics System
LuckyEngine tracks both individual player activity and global 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, with old entries automatically removed to prevent unnecessary data growth.
🔗 PlaceholderAPI
LuckyEngine supports PlaceholderAPI when installed.
Luck Placeholders
%luckyblock_luck%
%luckyblock_luck_formatted%
%luckyblock_luck_bar%
%luckyblock_luck_tier%
Other Placeholders
%luckyblock_total_rewards%
Placeholders can be used with:
- Scoreboards
- Holograms
- Menus
- Leaderboards
- Chat formatting
- Other PlaceholderAPI-compatible plugins
🎮 Gameplay Experience
LuckyEngine is designed around fast, unpredictable, and highly replayable gameplay.
The system focuses on:
- Simple Lucky Block interactions
- Dynamic reward outcomes
- Player-controlled luck progression
- Fast GUI management
- Visual feedback
- Flexible reward customization
The combination of random rewards and dynamic luck allows servers to create anything from simple Lucky Block events to larger reward-based minigames and progression systems.
🛠️ Commands
| Command | Description |
|---|---|
/lb gui | Open the main GUI |
/lb give <player> [amount] | Give Lucky Blocks |
/lb setluck <player> <value> | Set player luck |
/lb addluck <player> <value> | Add or remove player luck |
/lb getluck [player] | Check player luck |
/lb list | List configured rewards |
/lb reload | Reload configuration |
Aliases
/luckyblock
/lucky
🔐 Permissions
| Permission | Description |
|---|---|
luckyblock.use | Access basic commands and GUI features |
luckyblock.admin | Access administration features |
💾 Data Storage
LuckyEngine stores persistent Lucky Block data using:
plugins/LuckyEngine/lucky_blocks.yml
Player luck and statistics are also stored persistently so that player progression is preserved between server restarts.
Statistics automatically remove outdated entries to keep storage efficient.
⚙️ System Design
LuckyEngine combines vanilla Minecraft blocks, Block Display entities, persistent storage, and a modular reward system to create a flexible Lucky Block framework.
Core design goals include:
- Lightweight server-side operation
- Persistent player progression
- Efficient Lucky Block tracking
- Modular reward handling
- Flexible configuration
- In-game administration tools
- Easy integration with PlaceholderAPI
- Support for future reward expansion
The system is designed to work naturally with existing Paper and Spigot server ecosystems while remaining easy to configure and manage.
🚀 Installation
- Download LuckyEngine
- Place the plugin JAR into:
plugins/
- Restart the server
- Configure the plugin in:
plugins/LuckyEngine/config.yml
- Reload the configuration:
/lb reload
- Give yourself a Lucky Block:
/lb give <player>
🚀 Planned Features
LuckyEngine is actively maintained and can be expanded with additional reward and gameplay systems.
Potential future updates may include:
- Additional reward types
- Expanded GUI editors
- More advanced luck mechanics
- Additional statistics
- More language support
- Expanded PlaceholderAPI integration
- Additional configuration options
- Performance and optimization improvements
- API and developer expansion support
🔗 Links
Official Website: https://plugglab.pl/luckyengine/
Documentation: (In Repair) https://plugglab.pl/luckyengine/docs