Skip to content

About

DP Master Server (ID Tech) protocol

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

243 Commits

Folders and files

Repository files navigation

master-server

master server used for Aurora clients based on the DP Master Server (ID Tech) protocol. originally built by XLabsProject and maintained by AlterWare until archived

usage

default port is 20810/udp. pass a different port as the first argument (example: alterware-master 20811)

stats

set AW_STATS_LOCATION to a file or folder and the master writes stats.json there every 5 minutes. leave unset to skip stats

windows

download windows-x64-release-msvc from the build artifacts and run it:

set AW_STATS_LOCATION=C:\stats\stats.json
alterware-master.exe

allow 20810/udp through windows firewall and forward it on your router

linux

download linux-static-amd64-release (or linux-static-arm64-release). it runs on any distro:

chmod +x alterware-master
./alterware-master

open the port:

  • ubuntu/debian: sudo ufw allow 20810/udp
  • arch/fedora: sudo firewall-cmd --permanent --add-port=20810/udp && sudo firewall-cmd --reload

systemd service

put the binary in /opt/master-server and create /etc/systemd/system/master-server.service:

[Unit]
Description=Aurora Master Server
After=network.target

[Service]
Type=simple
ExecStart=/opt/master-server/alterware-master
WorkingDirectory=/opt/master-server
Environment="AW_STATS_LOCATION=/var/www/<domain name>/html/stats.json"
StandardOutput=null
Restart=on-failure
RestartSec=10
KillMode=process
User=<username>
Group=<group name>

[Install]
WantedBy=multi-user.target

then start it:

sudo systemctl daemon-reload
sudo systemctl enable --now master-server

the working directory must be writable (the master saves its keys there)

docker

docker run -p 20810:20810/udp -e AW_STATS_LOCATION=<path> alterware/master-server:latest

to keep stats on the host, mount a writable host folder into the container

build

you need Git and Premake5 5.0.0-beta8 or newer (download)

git clone --recursive https://github.com/auroramod/master-server.git
cd master-server

windows

needs Visual Studio 2022 with "Desktop development with C++"

premake5 vs2022
msbuild /m /p:Configuration=release /p:Platform=x64 build/alterware-master.sln

output: build/bin/x64/release

linux (statico)

needs docker

premake5 --linux-static gmake
docker run --rm -v "$PWD:/src" -w /src alpine:3.20 sh -c "apk add --no-cache build-base linux-headers && make -C build config=release_amd64 -j$(nproc)"

output is in build/bin/amd64/release (use release_arm64 on arm64)

linux (native)

install clang:

  • ubuntu/debian: sudo apt install build-essential clang lld
  • arch: sudo pacman -S --needed base-devel clang lld
  • fedora: sudo dnf install gcc-c++ clang lld make
premake5 --cc=clang gmake
make -C build config=release_amd64 -j$(nproc)

output is in build/bin/amd64/release

About

DP Master Server (ID Tech) protocol

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages