Skip to content

Latest commit

 

History

History
35 lines (26 loc) · 2.89 KB

README.md

File metadata and controls

35 lines (26 loc) · 2.89 KB

JBLS

Java Battle.net Logon Server- Java implementation of ValhallaLegends' BNLS protocol for interacting with Classic Battle.net servers. Originally authored by Hdx, this project is now maintained by the community.

JBLS - Java Battle.net Logon Server

Java Battle.net Logon Server is a Java emulation of a BNLS server, which assists bots with connecting to the Classic Battle.net servers (used by games such as Diablo 2). Its primary function is to store the most recent versions of supported game files and to run checksum algorithms over these files as needed by bots during the client verification step of the login process. It also has functions for product key decoding and account password hashing, though the protocol for these are insecure and should not be used unless absolutely necessary.

This repository is a fork of the original JBLS code, hosted by Hdx. It includes fixes for some minor changes to Battle.net over the last several years, cosmetic improvements, and a few added convenience features.

An active copy of this software is run on two separate servers:

BNLS Protocol

For information on the BNLS protocol run on this server, refer to the BNLS Packet Guide.

Running a server

To run the server, use the command java -jar JBLS.jar. The server runs the BNLS protocol on port 9367 and an optional HTTP status page will be available on port 81. Both ports are configurable in the settings.ini file, which will be generated when you first run the server.

JBLS uses the following directory structure by default:

  • JBLS
    • \DLLs\
      • lockdown-IX86-XX.dll (where XX is numbers 00-19)
    • \IX86\
      • \D2DV\
      • \WAR3\
      • etc... (sub-folder for each product)
    • JBLS.jar
    • settings.ini

You only need files in the DLLs and IX86 directories if you intend to serve clients that require them. For example, if you only need to support D2DV then you only need the IX86\D2DV directory and its associated files. A list of required files for each product can be found on BNETDocs.

The required game files and libraries can be acquired from BNFTP and/or from official game installations.

Disclaimer

JBLS is offered as-is and without warranty, expressed or implied. JBLS is not sponsored by Blizzard Entertainment or its subsidiaries in absolutely any way. Battle.net™ is a registered trademark of Blizzard Entertainment in the United States and other countries.