Referrals for Minecraft: Referral System with Player Rewards

Why Every Minecraft Server Needs a Referral System

Growing a Minecraft server takes more than just great builds and fun minigames. You need an active, loyal community that spreads the word. Word of mouth is powerful, but without a structured incentive, players may not bother inviting friends. The Referrals plugin changes that by rewarding both the inviter and the newcomer, turning your player base into a motivated recruitment team. It is a super-configurable tool that integrates seamlessly with your economy, items, and console commands, giving you full control over how you thank players for bringing fresh faces to your world.

How the Referrals Plugin Works

The core loop is simple but effective. Existing players generate unique referral codes, which they share with friends. When a new player joins and redeems that code, both parties receive customizable rewards. This not only encourages invites but also gives newcomers an immediate reason to engage with the server. The plugin tracks everything, prevents abuse, and offers detailed statistics so you can see who your top community builders are.

Generating and Redeeming Codes

An established player uses /generatecode to create a code. They can optionally specify a custom code if the server allows it. To see all their active codes, they type /codes. The new player, upon logging in for the first time, sees a configurable prompt instructing them to run /redeemcode <code> (in older versions, /redeem). Once redeemed, the plugin awards prizes to both sides and logs the event. The code is then deleted to prevent reuse, and the same player cannot redeem multiple codes.

Key Features That Set It Apart

• Fully customizable messages, rewards, and limits via an intuitive config file.
• Rewards in the form of in-game money (Vault economy), items, or console commands executed on behalf of the player.
• Milestone rewards: give special prizes when a player reaches 5, 10, or any number of successful referrals.
• Anti-abuse checks: prevents self-referral, same-IP referral, and old players from gaming the system.
• Optional restriction that only allows code redemption on a player’s first login.
• Automatic removal of old, unused codes after a configurable number of days.
• Leaderboard with /refertop to showcase top referrers and fuel friendly competition.
• Detailed referral stats per player via /referstats [player].
• Over 839 quadrillion possible codes, ensuring uniqueness and security.
• Logging system for all referral activity when enabled.

Commands and Permissions

Commands

• /generatecode [code] – Create a referral code. If a custom code is provided and allowed, that exact code is set.
• /redeemcode <code> – Redeem a referral code to claim your reward and credit the referrer. (Use /redeem for versions below 0.42.)
• /codes – View all your currently active referral codes.
• /refertop [page] – Display the leaderboard of top referrers.
• /referstats [player] – Check how many players you or another user have referred.
• /help referrals – Show the plugin’s help page.
• /fixrefferers – Reset playtime tracking for all players (useful if a glitch causes incorrect required playtime errors).

Permissions

• referrals.generate – Allows generating referral codes (default: true).
• referrals.redeem – Allows redeeming a code (default: true).
• referrals.stats – Allows viewing personal referral stats (default: true).
• referrals.top – Allows viewing the top referrers list (default: true).
• referrals.fix – Allows using the fix command (default: false).

Configuration and Rewards

The plugin’s true power lies in its deep configuration. You can tailor every aspect of the referral experience to match your server’s theme and economy. The main config file lets you set maximum codes per player, required playtime before generating codes, whether to use player names instead of codes, and IP checking. Rewards are defined under the Prizes section.

Setting Up Prizes

Under Prizes, you’ll find onRedeem (given to the code redeemer), onEvery (given to the referrer for each successful referral, unless a milestone is hit), and milestone entries like on5 for when a player reaches five referrals. Each prize can include:

• money: an amount granted via Vault (requires useEconomy: true).
• items: a list in the format MATERIAL:DATA:AMOUNT, e.g., DIAMOND:0:50 for 50 diamonds.
• commands: console commands executed with @p for the rewarded player and @r for the referred player. For example, gamemode 1 @p or give @p diamond 10.

This flexibility means you can give temporary ranks, broadcast announcements, or trigger any scripted event. Many server owners use this to integrate with crates, kits, or custom enchantments. For those who enjoy tinkering with server-side tools, the foxygame.net launcher provides a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, making it a breeze to keep your server’s plugin setup organized alongside client mods.

Customizing Messages

All player-facing messages are stored in a separate messages config. You can use standard Minecraft color codes with & and special placeholders like @n for player name, @c for the code, and @r for referral count. This allows you to brand the referral system in your server’s unique voice.

Installation and Compatibility

Installing Referrals is straightforward: drop the referrals.jar file into your server’s plugins folder and restart. For BungeeCord networks, you’ll want to set checkIpAdress: false or configure your proxy to forward real player IPs by adding both your server IP and 127.0.0.1 under bungee-proxies in spigot.yml. The plugin automatically updates its config when new options are added, so you won’t lose your settings. Metrics collection can be disabled by opting out in the PluginMetrics config if desired.

Conclusion

The Referrals plugin transforms passive players into active promoters, fueling organic growth without aggressive advertising. Its rich configuration, milestone rewards, and anti-cheat measures make it a reliable choice for servers of any size. By giving your community a tangible reason to invite friends, you create a self-sustaining cycle of engagement that benefits everyone. Whether you run a survival world, a minigame hub, or a roleplay realm, this plugin is a smart addition to your server toolkit.