Ship Multiplayer

Games Faster

Ship Multiplayer

Games Faster

Build and ship real-time multiplayer experiences with Colyseus. Open-source framework for Node.js with built-in matchmaking, state sync, and SDKs for Unity, Defold, Construct, Haxe, JavaScript, and more.

$ `npm create colyseus-app@latest ./my-server` Copied!

Requires Node.js

Get Started View on GitHub

Supports your favorite engine & platform

TypeScript
Unity
Godot Alpha
GameMaker Alpha
Defold
Haxe
C Alpha
Construct 3

Watch the Colyseus Reel

Trusted by teams with millions of players

See It In Action

Real-Time State Sync in Minutes

Define your game state on the server. Colyseus syncs it to all clients automatically — no manual serialization needed.

TypeScript React Unity Unity Godot Godot GameMaker Defold Defold Haxe Haxe C Construct 3

GameRoom.ts Server

import { Room, Client } from "colyseus";import { GameState, Player } from "./GameState";
export class GameRoom extends Room {  state = new GameState();
  messages = {    // listen for "move" messages from clients    move(client: Client, data: any) {      const player = this.state.players.get(client.sessionId);      if (player) {        player.x = data.x;        player.y = data.y;      }    },  }
  onJoin(client: Client) {    const player = new Player();    this.state.players.set(client.sessionId, player);  }
  onLeave(client: Client) {    this.state.players.delete(client.sessionId);  }}

client.ts Client

import { Client, Callbacks } from "@colyseus/sdk";
const client = new Client("https://your-server.com");const room = await client.joinOrCreate("game_room");const callbacks = Callbacks.get(room);
callbacks.onAdd("players", (player, key) => {  addSpriteForPlayer(player);  callbacks.onChange(player, () =>    moveSprite(key, player.x, player.y));});
callbacks.onRemove("players", (player, key) =>  removeSpriteForPlayer(key));
room.send("move", { x: 10, y: 20 });

`npm install @colyseus/sdk`

Demo Get Started

Game.tsx Client

import { Client } from "@colyseus/sdk";import { useRoom, useRoomState } from "@colyseus/react";
const client = new Client("https://your-server.com");
function Game() {  const { room, isConnecting } = useRoom(    () => client.joinOrCreate("game_room"),  );  const state = useRoomState(room);
  if (isConnecting) return <p>Connecting...</p>;
  return (    <ul>      {state?.players.map((player, key) => (        <li key={key}>Player at {player.x}, {player.y}</li>      ))}    </ul>  );}

`npm install @colyseus/react`

Demo Get Started

GameClient.cs Client

using Colyseus;using Colyseus.Schema;
var client = new Client("https://your-server.com");var room = await client.JoinOrCreate<GameState>("game_room");var callbacks = Callbacks.Get(room);
callbacks.OnAdd(state => state.players, (sessionId, player) => {    AddSpriteForPlayer(player);    callbacks.OnChange(player, () =>        MoveSprite(sessionId, player.x, player.y));});
callbacks.OnRemove(state => state.players, (sessionId, player) =>    RemoveSpriteForPlayer(sessionId));
await room.Send("move", new { x = 10, y = 20 });

Download Plugin

Demo Get Started

client.gd Client

var client: ColyseusClient = Colyseus.create_client()client.set_endpoint("wss://your-server.com")var room: ColyseusRoom = client.join_or_create("game_room")
room.joined.connect(func():    var callbacks = Colyseus.callbacks(room)
    callbacks.on_add("players", func(player, key):        add_sprite_for_player(player)        callbacks.on_change(player, func():            move_sprite(key, player.x, player.y)        )    )
    callbacks.on_remove("players", func(player, key):        remove_sprite_for_player(key)    )
    room.send("move", {"x": 10, "y": 20}))

Download SDK

Demo Get Started

obj\_client.gml Client

client = new ColyseusClient("https://your-server.com");room = client.join_or_create("game_room");callbacks = ColyseusCallbacks(room);
callbacks.on_add("players", function(player, key) {    add_sprite_for_player(player);    callbacks.on_change(player, function() {        move_sprite(key, player.x, player.y);    });});
callbacks.on_remove("players", function(player, key) {    remove_sprite_for_player(key);});
room.send("move", { x: 10, y: 20 });

Download SDK

Demo Get Started

client.lua Client

local ColyseusSDK = require "colyseus.sdk"
local client = ColyseusSDK.Client("https://your-server.com")client:join_or_create("game_room", function(room)    local callbacks = ColyseusSDK.callbacks(room)
    callbacks:on_add("players", function(player, key)        add_sprite_for_player(player)        callbacks:on_change(player, function()            move_sprite(key, player.x, player.y)        end)    end)
    callbacks:on_remove("players", function(player, key)        remove_sprite_for_player(key)    end)
    room:send("move", { x = 10, y = 20 })end)

See documentation

Demo Get Started

Client.hx Client

import io.colyseus.Client;import io.colyseus.schema.Callbacks;
var client = new Client("https://your-server.com");client.joinOrCreate("game_room", [], MyRoomState, function(err, room) {    var callbacks = Callbacks.get(room);
    callbacks.onAdd("players", (player, key) -> {        addSpriteForPlayer(player);        callbacks.onChange(player, () ->            moveSprite(key, player.x, player.y));    });
    callbacks.onRemove("players", (player, key) ->        removeSpriteForPlayer(key));
    room.send("move", {x: 10, y: 20});});

`haxelib install colyseus`

Demo Get Started

client.c Client

#include "colyseus.h"
colyseus_client_t* client = colyseus_client_new("https://your-server.com");colyseus_room_t* room = colyseus_join_or_create(client, "game_room");colyseus_callbacks_t* callbacks = colyseus_callbacks_get(room);
void on_player_add(colyseus_state_t* player, const char* key) {    add_sprite_for_player(player);    colyseus_on_change(callbacks, player, on_player_change, (void*)key);}
void on_player_change(colyseus_state_t* player, void* ctx) {    float x = colyseus_get_float(player, "x");    float y = colyseus_get_float(player, "y");    move_sprite((const char*)ctx, x, y);}
colyseus_on_add(callbacks, "players", on_player_add, NULL);colyseus_on_remove(callbacks, "players", on_player_remove, NULL);colyseus_room_send(room, "move", data, data_len);

Download SDK

Demo Get Started

game.js Client

const client = new Colyseus.Client("https://your-server.com");const room = await client.joinOrCreate("game_room");const callbacks = Colyseus.Callbacks.get(room);
callbacks.onAdd("players", (player, key) => {    const sprite = runtime.objects.Player.createInstance("Game", player.x, player.y);    callbacks.onChange(player, () => {        sprite.x = player.x;        sprite.y = player.y;    });});
callbacks.onRemove("players", (player, key) => {    // destroy sprite instance});
room.send("move", { x: 10, y: 20 });

Download Addon

Demo Get Started

Why Colyseus