๐ŸŽฎ Games

Funday games live under /home/usr/funday/games/{id}/ and are discovered from each gameโ€™s funday-plugin.json manifest.

Inventory summary

CategoryCountMeaning
Production-ready35Plugin + renderable entry + server/backend where required
Partial11Plugin exists but one or more required pieces are missing or gated
Frontend-only27Playable/renderable without dedicated Nakama match backend
Scaffolds/templates8Platform folders and templates, not catalog games
Unregistered1One current non-artifact directory lacks a manifest: groy/
Total directories82Current matrix total

Source of truth: /home/usr/funday/docs/game-completion-matrix.md.

GameStatusTypePlayersNotes
MusicQuizโœ… LiveStatic iframe / websim port1โ€“8Practice mode + Arena relay, bridge, leaderboard notes
Sister Brawl๐Ÿ”ง In developmentSvelte component + Nakama match2โ€“8Architecture, solo mode, audit trail
Test Game๐Ÿงช Template/referenceSvelteโ€”Minimal docs placeholder

Integration types

TypeMountBridge
svelte-componentNative Svelte component in the host shellplatformBus props/store
iframe-themeableClient-side iframepostMessage via Funday bridge
dedicated-serveriframe plus game-server backend/proxypostMessage + REST/server bridge

Add or update a game

  1. Keep all game code inside games/{id}/.
  2. Update funday-plugin.json.
  3. Validate with node scripts/validate-game-manifest.mjs <id>.
  4. If multiplayer, register the match handler in nakama-modules/ and map it in games/_platform/server/game_registry.ts.
  5. Update docs/game-completion-matrix.md and this page when status changes.