Note: This README covers development and contributing to the SDK. For end-user installation and usage, see the Documentation (Unity | MonoGame | Godot).
Run unity-setup.sh to fetch external dependencies (e.g. NativeWebSocket) into Assets/Colyseus/Runtime/WebSocket/:
bash unity-setup.sh
This is required before opening the project in Unity. The fetched files are gitignored and bundled automatically during CI for UPM and .unitypackage releases.
External dependencies are resolved via NuGet packages — no setup script needed. The SDK is available as the Colyseus NuGet package, which depends on Colyseus.NativeWebSocket.
When the client is created on an engine main thread with a SynchronizationContext (Unity, Godot C#), WebSocket callbacks are marshaled back there automatically. Engines without one can register an external dispatcher through ColyseusContext.RegisterWebSocketForDispatch, or call room.Connection.DispatchMessageQueue() from their update loop.
In order to start a test server for this project's included example, do the following:
git clone https://github.com/colyseus/sdks-test-server
cd sdks-test-server
npm install
npm start
dotnet test nuget/Colyseus.csproj
Update the version number under Assets/Colyseus/package.json and push to master branch.
MIT