Setup Painkiller Black Edition multiplayer client

To join a Painkiller multiplayer server, some conditions should be met:

Painkiller game version is 1.64 (Black Edition).
PK++ 1.3 mod is installed.
A client connects to OpenSpy master server.
A client should have a unique CD key.
A client should have all the required multiplayer maps installed. Must-have custom maps are DM_1v1_meatless and DM_Blink.

Game servers

Most of the Painkiller gameservers are on OpenSpy now and can be tracked here.
A couple of hidden Playgound servers can be connected to directly:
```
212.42.38.178:3455
212.42.38.178:3456
```
There are some servers on the Radmin VPN network.

Quick start

The quick start part of the guide describes the fastest way to get into the Painkiller Black Edition multiplayer.

You don't need to have a full game in this case.

Download the Painkiller 1.64 Lite multiplayer client here. This version of the game is already preconfigured for online play.
Unpack the archive.
Go to the ..\Painkiller_1.64_Lite\Bin folder and run the game via the PKPlus1.3.bat file. Allow Windows to launch the file if it's asking to launch an application from an unknown publisher. This BAT will launch the PK++ 1.3 mod required for most online servers.
Change the CD key. In the game menu, go to Multiplayer -> Player Settings and click on CD key. Remove the previous CD key and enter something random, like 3875-f802-f704-1d3e. Mind the format xxxx-xxxx-xxxx-xxxx, where x is a number or a letter. While OpenSpy does not check the validity of your key, game servers may check its format and uniqueness. If you don't do this step, servers might kick you out when joining.
Go to Multiplayer -> Join Game and click on the Internet tab, find a server and Join the game.
A couple of additional hidden Playground servers can be found on the Favourites tab.
For further questions, join the Painkiller Discord community here.

Full setup

This part of the guide describes the full game multiplayer configuration in case you have a complete Painkiller Black Edition game.

Move from GameSpy to OpenSpy to be able to see servers on the in-game browser list. To use OpenSpy, you can either replace all instances of gamespy.com with openspy.net in Bin/Engine.dll and Bin/Editor/Engine.dll or modify the Windows hosts file. This guide will give you more detailed information on how to do it.
Most servers have PK++ 1.3 mod installed. It is a competitive mod made for tournaments. Starting from the 1.3 version of this mod, it's incompatible with the vanilla Painkiller Black Edition 1.64. It means that you also need to install and run this mod as a client. You can download PK++ 1.3 Open Beta here
Once PK++ 1.3 is installed, create a shortcut with the following property:
```
C:\...\Painkiller\Bin\Painkiller.exe -lscripts pkplus.pak
```
Alternatively, you can create a BAT file in the game Bin directory with the following content:
```
PKPlus1.3 -lscripts pkplus.pak
```
Run the game via the shortcut. You should see a black CPL menu logo if the PK++ 1.3 mod was run successfully.
Change the CD key. In the game menu, go to Multiplayer -> Player Settings and click on CD key. Remove the previous CD key and enter something random, like 3875-f802-f704-1d3e. Mind the format xxxx-xxxx-xxxx-xxxx, where x is a number or a letter. While OpenSpy does not check the validity of your key, game servers may check its format and uniqueness. If you don't do this step, servers might kick you out when joining.
Install a multiplayer map pack. Since Painkiller does not have a map auto-download feature, you need to have some custom maps installed beforehand. A lot of custom multiplayer maps for Painkiller can be found on ModDB. You can use this map package as a starter. PKM maps should be put into the game Data directory.
Go to Multiplayer -> Join Game and click on the Internet tab, find a server and Join the game.
A couple of additional hidden Playground servers can be accessed by entering the IP:port address in the Enter IP field:
```
PlayGround FFA:
212.42.38.178:3455

PG Duel:
212.42.38.178:3456
```
Once you enter an IP address, click on the Add to Favourites button and these servers will appear on the Favourites tab.

Alternatively, type /connect IP:port in the in-game console ~ to connect to a hidden server.
Useful settings and console commands:
- Set maxfps 125 in console for consistent physics:
```
/setmaxfps 125
```
- To turn off the default Warmup time, modify \Bin\config.ini:
```
Cfg.WarmUpTime = 0
```
- Common console voting commands:
```
/maplist
/callvote map mapname
/callvote gamemode gamemodename
/vote yes
/ready
```
where gamemodename: ffa/tdm/pcf/tlb/voosh/ctf/lms/duel
For further questions, join the Painkiller Discord community here.