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)
