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

Navigation

Generate Code: All packets
Packets

File Transfer Protocol Version 1


Battle.net's file transfer protocol (often abbreviated BNFTP or BNFTPv1) is fairly simple. The protocol itself has no headers, and consists of 2 packets - the request, and the response.

The request is sent to Battle.net after connecting and requesting protocol BNFTP (0x02):

(WORD) Request length
(WORD) Protocol Version
(DWORD) Platform ID
(DWORD) Product ID
(DWORD) Banner ID*
(DWORD) Banner File Extension*
(DWORD) Start position in file (for resuming)
(FILETIME) Filetime of local file
(STRING) Filename

Battle.net should respond with the following BNFTP message, which is likely to be split across several TCP packets:

(WORD) Header length - Does not include the length of the file.
(WORD) Unknown (probably padding)
(DWORD) Filesize
(DWORD) Banners ID*
(DWORD) Banners File Extension*
(FILETIME) Remote Filetime
(STRING) Filename
(VOID) File data

After receiving the complete file data (determined by the filesize), the client terminates the connection.

The starred fields (*) are only required when downloading an ad banner. In other cases, they should be set to 0.
Version 1 of BNFTP actually has a version of 0x100 (256).

User Comments


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

Jailout2000
Jul 08, 2010
03:03 AM

Why would the unknown be padding and not part of the header length making it a DWORD? It makes no sense for it to be padding if this is a header.

Jailout2000
Oct 02, 2011
07:26 PM

Why would the protocol version be 0x100 (256)? They probably are using big endian instead of little endian, and the version is probably 0x01 (1).
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.