Social Features

​

Overview

​

Friend System

​

Adding Friends

1. Right-click another player
2. Select “Add Friend”
3. Friend request sent to target player
4. Target accepts or declines request
5. If accepted, both players added to each other’s friend lists

​

Friend List

• Friend’s name
• Online/offline status (real-time)
• Combat level
• Current activity (if online)

​

Managing Friends

​

Online Status

• Green dot: Friend is online
• Gray dot: Friend is offline
• Notification: “Friend [Name] has logged in”

​

Private Messaging

​

Sending Messages

1. Open friend list
2. Click friend’s name
3. Type message in chat input
4. Message appears in private chat tab

​

Message Features

• Direct messages: Only visible to sender and recipient
• Message history: Conversation history per friend
• Notifications: Alert when new message received
• Offline messages: Messages delivered when friend logs in

​

Chat Integration

• Purple color for private messages
• “From [Friend]:” or “To [Friend]:” prefix
• Separate from public chat
• Persistent message history

​

Ignore List

​

Blocking Players

1. Right-click player
2. Select “Ignore”
3. Player added to ignore list
4. Blocked player can’t:
   • Send you private messages
   • Send you trade requests
   • Send you friend requests

​

Managing Ignore List

​

Ignore Behavior

• Their messages don’t appear in your chat
• Their trade requests are auto-declined
• Their friend requests are auto-declined
• They don’t know they’re ignored (OSRS-style)

​

Database Schema

​

Tables

CREATE TABLE friendships (
  id SERIAL PRIMARY KEY,
  player_id VARCHAR(255) NOT NULL,
  friend_id VARCHAR(255) NOT NULL,
  created_at TIMESTAMP DEFAULT NOW(),
  UNIQUE(player_id, friend_id)
);

CREATE TABLE friend_requests (
  id SERIAL PRIMARY KEY,
  from_player_id VARCHAR(255) NOT NULL,
  to_player_id VARCHAR(255) NOT NULL,
  status VARCHAR(50) DEFAULT 'pending',
  created_at TIMESTAMP DEFAULT NOW(),
  UNIQUE(from_player_id, to_player_id)
);

CREATE TABLE ignore_list (
  id SERIAL PRIMARY KEY,
  player_id VARCHAR(255) NOT NULL,
  ignored_player_id VARCHAR(255) NOT NULL,
  created_at TIMESTAMP DEFAULT NOW(),
  UNIQUE(player_id, ignored_player_id)
);

​

Network Packets

​

Client → Server

​

Server → Client

​

Implementation

​

SocialSystem

class SocialSystem extends SystemBase {
  private friendList: Map<string, Friend>;
  private ignoreList: Set<string>;
  private pendingRequests: Map<string, FriendRequest>;
  
  // Add friend request
  sendFriendRequest(targetPlayerId: string): void;
  
  // Accept/decline request
  respondToFriendRequest(requestId: string, accept: boolean): void;
  
  // Remove friend
  removeFriend(friendId: string): void;
  
  // Send private message
  sendPrivateMessage(recipientId: string, message: string): void;
  
  // Ignore player
  addToIgnoreList(playerId: string): void;
  removeFromIgnoreList(playerId: string): void;
}

​

Server-Side Handlers

// Handle friend request
export function handleFriendRequest(
  socket: ServerSocket,
  data: { targetPlayerId: string },
  world: World,
  db: DatabaseConnection
): Promise<void>;

// Handle friend request response
export function handleFriendRequestRespond(
  socket: ServerSocket,
  data: { requestId: string, accept: boolean },
  world: World,
  db: DatabaseConnection
): Promise<void>;

// Handle friend removal
export function handleFriendRemove(
  socket: ServerSocket,
  data: { friendId: string },
  world: World,
  db: DatabaseConnection
): Promise<void>;

// Handle private message
export function handlePrivateMessage(
  socket: ServerSocket,
  data: { recipientId: string, message: string },
  world: World
): void;

​

Friend List Synchronization

1. Server loads friend list from database
2. Server checks online status of each friend
3. Server sends friendListSync packet with full list
4. Server notifies online friends that player logged in

1. Server broadcasts friendOffline to all online friends
2. Friend list persists in database

​

UI Components

​

FriendsPanel

• Friend list: Scrollable list of friends with online status
• Add friend button: Opens player search
• Private message: Click friend to open chat
• Remove friend: Right-click menu option
• Ignore list tab: View and manage ignored players

​

Chat Integration

• Private tab: Dedicated tab for private messages
• Color coding: Purple for private messages
• Notifications: Badge count for unread messages
• History: Persistent conversation history

​

Security & Privacy

​

Rate Limiting

• Friend requests: 5 per minute
• Private messages: 10 per minute
• Prevents spam and abuse

​

Validation

• Player existence: Target player must exist and be online
• Duplicate prevention: Can’t send multiple requests to same player
• Self-requests: Can’t friend yourself
• Ignore check: Ignored players can’t send requests

​

Privacy

• Ignore is private: Ignored players don’t know they’re ignored
• Online status: Only visible to friends
• Message privacy: Private messages not logged or visible to others

​

Common Issues

​

Friend Request Not Received

• Target player is offline
• You’re on their ignore list
• Request already pending

​

Can’t Send Private Message

• Player is not on your friend list
• Player is offline
• You’re on their ignore list

​

Friend Shows Offline But Is Online

​

Future Enhancements

• Clan system: Player-created groups
• Group chat: Multi-player chat rooms
• Friend notes: Add notes to friends
• Last seen: Show when offline friend was last online
• Activity status: Show what friend is doing (skilling, combat, etc.)

​

Related Documentation