From Mage
Jump to navigation Jump to search

How to install quickly and easily, even for a secondary user. The code for bn3t is freely available on Psi, our Git repository.


If you plan on running under its own user account, create it first . This document will assume you created a user named "battleuser". Make sure your primary user can do sudo commands as the secondary user, of the form of:

sudo -u battleuser -- *

This isn't required as you can run the bn3t script in a single-user setup , but this script is vastly overkill for that.

If you're using PulseAudio you may need to allow multiple users to use it at the same time.


First you'll need to download the bn3t script. It's a bash script that handles half of the logic for maintaining a install, which can download the secondary script under the account of your choosing. I recommend installing Wine applications under their own user accounts, so if something goes horribly wrong in the app itself it's easy to kill the whole stack. It also has security benefits as the application can be denied access to your primary user's files.

As an aside, you should never just download and run scripts. For the love of $DEITY at least glance through the code before blindly running it. The latest versions of both can be found here.

Download bn3t scripts

wget -O ./
chmod 700 ./
./ -u battleuser -i

Wineboot/Install DXVK/Setup

./ -u battleuser -bxs


Just launch

./ -u battleuser

Hide to tray (for startup)

./ -u battleuser -t

Running games

To launch a game after you've installed and aforementioned game, run the following command:

./ -u battleuser -g test

Substituting "test" for the game of you choice (unless you like glxgears). See -g for the game selections.

So for example, World of WarCraft would be:

./ -u battleuser -g wow

Doing Wonky Things

Certain actions can be processed in the conditional loop. For example, if you wanted to install into multiple prefixes for some reason:

./ -u battleuser -p /home/battleuser/1-bnet -bxs -p /home/battleuser/2-bnet -bxs

Or run winetricks three times in a row:

./ -u battleuser -www


If you must...

Download and install

wget -O ./
chmod 700 ./
./ -i


./ -bxs



Launch to tray

./ -t

Launch a game

See -g for the game selections.

./ -g wow

Script options

Usage: ./ -g (game) -u (user) -p (prefix) -a (arch) -dvksbwtnchxi


Launches the game of your choice. Test will launch glxgears.

./ -g test
Game List
Game -g (game) names
glxgears test
Hearthstone wtcg hearth hearthstone hs
Diablo 3 d3 diablo3
StarCraft II sc2 starcraft2
StarCraft sc starcraft
World of WarCraft wow worldofwarcraft
Heroes of the Storm hero heros hots
Overwatch pro ow overwatch
Destiny 2 dst2 destiny2


Runs as the user that is specified.

./ -u battleuser


Sets the WINEPREFIX to try to run under. By default, this will use:

./ -p /home/${runas_user}/.bnet


Sets the WINEARCH that will run under. Options include 32 for 32-bit support and 64 for 64-bit support.

./ -a 64


Turns the debug messages on. This also turns on the verbose messages. Debug is the most verbose setting, offering the slowest performance but the most diagnostic output. Unlike verbose, debug also turns on the debug output of Wine/wineboot/Setup/DXVK upgrades.

./ -d


Turns on verbose messages. This option is redundant if debug is also selected. Shows more script output and also gives the messaging for winetricks.

./ -v


Kill all processes for a user (if it isn't the current user or root). Comes in very handy if something's going wrong and you're running as suggested under a secondary user account. Instead of being stuck at a frozen whatever, murder it all.

./ -u battleuser -k


Runs setup from /tmp/ If this file does not exist, it will attempt to download it.

./ -s


Wineboot mode. Runs wineboot at the requested prefix (SPECIFY THE PREFIX FIRST IF USING A CUSTOM ONE!). By default this is: /home/${runas_user}/.bnet

./ -p /home/${runas_user}/.bnet -b


Winetricks mode. Runs winetricks under the requested prefix.

./ -w


Twitch Client mode. Runs the Twitch client (and installs it if necessary). Twitch requires .NET to be installed beforehand and Mono seems to have some issues. Make sure to install dotnet472 via winetricks before running Twitch.

./ -m


Attempts to hide to the system tray on launch. Specifically for auto-start launches. This is the default action when selecting "Launch minimized to the system tray" in Settings under Windows upon login.

./ -t


No BS mode. Forcibly doesn't launch an application. Will not launch and will ignore any games selected (even test). Useful for the paranoid when running winetricks/wineboot/setup/et al (in fact, bn3t-run will auto-set this when some modes are selected). Often superfluous.

./ -n


Launch a console session as the specified user. This session is dbus connected and setup via xhost, so it's completely capable of launching games and other GUI applications as the specified user.

./ -u battleuser -c


Displays the help message. Basically a less verbose version of this page.

./ -h


Forcibly upgrades DXVK in the specified prefix. DXVK is updated often and can bring very useful performance and functionality upgrades to your Wine install. To force a DXVK upgrade, run:

./ -x


Install the secondary script, bn3t-run. The first script you download basically handles when to clean up extra processes and sanitize input for bn3t-run. The -i option will download and configure the bn3t-run script automatically. By default, bn3t will download this to /home/${runas_user}/.script/

./ -i