Let players invite friends with unique codes, earn RefPoints, unlock milestones, and spend rewards in a built-in shop — with strong anti-abuse and staff tools. Paper and Folia 1.21 - 26.x
Support
Report bugs and get support here: https://discord.gg/VvM6k2eBDa
Features
• Folia support – Runs on Paper and Folia 1.21.x
• Referral codes – Each player gets a unique code; friends redeem with /referral or /ref
• Referral GUI – Hub menu for stats, milestones, RefPoints shop, and leaderboard
• RefPoints shop – Buy configured items with RefPoints; prices and rewards in gui/shop-gui.yml
• Invite milestones – Tiered rewards when referees reach playtime goals (gui/milestones-gui.yml)
• Instant rewards – Console commands and optional Vault money for referrer and referee on redeem
• Leaderboard – Top referrers in GUI and command view
• Anti-abuse – Household/subnet limits, IP caps, optional staff review, blacklist, and suspicion alerts
• Code sharing block – Stops sharing real referral codes in public chat and private-message commands
• Offline referrer mail – Notifies offline referrers when someone uses their code
• Discord webhook – Optional embed when a referral is redeemed
• Admin toolkit – Lookup, shop purchase history, points management, links, export, and full reset options
Placeholders
%perfreferral_code% – Player referral code
%perfreferral_count% – Successful invites (alias: %perfreferral_invite_count%)
%perfreferral_ref_points% – RefPoints balance (alias: %perfreferral_points%)
%perfreferral_invite_tier% – Current invite milestone tier label (alias: %perfreferral_tier%)
%perfreferral_next_milestone_minutes% – Minutes until next milestone requirement (if any)
Commands
/referral – Open main GUI when configured, otherwise show usage (perfreferral.use)
/ref – Alias for /referral (perfreferral.use)
/referral gui – Open the referral hub GUI (perfreferral.use)
/referral code – Show or generate your referral code (perfreferral.use)
/referral (code) – Redeem a referral code (perfreferral.use)
/referral use (code) – Redeem a referral code (perfreferral.use)
/referral stats – View your referral statistics (perfreferral.use)
/referral leaderboard – Open the referral leaderboard GUI (perfreferral.use)
/perfreferral reload – Reload configs and refresh the code index (perfreferral.admin)
/perfreferral help – Show admin command overview (perfreferral.admin)
/perfreferral lookup (player) [page] – Inspect a player’s referral data (perfreferral.admin)
/perfreferral history (player) [page] – View RefPoints shop purchase history (perfreferral.admin)
/perfreferral reset (player) – Reset a player’s referral data (perfreferral.admin)
/perfreferral setcode (player) (code) – Set a player’s referral code (perfreferral.admin)
/perfreferral export – Export referral data to CSV (perfreferral.admin)
/perfreferral blacklist list – List blacklisted players (perfreferral.admin)
/perfreferral blacklist add (player) – Blacklist a player from referrals (perfreferral.admin)
/perfreferral blacklist remove (player) – Remove a player from the blacklist (perfreferral.admin)
/perfreferral approve (linkId) – Approve a pending referral link (perfreferral.admin)
/perfreferral reject (linkId) – Reject and remove a pending referral link (perfreferral.admin)
/perfreferral shop add (id) (price) (name…) – Create a shop item (perfreferral.admin)
/perfreferral shop cmd (id) (console…) – Add a purchase console command to a shop item (perfreferral.admin)
/perfreferral shop slot (id) (slot) – Set a shop item GUI slot (perfreferral.admin)
/perfreferral shop remove (id) – Remove a shop item (perfreferral.admin)
/perfreferral shop list – List shop items (perfreferral.admin)
/perfreferral shop info (id) – Show shop item details (perfreferral.admin)
/perfreferral points lookup (player) – Show a player’s RefPoints balance (perfreferral.admin)
/perfreferral points add (player) (amount) – Add RefPoints (perfreferral.admin)
/perfreferral points remove (player) (amount) – Remove RefPoints (perfreferral.admin)
/perfreferral link add (referrer) (referee) (code) – Create a referral link manually (perfreferral.admin)
/perfreferral link remove (referee) – Remove a referral link (perfreferral.admin)
/perfreferral milestones reset (player) – Reset invite milestone claim flags (perfreferral.admin)
/perfreferral resetall confirm – Wipe all referral core data (perfreferral.admin)
/perfreferral ipwhitelist list – List IP whitelist entries (perfreferral.admin)
/perfreferral ipwhitelist add (player) – Add a player to the IP whitelist (perfreferral.admin)
/perfreferral ipwhitelist remove (player) – Remove a player from the IP whitelist (perfreferral.admin)
Database
• SQLite (default)
• MySQL (configurable)[/code]
