LuckSMP replica

A luck-based PvP plugin that rewards skill and risk with powerful, proc-based abilities.

Kill players to earn Luck Books — mysterious tomes that grant one of 12 unique abilities. Manage your Luck Points to unlock slots, sacrifice books to shift your fortune, and dominate with
devastating combat effects.

Availible items

Luckbooks and their abilities

---

How It Works

Kill a player → a golden ʟᴜᴄᴋ ʙᴏᴏᴋ drops. Right-click it to discover your fate — you'll randomly receive one of 12 powerful Luck Books, placed into your available slots.

Die → lose a Luck Point. Your luck determines how many book slots you can hold:

• 1+ points → 3 slots
• 0 to -1 points → 2 slots
• -2 points → 1 slot
• -3 or less → 0 slots

Use /badluck to sacrifice a book for a chance to recover your luck.

---

Commands

• /luck — View your luck points and available slots
• /badluck — Sacrifice a book to improve your luck
• /luckbooks — Open your luck books GUI
• /giveluckbook — Admin: give a specific book

---

Features

• Paper 1.21+ — built for modern Minecraft
• Fully configurable — every proc chance, duration, and message can be customized
• Persistent data — luck points and books saved across restarts
• Clean GUI — visual slot system with locked/unlocked/filled indicators
• Lightweight — event-driven with no ticking overhead when abilities aren't active

---

Configuration

All proc chances are adjustable in config.yml. Every player-facing message is customizable in messages.yml with full color code support.

---

Drop into your plugins folder and let luck decide the rest.