Troubleshooting

Server does not start

• Compare the runtime directory with the expected layout in README.md.
• Check server.toml syntax.
• Make sure required resources exist under resources/.
• Make sure required native modules exist under modules/.

Client cannot connect

• Check that the game port is listening (usually 7788).
• Check firewall/NAT settings.
• Confirm host, port and httpPort in server.toml.
• Open http://127.0.0.1:7789/server-info.json locally.

Server does not load a JS resource

Check:

• type = "js" in resource.toml (the Node host starts automatically; a separate js-module in the modules array is not required)
• main = "server/main.js" or an existing custom path
• the resource is listed in the server.toml resources field
• Node.js is available on PATH

Resource does not appear in the manifest

Check:

• the resource is in a direct subdirectory of resources/
• a resource.toml exists
• enabled is not false
• the resource is listed in the server.toml resources field

Client file does not download

For a normal resource the file must be resource.toml, client-main, or match client-files. For asset-pack use /assets/..., for dlc/rpf use /stream/.... The server only serves files listed in /resources/manifest.json.

Masterlist does not publish the server

Check:

• masterListUrl is not empty
• announce = true
• local development can use allowLocalUnlicensed = true
• production identity (serverId, serverLicenseTokenFile, requireServerLicense) is set for public listing

A C# / Go resource does not start

The current server binary executes only JavaScript resources server-side (server/src/CServer.cpp). The C# and Go SDKs are preview: varion-server.exe does not load them yet. Use type = "js" for server logic.

Source backing

This page is based on server/src/CServer.cpp, server/src/CResourceManager.cpp, server/src/CServerConfig.cpp, server/src/CJsHost.h (+ server/host/varion-host.cjs) and src/network/CNetworkManager.cpp.