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, with full Folia support.<\/p>\n
## Features<\/p>\n
– **Friend System** \u2013 Add friends, best friends, favorites, groups, notes, and nicknames. ## Commands<\/p>\n ### Friend<\/p>\n – `\/friend add ### Messaging & Mail<\/p>\n – `\/msg ### Party<\/p>\n – `\/party create` \u2013 Create a party. ### Gifts<\/p>\n – `\/gift ### Menus & Admin<\/p>\n – `\/settings` \u2013 Open notification settings menu. All primary commands also accept f-prefixed aliases (`\/fmsg`, `\/freply`, `\/fmail`, `\/fparty`, `\/fgift`, `\/fstats`, `\/fsettings`, `\/fleaderboard`) for servers with naming conflicts. On startup, the plugin warns if another plugin owns any primary name.<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | ## PlaceholderAPI<\/p>\n – `%friends_count%` \u2013 Total friends ## Multi-Server Setup (BungeeCord \/ Velocity)<\/p>\n Only one jar is shipped: `Friends.jar`. It goes on every backend Spigot\/Paper\/Folia server. Nothing on the proxy.<\/p>\n **1. Install the plugin**<\/p>\n Drop `Friends.jar` into `\/plugins\/` on every backend server in your network.<\/p>\n **2. Set up MySQL**<\/p>\n All servers share the same database. Open `database.yml` on each server and set:<\/p>\n “`yaml Make sure the `friends` database exists. Tables are created on first boot.<\/p>\n **3. Configure each server**<\/p>\n In `config.yml` set a unique name and enable networking:<\/p>\n “`yaml network: Use a unique `server-name` per backend (e.g. `survival`, `skyblock`, `lobby`).<\/p>\n **4. Enable proxy mode on each backend**<\/p>\n BungeeCord (`spigot.yml`):<\/p>\n “`yaml Velocity (`paper-global.yml`):<\/p>\n “`yaml **5. Restart every backend.** Friend requests, messages, mail, and party invites sync across the network.<\/p>\n ### Quick Checklist<\/p>\n – [x] Friends.jar on every backend server ### Troubleshooting<\/p>\n – **Friends not syncing?** Check every server points to the same MySQL database. ## Config<\/p>\n “`yaml settings: party: integrations: network: mail: gifts: emotes: debug: false ## API Usage<\/p>\n **Friend Management**<\/p>\n “`java **Friend Requests**<\/p>\n “`java **Messaging & Mail**<\/p>\n “`java **Party System**<\/p>\n “`java **Settings & Stats**<\/p>\n “`java ## Optional Dependencies<\/p>\n – **PlaceholderAPI** \u2013 For placeholders 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.<\/p>\n","protected":false},"featured_media":73324,"template":"","meta":{"_minecraft_slug":"friend","_minecraft_project_id":"ET0Xxjwd","_minecraft_author":"TheeCobra","_minecraft_license":"MIT","_minecraft_downloads":21,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"friend.zip","_minecraft_size_bytes":11604473,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:06:51.738202Z","_minecraft_date_created":"2026-04-30T20:25:00.411418Z","_minecraft_date_modified":"2026-05-12T06:40:03.342246Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/friend","_minecraft_icon_attachment_id":73324,"_minecraft_imported_at":"2026-06-04T06:30:32+00:00","_minecraft_import_hash":"5d47db433b1602753c81ac8dd3ccfec4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,127,129],"mod_loader":[130,895,131,132,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-73323","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– **Friend Chat** \u2013 `\/fc` channel to broadcast to all online friends at once.
\n– **Gift System** \u2013 Send items to friends with anti-abuse protection (cooldowns, daily limits, blacklist).
\n– **Private Messaging** \u2013 Direct messages with reply functionality and sound notifications.
\n– **Mail System** \u2013 Send offline messages to players who aren’t online. Can be disabled server-wide.
\n– **Party System** \u2013 Create parties, invite friends, and manage groups.
\n– **Party Effects** \u2013 Party members get potion effects with proximity-based activation.
\n– **Party Waypoints** \u2013 Action-bar arrow pointing at the nearest member or a specific locked target.
\n– **Last-Seen Lookup** \u2013 `\/friend seen
\n– **Leaderboards** \u2013 Rankings for most friends, gifts sent, and messages.
\n– **Statistics** \u2013 Track your social stats and see your rankings.
\n– **GUIs** \u2013 Clean inventory menus with custom model data support for resource packs.
\n– **Cross-Server** \u2013 Full BungeeCord and Velocity support in a single jar.
\n– **Folia Support** \u2013 Works on Folia’s region-threaded scheduler out of the box.
\n– **PlaceholderAPI** \u2013 25+ placeholders for scoreboards and more.
\n– **WorldGuard** \u2013 Friend groups can auto-share your WG region access.
\n– **GriefPrevention** \u2013 Party members auto-trusted in leader’s claims.
\n– **Database** \u2013 MySQL and SQLite with auto-migration.
\n– **Developer API** \u2013 Full API for integration.<\/p>\n
\n– `\/friend remove
\n– `\/friend accept
\n– `\/friend deny
\n– `\/friend list` \u2013 View your friends.
\n– `\/friend requests` \u2013 View pending requests.
\n– `\/friend best
\n– `\/friend fav
\n– `\/friend nick
\n– `\/friend note
\n– `\/friend group create\/delete\/set\/list` \u2013 Manage friend groups.
\n– `\/friend tp
\n– `\/friend jump
\n– `\/friend info
\n– `\/friend seen
\n– `\/friend block\/unblock
\n– `\/friend chat [message]` \u2013 Toggle friend chat mode or send a one-shot message.
\n– `\/friend compass` \u2013 Toggle the party compass.
\n– `\/friend waypoint
\n– `\/friend emote
\n– `\/friend status
\n– `\/friend menu` \u2013 Open the friends menu.<\/p>\n
\n– `\/reply
\n– `\/mail read [page]` \u2013 Read your mail.
\n– `\/mail send
\n– `\/mail delete
\n– `\/fc [message]` \u2013 Friend chat channel.<\/p>\n
\n– `\/party invite
\n– `\/party accept\/deny
\n– `\/party leave` \u2013 Leave your party.
\n– `\/party kick
\n– `\/party info` \u2013 View party info.
\n– `\/party disband` \u2013 Disband your party.
\n– `\/party transfer
\n– `\/party effects` \u2013 View active effects.
\n– `\/party shop` \u2013 Purchase party effect upgrades (requires Vault).
\n– `\/party chat [message]` \u2013 Toggle party chat mode or send a one-shot message.
\n– `\/pc [message]` \u2013 Party chat shortcut.<\/p>\n
\n– `\/gift pending` \u2013 View pending gifts.
\n– `\/gift accept
\n– `\/gift deny
\n– `\/stats` \u2013 View your social statistics.
\n– `\/leaderboard` \u2013 View friend leaderboards.
\n– `\/freload` \u2013 Reload the plugin configuration.
\n– `\/fupdate` \u2013 Check for plugin updates.<\/p>\n
\n|—|—|—|
\n| `friends.use` | true | Basic friend commands |
\n| `friends.mail` | true | Mail system access |
\n| `friends.party` | true | Party system access |
\n| `friends.party.effects` | true | Party effects access |
\n| `friends.chat` | true | Friend chat channel access |
\n| `friends.teleport` | true | Teleport to friends |
\n| `friends.jump` | true | Jump to a friend’s server |
\n| `friends.network` | true | Cross-server features |
\n| `friends.reload` | op | Reload command |
\n| `friends.admin` | op | All admin commands |<\/p>\n
\n– `%friends_online%` \u2013 Online friends
\n– `%friends_offline%` \u2013 Offline friends
\n– `%friends_best_friends%` \u2013 Best friends count
\n– `%friends_favorites%` \u2013 Favorite friends count
\n– `%friends_max%` \u2013 Max friends limit
\n– `%friends_requests%` \u2013 Pending friend requests
\n– `%friends_gifts_pending%` \u2013 Pending gifts
\n– `%friends_gifts_sent%` \u2013 Total gifts sent
\n– `%friends_gifts_received%` \u2013 Total gifts received
\n– `%friends_gifts_daily_remaining%` \u2013 Gifts you can still send today
\n– `%friends_gifts_cooldown%` \u2013 Gift cooldown remaining (seconds)
\n– `%friends_messages_sent%` \u2013 Messages sent
\n– `%friends_mail_total%` \u2013 Total mail
\n– `%friends_mail_unread%` \u2013 Unread mail
\n– `%friends_messaging_enabled%` \u2013 Private messages toggle
\n– `%friends_status%` \u2013 Your status message
\n– `%friends_in_party%` \u2013 In party (true\/false)
\n– `%friends_party_size%` \u2013 Party size
\n– `%friends_party_name%` \u2013 Party name
\n– `%friends_party_leader%` \u2013 Party leader name
\n– `%friends_is_party_leader%` \u2013 Are you party leader (true\/false)
\n– `%friends_rank_friends%` \u2013 Leaderboard rank (friends)
\n– `%friends_rank_gifts%` \u2013 Leaderboard rank (gifts)
\n– `%friends_rank_messages%` \u2013 Leaderboard rank (messages)<\/p>\n
\ndatabase:
\n type: mysql
\n host: your-database-ip
\n port: 3306
\n name: friends
\n username: your-user
\n password: your-password
\n pool:
\n max-connections: 10
\n timeout: 30000
\n keep-alive: true
\n“`<\/p>\n
\nserver-name: “lobby”<\/p>\n
\n enabled: true
\n channel: “friends:network”
\n“`<\/p>\n
\nsettings:
\n bungeecord: true
\n“`<\/p>\n
\nproxies:
\n velocity:
\n enabled: true
\n online-mode: true
\n secret: “your-velocity-secret”
\n“`<\/p>\n
\n– [x] MySQL database shared across all servers
\n– [x] Unique `server-name` on each server
\n– [x] `network.enabled: true` on each server
\n– [x] BungeeCord mode or Velocity forwarding enabled<\/p>\n
\n– **Cross-server messages not working?** `bungeecord: true` (BungeeCord) or Velocity forwarding must be enabled.
\n– **Players show wrong server?** Each server needs a unique `server-name` in config.yml.
\n– **Another plugin owns \/msg, \/party etc.?** Use the f-prefixed aliases (`\/fmsg`, `\/fparty`) or `\/friends:
\nserver-name: “lobby”<\/p>\n
\n max-friends: 0
\n best-friends:
\n max-limit: 5
\n enabled: true
\n friend-groups:
\n enabled: true
\n max-groups: 10
\n friend-teleport:
\n enabled: true
\n cooldown: 30
\n friend-jump:
\n enabled: true
\n cooldown: 10
\n private-messages:
\n friends-only: false
\n log-to-console: false
\n sounds: true
\n cross-server: true
\n allow-toggle: true<\/p>\n
\n max-size: 8
\n allow-public-parties: true
\n effects:
\n enabled: true
\n proximity-required: true
\n proximity-range: 50
\n scaling-strength: true
\n scale-percentage: 10
\n update-interval: 100
\n compass:
\n enabled: true
\n update-interval: 20
\n shop:
\n enabled: true
\n leader-only: true
\n reset-on-disband: true<\/p>\n
\n grief-prevention:
\n enabled: true
\n shared-building: true
\n shared-containers: true
\n shared-interactions: true
\n shared-entities: true
\n luck-perms:
\n enabled: true
\n worldguard:
\n enabled: false
\n shared-groups:
\n – trusted
\n – build<\/p>\n
\n enabled: true
\n channel: “friends:network”<\/p>\n
\n enabled: true
\n auto-cleanup:
\n enabled: true
\n days-old: 30<\/p>\n
\n enabled: true
\n cooldown: 60
\n max-daily: 10
\n max-stack-size: 64
\n expiry-days: 7
\n blacklist:
\n – BEDROCK
\n – BARRIER
\n – COMMAND_BLOCK<\/p>\n
\n enabled: true
\n cooldown: 5
\n range: 10<\/p>\n
\n“`<\/p>\n
\nFriendsAPI.getFriends(playerUUID); \/\/ Get a player’s friends list
\nFriendsAPI.getOnlineFriends(playerUUID); \/\/ Get only online friends
\nFriendsAPI.areFriends(playerUUID, otherUUID); \/\/ Check friendship status
\nFriendsAPI.addFriend(playerUUID, friendUUID); \/\/ Add a friend directly
\nFriendsAPI.removeFriend(playerUUID, friendUUID); \/\/ Remove a friend
\n“`<\/p>\n
\nFriendsAPI.sendFriendRequest(senderUUID, receiverUUID);
\nFriendsAPI.getPendingRequests(playerUUID);
\nFriendsAPI.acceptFriendRequest(receiverUUID, senderUUID);
\nFriendsAPI.denyFriendRequest(receiverUUID, senderUUID);
\n“`<\/p>\n
\nFriendsAPI.sendMessage(senderUUID, receiverUUID, message);
\nFriendsAPI.getPlayerMail(playerUUID);
\nFriendsAPI.sendMail(senderUUID, receiverUUID, content);
\n“`<\/p>\n
\nFriendsAPI.createParty(leaderUUID);
\nFriendsAPI.disbandParty(partyId);
\nFriendsAPI.invitePlayerToParty(partyId, playerId);
\nFriendsAPI.getPlayerParty(playerId);
\nFriendsAPI.getPartyEffects(partyId);
\nFriendsAPI.sendPartyMessage(player, message);
\nFriendsAPI.isPartyChatEnabled(playerUUID);
\n“`<\/p>\n
\nFriendsAPI.getPlayerSettings(playerUUID);
\nFriendsAPI.getPlayerStats(playerUUID);
\nFriendsAPI.getLeaderboard(type, limit);
\n“`<\/p>\n
\n– **LuckPerms** \u2013 For permission integration
\n– **GriefPrevention** \u2013 For claim trust integration
\n– **WorldGuard** \u2013 For region sharing by friend group
\n– **Vault** \u2013 For the party effects shop
\n– **ProtocolLib** \u2013 For enhanced features<\/p>\n","protected":false},"excerpt":{"rendered":"