MPromoCodes is a lightweight yet flexible promo code plugin that allows players to redeem reward codes using a simple command.
All rewards are fully configurable and executed safely on both Paper and Folia servers.

Features

• Redeem promo codes using /code
• Fully configurable rewards via config
• In-Game Admin Menu
• Supports console and player command execution
• Built-in message system (message:) without relying on vanilla commands
• Optional Title and Subtitle messages after successful redemption
• Per-player code usage (one-time codes)
• Supports start-date and expiry-date codes
• Permission-based code access
• Safe async execution using a custom TaskManager (Folia compatible)
• Automatic storage of redeemed codes
• Clean and simple configuration

Example Configuration

Commands

• /code <code> - Redeem a promo code
• /mpromocodes reload - Reload configuration

Permissions

• mpromocodes.use - Allows players to redeem codes
• mpromocodes.admin - Allows admin commands

How It Works

Promo codes are defined in config.yml.

Each code can:

• Run multiple commands
• Be restricted by permission
• Have a starting date
• Have an expiry date
• Be used once per player or multiple times
• Display a title and subtitle message
• Store redeemed codes safely to prevent reuse

All actions are executed in a Folia-safe way using region schedulers.

Server Compatibility

• Paper
• Purpur
• Folia
• Java 17+

Why MPromoCodes?

Unlike simple command-based plugins, MPromoCodes:

• Avoids vanilla command abuse
• Works natively with Folia threading
• Keeps configs readable and maintainable
• Is ideal for events, rewards, VIP promotions and server launches

Final Words

MPromoCodes was built with performance, clarity and future compatibility in mind.
If you are looking for a clean promo code solution that just works — this is it.

Stats

View bStats page