RallyRefer

Turn current players into recruiters without paying instant rewards to disposable alt accounts.

RallyRefer is a lightweight Paper and Folia referral plugin. A reward is paid only after the invited player reaches a configurable playtime threshold and passes practical anti-abuse checks.

What is RallyRefer?

Each player's name is their referral code. A new player runs /rally refer <name> shortly after joining. When that new player stays long enough, both sides receive their configured reward.

Features

• In-game item editor — use /rally refer edit to edit the new-player and inviter item rewards. Custom names, enchantments, model data, NBT, and filled shulkers are preserved.
• Reward on qualification, not signup — invited players must actually play before anyone is paid.
• Same-IP protection — obvious same-address referrals can be blocked.
• Daily inviter cap — limit how many referrals one player can cash out per day.
• Claim window — prevent established accounts from assigning a referrer long after joining.
• Rewards for both sides — give items, Vault money, and any console command.
• Offline inviter queue — an inviter who is offline receives the current reward on their next join.
• Folia-ready — playtime is measured from session time without ticking tasks.
• PlaceholderAPI support — show referral codes, counts, referrers, and qualification status.
• Simple storage — one flat YAML file, no database setup.

How it works

1. An existing player shares their name as a referral code.
2. A new player runs /rally refer <code> during the claim window.
3. The new player reaches the required playtime.
4. Anti-abuse rules are checked, then both players are rewarded.

Commands

Command	Description	Permission
/rally refer	Show your referral code	vouch.use
/rally refer <code>	Set who referred you	vouch.use
/rally refer edit	Edit the two item reward tracks	vouch.admin
/rally refer reload	Reload the configuration	vouch.admin
/rally refer stats <player>	Inspect referral statistics	vouch.admin

When RallyDaily is not installed, the standalone aliases /vouch and /vouchadmin remain available.

Placeholders

%vouch_code% · %vouch_referrals% · %vouch_referred_by% · %vouch_qualified%

Requirements

• Paper, Purpur, or Folia 1.20+
• Java 21
• Optional: PlaceholderAPI, Vault, and an economy plugin

Installation

1. Put the RallyRefer JAR in your server's plugins folder.
2. Restart the server.
3. Set the qualification time, claim window, same-IP rule, and daily cap in plugins/RallyRefer/config.yml.
4. Run /rally refer edit to build both item reward tracks in-game.
5. Test the complete flow with two player accounts before launching it publicly.

Important behavior

If a referral fails an anti-abuse check, it is marked as processed and pays nothing. Offline inviter rewards use the current configured reward when delivered. If an inventory is full, only leftover items are dropped safely at the player's feet.

RallyRefer is part of the Rally engagement suite with RallyDaily and RallyVote. Each plugin works on its own.

License

Free to download and use on Minecraft servers. All rights reserved; redistribution, resale, and modified reuploads are not permitted.