?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
LuckyEngine

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.

223downloads
1follower
223downloads
1follower

Links

Report issues View source Visit wiki Join Discord server
Donate on Ko-fi

Tags

Creators

Details

Licensed MIT
Published 3 months ago
Updated 2 months ago
All versions

1.0

Release
LuckyEngine 1.03 months ago 12
Download

Compatibility

Minecraft: Java Edition
1.21.x
Platforms
Bukkit
Paper
Spigot

Changes

Changelog — LuckyBlock

v1.0.0 — Initial Release

Core Features

  • Lucky Block system using Yellow Stained Glass as the real block with a half-scale Sponge BlockDisplay entity centred inside
  • Block placement tracking persisted in lucky_blocks.yml — only placed Lucky Blocks trigger rewards, naturally-generated glass is untouched
  • Weighted random reward selection with four tiers: GREAT, GOOD, NEUTRAL, BAD

Luck System

  • Per-player luck value (−100 → +100) stored in luck.yml
  • Luck biases the weighted random roll — positive luck amplifies GREAT/GOOD weights, negative luck amplifies BAD weights
  • Configurable default-luck, luck-min, luck-max, luck-drift-after-break, luck-reset-on-death

Reward Types

Type Description
ITEM Drop one item with optional enchantments, custom name, lore
MULTI_ITEM Drop several different items at once
XP Give XP points/levels directly via API (no Essentials conflict)
COMMAND Run console commands (%player% supported)
MOB_SPAWN Spawn mobs with options: powered, tamed, with-gear, drop-from-sky
EXPLOSION Configurable power + break-blocks toggle
POTION_EFFECT Multiple simultaneous effects with per-effect duration and amplifier
LIGHTNING Multiple lightning strikes scattered around the block
MESSAGE Private chat message to the player
STRUCTURE OBSIDIAN_CAGE, COBWEB_TRAP, TREASURE_VAULT, ORE_VEIN_DIAMOND
CHEST_LOOT Drops from any vanilla loot table
ENCHANT_HELD Randomly enchants the held item
FIREWORKS Launches colourful random fireworks
TRAP DROP_HOTBAR — scatters hotbar items on the ground

Crafting

  • Fully configurable 3×3 shaped recipe (default: 8 Glass + 1 Sponge)
  • Live recipe re-registration on /lb reload

In-Game GUI (/lb gui)

  • Main Menu — luck bar, browse, create, give, reload
  • Reward List — paginated grid, left-click to edit, right-click to delete
  • Reward Editor — all fields visible at once; sub-GUIs for complex fields:
    • Type Selector — icon grid of all 14 reward types
    • Enchantment Editor — full enchantment browser, level +/− per enchant, applied-list with remove
    • Mob Selector — 36-mob icon grid + toggle buttons (powered, tamed, gear, sky) + count adjuster
    • Potion Effect Editor — all 33 effect types, click to add/edit duration+amp, right-click to remove
    • Command Editor — up to 18 command slots, 8 placeholder buttons, 12 template commands
  • GUI navigation uses a transitioning flag to prevent InventoryCloseEvent clearing screen state mid-switch

Localisation

  • Full multi-language support via plugins/LuckyBlock/lang/<locale>.yml
  • Bundled: en_US (English) and pl_PL (Polish)
  • Every player-facing string is in the lang file — prefix, HUD lines, tier names, GUI titles/buttons, command feedback, item names
  • Set language: en_US (or pl_PL) in config.yml

PlaceholderAPI Integration (optional soft-depend)

Placeholder Returns
%luckyblock_luck% Raw luck number
%luckyblock_luck_formatted% Coloured luck string
%luckyblock_luck_bar% 10-segment ■ bar
%luckyblock_luck_tier% Tier name string
%luckyblock_total_rewards% Number of loaded rewards

Commands

Command Permission
/lb gui luckyblock.use
/lb give <player> [amt] luckyblock.admin
/lb setluck <player> <n> luckyblock.admin
/lb addluck <player> <n> luckyblock.admin
/lb getluck [player] luckyblock.use
/lb list luckyblock.use
/lb reload luckyblock.admin

Config Additions

  • language — select locale
  • luck-min / luck-max — clamp luck range
  • luck-reset-on-death — reset luck on player death
  • cooldown-seconds — per-player break cooldown
  • cooldown-message — customisable cooldown message
  • allowed-worlds — whitelist worlds (empty = all worlds)
  • required-tool — restrict breaking to a specific tool
  • effects.sound-volume / effects.sound-pitch — fine-tune break sound
  • effects.particle-count — control particle density
  • hud.enabled — toggle the in-chat HUD box