A robust, high-performance referral system. This plugin provides a complete solution for community growth through a tiered reward system and automated monthly competitions.
Core Functionality
Core Functionality
- Tiered Reward System: Custom GUI-based leveling where players claim rewards after reaching a specific number of successful referrals.
- Monthly Leaderboards: Separate tracking for monthly top recruiters with automated reset cycles.
- Offline Reward Handling: A built-in "pending commands" system ensures that monthly winners receive their rewards even if they are offline during the reset.
- Anti-Exploit Security: Integrated IP-address verification to prevent self-referrals and "alt-account" abuse.
- Playtime Requirements: Configurable minimum playtime (e.g., 1h) before a referral is counted, ensuring lead quality.
- Fully Configurable GUI: Every item, slot, and lore in the rewards menu can be modified via config.yml.
- Dynamic Reward Commands: Supports any console command for rewards (Economy, Items, Permissions, or custom scripts).
- Multi-Language Support: External lang.yml files for full localization (English and Russian pre-configured).
- Extensive PlaceholderAPI Support: Full set of placeholders for personal stats, global rankings, and monthly leaderboards.
- /referrals — Opens the rewards menu
- /referrals invite — Generates/Displays personal referral code
- /referrals use <code> — Links a new player to a recruiter
- /referrals reload — Reloads all configurations and the data (OP only)
- %referral_count%, %referral_count_monthly% — Personal referral stats.
- %referral_rank%, %referral_rank_monthly% — Current leaderboard positions.
- %referral_leaders_{N}%, %referral_leaders_monthly_{N}% — Top player names (1, 2, 3...).
- %referral_leaders_count_{N}%, %referral_leaders_monthly_count_{N}% — Top player scores.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MeToilet's referral is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 20 times (via Spigot). Download it and open it directly in the game.