BNCSUtil

Preface

BNCSUtil is the Battle.Net Chat Service Utility which aids applications trying to logon to Classic Battle.net™ using the binary protocol. Specifically, BNCSUtil has functions that help with the cryptography of game versions, keys, and passwords.

BNCSUtil was originally written by Eric Naeseth (shadypalm88) and has since been maintained over the course of several years by the open source Battle.net community.

Usage

Add bncsutil.h to your include directory and link against bncsutil.lib or libbncsutil.so.

Building

CMake is used to generate platform specific build files. The only external dependency is GMP (The GNU Multiple Precision Arithmetic Library ). It can be installed with a package manager from any major Linux distro. Debian example: sudo apt-get install libgmp10. To force a specific build (32bit or 64bit) build add -DBUILD_32 or -DBUILD_64 to CMake flags.

Windows

GMP

If you are using an older toolchain like VS 2005 or 2008, the GMP lib and header file are already included for you in depends/include and depends/lib. You can skip this step. For newer versions of Visual Studio we recommend to use MPIR library instead which is a drop-in replacement for GMP with better Windows support.

Go to http://mpir.org/ and download the latest source archive.
Open the VS solution file depending on which version you use, for example build.vc14 for VS 2015.
Make a Release build of lib_mpir_gc project. This produces mpir.lib and mpir.h in build.vc14\lib_mpir_gc\Win32\Release. Copy the header file to depends/include and library to depends/lib.

VS build

In root bncsutil folder run cmake -G "Visual Studio 14 2015" -B./build -H./ if you used GMP or cmake -G "Visual Studio 14 2015" -B./build -H./ -DUSE_MPIR=1 if you used MPIR in previous step. Change the Visual Studio version as needed.
CMake will generate sln file in ./build. Open it and build the library.

Linux

Install GMP with the package manager. Also install all the necessary development tools (gcc, make or build-essential package on Debian).
Run cmake -G "Unix Makefiles" -B./build -H./.
cd build && make && make install.

Building .deb and .rpm packages

After invoking cmake, cd to build folder and generate them with cpack -G "DEB" and cpack -G "RPM". You can then use gdebi to do a local install of .deb with automatic dependency resolution or yum localinstall on rpm distros. For dnf it's just dnf install <name>.rpm.

Hosted Linux repositories

DEB and RPM repositories are maintained with best effort.

Debian (amd64)

To /etc/apt/sources.list add:

#apt.xpam.pl
deb http://apt.xpam.pl/ jessie main

Add GPG key: wget -qO - http://apt.xpam.pl/xpam.pl-pubkey.asc | sudo apt-key add -
Update and install: sudo apt-get update && sudo apt-get install bncsutil

Fedora/CentOS (amd64)

In /etc/yum.repos.d/rpm.xpam.pl.repo add

[rpm.xpam.pl]
name = rpm.xpam.pl
baseurl = https://rpm.xpam.pl

or, with dnf on Fedora: dnf config-manager --add-repo https://rpm.xpam.pl 2. If using dnf, make sure to import the public key: rpm --import https://rpm.xpam.pl/stormlib-pubkey.asc 3. Update and install: yum update && yum install stormlib or dnf equivalent.

Fedora/CentOS (i686)

sudo dnf install bncsutil.i686

cen1/bncsutil