ReferralSystem V1.0.0-Final

🎫 ReferralSystem — Advanced Referral Plugin

Elevate your Minecraft community with seamless referral rewards

🌟 Why Choose ReferralSystem?

ReferralSystem transforms your server into a thriving community hub by rewarding players for inviting their friends!
Boost engagement, increase growth, and keep your players motivated with exclusive, fully customizable rewards.

🚀 Key Features

🎫 Unique Referral Codes — Players generate personalized codes instantly
💰 Customizable Rewards — Configure item rewards, names, and lore
🏆 Leaderboard System — Show top referrers in style
🔧 Full Configuration — Edit every message, reward, and color
💾 Persistent Data — No progress lost, ever
🎨 Beautiful Chat Formatting — Prefixes, colors, emojis, and more
⚡ Tab Completion — Smooth command suggestions
🛡️ Permission Support — Full admin control
📊 Statistics Tracking — Player stats and global leaderboards
🔄 Welcome Messages — Auto-prompts new players
🌐 Multi-Language Ready — Fully translatable messages

📋 Commands

/referral generate — Generate your unique referral code
/referral join — Join the server using a referral code
/referral info — View your code and referral stats
/referral leaderboard — Display top referrers
/referral — Show command help

🔐 Permissions

referral.generate — Allows players to generate referral codes (default: true)
referral.admin — Administrative control (default: op)

⚙️ Configuration Highlights

ReferralSystem includes a powerful config.yml that lets you adjust every element to match your server’s branding:

🎁 Rewards Section — Define materials, model data, display names & lore
💬 Messages Section — Customize all texts, prefixes, and colors
⚙️ Settings — Manage limits, permissions, and more

prefix: "&8[&aReferral&8] &r"
referrer-reward:
  material: DIAMOND
  amount: 1
  custom-model-data: 0
  name: "&aReferral Reward"
  lore:
    - "&7Thanks for inviting a friend!"
messages:
  code-generated: "&aYour referral code is: &e%code%&a! Share it with friends!"
  

📦 Requirements

🧱 Server Software: Paper 1.21+ / Spigot 1.21+ (optimized for Paper)
☕ Java Version: 17 or higher
🔌 Dependencies: None — 100% standalone

🛠 Installation

1️⃣ Download ReferralSystem.jar
2️⃣ Place it inside your /plugins folder
3️⃣ Restart your server
4️⃣ Configure the config.yml inside /plugins/ReferralSystem/
5️⃣ Enjoy — players can start generating codes immediately!

💡 Use Cases

🌍 Survival Servers — Reward players for growing your community
🎨 Creative Networks — Encourage friend invites & collaboration
⚔️ Mini-Game Servers — Keep players engaged with rewards
🧙 Roleplay Servers — Integrate referrals into your economy system

🎯 Benefits

✅ Boost Player Retention — Reward loyalty and engagement
✅ Accelerate Server Growth — Organic, word-of-mouth expansion
✅ Easy to Use — No complex setup or coding needed
✅ Fully Customizable — Fits any server theme
✅ Professional Appearance — Looks premium out of the box

📞 Support & Updates

💬 Full Source Code — Modify freely
📘 Documentation — Complete setup guide
🔄 Free Updates — Includes new features & bug fixes
⚙️ Priority Support — Discord or email support for buyers

🚀 Compatible with Paper 1.21.8+ — Download now and start rewarding referrals like a pro!