Add FriendScape

[Ugikie]

FriendScape overhauls the existing friends and messaging system in-game. It adds a side panel showing which of your friends are online, what world they're on and roughly where they are, plus a separate chat window with a tab per conversation. You can message friends while they're offline, keep your own chat history, make group chats, and view a friend's stats. There's a one-click importer for your in-game friends list so you don't have to re-add everyone by hand.

It talks to a small WebSocket relay so presence and messaging work across clients. I run that server myself and it's the only thing the plugin connects to.

Data and privacy

• The plugin only ever sends the player's own data. It never reads or forwards other players' info, so nobody who isn't running the plugin gets crowdsourced.
• What goes to the server is spelled out in the README and disclosed to users: RSN plus an auth token, world, approximate region (an area name, never exact coordinates), combat/total level, friend and ignore lists, and messages sent to other plugin users.
• The server only stores roster, block lists, privacy settings, last-seen time, and undelivered offline messages. Offline messages are deleted on delivery and expire after 7 days. Delivered message bodies are not kept.
• Chat history is written to a local file under ~/.runelite/friendscape and never leaves the user's machine.
• Privacy is user-controlled: who sees you online (everyone, mutual friends, or nobody), whether you share world, location, levels, or your stats window, and who can message you (all of this is configurable). Appear-offline is genuinely unobservable, so to everyone else you look exactly like you logged out.

Chat never touches the game

Worth calling out for the automation rules: the chat feature is plugin-to-plugin only. It never types into the in-game chatbox and never sends anything into the game on the player's behalf. All messaging goes over the relay between plugin users inside of external, custom-built UIs.

Other notes

• The server URL is baked in. Players can't repoint it, and there's no player-facing server setting (there's a developer-mode-only override I use for local testing).
• The stats window rendering is adapted from Party Panel by TheStonedTurtle (BSD-2) and credited in the README.
• Versioning is handled by release-please, starting at 0.1.0 while it's in beta.
• There are unit tests on both the plugin and the server side.

Happy to answer questions or make changes. Thanks for taking a look! I'm actually really excited for this and think it will really change the game for pming friends in-game (something I do all the time, often juggling multiple convos and sending a good few 'wc's a day haha)

[runelite-github-app]

New plugin friendscape: https://github.com/Ugikie/friendscape/tree/32a12b6f3d949e762c3d5a7d496b4a6feec5f703

[runelite-github-app]

This plugin requires a review from a Plugin Hub maintainer. The reviewer will request any additional changes if needed.

---

Internal use only: Reviewer details Maintainer details