―――――――――――――――――――――――――――――――――――――――――――
✦ Overview
AdvancedFriends is a fully self-contained friends plugin — no dependencies required beyond the server itself. It ships with a friends system, a built-in party system, private messaging, teleportation requests, a paginated GUI, join/leave notifications, and PlaceholderAPI support, all configurable down to every message and sound.
―――――――――――――――――――――――――――――――――――――――――――
✦ Features
- Friends System — Send, accept and deny friend requests. Requests expire automatically after a configurable timeout. Set a per-server max friend limit or remove it entirely.
- Built-in Party System — No external party plugin needed. Create parties, invite players, kick members, transfer leadership and disband — all with /friend party.
- Party Chat — Send a one-off message with /friend party chat <msg>, or enable always-on mode with /friend party chat always so every message you type goes straight to the party. Disable with /friend party chat disable.
- Private Messaging — Message any online friend with /fmsg <player> <msg>. Only mutual friends can message each other.
- Teleport Requests — Send teleport requests to friends. Each player can toggle this on or off for themselves.
- Friends GUI — A paginated, skull-based inventory showing all your friends with online/offline status.
- Left-click → message hint
- Right-click → teleport request
- Middle-click → party invite
- Shift-click → remove friend
- Join / Leave Notifications — Friends are notified when you join or leave. Toggleable per player.
- Per-Player Toggles — Toggle friend requests, join messages, teleport requests and party invites independently.
- PlaceholderAPI Support — 6 ready-to-use placeholders. Soft-depend — works perfectly without it.
- SQLite Storage — Zero-config persistent storage. Driver is shaded into the jar — no external database needed.
- Fully Configurable — Every message, prefix, sound and colour editable in config.yml. Supports &codes, &#RRGGBB and <gradient:#start:#end>.
- Update Checker — Checks SpigotMC for new versions on startup and notifies online OPs.
―――――――――――――――――――――――――――――――――――――――――――
✦ Commands
Friends
— Aliases: /f, /friends
Code (Text):
/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 → List all friends
/friend requests → View pending requests
/friend gui → Open the friends GUI
/friend tp <player> → Send a teleport request
/friend toggle <setting> → Toggle a personal setting
/fmsg <player> <msg> → Private message a friend
/friend reload → Reload config (op)
Party
Code (Text):
/friend party create → Create a new party
/friend party invite <player> → Invite a player (auto-creates party)
/friend party accept → Accept a party invite
/friend party decline → Decline a party invite
/friend party kick <player> → Kick a member (leader only)
/friend party leave → Leave the party
/friend party disband → Disband the party (leader only)
/friend party list → List all members
/friend party chat <msg> → Send a party message
/friend party chat always → Route all chat to party
/friend party chat disable → Disable always-on mode
Toggle settings:
requests ·
joinmessages ·
teleport ·
party
―――――――――――――――――――――――――――――――――――――――――――
✦ PlaceholderAPI
Code (Text):
%advancedfriends_count% → Total friend count
%advancedfriends_online% → Online friends
%advancedfriends_offline% → Offline friends
%advancedfriends_max% → Max friend limit
%advancedfriends_requests% → Pending request count
%advancedfriends_isfriend_NAME% → true / false
―――――――――――――――――――――――――――――――――――――――――――
✦ Permissions
Code (Text):
advancedfriends.use (default: true) → Use the friends system
advancedfriends.reload (default: op) → Reload the config
―――――――――――――――――――――――――――――――――――――――――――
✦ Requirements
―――――――――――――――――――――――――――――――――――――――――――