Friends is a social plugin that allows players to add friends, send messages, mail, and create parties on your server. The plugin features cross-server support via BungeeCord.
Features:
API Usage:
Friend Management:
Friend Requests:
Messaging & Mail:
Party System:
Features:
- Friend System – Add friends, manage requests, and view friend lists.
- Private Messaging – Send direct messages to other players with reply functionality and sound notifications.
- Mail System – Send offline messages to players who aren't currently online.
- Party System – Create parties, invite friends, and manage groups for activities.
- Party Effects – Party members receive potion effects with visual indicators and proximity-based activation.
- Cross-Server Support – Works across BungeeCord/Velocity networks with seamless integration.
- Database Support – Both MySQL and SQLite support for data storage.
- Developer API – API for developers to integrate with.
- /friend add <player> – Send a friend request.
- /friend remove <player> – Remove a friend.
- /friend accept <player> – Accept a friend request.
- /friend deny <player> – Deny a friend request.
- /friend list – View your friends list.
- /friend requests – View pending friend requests.
- /msg <player> <message> – Send a private message.
- /reply <message> – Reply to the last message.
- /mail read [page] [id] – Read your mail.
- /mail send <player> <message> – Send mail to a player.
- /mail delete <id/all> – Delete mail.
- /party create – Create a new party.
- /party invite <player> – Invite a player to your party.
- /party accept <player> – Accept a party invitation.
- /party deny <player> – Deny a party invitation.
- /party leave – Leave your current party.
- /party kick <player> – Kick a player from your party.
- /party info – View information about your party.
- /party disband – Disband your party.
- /party transfer <player> – Transfer party leadership.
- /party effects – View active party effects and benefits.
- friends.use – Access to friend commands.
- friends.mail – Access to mail system.
- friends.message – Access to messaging system.
- friends.party – Access to party system.
- friends.party.effects – Access to party effects system.
- friends.admin – Access to admin commands (includes all permissions).
Code (YAML):
# Friends Plugin Configuration
# General settings
settings :
# Maximum number of friends a player can have (0 for unlimited)
max-friends : 0
# Private messages settings
private-messages :
# Whether private messages can only be sent between friends
friends-only : false
# Whether to log private messages to console
log-to-console : false
# Whether to enable sound notifications for messages
sounds : true
# Whether to allow cross-server messaging
cross-server : true
# Whether to allow players to toggle private messages
allow-toggle : true
# Party settings
party :
# Maximum number of players in a party
max-size : 8
# Allow public parties that anyone can join without invitation
allow-public-parties : true
# Party effects system
effects :
# Enable party effects
enabled : true
# Require party members to be near each other for effects
proximity-required : true
# Maximum range for proximity detection (in blocks)
proximity-range : 50
# Effects become stronger based on party size (up to +3 levels)
scaling-strength : true
# Percentage scaling per party member (default 10%)
scale-percentage : 10
# Time between effect updates (in ticks, 20 ticks = 1 second)
update-interval : 100
# Party effect bonuses (effect name: amplifier level, starting at 0)
bonuses:
regeneration : 0
damage_resistance : 0
speed : 0
luck : 0
haste : 0
# Mail settings
mail :
# Maximum number of mails a player can have (0 for unlimited)
max-mail : 100
# Maximum length of a mail message
max-mail-length : 1000
# Network settings (for BungeeCord/proxy support)
network :
# Enable cross-server functionality
enabled : true
# Network channel name
channel : "friends:network"
# Storage settings
storage :
# Auto-purge old data
auto-purge:
enabled : false
# Purge interval in days
interval : 30
# Purge data older than X days
older-than : 60
# Debug mode - prints additional information to console
debug : false
# General settings
settings :
# Maximum number of friends a player can have (0 for unlimited)
max-friends : 0
# Private messages settings
private-messages :
# Whether private messages can only be sent between friends
friends-only : false
# Whether to log private messages to console
log-to-console : false
# Whether to enable sound notifications for messages
sounds : true
# Whether to allow cross-server messaging
cross-server : true
# Whether to allow players to toggle private messages
allow-toggle : true
# Party settings
party :
# Maximum number of players in a party
max-size : 8
# Allow public parties that anyone can join without invitation
allow-public-parties : true
# Party effects system
effects :
# Enable party effects
enabled : true
# Require party members to be near each other for effects
proximity-required : true
# Maximum range for proximity detection (in blocks)
proximity-range : 50
# Effects become stronger based on party size (up to +3 levels)
scaling-strength : true
# Percentage scaling per party member (default 10%)
scale-percentage : 10
# Time between effect updates (in ticks, 20 ticks = 1 second)
update-interval : 100
# Party effect bonuses (effect name: amplifier level, starting at 0)
bonuses:
regeneration : 0
damage_resistance : 0
speed : 0
luck : 0
haste : 0
# Mail settings
mail :
# Maximum number of mails a player can have (0 for unlimited)
max-mail : 100
# Maximum length of a mail message
max-mail-length : 1000
# Network settings (for BungeeCord/proxy support)
network :
# Enable cross-server functionality
enabled : true
# Network channel name
channel : "friends:network"
# Storage settings
storage :
# Auto-purge old data
auto-purge:
enabled : false
# Purge interval in days
interval : 30
# Purge data older than X days
older-than : 60
# Debug mode - prints additional information to console
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
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
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
FriendsAPI.getPendingRequests(playerUUID) // Get pending requests
FriendsAPI.acceptFriendRequest(receiverUUID, senderUUID) // Accept a request
FriendsAPI.denyFriendRequest(receiverUUID, senderUUID) // Deny a request
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
FriendsAPI.getPlayerMail(playerUUID) // Get player's mail
FriendsAPI.sendMail(senderUUID, receiverUUID, content) // Send mail
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.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
Resource Information
Author:
----------
Total Downloads:
76
First Release:
Mar 15, 2025
Last Update:
Mar 20, 2025
Category:
---------------
All-Time Rating:
1 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings