- Add fix-port.bat to handle 'port already in use' errors
- Detect blocking process and kill it, or prompt to use different port
- Updated start.bat to detect startup failures and offer fix
- Updated README.md with troubleshooting guide for port conflicts
Users can now easily resolve port 7777 conflicts by running fix-port.bat
or using --port override on the CLI.
Co-authored-by: Cursor <cursoragent@cursor.com>
Introduce production-ready CLI for hosting Commonwealth Online servers in
cloud and on-premises environments.
Features:
- Server orchestration service (server_service.py) wrapping relay lifecycle
- JSON configuration system (config.py) for hosted deployments
- Typer+Rich CLI (consumer_server_cli.py) with serve/status/clients/world commands
- Windows launcher (start.bat) for one-click server startup
- Auto-detection of LAN addresses and dependency installation
- Machine-readable JSON output for monitoring and automation
Cli commands:
serve - Start server with optional config overrides
status - Display server stats and packet counters
clients - List connected players
world time - Set in-game time for all clients
world weather - Set weather for all clients
config init - Generate default configuration file
Documentation:
- Updated docs/setup.md with CLI quick-start guide
- Added server/README.md with usage instructions
- Updated changelog and dev-log with test results
Testing: - Verified config generation and loading
- Verified server startup banner and LAN detection
- Verified fake client connection and welcome packet
- Verified CLI help and command routing
Co-authored-by: Cursor <cursoragent@cursor.com>
andrewandCursor