🎰 BS-Rewards

The Ultimate Casino-Style Reward System for Minecraft Servers

BS-Rewards is a high-polish, lightweight rewards plugin designed to increase player retention through gamified daily rewards and secret code redemptions.

Featuring a unique "Decelerating Title Animation", players experience a fast-to-slow rolling effect on their screen that builds hype before landing on their final prize.

---

✨ Features

• 🎡 Casino Rolling Animation: A smooth, custom-timed title sequence that starts fast and slows down as it reveals the reward.
• 💎 Tiered Rewards: Support for COMMON, RARE, LEGENDARY, and MYTHIC tiers out of the box.
• 🎟️ Secret Codes: Create one-time-use redemption codes (e.g., WELCOME2026) for your community or influencers.
• 📦 Dynamic GUI: Every slot, item, name, and lore in the rewards menu is 100% editable in the config.
• ✨ HEX & Gradient Support: Fully compatible with MiniMessage and Hex colors via BS-Core.
• 🛠️ Admin Control: Easily reset player cooldowns or reload configurations with built-in tab-completion.

---

📸 Media

---

🚀 Commands & Permissions

Command	Description	Permission
/rewards	Opens the Rewards Dashboard	None (Default)
/rewards reload	Reloads the config and data files	bsrewards.admin
/rewards dailyreset <player>	Manually resets a player's daily cooldown	bsrewards.admin

---

🛠️ Installation

1. Dependencies: Ensure you have BS-Core installed (Required for color formatting).
2. Upload: Drop BS-Rewards.jar into your /plugins/ folder.
3. Restart: Restart your server to generate the default files.
4. Customize: Open config.yml to set your custom commands, tiers, and GUI layout!

---

⚙️ Configuration Preview

BS-Rewards allows you to control the math behind the "roll":

animation:
  total-rolls: 22
  initial-delay: 2
  slowdown-start: 10
  slowdown-amount: 2
  sound: "BLOCK_NOTE_BLOCK_HAT"