## MPromoCodes<\/p>\n
Simple, powerful & Folia-ready promo code system for Minecraft servers<\/p>\n
**MPromoCodes** is a lightweight yet flexible promo code plugin that allows players to redeem reward codes using a simple command.
\nIt supports fully configurable rewards, conditions, Discord webhook logs, separated promo code files and multiple storage types including **YAML**, **SQLite** and **MySQL**.<\/p>\n
All rewards are executed safely on Bukkit, Spigot, Paper, Purpur and Folia servers.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– Redeem promo codes using **\/code**
\n– Promo codes are stored in a separate **codes.yml** file
\n– Fully configurable rewards
\n– In-Game Admin Menu
\n– Supports **console** and **player** command execution
\n– Built-in message system using `message:`
\n– Optional **Title** & **Subtitle** messages after successful redemption
\n– **Per-player** code usage
\n– One-time codes and multi-use codes
\n– Global use limits
\n– Per-player use limits
\n– Code cooldown support
\n– **20+ Conditions** for many different use cases
\n– Supports **start-date** and **expiry-date** codes
\n– **Permission-based** code access
\n– Configurable code input rules
\n– **Case-insensitive** code support
\n– Configurable **minimum** and **maximum** code length
\n– **Anti-spam protection** for failed redeem attempts
\n– **Discord webhook** integration
\n– Webhook logs for **successful** and **failed** redemptions
\n– `\/codes webhook test` command
\n– Storage support:
\n – **YAML**
\n – **SQLite**
\n – **MySQL**
\n– Automatic migration from old `config.yml` codes to `codes.yml`
\n– Automatic migration from YAML redeemed data to SQL storage
\n– Safe async execution using a custom TaskManager
\n– Folia-compatible execution
\n– Clean and organized configuration<\/p>\n
—<\/p>\n
## \ud83e\uddfe Example Code Configuration<\/p>\n
Promo codes are now stored in **codes.yml**.<\/p>\n
“`yaml
\ncodes:
\n WELCOME:
\n enabled: true
\n once-per-player: true
\n global-use: 3
\n per-player-use-limit: -1
\n cooldown: “”
\n permission-required: “”
\n start-date: “25\/12\/2025 00:00”
\n expiry-date: “31\/12\/2025 23:59”<\/p>\n
title:
\n enabled: true
\n main: “&aCode Redeemed!”
\n sub: “&7You used: &fWELCOME”
\n fade-in: 10
\n stay: 40
\n fade-out: 10<\/p>\n
commands:
\n – “console: give %player% diamond 2”
\n – “message: &aYou have successfully redeemed the &fWELCOME &acode!”
\n“`<\/p>\n
—<\/p>\n
## \u2699\ufe0f Example Plugin Settings<\/p>\n
General plugin settings are stored in **config.yml**.<\/p>\n
“`yaml
\nsettings:
\n enabled: true
\n server-name: “survival”
\n debug: false
\n case-insensitive-codes: true
\n trim-code-input: true
\n min-code-length: 2
\n max-code-length: 32
\n use-permission: “mpromocodes.use”<\/p>\n
anti-spam:
\n enabled: true
\n failed-attempt-cooldown: “3s”
\n max-failed-attempts: 5
\n block-time: “1m”
\n reset-on-success: true
\n webhook-log-blocked-attempts: true<\/p>\n
storage:
\n type: “SQLITE”
\n auto-migrate-yaml: true<\/p>\n
sqlite:
\n file: “storage.db”<\/p>\n
mysql:
\n host: “localhost”
\n port: 3306
\n database: “mpromocodes”
\n username: “root”
\n password: “password”
\n use-ssl: false
\n table-prefix: “mpromocodes_”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd17 Discord Webhook Integration<\/p>\n
MPromoCodes can send detailed logs directly to your Discord staff channel.<\/p>\n
Webhook logs can include:<\/p>\n
– Successful code redemptions
\n– Failed redemption attempts
\n– Invalid codes
\n– Expired codes
\n– Already used codes
\n– Missing permissions
\n– Global limit reached
\n– Conditions not met<\/p>\n
You can also test your webhook directly in-game:<\/p>\n
“`text
\n\/codes webhook test
\n“`<\/p>\n
Webhook embeds support configurable colors, username, avatar, footer and mention protection.<\/p>\n
—<\/p>\n
## \ud83d\uddc4 Storage System<\/p>\n
MPromoCodes supports multiple storage backends:<\/p>\n
– **YAML** \u2014 simple file-based storage
\n– **SQLite** \u2014 recommended for most single-server setups
\n– **MySQL** \u2014 recommended for larger setups and database-based storage<\/p>\n
Existing `redeemed.yml` data can be automatically migrated to SQLite or MySQL when enabled.<\/p>\n
“`yaml
\nstorage:
\n type: “SQLITE”
\n auto-migrate-yaml: true
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd04 Automatic Migration<\/p>\n
When updating from an older version, MPromoCodes can automatically move existing promo codes from `config.yml` to the new `codes.yml` file.<\/p>\n
On first startup after updating:<\/p>\n
– Existing `codes:` from `config.yml` are moved to `codes.yml`
\n– The old config is backed up as `config-old.yml`
\n– A fresh `config.yml` is generated
\n– Existing redeemed data can be migrated to SQLite or MySQL<\/p>\n
This keeps old setups safe while allowing the plugin to use the new cleaner file structure.<\/p>\n
—<\/p>\n
## \ud83d\udee1 Anti-Spam Protection<\/p>\n
MPromoCodes includes built-in anti-spam protection for failed redeem attempts.<\/p>\n
You can configure:<\/p>\n
– Failed attempt cooldown
\n– Maximum failed attempts
\n– Temporary block time
\n– Reset on successful redeem<\/p>\n
This helps protect your server and Discord webhook logs from spam.<\/p>\n
—<\/p>\n
## \ud83d\udee0 Commands<\/p>\n
– `\/code ---<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n - `mpromocodes.use` - Allows players to redeem codes The redeem permission can also be changed in `config.yml`:<\/p>\n ```yaml ---<\/p>\n ## \ud83e\udde0 How It Works<\/p>\n Promo codes are defined in **codes.yml**.<\/p>\n Each code can:<\/p>\n - Run multiple rewards Redeemed code data is safely stored using the selected storage type.<\/p>\n All actions are executed in a **Folia-safe** way using safe scheduling.<\/p>\n ---<\/p>\n ## \ud83d\ude80 Server Compatibility<\/p>\n \u2705 **Bukkit**<\/p>\n \u2705 **Spigot**<\/p>\n \u2705 **Paper**<\/p>\n \u2705 **Purpur**<\/p>\n \u2705 **Folia**<\/p>\n \u2705 **Java 17+**<\/p>\n ---<\/p>\n ## \ud83d\udce6 File Size Notice<\/p>\n The plugin `.jar` file is larger in this version because MPromoCodes now includes built-in **SQLite** and **MySQL** database support.<\/p>\n To make setup easier for server owners, the required database drivers are included directly inside the plugin file. This means you do not need to download or install any extra libraries for SQLite or MySQL support.<\/p>\n The increased file size is expected and is caused by the bundled SQL database drivers, especially the SQLite driver, which contains native libraries for multiple operating systems.<\/p>\n In short:<\/p>\n - The larger file size is normal ---<\/p>\n ## \ud83d\udca1 Why MPromoCodes?<\/p>\n Unlike simple command-based promo code plugins, MPromoCodes:<\/p>\n - Uses a clean separated `codes.yml` system ---<\/p>\n ## \u2764\ufe0f Final Words<\/p>\n **MPromoCodes was built with performance, clarity and future compatibility in mind.**<\/p>\n If you are looking for a clean promo code solution with modern storage, Discord logging and Folia-ready execution \u2014 this is it.<\/p>\n ---<\/p>\n ## \ud83d\udcca Stats<\/p>\n https:\/\/bstats.org\/plugin\/bukkit\/MPromoCodes<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" Simple, powerful & Folia-ready promo code system for Minecraft servers<\/p>\n","protected":false},"featured_media":106681,"template":"","meta":{"_minecraft_slug":"mpromocodes","_minecraft_project_id":"5XgdhBMc","_minecraft_author":"Majales","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":168,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mpromocodes.zip","_minecraft_size_bytes":33424781,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T13:15:44.615689Z","_minecraft_date_created":"2025-12-17T23:38:08.656981Z","_minecraft_date_modified":"2026-05-13T09:33:04.225316Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mpromocodes","_minecraft_icon_attachment_id":106681,"_minecraft_imported_at":"2026-06-06T03:49:58+00:00","_minecraft_import_hash":"afa70e3d795ab61b19a94bc7910781b0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,122,126,127,128,129,123,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-106680","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-magic","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n` - Redeem a promo code
\n- `\/codes reload` - Reload configuration and code files
\n- `\/codes stats` - Show information about your redeemed codes
\n- `\/codes menu` - Opens the Admin Menu
\n- `\/codes webhook test` - Sends a test Discord webhook<\/p>\n
\n- `mpromocodes.admin` - Allows admin commands
\n- `mpromocodes.admin.webhook` - Allows testing Discord webhooks<\/p>\n
\nsettings:
\n use-permission: \"mpromocodes.use\"
\n```<\/p>\n
\n- Execute console commands
\n- Execute player commands
\n- Send built-in plugin messages
\n- Be restricted by permission
\n- Have a start date
\n- Have an expiry date
\n- Be used once per player
\n- Be used multiple times
\n- Have global use limits
\n- Have per-player use limits
\n- Have cooldowns
\n- Display a title and subtitle
\n- Use advanced redeem conditions<\/p>\n
\n- No extra installation is required
\n- SQLite and MySQL work out of the box
\n- YAML storage is still supported<\/p>\n
\n- Supports Discord webhook logging
\n- Supports YAML, SQLite and MySQL storage
\n- Can automatically migrate old configs and redeemed data
\n- Avoids vanilla command abuse
\n- Works with Folia-safe scheduling
\n- Keeps configuration readable and maintainable
\n- Is ideal for events, rewards, VIP promotions, giveaways and server launches<\/p>\n