Friend System

Have you ever wanted a social system on your server that encourages players to invite their friends, rewards them for playing together, and tracks their daily streaks? A complete referral program with levels, rewards, and a unique fire streak system?

Luckily for you, there's my plugin that makes it possible!

I originally made this for my Paper server on version 1.21.1, but I think it should work on higher versions too.

So, the plugin includes:

---

REFERRAL SYSTEM

Each player receives a unique 6-character referral code:

• Players share their code with friends
• New players enter the code with /code <code>
• Friends are counted after meeting requirements
• Configurable requirements: days online and playtime

---

FRIEND LEVELS

Players earn rewards for bringing friends:

• Configurable levels with different goals
• Example: 5 friends, 10 friends, 25 friends
• Automatic reward commands on level up
• GUI to view all levels and rewards

---

FIRE STREAK SYSTEM

A unique "friend streak" mechanic:

• Players pair up with /streak invite <player>
• Two modes: any_login or online_together
• Streak grows daily when both players meet the requirement
• Streak breaks if a day is missed
• Visual fire icon in chat via PlaceholderAPI

---

STREAK RESTORATION

• Restore broken streaks with /friend restore
• Configurable restore limit per month
• Configurable days limit (can't restore after too many days)
• Balance between forgiveness and fairness

---

STREAK REWARDS

• Rewards for reaching certain streak lengths
• Configurable goals and commands
• Example: 7 days, 30 days, 100 days
• GUI to view and claim rewards

---

TOP STREAKS

• /streak top — view top 10 streaks on the server
• /streak list — view your active streaks
• /streak info <player> — view streak details

---

PLACEHOLDERAPI SUPPORT

Placeholder	Description
%fire_friend_streak%	Player's best streak
%rel_fire_friend_streak%	Streak between two players
%fire_friend_count%	Player's friend count
%fire_friend_code%	Player's referral code

---

GUI REWARD SYSTEM

• Beautiful inventory interface
• Available, locked, and claimed rewards
• Progress bars for goals
• Click to claim rewards

---

DAILY CHECK

• Automatic daily check at 00:01
• Verifies login days and playtime
• Updates streaks and friend counts
• Grants rewards automatically

---

COMMANDS

Command	Description
/code <code>	Activate referral code
/friend code	Show your referral code
/friend progress	View progress to next level
/friend restore	Restore a broken streak
/streak invite <player>	Invite to streak pair
/streak accept <player>	Accept streak invite
/streak decline <player>	Decline streak invite
/streak list	View your streaks
/streak top	View top streaks
/streak info <player>	View streak info
/streak break <player>	Break a streak
/rewards	Open rewards GUI

---

PERMISSIONS

Permission	Description
friendsystem.use	Use friend system commands
friendsystem.admin	Access to admin commands

---

CONFIGURATION

Section	Description
levels	Friend count levels and rewards
streak_rewards	Streak length rewards
friends_rewards	GUI rewards for friends
streak_gui_rewards	GUI rewards for streaks
referral	Referral requirements
settings	Streak mode, grace days, restore limits

---

If you run into any issues, contact me on Telegram! @AlexsandrDeveloper

(Also message me if you're interested in buying the plugin's source code)