Friends - Speedgot

Friends -----

Add friends, send messages, mail, and create parties

Friends is a social plugin that lets players add friends, send messages, mail, gifts, and create parties on your server. Works across BungeeCord and Velocity networks.

Features:

Friend System – Add friends, best friends, favorites, groups, notes, and nicknames.
Gift System – Send items to friends with anti-abuse protection (cooldowns, daily limits, blacklist).
Private Messaging – Direct messages with reply functionality and sound notifications.
Mail System – Send offline messages to players who aren't online.
Party System – Create parties, invite friends, and manage groups.
Party Effects – Party members get potion effects with proximity-based activation.
Leaderboards – Rankings for most friends, gifts sent, and messages.
Statistics – Track your social stats and see your rankings.
GUIs – Clean inventory menus for everything.
Cross-Server – Full BungeeCord and Velocity support.
PlaceholderAPI – 20+ placeholders for scoreboards and more.
Database – MySQL and SQLite with auto-migration.
Developer API – Full API for integration.

Commands:

/friend add <player> – Send a friend request.
/friend remove <player> – Remove a friend.
/friend accept <player> – Accept a request.
/friend deny <player> – Deny a request.
/friend list – View your friends.
/friend requests – View pending requests.
/friend best <player> – Toggle best friend status.
/friend favorite <player> – Toggle favorite status.
/friend nick <player> <nickname> – Set a nickname for a friend.
/friend note <player> <note> – Add a note about a friend.
/friend group create/delete/set/list – Manage friend groups.
/friend tp <player> – Teleport to a friend.
/friend jump <player> – Jump to a friend's server.
/friend info <player> – View friend details.
/friend gui – Open the friends menu.

/msg <player> <message> – Send a private message.
/reply <message> – Reply to the last message.
/mail read [page] – Read your mail.
/mail send <player> <message> – Send mail.
/mail delete <id/all> – Delete mail.

/party create – Create a party.
/party invite <player> – Invite a player.
/party accept/deny <player> – Handle invitations.
/party leave – Leave your party.
/party kick <player> – Kick a player.
/party info – View party info.
/party disband – Disband your party.
/party transfer <player> – Transfer leadership.
/party effects – View active effects.

Permissions:

friends.use – Basic friend commands.
friends.mail – Mail system access.
friends.message – Messaging access.
friends.party – Party system access.
friends.party.effects – Party effects access.
friends.teleport – Teleport to friends.
friends.jump – Jump to friend's server.
friends.admin – Admin commands.

PlaceholderAPI:

%friends_count% - Total friends
%friends_online% - Online friends
%friends_offline% - Offline friends
%friends_best_friends% - Best friends count
%friends_requests% - Pending requests
%friends_gifts% - Pending gifts
%friends_gifts_sent% - Total gifts sent
%friends_gifts_received% - Total gifts received
%friends_messages_sent% - Messages sent
%friends_rank_friends% - Leaderboard rank
%friends_rank_gifts% - Gifts leaderboard rank
%friends_party_size% - Party size
%friends_in_party% - In party (true/false)
%friends_mail_unread% - Unread mail

Code (YAML):

# Friends Plugin Configuration

settings:
max-friends : 0

private-messages:
friends-only : false
log-to-console : false
sounds : true
cross-server : true
allow-toggle : true

party:
max-size : 8
allow-public-parties : true
effects:
enabled : true
proximity-required : true
proximity-range : 50
scaling-strength : true
scale-percentage : 10
update-interval : 100
bonuses:
regeneration : 0
damage_resistance : 0
speed : 0
luck : 0
haste : 0

mail:
max-mail : 100
max-mail-length : 1000
auto-cleanup:
enabled : true
days-old : 30

gifts:
enabled : true
cooldown : 60
max-daily : 10
max-stack-size : 64
expiry-days : 7
blacklist :
- BEDROCK
- BARRIER
- COMMAND_BLOCK

teleport:
enabled : true
cooldown : 30
cross-server : true

network:
enabled : true
channel : "friends:network"

storage:
auto-purge:
enabled : false
interval : 30
older-than : 60

debug : false

API Usage:

Friend Management:

Code (Text):

FriendsAPI.getFriends(playerUUID) // Get a player's friends list

FriendsAPI.getOnlineFriends(playerUUID) // Get only online friends

FriendsAPI.areFriends(playerUUID, otherUUID) // Check friendship status

FriendsAPI.addFriend(playerUUID, friendUUID) // Add a friend directly

FriendsAPI.removeFriend(playerUUID, friendUUID) // Remove a friend

Friend Requests:

Code (Text):

FriendsAPI.sendFriendRequest(senderUUID, receiverUUID) // Send a request

FriendsAPI.getPendingRequests(playerUUID) // Get pending requests

FriendsAPI.acceptFriendRequest(receiverUUID, senderUUID) // Accept a request

FriendsAPI.denyFriendRequest(receiverUUID, senderUUID) // Deny a request

Messaging & Mail:

Code (Text):

FriendsAPI.sendMessage(senderUUID, receiverUUID, message) // Send a direct message

FriendsAPI.getPlayerMail(playerUUID) // Get player's mail

FriendsAPI.sendMail(senderUUID, receiverUUID, content) // Send mail

Party System:

Code (Text):

FriendsAPI.createParty(leaderUUID) // Create a new party

FriendsAPI.disbandParty(partyId) // Disband an existing party

FriendsAPI.invitePlayerToParty(partyId, playerId) // Invite a player

FriendsAPI.getPlayerParty(playerId) // Get a player's current party

FriendsAPI.getPartyEffects(partyId) // Get active effects for a party

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 487

First Release: Mar 15, 2025

Last Update: Nov 30, 2025

Category: ---------------

All-Time Rating:

4 ratings

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings