Player vs Player Gaming Network - PRO

PvPGN is a free and open source cross-platform server software that supports Battle.net and and Westwood Online game clients. PvPGN-PRO is a fork of the official PvPGN project, whose development stopped in 2011, and aims to provide continued maintenance and additional features for PvPGN.

Deleaker helps us find memory leaks.

Tracking

By default, tracking is enabled and is only used for the purpose of sending informational data (e.g. server description, homepage, uptime, amount of users) to tracking servers. To disable tracking, set track = 0 in conf/bnetd.conf.

Supported Clients

• WarCraft 2: Battle.net Edition: 2.02a, 2.02b
• WarCraft 3: Reign of Chaos*: 1.13a, 1.13b, 1.14a, 1.14b, 1.15a, 1.16a, 1.17a, 1.18a, 1.19a, 1.19b, 1.20a, 1.20b, 1.20c, 1.20d, 1.20e, 1.21a, 1.21b, 1.22a, 1.23a, 1.24a, 1.24b, 1.24c, 1.24d, 1.24e, 1.25b, 1.26a, 1.27a, 1.27b, 1.28, 1.28.1, 1.28.2, 1.28.4, 1.28.5
• WarCraft 3: The Frozen Throne*: 1.13a, 1.13b, 1.14a, 1.14b, 1.15a, 1.16a, 1.17a, 1.18a, 1.19a, 1.19b, 1.20a, 1.20b, 1.20c, 1.20d, 1.20e, 1.21a, 1.21b, 1.22a, 1.23a, 1.24a, 1.24b, 1.24c, 1.24d, 1.24e, 1.25b, 1.26a, 1.27a, 1.27b, 1.28, 1.28.1, 1.28.2, 1.28.4, 1.28.5
• StarCraft: 1.08, 1.08b, 1.09, 1.09b, 1.10, 1.11, 1.11b, 1.12, 1.12b, 1.13, 1.13b, 1.13c, 1.13d, 1.13e, 1.13f, 1.14, 1.15, 1.15.1, 1.15.2, 1.15.3, 1.16, 1.16.1, 1.17.0, 1.18.0
• StarCraft: Brood War: 1.08, 1.08b, 1.09, 1.09b, 1.10, 1.11, 1.11b, 1.12, 1.12b, 1.13, 1.13b, 1.13c, 1.13d, 1.13e, 1.13f, 1.14, 1.15, 1.15.1, 1.15.2, 1.15.3, 1.16, 1.16.1, 1.17.0, 1.18.0
• Diablo: 1.09, 1.09b
• Diablo 2: 1.10, 1.11, 1.11b, 1.12a, 1.13c, 1.14a, 1.14b, 1.14c, 1.14d
• Diablo 2: Lord of Destruction: 1.10, 1.11, 1.11b, 1.12a, 1.13c, 1.14a, 1.14b, 1.14c, 1.14d
• Westwood Chat Client: 4.221
• Command & Conquer: Win95 1.04a (using Westwood Chat)
• Command & Conquer: Red Alert: Win95 2.00 (using Westwood Chat), Win95 3.03
• Command & Conquer: Red Alert 2: 1.006
• Command & Conquer: Tiberian Sun: 2.03 ST-10
• Command & Conquer: Tiberian Sun Firestorm: 2.03 ST-10
• Command & Conquer: Yuri's Revenge: 1.001
• Command & Conquer: Renegade: 1.037
• Nox: 1.02b
• Nox Quest: 1.02b
• Dune 2000: 1.06
• Emperor: Battle for Dune: 1.09

* WarCraft 3 clients are unable to connect to PvPGN servers without a client-side modification, through tools such as W3L, to disable server signature verification.

* StarCraft clients beginning with patch 1.18 will not be supported by PvPGN-PRO due to protocol changes. A 1.18.0 versioncheck entry is included for compatibility with bot software.

Support

Create an issue if you have any questions, suggestions, or anything else to say about PvPGN-PRO. Please note that D2GS is not part of the PvPGN project and is therefore unsupported here.

You may also find people familiar with PvPGN at these Discord servers:

• #botdev at Discord - BNETDocs
• #pvpgn-d2gs-support at Discord - DIABLO2.ORG

Development

Submit pull requests to contribute to this project. Utilize C++11 features and adhere to the C++ Core Guidelines whenever possible.

Building

See docs/ports.md for operating systems and compilers that have been confirmed to work with PvPGN. Any operating system that supports WinAPI or POSIX, and any C++11 compliant compiler should be able to build PvPGN.

On Windows, Magic Builder is a convenient tool for building PvPGN.

Obtain packages.

Ubuntu / Debian 10

apt install -y build-essential git cmake zlib1g-dev libcurl4-openssl-dev
apt install -y liblua5.1-0-dev # Lua support
apt install -y mysql-server mysql-client libmysqlclient-dev # MySQL support
apt install -y sqlite3 libsqlite3-dev # SQLite3 support
apt install -y postgresql libpq-dev # PostgreSQL support

CentOS 8

dnf -y install wget gcc-c++ make git cmake zlib-devel libcurl-devel
dnf -y install readline-devel && wget -c https://www.lua.org/ftp/lua-5.1.5.tar.gz -O - | tar -xz && cd lua-5.1.5 && make linux && make install # Lua 5.1 must be compiled and installed from source. Newer version not supported yet.
dnf -y install mysql-server mysql-devel
dnf -y install sqlite-devel
dnf -y install postgresql

CentOS 7

yum -y install epel-release centos-release-scl
yum -y install git zlib-devel cmake3 libcurl-devel devtoolset-7-gcc*
ln -s /usr/bin/cmake3 /usr/bin/cmake
scl enable devtoolset-7 bash

Fedora 32

dnf -y install gcc-c++ make git cmake zlib-devel libcurl-devel
dnf -y install community-mysql-server

FreeBSD 12

env ASSUME_ALWAYS_YES=yes pkg install git cmake curl
# Lua?
# MySQL?
# SQLite3?
# PostgreSQL?

macOS

Install the Xcode Command Line Tools (provides Apple Clang, make, and the zlib/libcurl headers from the macOS SDK — no Homebrew packages are needed for these), then install CMake via Homebrew:

xcode-select --install
brew install git cmake

For Lua support, Lua 5.1 must be compiled and installed from source (newer versions are not supported yet). Installing to a user-local prefix avoids sudo:

curl -fsSL https://www.lua.org/ftp/lua-5.1.5.tar.gz | tar -xz
cd lua-5.1.5 && make macosx && make install INSTALL_TOP="$HOME/lua51"

Generate a makefile or Visual Studio solution

git clone https://github.com/pvpgn/pvpgn-server.git
cd pvpgn-server && mkdir build && cd build

cmake -DCMAKE_BUILD_TYPE="RelWithDebInfo" ../

• On Linux, you may want to specify a custom installation directory by passing -DCMAKE_INSTALL_PREFIX=/usr/local/pvpgn to CMake.
• On macOS:
  • CMake 4.x (the current Homebrew version) no longer supports this project's minimum CMake version, so add -DCMAKE_POLICY_VERSION_MINIMUM=3.5 to the CMake command.
  • When building with -DWITH_LUA=true, also pass -DCMAKE_PREFIX_PATH="$HOME/lua51" (the Lua 5.1 install prefix from the step above). Without it, CMake will pick up any newer Homebrew Lua (5.4/5.5), which fails to compile.
  • Full example:

    cmake -DCMAKE_BUILD_TYPE="RelWithDebInfo" -DCMAKE_POLICY_VERSION_MINIMUM=3.5 -DWITH_LUA=true -DCMAKE_PREFIX_PATH="$HOME/lua51" ../
    

• Additional CMake options are:
  • -DWITH_BNETD=true
  • -DWITH_D2CS=true
  • -DWITH_D2DBS=true
  • -DWITH_LUA=false
  • -DWITH_WIN32_GUI=true
  • -DWITH_MYSQL=false
  • -DWITH_SQLITE3=false
  • -DWITH_PGSQL=false
  • -DWITH_ODBC=false

Build and install

Linux / macOS

make && make install

On macOS, the default install prefix (/usr/local) requires sudo make install; alternatively pass -DCMAKE_INSTALL_PREFIX=$HOME/pvpgn to CMake to install without sudo.

Windows (Visual Studio)

First open Developer PowerShell for VS ... or Developer Command Prompt for VS ...

msbuild pvpgn.sln -target:ALL_BUILD;INSTALL /p:Configuration="RelWithDebInfo"

Docker

Check this link

Hosting on LAN or VPS with private IP address

Some VPS providers do not assign your server a direct public IP. If that is the case or you host at home behind NAT you need to setup the route translation in address_translation.conf. The public address is pushed as the route server address to game clients when seeking games. Failure to push the correct address to game clients results in players not being able to match and join games (long game search and error).

If your network interface is directly bound to public IP, PvPGN can figure it out on it's own and this step is not necessary.

License

PvPGN-PRO is licensed under the GNU GPL v2 (or later). See LICENSE file for more information.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.