create-playverse-game

Scaffold a fresh Playverse game project — Vite + Babylon.js + the playverse-makers SDK + a CLAUDE.md already pointed at the SDK's AI guides.

pnpm create playverse-game my-game
# or
npm  create playverse-game my-game
# or
npx  create-playverse-game my-game

cd my-game
pnpm install
pnpm dev
# open http://localhost:5173

Click the canvas to lock the cursor → WASD + mouselook + space.

What you get

my-game/
├── CLAUDE.md             AI bootstrap — points at node_modules/playverse-makers/AGENTS.md
├── README.md             quickstart for humans
├── index.html            canvas + script
├── package.json          playverse-makers + Babylon peers + Havok postinstall
├── tsconfig.json
├── .gitignore
└── src/
    └── main.ts           ~60-line working game (FPS demo)

A playable game in 60 lines, with the AI-readable convention scaffolding already in place.

Options

pnpm create playverse-game [name] [options]

  -f, --force    Scaffold over an existing non-empty directory
  -h, --help     Show usage

If you omit [name] and the terminal is a TTY, you'll be prompted. For non-interactive runs (CI), pass it as the first arg.

Replacing the demo map

src/main.ts ships pointing at a real published Playverse map. Swap MAP_ID for your own (publish a map in the editor → copy its UUID), or load from a URL / async backend / in-memory MapDocument. See node_modules/playverse-makers/AGENTS.md for the full decision tree.

Why a separate create-* package?

Same reason create-vite, create-react-app, create-next-app exist:

• One command (pnpm create playverse-game my-game) end-to-end.
• The scaffolder updates as the SDK evolves — older generated projects are unaffected, but new ones always get the latest layout.
• AI assistants in fresh projects find a CLAUDE.md at the root immediately, no manual copy step.

If you have an existing project and just want the AI bootstrap file, use the SDK's CLI instead:

pnpm add playverse-makers
npx playverse-makers init

Related packages

• playverse-makers — Babylon runtime
• playverse-makers-spec — engine-neutral schema

License

MIT