Roll Master

# 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 * **(https://www.spigotmc.org/resources/vault.34315/)** - 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) <details> <summary>Click to see the process for Players and Admins...</summary> **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! </details> --- ## 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