Skip to content

Set Up a Path of Titans Server

WARNING

By hosting servers you agree to our Server Hosting Agreement.

Path of Titans Server files can be downloaded and updated using an automated command line utility called AlderonGamesCmd. This is similar to SteamCMD.

AlderonGamesCmd Tool (Download)

AlderonGamesCmd Tool can be downloaded for Windows, Mac, and Linux here:

INFO

Note that running this executable will not download the server software, you will need to use the below instructions to pass command line arguments to tell it what to download and where.

Command Line Arguments for AlderonGamesCmd

The AlderonGamesCmd tool can be used to download and update the Path of Titans server files. Below are the command line arguments you can use to specify the game, server, and other settings.

--game path-of-titans

This command will specify the game to download. Normally this is path-of-titans.

--server true

This command will specify that the server files should be downloaded.

--beta-branch production

This command will specify the beta branch to use.

--hotfix 0

This command will specify the hotfix version to use. By default, if you do not specify it, it will use the latest hotfix.

--auth-token ...

This command will specify the authentication token for the server. This is required for the server to work and can be generated here: https://alderongames.com/oauth/hosting-token

--install-dir ...

This command will specify the installation directory for the server files.

Alderon Games Cmd Release Notes (v1.0.5)

  • New: Introduced --arch command line argument. This allows for specifying an override arch to download. This is currently only used for Linux Server downloads. You can swap between Arm64 vs x86_64. Please note that Arm64 Linux Server support is experimental but as of this patch its now functional.
  • AlderonGamesCmd-Linux-arm64 now downloads the Arm64 version of Linux Server by default.

You can find the full release notes here.

DANGER

Alderon Games Cmd does not currently update itself.

Details

It is recommended you might have to download it when building a container so to ensure it's up to date. We plan on adding this in the future, however it won’t get changed often and old versions should still work.

Server Authentication

Both AlderonGamesCmd and PathOfTitansServer will need user authentication to the Alderon Games Platform, this can be any account that has access to the game. If you want to hive the database of two servers together using -Database=Remote, they will need to the same account.

These tokens are specified via specify -AuthToken= for PathOfTitansServer and --auth-token tokenhere for AlderonGamesCmd by using the generated tokens.

To learn more about how to generate these tokens and how they work, please check out the Authentication Token page.

WARNING

Due to Windows having a 1024 character limit on command line argument and it being a Json Web Token which is fairly long, we have added the ability to specify it via Process Environment Variable instead. You can use the environment variable AG_AUTH_TOKEN instead.

Beta Branch

Right now we recommend using production as the Beta Branch, in some rare cases, you might want to use the other branch demo-public-test.

Please note that if you want to setup a server on the public test branch you will need to get access to that branch via the public test instructions here: Public Test Branch Signup Instructions.

Server GUIDs (Globally Unique Identifier)

Each Path of Titans Server will need a unique identifier. If you have trouble generating one, please go here:

https://duckduckgo.com/?q=random+guid&atb=v296-1&ia=answer

This GUID is linked to your Path of Titans server and Alderon Games Account it starts with. Please replace the GUID blank of 00000000-0000-0000-0000-000000000000 in the below command line with the one you generated. It is in the format of UUIDv4.

Database

Server can use a Local or Remote Database. Specified using -Database=Local or -Database=Remote.

TIP

It is highly recommended to use a Remote Database so that you can run multiple servers and have them share the same database. Also prevents data loss if you accidentally delete your server folder.

Extra Command Line Arguments

These are extra command line arguments you can use to customize your server. Some of these are required for the server to work.

-ServerListIP=000.000.000

This command will be the address the server will publicly broadcast to. Useful if you want players to connect via a different IP, Firewall, Relay or DDoS protection.

TIP

If you get timeouts after trying to connect to your server via the server list, but the direct IP connect works, you will need to specify it.

-Port=7777

This command will be the port for the server. This is required for the server to work (or it will default to 7777).

-BranchKey=production

This command will be the branch key for the server. If you want to use the public test branch, you will need to get access to that branch via the public test instructions here: Public Test Branch Signup Instructions.

-ServerGUID=00000000-0000-0000-0000-000000000000

This command will be the GUID for the server. This is required for the server to work.

-AuthToken=...

This command will be the authentication token for the server. This links the server to your Alderon Games account. This is required for the server to work and can be generated here: https://alderongames.com/oauth/hosting-token

-Database=Local

This command will be the database type for the server. This is required for the server to work. Can be Local or Remote.

-ServerName=TestName

This command will set the server name. This is optional.

-MULTIHOME=000.000.000

This command will be the address the server will bind to for the network adapter

-RconIP=000.000.000

This command will be the IP for Rcon. This is required for RCON to work.

-RconPort=0000

This command will be the port for Rcon. This is required for RCON to work.

-RconPassword=test

This command will be the password for Rcon. This is required for RCON to work.

-ExternalRconPort=...

(Optional) This is used to set a external RCON port for the ServerStart webhook. This only needs to be set if you have a seperate RCON port from one that's externally accessible like the game server is running in a container, etc.

Setup Guides

This section will show you how to setup your server on Windows, Mac, and Linux. Please note that these guides are not exhaustive and you may need to do additional steps to get your server working.

Windows Server Setup

The steps below will show you how to setup a Path of Titans server on Windows.

WARNING

Please note that :: is used for comments in batch files.

  1. Download the AlderonGamesCmd Tool for Windows here: https://launcher-cdn.alderongames.com/AlderonGamesCmd-Win64.exe

  2. Create a folder for your server. This can be anywhere on your computer. For this example, we will use C:\Server1\

  3. Create a batch file called Update.bat in the folder you created in step 2. You can do this by creating a new text file and renaming it to Update.bat.

  4. Edit the Update.bat file and add the following text:

bash
:: Set the beta branch to use (e.g., "production")
SET BETA_BRANCH="production"

:: Set your authentication token here
SET AG_AUTH_TOKEN="your_auth_token_here"

:: Set the installation directory for the server files
SET INSTALL_DIR="C:\Server1"

:: Set the server GUID (replace with your actual GUID)
SET SERVER_GUID="00000000-0000-0000-0000-000000000000"

:: Run the command to update the server with the given parameters
AlderonGamesCmd-Win64.exe --game path-of-titans --server true --beta-branch %BETA_BRANCH% --auth-token %AG_AUTH_TOKEN% --install-dir %INSTALL_DIR%
  1. Run the Update.bat file. This will download the server files to the folder you created in step 2.

  2. Create a batch file called Start.bat in the folder you created in step 2. You can do this by creating a new text file and renaming it to Start.bat.

bash
:: Set the beta branch to use (e.g., "production")
SET BETA_BRANCH="production"

:: Set your authentication token here
SET AG_AUTH_TOKEN="your_auth_token_here"

:: Set the installation directory for the server
SET INSTALL_DIR="C:\Server1"

:: Set the server GUID (replace with your actual GUID)
SET SERVER_GUID="00000000-0000-0000-0000-000000000000"

:: Set the database type (e.g., "Local")
SET DATABASE="Local"

:: Start the Path of Titans server with the specified parameters
%INSTALL_DIR%\PathOfTitans\Binaries\Win64\PathOfTitansServer-Win64-Shipping.exe -Port=7777 -BranchKey=%BETA_BRANCH% -log -AuthToken=%AG_AUTH_TOKEN% -ServerGUID=%SERVER_GUID% -Database=%DATABASE%
  1. Run the Start.bat file. This will start your server. That's it!

While the above steps will work, you may want to update your server automatically and restart it if it crashes. Below is an example script that will do this for you.

bash
:: Full Example Script with Auto Restart on Crash - UpdateAndRun.bat

:: Set the beta branch to use (e.g., "production")
SET BETA_BRANCH="production"

:: Set your authentication token here
SET AG_AUTH_TOKEN="your_auth_token_here"

:: Set the installation directory for the server
SET INSTALL_DIR="C:\Server1"

:: Set the server GUID (replace with your actual GUID)
SET SERVER_GUID="00000000-0000-0000-0000-000000000000"

:: Set the database type (e.g., "Local")
SET DATABASE="Local"

:: Set the port for the server
SET PORT=7777

:Run
echo (%time%) Updating Server Files
"%INSTALL_DIR%\AlderonGamesCmd-Win64.exe" --game path-of-titans --server true --beta-branch %BETA_BRANCH% --auth-token %AG_AUTH_TOKEN% --install-dir %INSTALL_DIR%

echo (%time%) Starting Server
"%INSTALL_DIR%\PathOfTitans\Binaries\Win64\PathOfTitansServer-Win64-Shipping.exe" -log -Port=%PORT% -BranchKey=%BETA_BRANCH% -AuthToken=%AG_AUTH_TOKEN% -ServerGUID=%SERVER_GUID% -Database=%DATABASE%

echo (%time%) WARNING: Server Closed or Crashed, Restarting in 60 seconds.

timeout /t 60
goto Run

Linux Server Setup

This guide has been tested on Ubuntu 22.04. Steps may be different if you are using a different versions or distributions of Linux.

WARNING

Important: Please do not run the server as the root user. You will need to run it under a non-root user.

Install Required Dependencies

These are used by Path of Titans to setup and run the server.

sh
sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -y --no-install-recommends \
  apt-utils apt-transport-https ca-certificates libunwind8 icu-devtools \
  openssl libkrb5-3 zlib1g libuuid1 dos2unix gnupg gnupg2 debian-archive-keyring \
  gcc g++ lib32gcc-s1 lib32z1 lib32stdc++6 iproute2 gdb libsdl1.2debian libfontconfig libcurl4
sudo apt-get autoremove --purge

Install Debugging Dependencies: (Optional)

These are used for helping to debug your server with things like performance

sh
sudo apt-get install -y --no-install-recommends \
  p7zip-full unzip tar curl wget nmap net-tools netcat openssh-server \
  sudo htop vim lm-sensors stress
sudo apt-get autoremove --purge -y

Download AlderonGamesCmd for Linux

There are two architectures for Linux, x86_64 and arm64. You can find the download links for both below and download the one that matches your hardware. If you are unsure, you can use the uname -m command to find your architecture.

sh
curl -o AlderonGamesCmd-Linux https://launcher-cdn.alderongames.com/AlderonGamesCmd-Linux-x64
chmod +x AlderonGamesCmd-Linux
sh
curl -o AlderonGamesCmd-Linux https://launcher-cdn.alderongames.com/AlderonGamesCmd-Linux-arm64
chmod +x AlderonGamesCmd-Linux

Next, you will need to create a folder for your server. This can be anywhere on your computer. For this example, we will use /home/Server1/ as the folder. Then, to install the server, you will need to run the following command:

sh
#!/bin/sh
# Example Update Script (Update.sh)
export BETA_BRANCH="production"
export INSTALL_DIR="/home/Server1/"
export AG_AUTH_TOKEN="yourauthtokenhere"

# Run the AlderonGamesCmd to download/update server files
./AlderonGamesCmd-Linux --game path-of-titans --server true --beta-branch "$BETA_BRANCH" --auth-token "$AG_AUTH_TOKEN" --install-dir "$INSTALL_DIR"

Following that, you can make the script executable and run it:

sh
chmod +x Update.sh
./Update.sh

Similar to Windows, you may want to update your server automatically and restart it if it crashes. Below is an example script that will do this for you.

sh
#!/bin/sh
# Example Startup Script to update and start the server, with auto-restart on crash
export AG_AUTH_TOKEN="yourauthtokenhere"
export SERVER_MAP="Island"
export SERVER_MAX_PLAYERS="100"
export SERVER_NAME="MyCommunityServerTest1"
export SERVER_GUID="server-guid-here"
export SERVER_DB="Remote"
export BETA_BRANCH="production"
export INSTALL_DIR="/home/Server1/"

# Update the server files
echo "$(date +%T) Updating Path of Titans server"
./AlderonGamesCmd-Linux --game path-of-titans --server true --beta-branch "$BETA_BRANCH" --auth-token "$AG_AUTH_TOKEN" --install-dir "$INSTALL_DIR"

# Start the server with the specified parameters
while true
do
  echo "$(date +%T) Starting Path of Titans server"
  "$INSTALL_DIR"/server/PathOfTitansServer.sh "${SERVER_MAP}?listen?MaxPlayers=${SERVER_MAX_PLAYERS}" \
    -nullRHI -ServerName="${SERVER_NAME}" -ServerGUID="${SERVER_GUID}" \
    -BranchKey="${BETA_BRANCH}" -Database="${SERVER_DB}" -log

  echo "$(date +%T) WARNING: Server closed or crashed, restarting in 60 seconds."
  sleep 60
done
Footer Image

602f5a5