BNETDocs: Redux is no longer updated, this subdomain exists for archival purposes only. Visit the main site.

Navigation

Generate Code: All packets
Packets

Packet Information


Message ID:0x65
  
Message Name:SID_FRIENDSLIST
  
Direction:Server -> Client (Received)
  
Used By:Starcraft Broodwar, Warcraft III: The Frozen Throne, Starcraft, Warcraft III
  
Format:(BYTE) Number of Entries
For each entry:
(STRING) Account
(BYTE) Location
(BYTE) Status
(DWORD) ProductID
(STRING) Location name
  
Remarks:This packet contains the current user's Friends List. If the friend is offline, their ProductID is 0. Location is only supplied when it is relevant - for example, if Status is set to offline (0x00), the location string will be empty.

Possible bitwise values for Status:
0x01: Mutual
0x02: DND
0x04: Away
Possible values for Location:
0x00: Offline
0x01: Not in chat
0x02: In chat
0x03: In a public game
0x04: In a private game, and you are not that person's friend.
0x05: In a private game, and you are that person's friend.

Whether you are a particular user's friend causes different behavior when receiving information about the type of game the user is in (this is true when receiving friend updates, too). When the Location field is 0x04, the user is in a password-protected game, and you are not on that user's friends list. When it is 0x05, the user is in a password-protected game, and you are on that user's friends list.

For example, let's say MyndFyre is logging on and Arta[vL] is on his friends list. Arta[vL] is also in a password-protected game. MyndFyre is not on Arta[vL]'s friends list. MyndFyre will receive location 0x04 for Arta[vL] and the Channel parameter will be a NULL string. And, if MyndFyre were to type in /f l, Battle.net would respond with SID_CHATEVENT saying "1. Arta[vL] is in a private game."

On the other hand, if Arta[vL] had listed MyndFyre as a friend, then on logon, MyndFyre will receive location 0x05 for Arta[vL] and the name of the password-protected game will come through the Channel parameter of the message. If MyndFyre were to type in /f l, Battle.net would respond with "1. Arta[vL] is in the private game vL."
  
Related:[0x0F] SID_CHATEVENT (S->C), [0x65] SID_FRIENDSLIST (C->S)

User Comments


For detailed questions and discussion, visit the Battle.net Research Forum

Heinermann
Sep 03, 2010
04:44 PM

Enum in wc3tft beta:

[Unknown] (couldn't find the values for these, but you can guess where they go anyway)
BNET_FRIEND_MUTUAL_FRIEND
BNET_FRIEND_DND
BNET_FRIEND_AFK
BNET_FRIEND_ONLINE

[Location]
0 BNET_FRIEND_OFFLINE
2 BNET_FRIEND_IN_CHANNEL
3 BNET_FRIEND_IN_PUBLIC_GAME
4 BNET_FRIEND_IN_PRIVATE_GAME
5 BNET_FRIEND_IN_PASSWORD_GAME


ALERT
We recommend you use Firefox to view this site. This site has been optimized for Firefox.

Get Firefox
BNLS Server Status
bnls.bnetdocs.org:
bnls.net:
bnls.mattkv.net:
phix.no-ip.org:
pyro.no-ip.biz:
bnls.war-lords.net:
bnls.anubisdev.net:
knight.mattkv.net:

= Online       = Offline

Battle.net Server Status

Battle.net v1

uswest.battle.net:
exodus.battle.net:
useast.battle.net:
asia.battle.net:
europe.battle.net:
ustest.battle.net:
beta.battle.net:
classicbeta.battle.net:
demo.war3.battle.net:

Battle.net v2

us.logon.battle.net:
eu.logon.battle.net:
kr.logon.battle.net:
cn.logon.battle.net:
us.patch.battle.net:
eu.patch.battle.net:
kr.patch.battle.net:
cn.patch.battle.net:
public-test.logon.battle.net:
public-test.patch.battle.net:

emNet

cali.emwar.com:
dallas.emwar.com:
kc.emwar.com:
ny.emwar.com:

PvPGN

server.eurobattle.net:
rubattle.net:
sc.theabyss.ru:
wc3.theabyss.ru:
bnetd.fishbattle.net:

RBNETD

server.bnetdocs.org:

= Online       = Offline



Copyrights

Site scripts and design copyrights reserved to Don Cullen.
Contents copyrighted to Blizzard and their parent corporation, Vivendi.
Main credits for contents goes to Arta. View the rest of credits.
Demented Minds copyrights reserved to Don Cullen 2003-present.
Copyright infringements will be prosecuted to the fullest extent allowable by law.
Please view our legal disclaimer and terms of service.