MPromoCodes

MPromoCodes

Simple, powerful & Folia-ready promo code system for Minecraft servers

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 & 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

codes:
  WELCOME:
    once-per-player: true
    global-use: 3
    start-date: "25/12/2025 00:00"
    expiry-date: "31/12/2025 23:59"
    title:
      enabled: true
      main: "&aCode Redeemed!"
      sub: "&7You used: &fWELCOME"
      fade-in: 10
      stay: 40
      fade-out: 10
    commands:
      - "console: give %player% diamond 2"
      - "message: &aYou have successfully redeemed the &fWELCOME &acode!"

---

🛠 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 starting date
• Have expiry date
• Be used once per player or multiple times
• Display a title & subtitle message
• Redeemed codes are safely stored 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 (no broken /msg)
• 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

https://bstats.org/plugin/bukkit/MPromoCodes