
FriendSystem
A powerful, GUI-based friends system that lets players manage friends, teleport requests, and privacy settings
📖About FriendSystem
Friends - is a comprehensive, feature-rich friends management system for Minecraft servers running Spigot/Bukkit. Built with performance and user experience in mind, this plugin allows players to build connections, manage friendships, and interact with their friends through a GUI system and commands.
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
[IMG] [IMG] [IMG] [IMG] [IMG]
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
[IMG]
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
Description: Send a friend request to a player
Usage: /friend add
Permission: friends.add
/friend remove
Description: Remove a friend from your list
Usage: /friend remove
Permission: friends.remove
/friend accept
Description: Accept a friend request (auto-generated by clicking)
Usage: /friend accept
Permission: friends.accept
/friend decline
Description: Decline a friend request (auto-generated by clicking)
Usage: /friend decline
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 (Aliases: /tpfriend, /friendtp)
Description: Send a teleport request to a friend
Usage: /rtpnn
Permission: friends.teleport
/rtpnn accept
Description: Accept a teleport request from a friend
Usage: /rtpnn accept
Permission: friends.teleport
/rtpnn decline
Description: Decline a teleport request from a friend
Usage: /rtpnn decline
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
Description: Remove all friends from a specific player
Usage: /friendadmin clearfriends
Permission: friends.admin
/friendadmin clearrequests
Description: Clear all pending requests for a specific player
Usage: /friendadmin clearrequests
Permission: friends.admin
/friendadmin resetsettings
Description: Reset a player's settings to default
Usage: /friendadmin resetsettings
Permission: friends.admin
/friendadmin removefriend
Description: Remove a specific friendship between two players
Usage: /friendadmin removefriend
Permission: friends.admin
/friendadmin cleanup
Description: Clean up invalid friendships and corrupted data
Usage: /friendadmin cleanup
Permission: friends.admin
Console-Only Commands
/friendpluginadmin addadmin (Aliases: /fpadmin, /friendsplugadmin)
Description: Grant admin access to a player (Console only)
Usage: /friendpluginadmin addadmin
Permission: Console only
/friendpluginadmin removeadmin
Description: Revoke admin access from a player (Console only)
Usage: /friendpluginadmin removeadmin
Permission: Console only
/friendpluginadmin listadmins
Description: List all plugin administrators
Usage: /friendpluginadmin listadmins
Permission: Console only
/friendpluginadmin
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 true
friends.remove
Description: Allows removing friends from your list
Default: (all players)
Commands: /friend remove 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 true
friends.decline
Description: Allows declining friend requests
Default: (all players)
Commands: /friend decline true
friends.teleport
Description: Allows teleporting to friends and managing teleport requests
Default: (operators only)
Commands: /rtpnn , /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