SKILL

edgegap-colyseus

Colyseus + Edgegap: host a Colyseus (Node.js) multiplayer game on Edgegap with one dedicated server per match, near its players, that stops itself, end to end. Load this before using any Edgegap MCP tool on a Colyseus project (colyseus or @colyseus/* in package.json, Room classes with onJoin/onLeave, defineServer, app.config.ts, colyseus.js, @colyseus/sdk, the Colyseus Unity, Godot, Cocos Creator, Defold, GameMaker or Haxe SDKs). It has templates verified on Edgegap: a lifecycle module (self-stop on no join, empty server or match end), a Dockerfile, the WS + TLS Upgrade app version, a direct deploy script, a matchmaker config, and matchmaker clients for browser JS/TS, Cocos Creator, Unity and Godot, plus the pitfalls: 502 on a fresh server, wss by FQDN, CORS origins, exposed playground. Use for "host my Colyseus server", "Colyseus on Edgegap", "replace Colyseus Cloud", "one server per match", "Find Match with Colyseus", or debugging Colyseus deployments. Manus games: edgegap-manus.

Target: Target not categorized. Automatically collected · unverified.

Excerpt from the author’s documentation

Extracted from a fixed version of SKILL.md in its original language. This is the author’s documentation; installation, compatibility and runtime results have not been verified by this site.

Read the original English text

Topics in the source

  • Edgegap for Colyseus games: one server per match
  • How to work
  • Phase 0: Understand the project
  • Phase 1: Server changes, local
  • Phase 2: Image, app version, one direct deployment
  • Phase 3: Matchmaker
  • Phase 4: Clients
  • Phase 5: End-to-end test and hand-off

Goal: each match gets its own Colyseus server on Edgegap, placed near its players. Players reach it directly (a URL from a script or the developer's backend) or through Edgegap's matchmaker (click Play, get matched, connect), over wss:// .pr.edgegap.net: , and the server stops its own deployment when the match is over. Done means two real clients played on one Edgegap deployment and it stopped itself afterwards, not that the image builds. This path was run end to end on Edgegap on 2026-10-20 with edgegap/backend-game-sample-threejs-colyseus-tanks, a fork of Colyseus's official tanks demo (Colyseus 0.17, one server, 9 clients; guide in its edgegap/README.md). Verified: the Colyseus matchmake HTTP request and the room WebSocket both go through one WS port with TLS Upgrade; direct mode with Node and Godot desktop clients; matchmaker 3.3.2 matched a Three.js browser client with a Godot desktop client, then with a Unity Windows build; the server stopped itself each time. On 2026-10-29 the same templates ran with a Cocos Creator 3.8.8 web build: edgegap/backend-game-sample-cocos-colyseus-tictactoe, a fork of Colyseus's Cocos tic-tac-toe demo upgraded from Colyseus 0.14 to 0.17, matched w

This is an excerpt. Refer to the complete source and its current requirements.

Source repository
edgegap/llm-agent-skills
Source file
skills/edgegap-colyseus/SKILL.md
Fixed revision
fd510ba826ea29ab359e70e185d2e650ef6827de
Read the complete original documentation ↗

Sources and evidence

This record was collected automatically. Its documentation, suitability and runtime behavior have not been manually verified.

Author: edgegap/llm-agent-skills · original repository metadata. Documentation review: Not reviewed. Last source check: 2026-11-11T08:01:42.829Z.

Categories are inferred from names, descriptions and paths. They do not establish compatibility.

License and attribution

Apache-2.0. Third-party content and copyright remain with their authors. Refer to the original license and terms.

Original license ↗

Synchronization, copying and user-reported success do not mark a resource as runtime-tested.

Limitations and notes

  • Collecting metadata does not mean this site has installed, adapted, runtime-tested or security-reviewed the resource.