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

• 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.

Customization & Integration

• 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.

Commands & Permissions

• /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)

Placeholders

• %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.