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:

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:

🖥️ 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

Aliases:

• /luckyblock
• /lucky

🔑 Permissions

📦 Requirements

🚀 Installation

1. Download LuckyEngine
2. Put the jar into:

plugins/

1. Restart the server
2. Configure:

plugins/LuckyEngine/config.yml

1. Reload:

/lb reload

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