dafzor / bnetlauncher

Launcher utility to help start battle.net games with the steam overlay.
http://madalien.com/stuff/bnetlauncher/
GNU General Public License v3.0
225 stars 24 forks source link
battle-net launcher launcher-utility steam steam-overlay utility

bnetlauncher

Launcher utility to help start battle.net games with the steam overlay.

Official page http://madalien.com/stuff/bnetlauncher/

❗❗ Project Status ❗❗

It's now been years since I last played a blizzard game so this project has been put into "maintenance" as I'm no longer a user of it.

Contributions are still accepted (new games, features, etc) but other then those no further developments will be made.

There still other launcher project in active development like Launchpad in case bnetlauncher no longer works for you.

Purpose

This application is intended to facilitate the launch of battle.net games from steam with overlay with minimal/no interaction with the battle.net client while still being automatically logged in.

Requirements

Howto Use

  1. Extract the included exe to any location you want (ex: steam folder)
  2. Add the exe to steam as a non-steam game shortcut
  3. On the shortcut properties add one of the following parameters:
code game
codbo4 Call of Duty: Black Ops 4
codbocw Call of Duty: Black Ops Cold War
codmw2019 Call of Duty: Modern Warfare (2019)
codmw2crm Call of Duty: Modern Warfare 2 Campaign Remastered
codmw2 Call of Duty: Modern Warfare 2 + Warzone 2
cb4 Crash Bandicoot 4: It's About Time
d2r Diablo 2: Resurrected
d3 Diablo 3
d3ptr Diablo 3 Public Test Realm
d4 Diablo IV
di Diablo Immortal
hs Heartstone
hots Heroes of the Storm
ow Overwatch
owptr Overwatch Public Test Realm
scr Starcraft Remastered
sc2 Starcraft 2
w3 Warcraft 3: Reforged
wow World of Warcraft
wowclassic World of Warcraft Classic
wowclassicera World of Warcraft Classic Era
wowptr World of Warcraft Public Test Realm

the result should look something like the example or screenshot bellow:

"G:\Steam\bnetlauncher.exe" ow

Example Screenshot

Note: bnetlauncher default behavior is to retain the state of the client, so if the client is not running bnetlauncher will close it, if it's running it will leave it running.

Public Test Realm and World of Warcraft Classic

With the release of the the new client in 2021 the previous methods to launch PTR and Classic version no longer work. This version includes experimental fix for the issue that may not always work. If game doesn't launch automaticall manual interaction to press the play button will be required.

Troubleshooting

In case of problems logging can be enabled by creating a enablelog.txt file inside %localappdata%\madalien.com\bnetlauncher\, you can open the location by pasting the path into explorer or the run dialog in windows (WinKey+R)

Known Issues

Additional options

There's also the following additional options provided by command line switches:

Uninstalling

To remove all traces of bnetlauncher from your system:

Advanced: Adding new games or custom cases

From v2.00 onward bnetlauncher uses a internal gamedb.ini to control how games are launched.

Disclaimer: This option is there to make it easier to add new games or support "exotic" use cases. It's not intended or needed for regular users.

To customize the configurations create a gamedb.ini file in:

A gamesdb.ini.sample is distributed with bnetlauncher containing a copy of the built in configuration.

Important: The defaults entries are not changeable. bnetlauncher will always override any changed value with it's internal gamesdb. However it is possible to create a new entry using a different name to use custom options.

Example entry:

  [codbo4]
  name=Call of Duty: Black Ops 4
  client=battlenet
  cmd=VIPR
  exe=BlackOps4.exe
  options=noargs,waitforexit

Explaining what each part does:

Contributors