BetterRewards: The Complete Promo Code System for Minecraft Servers
Running a Minecraft server means constantly looking for ways to keep players engaged. Whether you are welcoming newcomers, celebrating a holiday, or rewarding your Discord community, handing out items manually gets old fast. BetterRewards solves that problem by giving server administrators a full promotional code system that players can redeem themselves through a clean in-game interface.
This mod is built for server-side use and supports multiple Minecraft versions across popular modloaders, so most admins can find a build that matches their setup. If you have been searching for a straightforward way to run giveaways, starter kits, and seasonal events, this is the tool you want.
What BetterRewards Does
At its core, BetterRewards adds a simple redemption GUI that players open with the /promo command. They type in a code, hit confirm, and the configured rewards land in their inventory. If their inventory happens to be full, overflow items drop at their feet instead of vanishing, which is a small detail that saves a lot of support tickets.
Server admins create and manage codes entirely in-game using commands, with no need to touch config files unless they want to. Each code can hold multiple reward items with custom quantities, a maximum number of total redemptions, and an optional expiration date.
Key Features at a Glance
- Simple GUI: players redeem codes with /promo and a few keystrokes
- Flexible rewards: stack multiple items with individual quantities per code
- Admin controls: create and delete codes live with /promocode commands
- Usage limits: cap total redemptions or set an expiry timestamp
- Anti-abuse: every player can claim each code only once
- Statistics: track total redemptions and unique players per code
- Offline-mode and online-mode server support
- Auto-save: redemption data persists across restarts
How to Install BetterRewards on Your Server
Getting started is quick, and the process is the same whether you run a small private world or a busy public server. If you would rather skip manual file handling entirely, the foxygame.net launcher offers a one-click install path for BetterRewards, pulling the correct build for your Minecraft version and modloader automatically so you can get back to managing your community.
Server-Side Setup
- Download the .jar file that matches your Minecraft version and modloader.
- Place it inside your server's mods folder.
- Start the server and let the configuration files generate.
- Optionally edit server_config/promocodemod-server.toml to add default codes.
- Restart the server after any configuration changes.
Players usually do not need to install anything, though depending on the server configuration and the Minecraft version in use, the mod may also be required on the client. Always follow the instructions your server administrator provides.
Creating Your First Promo Code
The basic syntax is easy to remember. To hand out five diamonds to anyone who types WELCOME, an admin runs:
/promocode create WELCOME minecraft:diamond 5
For richer rewards, you can chain multiple items together. A starter kit might include three diamonds, an iron sword, and ten bread, all from a single command. The createraw variant handles more complex configurations with semicolons and pipes, which is handy for seasonal events where you want a redemption cap without an expiry date.
Understanding the Parameters
- CODE — letters, numbers, underscores, and hyphens; codes are case-insensitive
- item — a full Minecraft item ID such as minecraft:golden_apple
- count — quantity from 1 to 64 per reward entry
- maxUses — total redemptions allowed; 0 means unlimited
- expiryEpoch — a Unix timestamp in seconds; 0 means the code never expires
Expiration dates trip up a lot of new admins, so keep a Unix timestamp converter bookmarked. For reference, 1 January 2026 corresponds to 1767225600.
Managing Codes and Tracking Usage
Deleting a code is as simple as creating one: run /promocode delete CODE and it is gone. The GUI also surfaces useful statistics, such as "Redeemed 25 / 100" and a count of unique players who have claimed a given code, so you can see at a glance how an event is performing.
Redemption data is stored automatically in world_folder/promocodes_data.json. Manual editing is not recommended, but if you must, back the file up first.
Anti-Abuse and Offline-Mode Notes
Each player can redeem each code only once, and that information survives server restarts. Offline-mode servers are supported, but they cannot offer the same identity guarantees as authenticated online-mode servers, so admins on those setups should keep an eye out for suspicious activity and disable problematic codes when needed.
Common Troubleshooting Tips
- "Invalid item" usually means a typo in the item ID or an item unavailable in your Minecraft version.
- "Code already exists" means you need to delete the old code before recreating it.
- If a valid code will not redeem, check whether the player already claimed it, whether it expired, or whether the redemption cap was reached.
- Missing items are often sitting on the ground because the player's inventory was full.
Final Thoughts
BetterRewards fills a gap that many server owners do not realize they have until they try it. Instead of juggling spreadsheets and manual handouts, you get a clean, command-driven system with real limits, real statistics, and real anti-abuse protection. Download BetterRewards for Minecraft, create your first code, and watch your next event run itself.