SID_FRIENDSLIST
| Protocol | BNCS |
|---|---|
| Directions | Client → Server and Server → Client |
| Used by |
Asks for the player's friends list, with where each friend is.
Client → Server
No payload. Warcraft III asks right after logging on.
No payload: the message is only its 4-byte header.
Server → Client
| Type | Field | Notes | Confidence |
|---|---|---|---|
UINT8 |
Number of friends | ✅ Verified | |
| For each friend | |||
STRING |
Account name | ⚠️ Single source | |
UINT8 |
Status | Flags: 0x01 mutual, 0x02 do not disturb, 0x04 away. |
⚠️ Single source |
UINT8 |
Location | 0x00 offline, 0x01 not in chat, 0x02 in chat, 0x03 public game, 0x04 private game, 0x05 private game with a mutual friend. |
⚠️ Single source |
DWORD |
Product code | The friend's game, sent backwards (W3XP is PX3W). 0 when offline. |
⚠️ Single source |
STRING |
Location name | The channel or game, when relevant. | ⚠️ Single source |
Remarks
A reply with zero friends, a single 00 byte, lets the client's friends panel finish loading. Diablo II doesn't receive friend updates automatically, so it asks again from time to time.
Appears in
Sources and credits
- Command Center: WARCRAFT3.md
- BNETDocs, SID_FRIENDSLIST (client to server): documented by the original BNETDocs contributors.
- BNETDocs, SID_FRIENDSLIST (server to client): documented by LordVader, and edited 3 times since.
This page is written in our own words. BNETDocs is credited for its research; none of its text is copied. See Credits.