create-threejs-game

create-threejs-game

Scaffold a Three.js game project with AI-assisted design documents.

Prerequisites

Before running the CLI, have these ready:

1. 3D Assets (Required)

Download GLTF asset packs from:

• itch.io
• Kenney.nl
• Quaternius

The CLI will ask for the path to your downloaded assets folder and validate it contains .gltf or .glb files.

Multi-Pack Support: You can combine multiple asset packs by organizing them in subdirectories (nested to any depth):

my-assets/
├── characters/
│   ├── humans/        # Has Preview.jpg
│   └── monsters/      # Has Preview.jpg
├── buildings/         # Has Preview.jpg
└── environment/
    ├── trees/         # Has Preview.jpg
    └── rocks/         # Has Preview.jpg

The CLI recursively finds all directories with previews and combines them into a single grid.

2. Preview Image (Auto-generated for multi-packs)

Most asset packs include a Preview.jpg. For multi-pack directories, the CLI automatically combines all subdirectory previews into one image. For single packs without a preview, take a screenshot of your assets.

3. API Keys (Required for automation)

Set these as environment variables for the smoothest experience:

export GOOGLE_API_KEY="your-key"      # or GOOGLE_AI_STUDIO_API_KEY
export ANTHROPIC_API_KEY="your-key"

Get keys from:

• Google AI Studio - free tier available
• Anthropic Console

If not set, the CLI will prompt for them.

Quick Start

npx create-threejs-game

The CLI will:

• Ask for your project name
• Ask for a game description (1-3 sentences describing your game)
• Check for API keys (from env vars, or prompt if missing)
• Ask for path to your assets folder (required for automation)
• Validate everything and tell you if anything is missing
• Create your project with assets copied in

Then run the automation:

cd my-game
node scripts/pipeline.js

What Gets Generated

The automation pipeline creates:

Step	Output	AI Service
Asset Index	public/assets/{game}/assets.json	Local script
Concept Mockup	public/{game}/concept.jpg	Google AI Studio
PRD	docs/prd.md	Claude (Anthropic)
TDD	docs/tdd.md	Claude (Anthropic)
Execution Plan	plans/plan.md	Claude (Anthropic)

Project Structure

my-game/
├── .claude/skills/      # Three.js skills for Claude
├── .codex/skills/       # Three.js skills for Codex
├── docs/                # Generated PRD and TDD
├── plans/               # Generated implementation plans
├── prompts/             # Prompt templates (fallback/reference)
├── public/
│   ├── {game}/
│   │   └── concept.jpg  # Generated mockup
│   └── assets/{game}/   # Your 3D assets (copied by CLI)
├── scripts/
│   ├── config.json      # API keys and game config
│   ├── pipeline.js      # Run full automation
│   └── generate-*.js    # Individual generators
└── README.md

Final Step

After the pipeline completes, open your project in Claude Code or Cursor and follow the generated execution plan:

Please proceed with implementing based on the plan in plans/plan.md

Requirements

• Node.js 18+
• API keys (see Prerequisites)
• 3D assets in GLTF format

License

MIT