Construct 3
Installation
You need a server to use Colyseus!
Construct has well-known existing features to “host” a multiplayer session from the frontend. This is not possible when using Colyseus. Colyseus is an authoritative server, written in Node.js. You can’t let your frontend host the game sessions directly.
Example project
Please explore this demonstration project to understand how to use Colyseus with Construct3.
- Download
.c3pand server files ( View source-code) - Open the
RawUsage.c3pfile on Construct3 Editor ↗. - Start the local server by running
npm installand thennpm starton theserverfolder.
The example project covers the core concepts of using Colyseus with Construct 3:
Joining a Room
Use the “Join Room” action to connect to a room on the server. Once connected, you can listen for incoming messages using “On Message” triggers, and handle disconnection with “On Leave”.

Listening for changes in the State
Use “On State Change” to react whenever the server updates the room state. Access individual state properties using the expression syntax to read synchronized values like scores, positions, or game phase.

Listening for add/remove events on Maps and Arrays within the State
Track when items are added to or removed from collections (Maps and Arrays) in the state. This is essential for handling dynamic lists like players joining/leaving or inventory changes.

Next Steps
- Client SDK API Reference - Full API documentation for all methods, events, and room operations
- State Synchronization - Understanding Schema definitions
- Room API - Server-side room implementation
Construct 3
Defold
GameMaker