ReferralSystem V1.0.0-Final

ReferralSystem - Advanced Referral Plugin for Minecraft Servers

Elevate Your Server's Community with Seamless Referral Rewards!

Are you tired of struggling to grow your Minecraft server? Do you want to incentivize players to invite their friends and boost engagement? Look no further! ReferralSystem is the ultimate solution for implementing a professional, customizable referral program on your Paper/Spigot server.

🌟 Why Choose ReferralSystem?

ReferralSystem transforms your server into a thriving community hub by rewarding players for bringing in new members. With its sleek design, extensive customization options, and user-friendly interface, it's perfect for survival, creative, or any multiplayer server. Watch your player base grow exponentially while keeping everyone motivated with exclusive rewards!

🚀 Key Features

1. 🎫 Unique Referral Codes: Players generate personalized referral codes instantly.
2. 💰 Customizable Rewards: Fully configurable item rewards with custom model data, names, and lore for both referrers and new players.
3. 🏆 Leaderboard System: Display top referrers with a beautiful, ranked leaderboard.
4. 🔧 Extensive Configuration: Every message, reward, and setting is customizable via an intuitive config.yml file.
5. 💾 Persistent Data: All codes and referral counts are saved automatically, ensuring no data loss.
6. 🎨 Beautiful Styling: Professional chat formatting with prefixes, colors, and emojis for an enhanced user experience.
7. ⚡ Tab Completion: Intelligent command suggestions for easy navigation.
8. 🛡️ Permission Support: Control who can generate codes with optional permissions.
9. 📊 Statistics Tracking: View personal referral stats and server-wide leaderboards.
10. 🔄 Automatic Welcome Messages: Greet new players and prompt them to use referral codes.
11. 🌐 Multi-Language Ready: All text is configurable, making it easy to translate or customize.

📋 Commands
         

1. /referral generate

   
   - Generate your unique referral code.

2. /referral join 

   - Join the server using a referral code to claim rewards.

3. /referral info

   
   - View your referral code and statistics.

4. /referral leaderboard

   
   - Display the top referrers.

5. /referral

   - Show usage information.

🔐 Permissions

1. referral.generate

   - Allows players to generate referral codes (default: true).

2. referral.admin

   - Administrative permissions for advanced features (default: op).

⚙️ Configuration Highlights

ReferralSystem comes with a comprehensive config.yml that lets you tailor every aspect:

1. Rewards Section: Define materials, amounts, custom model data, display names, and lore for referrer and newbie rewards.
2. Messages Section: Customize all chat messages, including prefixes, colors, and formatting.
3. Settings: Control max referrals per player, permission requirements, and more.
4. Example Config Snippet:
   

   
   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!"
     # ... and many more!
   

📦 Requirements

1. Server Software: Paper 1.21+ or Spigot 1.21+ (optimized for Paper).
2. Java Version: Java 17 or higher.
3. Dependencies: None – fully standalone plugin.

🛠️ Installation

Download the ReferralSystem.jar file.Place it in your server's

plugins/

folder.Restart your server.Configure the

config.yml

file in

plugins/ReferralSystem/

to your liking.Enjoy! Players can start generating codes immediately.

💡 Use Cases

1. Survival Servers: Reward players for expanding the community.
2. Creative Networks: Encourage collaborations and friend invites.
3. Mini-Game Servers: Boost player retention with referral incentives.
4. Role-Playing Servers: Integrate referrals into your server's economy.

🎯 Benefits

1. Increase Player Retention: Rewarded players stay longer and invite more friends.
2. Boost Server Growth: Organic growth through word-of-mouth referrals.
3. Easy to Use: Intuitive commands and automatic features require minimal setup.
4. Highly Customizable: Adapt to any server's theme and style.
5. Professional Appearance: Styled messages make your server look premium.

📞 Support & Updates

Purchasing ReferralSystem grants you access to:

1. Full source code for modifications.
2. Priority support via Discord/email.
3. Free updates for bug fixes and new features.
4. Comprehensive documentation and setup guide.

Don't miss out on the opportunity to supercharge your server's growth! Invest in ReferralSystem today and watch your community flourish.

Compatible with Paper 1.21.8, tested and optimized for the latest Minecraft versions.

Download now and start rewarding referrals like a pro! 🚀