RoyaleCodes 1.16.5+

About the plugin

RoyaleCodes is a high-performance, fully GUI-driven reward code system designed for modern servers. Whether you want to drop standard promotional codes or create exclusive one-time redemptions for Content Creators, RoyaleCodes handles it all asynchronously without touching a single configuration file.

Create, edit, and manage your codes entirely in-game with an interactive dashboard, backed by an optimized SQL engine.

• Dual Code System
  • Standard Codes: Classic promotional codes with configurable global use limits.
  • Content Creator Codes: Exclusive support codes. A strict validation system ensures players can only redeem one creator code per account history.

• Zero-Config In-Game GUI (Admin Mode)
  • Paged Dashboard to visualize, edit, and delete active codes.
  • Smart Chat Capture: Set limits, times, and IDs by simply typing in chat while the GUI pauses.
  • Cursor Item Reader: Set the display icon of a code by clicking the menu button with any physical item from your inventory.
  • Safe deletion with a secondary confirmation menu to prevent accidental wipes.

• Advanced Anti-Abuse & Restrictions
  • Minimum Time Played: Reads internal Spigot statistics to prevent alt-account/bot farming.
  • Maximum Global Uses: Limit redemptions (e.g., "Only the first 50 players").
  • Real-Time Expiration: Codes expire automatically based on Unix epoch time.
  • Node Permissions: Lock codes behind custom permission nodes (e.g., myserver.vip.code).
  • Admin Bypass: Instantly bypass playtime and capacity barriers with Codes.Bypass.

• Dynamic Reward Delivery
  • Physical Items: Drops excess items safely to the ground if the player's inventory is full.

• Technical & Performance
  • Fully Asynchronous SQL: MySQL & SQLite support out-of-the-box. DML transactions never touch the Main Thread.
  • In-Memory Caching: Player redemption profiles are cached to avoid database bottlenecks during high-traffic redemptions.
  • Autonomous Garbage Collector: Automatically purges expired codes from memory, database, and live GUIs.
  • Clean Architecture: Built on a robust modular suite with relocated dependencies to ensure zero conflicts with other plugins.