This guide covers the rs2server module in AlphaGSM.
rs2server is currently PASSED on the documented Ubuntu 24.04 Linux
baseline. Its supported Linux CI path is Docker-first through the shared
wine-proton runtime. A current forced host-process Wine run stalled without
reaching A2S, while the matching Docker lifecycle passed, so CI no longer
duplicates the unsupported host lane.
Requirements
- Docker with the shared
wine-proton runtime
- For experimental host/process mode:
screen and Wine or Proton-GE
- SteamCMD runtime libraries (
lib32gcc-s1, lib32stdc++6)
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm myrs2serve create rs2server
Run setup:
alphagsm myrs2serve setup
Start it:
alphagsm myrs2serve start
Check it:
alphagsm myrs2serve status
Stop it:
alphagsm myrs2serve stop
Setup Details
Setup configures:
- the game port (default 7777)
- the A2S query port (default 27015)
- the install directory
- SteamCMD downloads the Windows dedicated server files
Useful Commands
alphagsm myrs2serve update
alphagsm myrs2serve backup
Notes
- Module name:
rs2server
- Default game port:
7777
- Default query port:
27015
Workshop content
The native Workshop adapter accepts public item or collection IDs and Steam
Community URLs, checking the consumer game AppID 418460 separately from the
dedicated-server tool AppID 418480:
alphagsm myrs2serve stop
alphagsm myrs2serve mod add workshop https://steamcommunity.com/sharedfiles/filedetails/?id=952365960
alphagsm myrs2serve mod apply
alphagsm myrs2serve start
It configures ServerSubscribedWorkshopItems under
[OnlineSubsystemSteamworks.TWWorkshopSteamworks] in
ROGame/Config/PCServer-ROEngine.ini and puts the native Workshop client download
manager first. Operator subscriptions, comments and unrelated settings are
preserved. Changes require a stopped server, as the engine rewrites its INIs.
Start on the stock map to download content before selecting an installed custom
map with set startmap MAP_NAME. mod cleanup removes the entries AlphaGSM
added and retains the engine's download cache.
The developer's CousteauPlantation fixture (952365960) passed public metadata
validation and anonymous SteamCMD download on 2026-10-13. Its native
VNTE-CousteauPlantation.roe map has not yet been proven loaded by this adapter
through the full AlphaGSM smoke/integration lifecycle. Process and Docker
Workshop validation remain pending. The native setup follows
Tripwire's server instructions.
Server variables
After create rs2server, inspect or change these with set:
alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE
| Key |
Aliases |
Type |
What it does |
configfile |
— |
string |
Config file path for the server. |
dir |
— |
string |
Install directory for the server. |
exe_name |
— |
string |
Server executable filename. |
port |
gameport |
integer |
The game port for the server. Example: 7777. |
queryport |
— |
integer |
The query port for the server. Example: 27015. |
servername |
hostname, name |
string |
The advertised server name. |
Developer Notes
Run File
- Executable:
Binaries/Win64/VNGame.exe
- Location:
<install_dir>/Binaries/Win64/VNGame.exe
- Engine: UE3 Windows dedicated server via Wine/Proton
- SteamCMD App ID:
418480
AlphaGSM launches the server with -log, tracks readiness through
ROGame/Logs/Launch.log reaching the current map-bringup markers such as
Bringing up level for play took, and waits for info --json to report
protocol a2s before smoke and integration treat the server as query-ready.
The current smoke and integration checks allow up to 20 minutes for this
Wine/Proton bring-up because RS2 has historically stalled beyond the old
600 second startup window in CI. The Docker lifecycle passed on 2026-07-16
with query, info, info --json, and shutdown verification on the managed
queryport; the same run's forced host-process lane never reached A2S.
Server Configuration
- Config file:
ROGame/Config/PCServer-ROGame.ini
set servername rewrites [/Script/Engine.GameReplicationInfo] ServerName in ROGame/Config/PCServer-ROGame.ini through the schema-backed config-sync path.
- Template: See server-templates/rs2server/ if available
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: Native subscription adapter; complete native load validation pending.