Commonwealth-Online/Commonwealth-Online-Server
3
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases 2 Wiki Activity

2 Releases 2 Tags

RSS Feed
  • Release 04f6f2b225
    Compare

    Server 1.0 Release Stable

    andrew released this 2026-08-01 18:51:58 +12:00 | 2 commits to main since this release

    Commonwealth Online Server 1.0

    The first stable release of the Commonwealth Online dedicated server and the new Windows Host GUI.

    Host a Commonwealth Online multiplayer session on your own computer, make it discoverable across your local network, and manage connected players through either the interactive server console or the native Windows Host application.

    What’s included

    Dedicated relay server

    The relay server supports Python 3.9 and newer.

    • One-command startup using start.bat on Windows or start.sh on Linux and macOS
    • Configurable TCP bind address, port, server name, description, and player limit
    • LAN discovery, allowing clients to automatically find servers on the local network
    • Interactive commonwealth> administration prompt
    • List and monitor connected players
    • Kick, ban, and unban players by player ID or IP address
    • Change the world time and weather from the console
    • Localhost administration port for management from another terminal or the Host GUI
    • Automatic generation of commonwealth-server.json on first launch

    Windows Host GUI

    The Commonwealth Online Host app provides a native Qt 6 interface for running and managing a server without using the command line.

    • Start and stop the server
    • Edit the server name, description, bind address, port, maximum players, and log level
    • View the active bind address, LAN IP, client count, uptime, and packet statistics
    • Monitor connected clients in real time
    • View server output through a resizable log panel
    • Keep the server running as a separate process if the Host GUI closes or crashes

    Requirements

    Relay server

    • Python 3.9 or newer

    Windows Host GUI

    • Windows 10 or newer
    • Qt 6.4 or newer
    • Visual Studio 2022
    • CMake 3.20 or newer

    Quick start

    Command-line server

    Download the server folder and run:

    start.bat

    On Linux or macOS:

    ./start.sh

    No compilation or build step is required.

    Windows Host GUI

    Follow the instructions in SETUP.md, then run:

    check-setup.bat
build.bat

    The compiled application will be created at:

    build\bin\Release\CommonwealthOnlineHost.exe

    Connecting

    The default server address is:

    0.0.0.0:7777

    To connect from the same computer, use:

    127.0.0.1:7777

    Players on the same local network can connect using the LAN IP displayed when the server starts.

    Hosting over the internet may require allowing the server through your firewall and forwarding the selected TCP port.

    Notes

    • Changes saved through the configuration file or Host GUI take effect the next time the server starts.
    • If port 7777 is already being used, run fix-port.bat or fix-port.sh, or select another port in commonwealth-server.json.
    • The server software does not include the Fallout 4 client mod.
    Downloads