Friend System

# 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)