Friend

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.

## Features

• Friend System – Add friends, best friends, favorites, groups, notes, and nicknames.
• Friend Chat – `/fc` channel to broadcast to all online friends at once.
• 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. Can be disabled server-wide.
• Party System – Create parties, invite friends, and manage groups.
• Party Effects – Party members get potion effects with proximity-based activation.
• Party Waypoints – Action-bar arrow pointing at the nearest member or a specific locked target.
• Last-Seen Lookup – `/friend seen ` checks when any player was last online.
• Leaderboards – Rankings for most friends, gifts sent, and messages.
• Statistics – Track your social stats and see your rankings.
• GUIs – Clean inventory menus with custom model data support for resource packs.
• Cross-Server – Full BungeeCord and Velocity support in a single jar.
• Folia Support – Works on Folia's region-threaded scheduler out of the box.
• PlaceholderAPI – 25+ placeholders for scoreboards and more.
• WorldGuard – Friend groups can auto-share your WG region access.
• GriefPrevention – Party members auto-trusted in leader's claims.
• Database – MySQL and SQLite with auto-migration.
• Developer API – Full API for integration.

## Commands

• `/friend add ` – Send a friend request.
• `/friend remove ` – Remove a friend.
• `/friend accept ` – Accept a request.
• `/friend deny ` – Deny a request.
• `/friend list` – View your friends.
• `/friend requests` – View pending requests.
• `/friend best ` – Toggle best friend status.
• `/friend fav ` – Toggle favorite status.
• `/friend nick ` – Set a nickname for a friend.
• `/friend note ` – Add a note about a friend.
• `/friend group create/delete/set/list` – Manage friend groups.
• `/friend tp ` – Teleport to a friend.
• `/friend jump ` – Jump to a friend's server.
• `/friend info ` – View friend details.
• `/friend seen ` – Last-seen lookup for any player.
• `/friend block/unblock ` – Block or unblock a player.
• `/friend chat ` – Toggle friend chat mode or send a one-shot message.
• `/friend compass` – Toggle the party compass.
• `/friend waypoint ` – Lock the compass on a specific member.
• `/friend emote ` – Send a particle emote.
• `/friend status ` – Set your status message.
• `/friend menu` – Open the friends menu.

### Messaging & Mail

• `/msg ` – Send a private message.
• `/reply ` – Reply to the last message.
• `/mail read ` – Read your mail.
• `/mail send ` – Send mail.
• `/mail delete ` – Delete mail.
• `/fc ` – Friend chat channel.

• `/party create` – Create a party.
• `/party invite ` – Invite a player.
• `/party accept/deny ` – Handle invitations.
• `/party leave` – Leave your party.
• `/party kick ` – Kick a player.
• `/party info` – View party info.
• `/party disband` – Disband your party.
• `/party transfer ` – Transfer leadership.
• `/party effects` – View active effects.
• `/party shop` – Purchase party effect upgrades (requires Vault).
• `/party chat ` – Toggle party chat mode or send a one-shot message.
• `/pc ` – Party chat shortcut.

• `/gift ` – Send the held item to a friend.
• `/gift pending` – View pending gifts.
• `/gift accept ` – Accept a gift.
• `/gift deny ` – Deny a gift.

### Menus & Admin

• `/settings` – Open notification settings menu.
• `/stats` – View your social statistics.
• `/leaderboard` – View friend leaderboards.
• `/freload` – Reload the plugin configuration.
• `/fupdate` – Check for plugin updates.

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.

## Permissions

| Permission | Default | Description | |---|---|---| | `friends.use` | true | Basic friend commands | | `friends.mail` | true | Mail system access | | `friends.party` | true | Party system access | | `friends.party.effects` | true | Party effects access | | `friends.chat` | true | Friend chat channel access | | `friends.teleport` | true | Teleport to friends | | `friends.jump` | true | Jump to a friend's server | | `friends.network` | true | Cross-server features |