# @moku-labs/game

> A 2D puzzle engine where the game is a graph.

## Overview

`@moku-labs/game` is a 2D puzzle engine where the game is a graph, and the screen is just an
opinion about it. You write small nodes and edge tables. The engine runs them, saves on the edges
and replays the whole game without a screen. It ships no genre rules.

- **The game is a graph.** Flows are edge tables. Nodes are small functions with plain `await`
  bodies. One node is active at a time.
- **State commits only on edges.** A node works on drafts. A node that throws changes nothing.
- **Deterministic by construction.** Time is an input named `now`. Randomness is a saved `rng`
  stream. A lint rule refuses `Date.now` and `Math.random` in game logic.

## Install

```sh
bun add @moku-labs/game pixi.js
```

Bun only, ESM only. `pixi.js` is a peer dependency. Screens are `.tsx`, so a game sets
`"jsxImportSource": "@moku-labs/game"`.

## Quick start

A dice game: one rest node, one working node, one flow. `defineGame` binds the helpers to the
types of the game.

```ts
import { defineGame, type } from "@moku-labs/game";

const { defineNode, defineFlow } = defineGame<{
  player: { coins: number };
  session: { rolls: number };
  assets: string;
  strings: Record<string, unknown>;
}>();

const home = defineNode({ outcomes: { roll: type() }, rest: true, checkpoint: true });

const roll = defineNode({
  outcomes: { done: type() },
  run: ({ player, session, rng, out }) => {
    player.coins += rng.stream("dice").range(1, 6);
    session.rolls += 1;
    return out.done();
  }
});

export const mainFlow = defineFlow("main", {
  nodes: { home, roll },
  start: "home",
  edges: { home: { roll: "roll" }, roll: { done: "home" } }
});
```

1. A rest node: the graph waits here for the player.
2. The drafts commit on this edge.

The game itself is one data object in `index.ts`:

```ts
import { defineGameApp } from "@moku-labs/game/app";
import { mainFlow } from "./flow";

export default defineGameApp({
  flow: mainFlow,
  safeNode: "home",
  player: { coins: 0 },
  session: { rolls: 0 }
});
```

Serve it with hot reload:

```sh
bunx moku-game dev
```

## Start with Claude

Describe what you want. The conductor picks the packages.

```text
Build a blog with tags and an RSS feed on @moku-labs/web
```

```text
Add a D1-backed comments API with @moku-labs/worker
```

```text
Make a couch quiz game: TV shows questions, phones answer
```

```text
Ship this app to macOS and iOS
```


Source: https://moku-labs.com/docs/game/ · @moku-labs/game@0.15.89