@moku-labs/room

Overview

@moku-labs/room is a Moku framework for local multiplayer. A shared screen hosts the game state, phones join by scanning a QR code, and everything flows over direct WebRTC DataChannels on the LAN. No accounts, no lobby servers, no relay for gameplay.

• Couch multiplayer, no server. One shared screen hosts. Phones join by QR and talk to it directly over WebRTC.
• The host owns the truth. The stage validates controller intents, owns the game state and sends snapshots and deltas back. Phones render a read-only replica.
• Two planes, never crossed. Gameplay rides the typed wire. Only coarse room:* lifecycle rides Moku events.

Install

bun add @moku-labs/room @moku-labs/core @moku-labs/common

Quick start

The stage is the shared screen. Add the host facade stagePlugin and a game plugin that depends on it, so the room:* events are typed in its hooks.

import { createApp, createPlugin, inMemory, stagePlugin } from "@moku-labs/room";

const gamePlugin = createPlugin("game", {
  depends: [stagePlugin],
  hooks: ctx => ({
    "room:peer-joined": ({ peerId }) => ctx.log.info("game:joined", { peerId }),
    "room:network-warning": ({ reason }) => ctx.log.warn("game:network", { reason })
  })
});

const app = createApp({
  plugins: [stagePlugin, gamePlugin],
  pluginConfigs: { transport: { signaling: inMemory(), iceServers: [] } }
});
await app.start();

const { code, joinUrl } = app.stage.createRoom();
console.log(`Join ${code} at ${joinUrl}`);

app.stage.onIntent("score", (_payload, peerId) => {
  app.stage.mutate("scores", draft => ({ ...draft, [peerId]: Number(draft[peerId] ?? 0) + 1 }));
});

A phone is the same framework with controllerPlugin: await app.controller.joinRoom(code), then app.controller.intent("score", {}).

Start with Claude

Describe what you want. The conductor picks the packages.