@loonylabs/create-game

Scaffold a complete game project in one command.

Usage

npx @loonylabs/create-game <game-name> <target-dir>

Example:

npx @loonylabs/create-game my-game ./my-game
cd my-game
pnpm install
pnpm dev

Then open http://localhost:3200 in your browser.

What gets created

my-game/
├── apps/
│   ├── client/        — Three.js + Svelte frontend
│   ├── server/
│   │   └── src/
│   │       ├── index.ts        — experience registration (~30 lines)
│   │       └── db/
│   │           ├── client.ts   — DB setup (generic)
│   │           └── schema.ts   — your game schema (fill in here)
│   ├── experiences/   — Diablo, Shooter, Runner, Oil as reference implementations
│   └── game-data/     — your game content (enemies, rooms, items, areas)
└── .claude/
    └── skills/        — AI workflow skills + primitive behavior docs

No framework internals in apps/server/src/ — all server logic lives in compiled @loonylabs/* packages.

What you write

1. apps/experiences/my-game/manifest.ts — pure data, no logic
2. apps/client/src/experiences/my-game/handler.ts — browser rendering
3. Register in apps/server/src/index.ts:

import { createExperienceFromManifest, createManifestExperience } from '@loonylabs/gamedev-server';
import { myManifest } from '../../experiences/my-game/manifest.js';

// No persistence:
experienceManager.register(createExperienceFromManifest(myManifest));

// With player + world persistence:
experienceManager.register(createManifestExperience(myManifest, db));

AI-native workflow

Once your project is set up, open it in Claude Code and run:

/aigdtk-new-game

This starts an AI conversation that designs your game, generates stories, and implements them — using the loonylabs framework as the foundation. Primitive behavior docs are co-located in .claude/skills/aigdtk-shared/primitives/ for targeted context loading.

Part of the loonylabs gamedev toolkit

| Package | Role | |---|---| | @loonylabs/gamedev-core | ECS, physics, dungeon gen | | @loonylabs/gamedev-client | Three.js renderer, cameras, input | | @loonylabs/gamedev-server | Tick loop, session management, DB, manifest persistence | | @loonylabs/gamedev-protocol | Zod network schemas | | @loonylabs/create-game | ← you are here |