RollMaster

Build Your Own Rewarding Experience!

---

RollMaster brings a complete, feature-rich reward rolling system to your server. Designed to boost player engagement and provide a meaningful currency sink, this plugin allows you to create fully customized loot banners that your community will love. From the intuitive player GUI to the powerful in-game editor for admins, RollMaster is the all-in-one solution for server rewards.

---

EULA Compliant & Fair Play

RollMaster is a powerful tool designed with Minecraft's commercial usage guidelines in mind. The plugin itself is a mechanism for item distribution and does not inherently violate any rules. Compliance depends entirely on how you configure the rewards.

• For Real-Money Servers: To remain EULA compliant, any banners that can be rolled using real money (or a virtual currency purchased with real money) should only grant cosmetic items that do not give a gameplay advantage (e.g., particle effects, chat titles, non-combat pets, cosmetic armor).
• For In-Game Currency Servers: If your rolls are purchased with a currency that can only be earned through gameplay, you are free to include any items as rewards, as this is considered part of your server's natural game progression.

RollMaster gives you the complete control to create a fair, engaging, and compliant reward system for your players.

---

Features

• GUI-Based System: Players can browse and roll on banners through a clean, intuitive, and paginated graphical menu.
• In-Game Banner Editor: No more fiddling with YAML files! Create, populate, and set prices for your reward banners entirely in-game with a simple command.
• Weighted Rewards & Pity System: Configure multiple reward tiers with different drop chances. The built-in guarantee system ensures players get a top-tier reward after a set number of rolls, keeping them motivated.
• Fully Configurable: Customize everything from messages and GUI titles to banner items and guarantee counts in the detailed config.yml.
• Vault Economy Integration: Seamlessly connect to your server's economy. Charge players for rolls and create a balanced currency sink.
• Admin-Friendly: A full suite of commands and permissions allows staff to create, toggle, and manage banners, as well as reload the configuration on the fly.
• Lightweight & Performant: Designed to be efficient and have a minimal impact on your server's performance.

---

Requirements

• Vault - This plugin is required for all economy features to work.
• An Economy Plugin - You also need an economy plugin that hooks into Vault, such as EssentialsX, CMI, or any other economy manager.

---

How It Works (A Quick Guide)

Click to see the process for Players and Admins...

For Players:

1. Open the Menu: Use the /rollmaster command to open the banner selection menu.
2. Choose and Roll: Browse the available banners. Clicking on an active banner will charge your account and give you a random reward from its loot table!
3. Check Your Progress: Use /rollmaster pity at any time to see how many rolls you have left until you get a guaranteed rare reward on each banner.

For Admins (Creating a Banner):

1. Start the Creation: Use the /rollmaster create <BannerName> <Price> command.
2. Populate the Loot Table: An editor GUI will open. Place the items you want as rewards into the rows. Each row corresponds to a different chance, configured in config.yml.
3. Save and Finish: Simply close the inventory. The banner is now saved and will immediately appear in the player menu!

---

Commands & Permissions

Player Commands

• /rollmaster   * Description: Opens the main banner selection GUI.   * Permission: rollmaster.use

• /rollmaster pity   * Description: Shows your personal roll count towards the guarantee on each banner.   * Permission: rollmaster.pity

Admin Commands

• /rollmaster create <name> <price>   * Description: Opens the in-game editor to create a new banner.   * Permission: rollmaster.create

• /rollmaster toggle <banner_name>   * Description: Activates or deactivates an existing banner.   * Permission: rollmaster.toggle

• /rollmaster reload   * Description: Reloads the config.yml and banners.yml files from disk.   * Permission: rollmaster.reload