Multiplayer Framework for Node.js.
View documentation

Colyseus is an Authoritative Multiplayer Framework for Node.js, with SDKs
available for the Web, Unity, Defold, Haxe, Cocos and Construct3. (See official SDKs)

The project focuses on providing synchronizable data structures for realtime and
turn-based games, matchmaking, and ease of usage both on the server-side and
client-side.

The mission of the framework is to be a standard netcode & matchmaking solution
for any kind of project you can think of!

Why developers choose Colyseus:

- ⚡️ Real-time state sync that just works → Define your state on the server and it automatically synchronizes to all clients, delta-compressed and binary-encoded.
- ⚔️ Built-in matchmaking → Room-based architecture with filtering, queuing, and reconnection support out of the box.
- 📈 Scalable → Go from 10 to 10,000+ CCU by scaling vertically or horizontally with Redis and load balancers.
- 🛡️ Cheat-proof by design → Authoritative server model ensures game logic runs on the server, not the client.
- 🛠️ Use the tools you already know → Built on Node.js and TypeScript with a simple, familiar API on both server and client.
- 💙 Free forever → MIT licensed, even for commercial games.

See public roadmap for version 1.0.

🚀 Quickstart

Set up your own Colyseus server project for your game using npm create colyseus-app@latest:

``
npm create colyseus-app@latest ./my-server
cd my-server
npm start
``

Sponsors

The sustainability of the project relies on Colyseus Cloud subscriptions and sponsorships. If you are not using Colyseus Cloud, please consider sponsoring the project 💖

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Aymeric Chauvin 💬 💡	Brian Hay 🖋	Damian A. Pastorini 💬 📖 🐛	Darek Greenly 💬 🐛 💻	David Rydwanski 💬 💻	Dr. Burton 🧑‍🏫	Endel Dreyer 💻 📖 💡
Enriqueto 💼	Fazri Zubair 💼	Federico 🐛 💻	James Jacoby 💬 💡 🖋	Jonas Voland 💬 🐛 💻 🤔 💡	Kyle J. Kemp 💬 🐛 💻 🤔	Luke Wood 💬 🐛 💻
Milad Doorbash 🐛 💻	Nikita Borisov 🐛 💻 💼 🤔	Phil Harvey 📖	Sergey 🐛 💻	Sophie 💬 🐛 🤔	Tommy Leung 🧑‍🏫	digimbyte 📖

This project follows the all-contributors specification.
Contributions of any kind are welcome!

Contributing

We encourage you to contribute to Colyseus! Please check out the Contributing
guide for guidelines about how to proceed. Join us!

Everyone interacting in Colyseus and its sub-projects' codebases, issue trackers
and chat rooms is expected to follow the code of conduct.

License

MIT