Commonwealth-Online-Server/SETUP.md

Setup

Dedicated server development

Install the .NET 8 SDK.

cd server
dotnet build CommonwealthOnline.Server.csproj -c Release
dotnet run --project tests/CommonwealthOnline.Server.Tests.csproj -c Release

Run from source:

dotnet run --project CommonwealthOnline.Server.csproj -- serve --config commonwealth-server.json --interactive

Windows Qt Host development

Required:

• Visual Studio 2022 with C++ tools
• CMake 3.20+
• Qt 6.4+ MSVC 2022 package
• .NET 8 SDK

Run:

check-setup.bat
build.bat

CMake builds the Qt host and publishes the bundled C# server as a self-contained Windows executable under the staged server directory beside the host.

GameNetworkingSockets

The authoritative server is C#. Valve GameNetworkingSockets remains in the native C++ bridge under server/native_transport.

A server with enable_gns_transport: true needs the appropriate bridge library beside the server or a valid gns_bridge_path.

Ports

• Gameplay TCP compatibility: TCP 7777 by default
• GNS gameplay: UDP 7777 by default when enabled
• LAN discovery: UDP 7778
• Admin control: TCP 127.0.0.1:7779 by default

The admin port must remain localhost-only.