LuckyEngine | The Ultimate LuckyBlock Plugin

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

Features:

• Current luck display
• Reward browser
• Reward creation
• Give Lucky Blocks
• Configuration reload

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:

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%

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

1. Download LuckyEngine

2. Put the jar into:

3. Restart the server

4. Configure:

5. Reload:

6. Create your first Lucky Block:


✦ Why LuckyEngine?

LuckyEngine combines classic Lucky Block randomness with modern Minecraft systems, providing servers with a complete event, crate, and minigame-style reward system with deep customization and easy management.