✦ 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:

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
`/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:

/luckyblock
/lucky

🔑 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.

LuckyEngine | The Ultimate LuckyBlock Plugin