Friends
Build a friends list, get join/quit alerts, swap private messages, and never lose track of your crew.
The Friends system is Imperium's lightweight social backbone. Add the players you mine with, keep a persistent friends list, get notified the moment one of them joins or leaves the server, and swap private messages without cluttering public chat. Friends are mutual — both sides have to agree — and your list is saved to the database, so it follows you across logins.
How Friendships Work
Friendships are bidirectional. Sending a request creates a pending entry in the friend_requests table; when the recipient accepts, both players are written to the player_friends table as a pair of mirrored rows (you → them and them → you). When you remove a friend, both rows are deleted, so the link is severed on both sides at once. There is no such thing as a one-sided friend.
Your friends list and any pending requests are loaded into a per-player cache the moment you join, so friend lookups during chat and mining are instant rather than a database hit each time. When you log out, the cache is cleared and rehydrated on your next login.
Sending and Accepting Requests
- Type
/friend add <player>to send a request. - If you already sent one, you'll see Already Requested — no duplicate is created.
- The target gets an in-chat notice with a ready-to-click
/friend accepthint. - They run
/friend accept <your name>to seal the friendship, or/friend decline <your name>to turn it down. - Once accepted, both of you are notified and the friendship is permanent until one of you removes it.
You can send requests to offline players too — the system falls back to the offline player cache, so a friend who hasn't logged in for weeks can still be added. They'll see the request the next time they join (use /friend requests to check).
Request Results
Every friend action returns one of a small set of statuses so you always know what happened:
| Result | What it means |
|---|---|
| Request Sent | A brand-new request was created and the target was notified. |
| Already Friends | You and the target are already on each other's lists. |
| Already Requested | You have a pending request to that player — no duplicate sent. |
| Self | You can't friend yourself. |
| Accepted | The request was accepted; you are now mutual friends. |
| No Request | There is no pending request from that player to accept or decline. |
| Removed | The player was taken off your friends list (and you off theirs). |
| Not Friends | You tried to remove someone who isn't on your list. |
Your Friends List
/friend list shows every friend you have, grouped into two buckets:
- Online — friends currently logged in, listed by name and count.
- Offline — friends who are not currently online, dimmed for clarity.
The total count appears in the header (Friends (12)), so you can see at a glance how big your network is. If your list is empty, the command suggests /friend add <player> to get started.
Join and Quit Notifications
Whenever a friend joins or leaves the server, every one of their friends who is online gets a short notification in chat:
- Join: "Your friend <name> just joined!"
- Quit: "Your friend <name> just left."
These alerts fire only for mutual friends and only to players who are online at the moment — they are not queued for later. It's a great way to notice when your mining crew logs on so you can coordinate a cell visit, a legion push, or a trip to the PVP Mine.
Notifications are sent at MONITOR event priority, which runs after your friends list has been loaded on join — so the very first join alert for a returning friend is reliable and never races the cache.
Friend Chat
Use /friend msg <player> <message> to send a private message to an online friend. The message is formatted as a two-way whisper so both sides see who said what:
- To you:
[You → FriendName] your message - To them:
[YourName → You] your message
Friend messages are friends-only — you can't whisper a stranger, and the target must be online. Messages are sanitized of formatting codes before they're sent, so no one can inject colors or fake server messages. For longer offline correspondence, use the /mail system instead.
Removing a Friend
Run /friend remove <player> (aliases unfriend, del) to sever the link. The removal is bilateral — the other player is notified that you removed them, and they are removed from your list too. There is no confirmation prompt, so be sure before you hit enter; you can always re-add them with another request.
Command Reference
| Command | What it does |
|---|---|
/friend add <player> | Send a friend request to a player (online or offline). |
/friend accept <player> | Accept a pending friend request from that player. |
/friend decline <player> | Decline a pending friend request from that player. |
/friend remove <player> | Unfriend a player (aliases: unfriend, del). |
/friend list | Show all your friends, split into online and offline groups. |
/friend requests | List your pending incoming friend requests (alias: pending). |
/friend msg <player> <message> | Send a private message to an online friend (aliases: message, whisper). |
/friend help | Show the friend command reference in-game. |
The base command has aliases /f and /friends, and every subcommand tab-completes player names from the online list for fast typing.
Tips
- Add your legion-mates. Join/quit pings make it trivial to spot when your legion is online for a boost push or outpost capture.
- Check pending requests on login. A request you missed while offline is waiting in
/friend requests. - Use friend msg for trade talk. It keeps public chat clean and avoids advertising a sale to the whole server.
- Offline adds work. Don't wait for someone to be online — send the request and they'll see it next time.
- Re-adding is fine. Removed a friend by accident? Just send another request — there's no cooldown.
Friends are the social glue of Imperium. A populated friends list means you always have a crew for the PVP Mine, a partner for trading, and someone to ask when you forget a command — build yours early.