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.
/party chat – Toggle party chat mode.
/party gui – Open party management menu.

/gift <player> – Send an item to a friend.
/gift pending – View pending gifts.
/gift accept <id> – Accept a gift.
/gift deny <id> – Deny a gift.

/settings – Open notification settings menu.
/stats – View your social statistics.
/leaderboard – View friend leaderboards.

/friendsadmin reload – Reload the plugin.
/friendsadmin reset <player> – Reset a player's data.
/friendsadmin purge – Purge inactive data.

Permissions:

friends.use – Basic friend commands.
friends.mail – Mail system access.
friends.message – Messaging access.
friends.gift – Gift system access.
friends.party – Party system access.
friends.party.effects – Party effects access.
friends.party.chat – Party chat access.
friends.teleport – Teleport to friends.
friends.jump – Jump to friend's server.
friends.settings – Access settings menu.
friends.stats – View statistics.
friends.leaderboard – View leaderboards.
friends.msg.bypass – Message non-friends.
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_party_leader% - Party leader name
%friends_party_chat% - Party chat enabled (true/false)
%friends_mail_unread% - Unread mail
%friends_favorites% - Favorite friends count

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
chat:
enabled : true
format : "&d[Party] &f%player%: &7%message%"
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:
type : sqlite
mysql:
host : localhost
port : 3306
database : friends
username : root
password : ""
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

FriendsAPI.sendPartyMessage(player, message) // Send party chat message

FriendsAPI.isPartyChatEnabled(playerUUID) // Check party chat toggle

Settings & Stats:

Code (Text):

FriendsAPI.getPlayerSettings(playerUUID) // Get player settings

FriendsAPI.getPlayerStats(playerUUID) // Get player statistics

FriendsAPI.getLeaderboard(type, limit) // Get leaderboard data

Optional Dependencies:

PlaceholderAPI – For placeholders
LuckPerms – For permission integration
GriefPrevention – For claim trust integration
WorldGuard – For region integration
ProtocolLib – For enhanced features

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 671

First Release: Mar 15, 2025

Last Update: Yesterday at 11:49 PM

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

All-Time Rating:

6 ratings

Version -----

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

Downloads: ------

Version Rating:

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

-- ratings