Tutorial: (G)ZDoom multiplayer between Windows & Linux (Ubuntu, Mint & Arch)
Installation instructions
As a solution for the multiplayer between Windows & Linux, the following requirements would have to be met:
- 1) It is available as Windows binary on the internet
2) It is available as compile-friendly source code for Linux on Github
3) It uses OpenGL 2.X
It became clear that the latest GZDoom version that could be used for multiplayer gaming (with taking abovementioned requirements into consideration) was version 1.8.6. Additionally for GZDoom, you also need to install ZDL Launcher. What you have to do to get multiplayer functioning in full is described below as step-by-step instructions:
Windows
- 1) Download GZDoom 1.8.6 Win32 binary from here
2) Download ZDL 3.2.2.3 beta daemon from here
3) Start ZDL and set up the settings. Source Port for GZDoom executable is your gzdoom.exe. Set up your iWAD files and multiplayer settings (external files, internet port, game mode etc.). iWAD files are the main WAD files you want to play. External files are mod files, run within the main WAD you've selected.
4) If you set up a server in ZDL, share your WAN/LAN IP with your client-side friends. If you're a client and your friend hosts the multiplayer server, get your friend's WAN/LAN IP and paste it to IP field in ZDL. Configure Multi Settings for a specific port address etc.
5) Start multiplayer. Have fun!
Linux
Arch Linux
- 1) Download & extract GZDoom AUR tarball (do NOT use pacaur or yaourt, see the following steps why not)
2) Replace the contents of PKGBUILD file with the following one:
Code: Select all
# This PKGBUILD is maintained at <https://github.com/grubber/archlinux-packages>
# Maintainer: Jan Cholasta <grubber at grubber cz>
# Contributor: Christoph Zeiler <rabyte*gmail>
pkgname=gzdoom
pkgver=1.8.6
pkgrel=1
pkgdesc="Doom source port based on ZDoom with an OpenGL renderer."
arch=('i686' 'x86_64')
url="http://www.osnanet.de/c.oelckers/gzdoom/"
license=('custom')
depends=('fluidsynth' 'fmodex4.26.36' 'glew' 'gtk2' 'gxmessage' 'sdl')
makedepends=('nasm' 'cmake' 'imagemagick' 'mesa' 'git')
optdepends=('blasphemer: Blasphemer (free Heretic) game data'
'chexquest3-wad: Chex Quest 3 game data'
'doom1-wad: Doom shareware game data'
'freedoom: FreeDoom game data'
'hacx-wad: HacX game data'
'harmony-wad: Harmony game data'
'heretic1-wad: Heretic shareware game data'
'hexen1-wad: Hexen demo game data'
'strife0-wad: Strife shareware game data'
'urbanbrawl-wad: Urban Brawl: Action Doom 2 game data')
_gitroot="-b g$pkgver git://github.com/coelckers/gzdoom.git $pkgname-g$pkgver"
source=(config-update-fix.patch \
doom-share-dir.patch \
stack-noexec.patch \
gzdoom.desktop)
md5sums=('eed301389f533effbd127681a3ddc2c5'
'3ee3d6bb1f777445438bc40ae81a95df'
'4778bb22190c445a4ed764c64432de12'
'3f5920d839086c9ad04ed1338c3fb546')
_fmodver=4.26.36
_libdir=/usr/lib/gzdoom
_sharedir=/usr/share/games/gzdoom
prepare() {
cd $srcdir/
msg "Connecting to the GIT server...."
git clone ${_gitroot}
msg "GIT checkout done."
msg "Starting make for: $pkgname"
cd gzdoom-g$pkgver
patch -p1 <"$srcdir/config-update-fix.patch"
patch -p1 <"$srcdir/doom-share-dir.patch"
patch -p1 <"$srcdir/stack-noexec.patch"
sed -i "s|setPluginPath(progdir)|setPluginPath(\"$_libdir\")|" src/sound/fmodsound.cpp
}
build() {
cd gzdoom-g$pkgver
cmake -DFMOD_INCLUDE_DIR=/usr/include/fmodex-$_fmodver \
-DFMOD_LIBRARY=/usr/lib/libfmodex-$_fmodver.so \
-DCMAKE_C_FLAGS="$CFLAGS -DSHARE_DIR=\\\"$_sharedir\\\"" \
-DCMAKE_CXX_FLAGS="$CXXFLAGS -DSHARE_DIR=\\\"$_sharedir\\\"" \
.
make
convert "src/win32/icon1.ico[2]" gzdoom.png
}
package() {
cd gzdoom-g$pkgver
install -Dm755 gzdoom "$pkgdir/usr/bin/gzdoom"
install -Dm755 liboutput_sdl.so "$pkgdir/$_libdir/liboutput_sdl.so"
install -Dm644 gzdoom.pk3 "$pkgdir/$_sharedir/gzdoom.pk3"
install -Dm644 brightmaps.pk3 "$pkgdir/$_sharedir/brightmaps.pk3"
install -Dm644 lights.pk3 "$pkgdir/$_sharedir/lights.pk3"
install -Dm644 gzdoom.png "$pkgdir/usr/share/pixmaps/gzdoom.png"
install -Dm644 "$srcdir/gzdoom.desktop" "$pkgdir/usr/share/applications/gzdoom.desktop"
install -Dm644 docs/BUILDLIC.TXT "$pkgdir/usr/share/licenses/$pkgname/BUILDLIC.TXT"
install -Dm644 docs/doomlic.txt "$pkgdir/usr/share/licenses/$pkgname/DOOMLIC.TXT"
}
sudo pacman -U gzdoom-1.8.6-1-x86_64.pkg.tar.xz (64-bit)
sudo pacman -U gzdoom-1.8.6-1-i686.pkg.tar.xz (32-bit)
4) Install zdl 3.2.2.3 beta from AUR (or use pacaur -S zdl OR yaourt zdl)
5) Copy gzdoom.pk3, brightmaps.pk3 & lights.pk3 from this Windows ZIP into /usr/share/games/gzdoom/ and replace the old ones. Requires root priviledges.
6) Start ZDL and set up the settings. Source Port for GZDoom executable is located at /usr/bin/gzdoom. Set up your iWAD files and multiplayer settings (external files, internet port, game mode etc.). iWAD files are the main WAD files you want to play. External files are mod files, run within the main WAD you've selected.
7) If you set up a server in ZDL, share your WAN/LAN IP with your client-side friends. If you're a client and your friend hosts the multiplayer server, get your friend's WAN/LAN IP and paste it to IP field in ZDL. Configure Multi Settings for a specific port address etc.
8) Start multiplayer. Have fun!
Ubuntu & Linux Mint
Ubuntu and Linux Mint users have to install GZDoom and ZDL separately in order to play GZDoom online. There is no simple PPA way to do it at the moment since not many if any available deb packages are floating around the internet for these programs (as far as I know). Anyway, please read the following instructions to proceed with the installation.
For multiplayer between Windows & Linux, version 1.8.6 of GZDoom is recommended.
Whichever method you use to install GZDoom and ZDL, install prerequisites BEFORE installing the corresponding deb package!
GZDoom installation
Two individual installation methods are provided. Use either A) or B) Method, whichever you prefer over the other one.
A) Method - Precompiled package (easy for beginners):
Use
one of these packages, depending on what Ubuntu/Linux Mint version you're running on your computer.
You can install an individual .deb packages eitheer by
- - opening a new terminal
- in terminal: go to the same directory where your .deb file locates
- type the following command: sudo dpkg -i mydebfile.deb. Just replace string mydebfile with the real name of your deb file.
or using a graphical package manager (such as Ubuntu Software Center).
If you use terminal way, make sure you have all prerequisites installed first! If you, however, accidentally mess up with apt-get, run
sudo apt-get install -f.
NOTE: The following deb packages have NOT been tested with ANY Linux Mint distribution. The compatilibity with Mint is estimated by using
this Wikipedia article as a reference.
Ubuntu 13.10 (and Linux Mint 16)
Ubuntu 14.04 & 14.10 (and Linux Mint 17 & 17.1)
These packages work on Kubuntu 14.10 Plasma 5, too (with ZDL).
B) Method - DEB package from source code, automatic bash script provided below:
If, for a reason or another, precompiled packages are not suitable for you, I provide a fully automated bash script for building GZDoom easily from source into an installable DEB package. The script is tested on Ubuntu 13.10, 14.04 and 14.10 (32-bit & 64-bit versions) and should work with GZDoom 1.8.6, 1.8.09 & 2.0.04 Github source codes at least.
The script asks for root (sudo) password. The password is asked only for installing possibly missing packages required for successful compilation process. If you miss some critical packages, there would probably be a ton of required packages to be installed. Don't panic or get confused. All other script actions are run as normal user and do not require any user actions/interference.
After you've run the script you should see a new
gzdoom_xxxx.deb file compiled in the same folder where this script is located at. Install this compiled deb package with Ubuntu Software Center (or equivalent) or simply by typing
sudo dpkg -i gzdoom_xxxx.deb in terminal. You have to use correct deb file name here, of course.
Copy the script below and save it as a text file (
gzdoom.sh for example). Execute it in terminal by typing
bash gzdoom.sh or use equivalent command. The script may not work with
sh command. I recommend you to use
bash command instead.
Code: Select all
#!/bin/bash
PKGVERSION=1.8.6
SOURCEDIR=gzdoom-$PKGVERSION
_sharedir=/usr/share/games/gzdoom
sudo apt-get install git cmake imagemagick dh-make build-essential zlib1g-dev libsdl1.2-dev libsdl2-dev libjpeg-dev nasm tar libbz2-dev libgtk2.0-dev cmake git libfluidsynth-dev libgme-dev libgl1-mesa-dev libglew-dev
git clone -b g$PKGVERSION git://github.com/coelckers/gzdoom.git gzdoom-$PKGVERSION
cd $SOURCEDIR
if [ "$(uname -m)" = "x86_64" ]; then
FMODFOLDER="fmodapi42636linux64"
else
FMODFOLDER="fmodapi42636linux"
fi && \
wget -nc http://www.fmod.org/download/fmodex/api/Linux/$FMODFOLDER.tar.gz && \
tar -xvzf $FMODFOLDER.tar.gz -C ./
if [ "$(uname -m)" = "x86_64" ]; then
FMODFOLDER="fmodapi42636linux64"
FMODFILE="libfmodex64-4.26.36"
else
FMODFOLDER="fmodapi42636linux"
FMODFILE="libfmodex-4.26.36"
fi && \
cmake -DCMAKE_BUILD_TYPE=Release \
-DFMOD_LIBRARY=./$FMODFOLDER/api/lib/$FMODFILE.so \
-DFMOD_INCLUDE_DIR=./$FMODFOLDER/api/inc \
-DCMAKE_C_FLAGS="$CFLAGS -DSHARE_DIR=\\\"$_sharedir\\\"" \
-DCMAKE_CXX_FLAGS="$CXXFLAGS -DSHARE_DIR=\\\"$_sharedir\\\"" && \
make
convert "src/win32/icon1.ico[2]" gzdoom.png
printf "[Desktop Entry]\nEncoding=UTF-8\nVersion=1.0\nType=Application\nName=GZDoom\nGenericName=Enhanced Doom Engine\nIcon=gzdoom\nExec=gzdoom %F\nTerminal=false\nCategories=Game;ActionGame;\nStartupNotify=true\n" > gzdoom.desktop
mkdir -p ./$SOURCEDIR/usr/bin
mkdir -p ./$SOURCEDIR/usr/lib/gzdoom
mkdir -p ./$SOURCEDIR/usr/share/applications
mkdir -p ./$SOURCEDIR/usr/share/games/gzdoom
mkdir -p ./$SOURCEDIR/usr/share/licenses/gzdoom
mkdir -p ./$SOURCEDIR/usr/share/pixmaps
mkdir -p ./$SOURCEDIR/usr/share/licenses/gzdoom
mv gzdoom ./$SOURCEDIR/usr/bin/
mv ./output_sdl/liboutput_sdl.so ./$SOURCEDIR/usr/lib/gzdoom/
mv gzdoom.pk3 brightmaps.pk3 lights.pk3 ./$SOURCEDIR/usr/share/games/gzdoom/
mv gzdoom.png ./$SOURCEDIR/usr/share/pixmaps/
mv gzdoom.desktop ./$SOURCEDIR/usr/share/applications/
mv ./docs/BUILDLIC.TXT ./$SOURCEDIR/usr/share/licenses/gzdoom/
mv ./docs/doomlic.txt ./$SOURCEDIR/usr/share/licenses/gzdoom/
cp ./$FMODFOLDER/api/lib/$FMODFILE.so ./$SOURCEDIR/usr/lib/
cd ./$SOURCEDIR/
dh_make -s -y --createorig
mkdir -p ./debian/gzdoom/
cp -R ./usr ./debian/gzdoom/usr/
printf "usr/* usr/" > ./debian/gzdoom.install
dpkg-buildpackage -us -uc -b
cd ..
mv *.deb ../
These ZDL installation instructions are for Ubuntu 13.10, 14.04, 14.10 & Linux Mint 16, 17 & 17.1.
About ZDL:
"ZDL is a feature rich Doom launcher for ZDoom and GZDoom. It supports multiplayer (WAN/LAN) and Doom mods (such as Brutal Doom)."Multiple mods can be loaded simultaneously into one game session."
I provide to two alternative installation methods for the latest ZDL 3.2.2.3 beta version.
A) Method - Precompiled package (easy for beginners):
Use
one of these packages, depending on what OS architecture (amd64 or i386) you're running on your computer.
ZDL 3.2.2.3 beta (64-bit) - .deb file
ZDL 3.2.2.3 beta (32-bit) - .deb file
Prerequisites:
Code: Select all
sudo apt-get install libc6 libgcc1 libqt4-network libqtcore4 libqtgui4 libstdc++6
Save the script to your computer as a .sh file (
zdl.sh for example) and execute it in terminal by typing
bash zdl.sh:
Code: Select all
#!/bin/bash
PKGVERSION=3.2.2.3
SOURCEDIR=zdl-$PKGVERSION
sudo apt-get install qt4-dev-tools make gdb git autotools-dev imagemagick dh-make
git clone -b v$PKGVERSION git://github.com/qbasicer/qzdl.git $SOURCEDIR
cd $SOURCEDIR
./configure --prefix=/usr --disable-updater
make
convert "res/ico_icon.ico[2]" ./zdl.png
printf "[Desktop Entry]\nEncoding=UTF-8\nName=ZDL Doom Launcher\nGenericName=Doom launcher\nComment=A feature rich Doom launcher for ZDoom and GZDoom\nExec=zdl\nIcon=zdl\nTerminal=false\nType=Application\nCategories=Game;\nStartupNotify=true\n" > zdl.desktop
mkdir -p ./$SOURCEDIR/usr/bin
mkdir -p ./$SOURCEDIR/usr/share/applications
mkdir -p ./$SOURCEDIR/usr/share/pixmaps
mv zdl ./$SOURCEDIR/usr/bin/
mv zdl.png ./$SOURCEDIR/usr/share/pixmaps/
mv zdl.desktop ./$SOURCEDIR/usr/share/applications/
cd ./$SOURCEDIR
dh_make -s -y --createorig
mkdir -p ./debian/zdl/
cp -R ./usr ./debian/zdl/usr/
printf "usr/* usr/" > ./debian/zdl.install
dpkg-buildpackage -us -uc -nc -b
cd ..
mv *.deb ../
After the script execution there should be
zdl-someversion.deb file compiled for you in the script folder.
Post-installation configuration
<note>these instructions are for Ubuntu/Mint/Arch users only. Skip if you use Windows.</note>
After you have installed GZDoom and ZDL, you should have two new desktop shortcuts in your application menu (under "Games"). Physically they're located at
/usr/share/applications folder in your system.
GZDoom stores your settings in
$HOME/.config/gzdoom/zdoom.ini. It's recommended that you use the same folder to store your WAD files, too. To run GZDoom individually without ZDL, it requires at least one WAD file being stored in the beforementioned folder.
Running the game
<note>these instructions are for Ubuntu/Mint(/Arch) users only. Skip if you use Windows.</note>
- 1) Copy gzdoom.pk3, brightmaps.pk3 & lights.pk3 from this Windows ZIP into /usr/share/games/gzdoom/ and replace the old ones. Requires root priviledges.
2) Start ZDL and set up the settings. Source Port for GZDoom executable is located at /usr/bin/gzdoom. Set up your iWAD files and multiplayer settings (external files, internet port, game mode etc.). iWAD files are the main WAD files you want to play. External files are mod files, run within the main WAD you've selected.
3) If you set up a server in ZDL, share your WAN/LAN IP with your client-side friends. If you're a client and your friend hosts the multiplayer server, get your friend's WAN/LAN IP and paste it to IP field in ZDL. Configure Multi Settings for a specific port address etc.
4) Start multiplayer. Have fun!
Using ZDoom instead of GZDoom
Version 2.7.1 is recommended.
Windows
Download Windows binary (2.7.1) from
here
Linux
Changes to GZDoom installation instructions:
- - zdoom.pk3 instead of gzdoom.pk3 (Replace the linux version of this file with Windows version. zdoom.pk3 is installed to /usr/share/games/zdoom/ folder so you need root priviledges to replace the file)
- No brightmaps.pk3 or lights.pk3
- Default user settings directory is located at $HOME/.config/zdoom. This is the place where you should put your WAD files.
- Executable (Source Port) for zdoom is /usr/bin/zdoom file
Arch Linux
Get zdoom 2.7.1 from
AUR (or use
pacaur -S zdoom OR
yaourt zdoom).
Ubuntu & Linux Mint
A) Method - Precompiled package (easy for beginners):
Ubuntu 13.10 (and Linux Mint 16)
ZDoom 2.7.1 (64-bit) - .deb file
ZDoom 2.7.1 (32-bit) - .deb file
Prerequisites:
Code: Select all
sudo apt-get install libbz2-1.0 libc6 libfluidsynth1 fluidsynth libgcc1 libglib2.0-0 libgtk2.0-0 libjpeg8 libsdl1.2debian libstdc++6 zlib1g
Code: Select all
sudo apt-get install libbz2-1.0 libc6 libfluidsynth1 fluidsynth libgcc1 libglib2.0-0 libgtk2.0-0 libjpeg8 libsdl1.2debian libstdc++6 zlib1g
Save the following script to your computer as
zdoom.sh and execute it by typing
bash zdoom.sh in terminal. Root/Sudo password is required only for installation of necessary development packages to compile ZDoom successfully (apt-get). All other script actions are run as normal user.
After the script has been executed, a compiled & fresh zdoom debian package should be in your zdoom.sh script directory. Install runtime
dependencies/prerequisites (above) and then the .deb package itself.
The script is based on the GZDoom compilation script shown earlier. It has just some minor modifications for ZDoom adaptation. Please feel free to modify it for your needs.
Code: Select all
#!/bin/bash
PKGVERSION=2.7.1
SOURCEDIR=zdoom-$PKGVERSION
_sharedir=/usr/share/games/zdoom
sudo apt-get install git cmake imagemagick dh-make build-essential zlib1g-dev libsdl1.2-dev libsdl2-dev libjpeg-dev nasm tar libbz2-dev libgtk2.0-dev cmake git libfluidsynth-dev fluidsynth libgme-dev libgl1-mesa-dev libglew-dev
git clone -b $PKGVERSION git://github.com/rheit/zdoom.git zdoom-$PKGVERSION
cd $SOURCEDIR
if [ "$(uname -m)" = "x86_64" ]; then
FMODFOLDER="fmodapi42636linux64"
else
FMODFOLDER="fmodapi42636linux"
fi && \
wget -nc http://www.fmod.org/download/fmodex/api/Linux/$FMODFOLDER.tar.gz && \
tar -xvzf $FMODFOLDER.tar.gz -C ./
if [ "$(uname -m)" = "x86_64" ]; then
FMODFOLDER="fmodapi42636linux64"
FMODFILE="libfmodex64-4.26.36"
else
FMODFOLDER="fmodapi42636linux"
FMODFILE="libfmodex-4.26.36"
fi && \
cmake -DCMAKE_BUILD_TYPE=Release \
-DFMOD_LIBRARY=./$FMODFOLDER/api/lib/$FMODFILE.so \
-DFMOD_INCLUDE_DIR=./$FMODFOLDER/api/inc \
-DCMAKE_C_FLAGS="$CFLAGS -DSHARE_DIR=\\\"$_sharedir\\\"" \
-DCMAKE_CXX_FLAGS="$CXXFLAGS -DSHARE_DIR=\\\"$_sharedir\\\"" && \
make
convert "src/win32/icon1.ico[2]" zdoom.png
printf "[Desktop Entry]\nEncoding=UTF-8\nVersion=1.0\nType=Application\nName=ZDoom\nGenericName=Doom Engine\nIcon=zdoom\nExec=zdoom %F\nTerminal=false\nCategories=Game;ActionGame;\nStartupNotify=true\n" > zdoom.desktop
mkdir -p ./$SOURCEDIR/usr/bin
mkdir -p ./$SOURCEDIR/usr/lib/zdoom
mkdir -p ./$SOURCEDIR/usr/share/applications
mkdir -p ./$SOURCEDIR/usr/share/games/zdoom
mkdir -p ./$SOURCEDIR/usr/share/licenses/zdoom
mkdir -p ./$SOURCEDIR/usr/share/pixmaps
mkdir -p ./$SOURCEDIR/usr/share/licenses/zdoom
mv zdoom ./$SOURCEDIR/usr/bin/
mv ./output_sdl/liboutput_sdl.so ./$SOURCEDIR/usr/lib/zdoom/
mv zdoom.pk3 ./$SOURCEDIR/usr/share/games/zdoom/
mv zdoom.png ./$SOURCEDIR/usr/share/pixmaps/
mv zdoom.desktop ./$SOURCEDIR/usr/share/applications/
mv ./docs/BUILDLIC.TXT ./$SOURCEDIR/usr/share/licenses/zdoom/
mv ./docs/doomlic.txt ./$SOURCEDIR/usr/share/licenses/zdoom/
cp ./$FMODFOLDER/api/lib/$FMODFILE.so ./$SOURCEDIR/usr/lib/
cd ./$SOURCEDIR/
dh_make -s -y --createorig
mkdir -p ./debian/zdoom/
cp -R ./usr ./debian/zdoom/usr/
printf "usr/* usr/" > ./debian/zdoom.install
dpkg-buildpackage -us -uc -b
cd ..
mv *.deb ../
User settings directory of Zdoom is located at
$HOME/.config/zdoom/ on Linux.
Troubleshooting (Linux)
General
- Issue: I try install these deb packages via command line with command sudo dpkg -i somepackage.deb. However, I get complains about missing packages or dependencies on my system.
Solution: Install all packages listed under Prerequisites titles before installing individually downloaded deb packages. If you missed that, you can always try to get things right with command sudo apt-get install -f which attempts to correct dependency-related installation errors. If a not-listed package is missing, install it with command sudo apt-get update && sudo apt-get install <missingpackages> (use correct package names here).
GZDoom/ZDoom
- Issue: I can't start GZDoom/ZDoom because of missing wads. (or "GZDoom/ZDoom doesn't launch").
Solution: Make sure you have .config/gzdoom/ (or ./config/zdoom if using ZDoom) in your home directory. You must also place at least one valid WAD file there (doom2.wad for example). After having done that, run gzdoom again.
Issue: Audio is not working
Solution: To get audio working, try different midi devices (Options -> Sound Options). For me, OPL SYNTH EMULATION works perfectly with both music & other sounds. However, GZDoom sounds may not work if you have some another program opened using audio (Flash in Firefox, VirtualBox etc.).
Issue: Crackling sounds
Solution: GZDoom sounds may not work if you have some another program opened using audio (Flash in Firefox, VirtualBox etc.). I got crackling sounds in GZDoom while VirtualBox session was running on the background.
EDIT: Hamachi & Haguichi related requirements/stuff removed.
EDIT 2: ZDoom part added. Text trimmed little bit.
