Key Features
A complete REVAMP of the plugin

Core Friend System

• Add/Remove Friends - Send friend requests and manage your friend list
• Accept/Decline Requests - Full control over incoming friend requests
• Favorites System - Mark your closest friends as favorites for quick access
• Friend Settings - Individual privacy controls for each player

GUI System

• Main Friends Menu - Central hub for all friend management
• Friends List - View all friends with online/offline status and pagination
• Pending Requests - Manage incoming friend requests with clickable accept/decline
• Settings Menu - Toggle privacy and notification preferences
• Friend Profiles - Individual pages for each friend with management options

Notifications

• Join/Leave Alerts - Get notified when friends come online or leave
• Request Notifications - Instant alerts for new friend requests
• Clickable Messages - Accept/decline requests directly from chat
• Configurable - Toggle notifications on/off per player

Teleportation System To Friends

• Request-Based Teleports - Ask permission before teleporting to friends
• Safe Landing - Smart location finding to avoid water, lava, and unsafe spots
• Accept/Decline System - Friends control who can teleport to them
• Cooldown Protection - Prevents teleport spam
• Random Distance - Teleports near friends (not exact location) for privacy

️ PvP Protection

• Friend PvP Protection - Prevents friends from hurting each other
• Melee & Projectile Protection - Blocks all damage between friends
• Configurable - Enable/disable via config

⚙️ Advanced Settings

• Privacy Controls - Players can:
  • Toggle recieving friend requests
  • Enable/disable teleport requests
  • Control join/leave notifications
  • Set profile to private
• Per-Player Configuration - Each player has individual settings

Admin Panel

• Comprehensive Admin GUI - Manage all plugin aspects from in-game
• Player Management - View any player's friend data
• Database Tools - Save, reload, cleanup, and export data
• Bulk Operations - Clear all requests, reset settings, remove favorites
• Admin Management System - Grant/revoke admin access (console only)
• Statistics Dashboard - View total players, friendships, requests, and more

Statistics Tracking

• Player Statistics - Track logins, friend additions/removals, teleports, requests
• Global Statistics - View server-wide friendship metrics

Performance Features

• JSON Database - Fast and efficient data storage
• Auto-Save System - Configurable automatic data saving
• Cooldown Management - Prevents spam and server lag
• Request Expiration - Old friend requests automatically expire
• Optimized GUI - Smooth pagination and instant updates

Smart Cooldown System

• Per-Target Cooldowns - 3-minute cooldown per friend request recipient
• Teleport Cooldowns - Configurable cooldown between teleports
• Anti-Spam Protection - Prevents request flooding

Commands

Player Commands
/friend (Aliases: /friends, /f)
Description: Main friends command
Usage: /friend [list|add|remove|gui|help]
Permission: friends.use

/friend list
Description: View your friends list in chat
Usage: /friend list
Permission: friends.list

/friend add <name>
Description: Send a friend request to a player
Usage: /friend add <playername>
Permission: friends.add

/friend remove <name>
Description: Remove a friend from your list
Usage: /friend remove <playername>
Permission: friends.remove

/friend accept <name> <uuid>
Description: Accept a friend request (auto-generated by clicking)
Usage: /friend accept <playername> <uuid>
Permission: friends.accept

/friend decline <name> <uuid>
Description: Decline a friend request (auto-generated by clicking)
Usage: /friend decline <playername> <uuid>
Permission: friends.decline

/friend gui (Also: /friend menu)
Description: Open the friends GUI menu
Usage: /friend gui
Permission: friends.use

/friend help
Description: Display help with available commands
Usage: /friend help
Permission: friends.use

Teleport Commands
/rtpnn <friend> (Aliases: /tpfriend, /friendtp)
Description: Send a teleport request to a friend
Usage: /rtpnn <friendname>
Permission: friends.teleport

/rtpnn accept <name>
Description: Accept a teleport request from a friend
Usage: /rtpnn accept <friendname>
Permission: friends.teleport

/rtpnn decline <name>
Description: Decline a teleport request from a friend
Usage: /rtpnn decline <friendname>
Permission: friends.teleport

Admin Commands
/friendadmin (Aliases: /fadmin, /friendsadmin)
Description: Admin commands for friends plugin
Usage: /friendadmin [reload|save|stats|clearfriends|clearrequests|resetsettings|removefriend|cleanup]
Permission: friends.admin

/friendadmin gui
Description: Open the admin GUI panel
Usage: /friendadmin gui
Permission: friends.admin

/friendadmin reload
Description: Reload plugin configuration and messages
Usage: /friendadmin reload
Permission: friends.admin

/friendadmin save
Description: Manually save the database and statistics
Usage: /friendadmin save
Permission: friends.admin

/friendadmin stats
Description: View plugin statistics (total players, friendships, requests)
Usage: /friendadmin stats
Permission: friends.admin

/friendadmin clearfriends <player>
Description: Remove all friends from a specific player
Usage: /friendadmin clearfriends <playername>
Permission: friends.admin

/friendadmin clearrequests <player>
Description: Clear all pending requests for a specific player
Usage: /friendadmin clearrequests <playername>
Permission: friends.admin

/friendadmin resetsettings <player>
Description: Reset a player's settings to default
Usage: /friendadmin resetsettings <playername>
Permission: friends.admin

/friendadmin removefriend <player> <friend>
Description: Remove a specific friendship between two players
Usage: /friendadmin removefriend <player1> <player2>
Permission: friends.admin

/friendadmin cleanup
Description: Clean up invalid friendships and corrupted data
Usage: /friendadmin cleanup
Permission: friends.admin





Console-Only Commands
/friendpluginadmin addadmin <player> (Aliases: /fpadmin, /friendsplugadmin)
Description: Grant admin access to a player (Console only)
Usage: /friendpluginadmin addadmin <playername>
Permission: Console only

/friendpluginadmin removeadmin <player>
Description: Revoke admin access from a player (Console only)
Usage: /friendpluginadmin removeadmin <playername>
Permission: Console only

/friendpluginadmin listadmins
Description: List all plugin administrators
Usage: /friendpluginadmin listadmins
Permission: Console only

/friendpluginadmin <command>
Description: All other admin commands work from console as well
Usage: /friendpluginadmin [save|reload|stats|removefriend|cleanup]
Permission: Console only

Permissions
Player Permissions
friends.use
Description: Allows basic friend commands and GUI access
Default: (all players)
Commands: /friend, /friend gui, /friend help true

friends.add
Description: Allows sending friend requests
Default: (all players)
Commands: /friend add <name> true

friends.remove
Description: Allows removing friends from your list
Default: (all players)
Commands: /friend remove <name> true

friends.list
Description: Allows viewing your friends list
Default: (all players)
Commands: /friend list true

friends.accept
Description: Allows accepting friend requests
Default: (all players)
Commands: /friend accept <name> true

friends.decline
Description: Allows declining friend requests
Default: (all players)
Commands: /friend decline <name> true

friends.teleport
Description: Allows teleporting to friends and managing teleport requests
Default: (operators only)
Commands: /rtpnn <friend>, /rtpnn accept, /rtpnn decline op

Admin Permissions
friends.admin
Description: Allows using all admin commands and admin GUI
Default: (operators only)
Commands: All /friendadmin commands op

Wildcard Permission
friends.*
Description: Grants all friend permissions
Default: (operators only)
Includes: op

• friends.use
• friends.add
• friends.remove
• friends.list
• friends.accept
• friends.decline
• friends.teleport
• friends.admin

Now the owner of the server can set his own friends limit (the amount of friends that every player can have)(By default the limit is 50)

Bug fix

Multiple changes :
1. Plugin uses new file to manage user messages - messages.yml
2. You can change text color ( using color codes )
3. The plugin uses now placeholder api plugin. So you can use placeholders in the message strings
4. You must download placeholders api plugin. After installing this plugin run that command to download player expansion pack:
/papi ecloud download Player


(if you find a bug let me now)

Now you can customize any message!

(now it is in the config.)

In the next update it will be in a new file "messages.yml"

I fixed friend remove command when the friend is offline

bug fixed










I think I fixed all the bugs (I'm not sure)

In this update I fixed bugs.

I added the name of the world in the friend list near the name of online friend

please remove old config file so a new config file will be created

With this update you can teleport near your friend on the friend list (if your friend online)!
To activate this new feature use config parameters:
1. TpNearToOnlineFriend: 1
2. TpDistance: 10
First parameter takes 1 as YES or any other number as NO.
Second parameter is a distance from your friend to teleport to.



new permissions:
friends.teleport ()

Bug fixes

Now, if your friend joined the game or left the game, his friends will receive a message about his joining or leaving.