colyseus/colyseus

O que é?

Recursos principais

• 01Sincronização automática do estado do servidor para os clientes, com compactação por delta e codificação binária
• 02Arquitetura baseada em salas, com matchmaking, filtros, filas e reconexão
• 03Modelo de servidor autoritativo que mantém a lógica do jogo no servidor
• 04SDKs de cliente para TypeScript, React, Unity, Godot, GameMaker, Defold e outros
• 05Escalonamento horizontal com Redis e balanceadores de carga

Casos de uso

• Desenvolver jogos multiplayer em tempo real para navegador ou Node.js
• Criar jogos por turnos com aplicação das regras no servidor
• Adicionar matchmaking e salas de lobby a jogos feitos com Unity ou Godot
• Prototipar recursos de jogos em rede com TypeScript

Início rápido

1. 1

   Crie um projeto de servidor com o starter do npm

   npm create colyseus-app@latest ./my-server
2. 2

   Entre na pasta do projeto

   cd my-server
3. 3

   Inicie o servidor

   npm start

Antes de usar

• !Os SDKs de cliente para engines como Unity, Godot e GameMaker são baixados separadamente, não pelo npm.
• !Para escalar de um servidor para milhares de jogadores, são necessários Redis e balanceadores de carga, que você precisa configurar por conta própria.

Tópicos

Perguntas frequentes

O que é colyseus?

Framework autoritativo de multiplayer para Node.js, com sincronização de estado, matchmaking baseado em salas e SDKs para web, Unity, Godot e outros. Colyseus é um framework de servidores para jogos multiplayer em Node.js. A lógica do jogo é executada no servidor, e o framework sincroniza automaticamente o estado definido no servidor com todos os clientes conectados, usando atualizações codificadas em binário e compactadas por delta. Esse modelo autoritativo mantém as regras do jogo fora do cliente, ajudando a evitar trapaças.

colyseus é gratuito? Qual é a licença?

colyseus é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

colyseus ainda é mantido?

Manutenção ativa. O último commit de colyseus foi em 16 de out. de 2026.

Para que posso usar colyseus?

Desenvolver jogos multiplayer em tempo real para navegador ou Node.js Criar jogos por turnos com aplicação das regras no servidor Adicionar matchmaking e salas de lobby a jogos feitos com Unity ou Godot Prototipar recursos de jogos em rede com TypeScript

Como instalar colyseus?

Crie um projeto de servidor com o starter do npm: npm create colyseus-app@latest ./my-server Entre na pasta do projeto: cd my-server Inicie o servidor: npm start

Onde consigo colyseus?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/colyseus/colyseus