Lucky Block - XPrison Addon 1.0

🎲 Lucky Block Enchant — Custom Addon for X-Prison

💎 Premium Addon for X-Prison Enchants
⚠️ This is a custom enchantment addon made exclusively for the X-Prison Core. It will not function without X-Prison installed.

✨ What is Lucky Block?

Lucky Block is a powerful, progression-based enchant that brings excitement, rewards, and randomness to your prison server. When equipped, it gives players a chance to spawn a Lucky Block while mining—which, when broken, rewards them with valuable loot, boosters, or economy perks.

Perfect for engaging players and keeping mining fun, Lucky Block is fully customizable and scales with enchant level, making it a great long-term progression goal.

🧱➡️🎁 Every mined block is a chance at a jackpot!

🧠 How It Works

✅ Works passively when equipped on a pickaxe
🎁 Chance to spawn a Lucky Block increases with enchant level
💥 Lucky Blocks drop valuable rewards when broken (commands, messages, weights all configurable)
📈 Level-based scaling: 0.015% at Level 1 → 1.5% at Max Level 100
📣 Customizable spawn message: &6Lucky Block spawned! &aBreak it to receive a random reward!
⚙️ Ideal for crate systems, boosters, and economy-driven servers

🔢 Reward Pool (Weighted RNG)

Each Lucky Block can randomly trigger one of the following (by default, configurable):

• 💰 1,000,000 Tokens — 30% weight

• 💵 $20,000,000 in-game money — 30% weight

• 🎁 2x Legendary Crate Keys — 20% weight

• 🔥 2.5x Sell Multiplier (10 mins) — 10% weight

• 🪙 2.5x Token Multiplier (10 mins) — 10% weight

Fully editable reward system using commands, messages, and weights in config.

🔧 Configuration (JSON Overview)

{
"class": "dev.drawethree.xprison.enchant.LuckyBlockEnchant",
  "id": 102,
  "rawName": "luckyblock",
  "name": "&eLucky Block",
  "enabled": true,
  "increaseCostBy": 250,
  "maxLevel": 100,
  "currency": "GEMS",
  "initialCost": 1000,
  "chance": 0.015,
  "pickaxeLevelRequired": 1,
  "message": "&6Lucky Block spawned! &aBreak it to receive a random reward!",
  "rewards": [
    {
"command": "tokens give %player% 1000000",
      "message": "&aYou received &e1,000,000 &atokens!",
      "weight": 30
    },
    {
"command": "eco give %player% 20000000",
      "message": "&aYou received &e$20,000,000&f!",
      "weight": 30
    },
    {
"command": "crate givekey %player% legendary 2",
      "message": "&6You received &e2x &lLegendary Crate Keys!",
      "weight": 20
    },
    {
"command": "sellmulti %player% 2.5 10 MINUTES",
      "message": "&bSell Multiplier &fx2.5 &bfor 10 minutes activated!",
      "weight": 10
    },
    {
"command": "tokenmulti %player% 2.5 10 MINUTES",
      "message": "&bToken Multiplier &fx2.5 &bfor 10 minutes activated!",
      "weight": 10
    }
],
  "refund": {
"enabled": true,
    "guiSlot": 53,
    "percentage": 50.0
  },
  "gui": {
"name": "&eLucky Block",
    "material": "SPONGE",
    "customModelData": 0,
    "slot": 53,
    "description": [
"&7&o(( Chance to spawn a Lucky Block while mining ))",
      "&7&oBreak it to receive an OP reward!",
      "",
      "&fScales with level:",
      "&f➤ &7Level 1: 0.015%",
      "&f➤ &7Level 100: 1.5% max chance"
    ]
  }
}

📈 Scaling Chance Formula:
Level * base chance (0.015%)
→ At Level 100, you reach 1.5% proc chance

🛒 Monetization-Ready

This enchant is perfect for donor perks and premium shops:

• Add to GUI token shops

• Include in crate loot tables

• Bundle with ranks, kits, or seasonal rewards

• Encourage prestige grinding by scaling the reward frequency

🛠️ Installation

1. Drop LuckyBlockEnchant.jar into /plugins/X-Prison/addons/

2. Reload or restart your server

3. Open the in-game enchant GUI and apply it to a pickaxe

4. Start mining and watch the blocks turn lucky!

📋 GUI Integration

• Appears as a Sponge in the enchant GUI

• Custom description with scaling details and tooltips

• Refundable at 50% of cost by default

🔧 Requirements

✅ Requires X-Prison Plugin
❌ Not compatible with other prison systems
🔁 Fully tested with Spigot, Paper, and Purpur

📞 Support & Custom Enchants

Want help or custom enchantments tailored for your server?

📨 Contact via DM or join our Discord server for assistance and custom work.

✅ Terms of Use

• Licensed for unlimited personal/server use

• Redistribution or resale is strictly prohibited

• Follows the same license structure as X-Prison

🚀 Add Some Luck to Your Mines Today!

Lucky Block keeps players engaged, rewarded, and always hoping for that next big prize.
Make mining addictive. Make it lucky.