create-kei-game

Scaffolds a browser game with a real currency, real items, and a wallet the player owns.

npm create kei-game

It asks what the project is called and what the currency is called, writes a working game, and exits.

npm create kei-game star-clicker -- --currency "Gold Pieces"
bun create kei-game star-clicker --currency "Gold Pieces"

| Option | | |---|---| | --template <name> | Which game to start from. Default: star-clicker | | --currency <name> | What the in-game currency is called. Default: Coins | | --yes, -y | Take the defaults and ask nothing. For CI and agents. | | --force | Write into a directory that already has files in it. | | --help, -h | The above. |

The three templates

| | | |---|---| | star-clicker | A 3D scene, a currency, and an item you buy for a fraction of a cent. Ten files, single-player. The default, and the one to read first. | | world-of-wonder | A multiplayer 3D RPG whose gold and items are on the chain — Babylon.js and Colyseus, with movement, combat, quests, a navmesh, a vendor, and a bag. Forked from orion3dgames/t5c. | | carpet-markets | A coin launchpad where whether a coin can be rugged is not a promise but the deed's transfer policy, chosen at launch and enforced by consensus. |

npm create kei-game my-mmo -- --template world-of-wonder --currency "Shards"

star-clicker is written from inside this package. The other two are whole example projects that live in their own repositories and are downloaded when you ask for one — a 30MB tarball of .glb models has no business inside a scaffolder most people run to get a star and a button. That is the only difference; what lands on disk is yours either way.

Downloading means --template world-of-wonder and --template carpet-markets need a network. star-clicker, the default, does not.

What star-clicker writes

star-clicker/
├── .gitignore
├── README.md
├── src/economy.ts     every line of Kei in the browser
├── src/world.ts       the Babylon.js scene — knows nothing about Kei
├── src/main.ts        joins the two
├── server/game.ts     the whole backend: issues the currency, sells the item
├── server/orders.ts   payment-hash write-ahead log and restart recovery
├── server/main.ts     bun run dev — node, issuer, and client in one process
├── shared/game.ts     the price list
├── index.html
├── package.json
└── tsconfig.json      strict type-check for the emitted project

cd star-clicker
bun install
bun run dev

Two prompts, and no more

Every question a scaffolder asks is a decision the developer has to make before they have any information with which to make it. So this one asks about the project and the currency, and decides the rest:

• The renderer is Babylon.js, and src/world.ts documents how to replace it. The SDK is framework-agnostic; the game does its own rendering.
• The ticker is derived from the currency name — Gold Pieces becomes GOLD — and printed before anything is written.
• star-clicker is single-player, because a game that is only fun when someone else is online is the wrong thing to start from. Reach for world-of-wonder when multiplayer is the point rather than a step.

The template is a flag rather than a fourth prompt for the same reason. Someone who does not know they want an MMO wants the default, and someone who does knows it before they type the command.

carpet-markets is asked one question, not two: it has no currency of its own, because every coin on it is launched by a player at runtime.

It is not a framework

The generated project does not import this package, does not depend on it, and does not know it exists. Delete create-kei-game from your machine and the game still builds and still runs — that is the test, and it has one.

It has a harder one too: bun test writes the project out, imports both halves, and buys the item, so an SDK change that breaks the emitted code fails here rather than in somebody's brand-new project.

The downloaded templates get a strict version of the same treatment. Renaming one has to find the project's name, its currency, and its README exactly where it expects them, and fails loudly when it does not — so a drift in either of those repositories breaks a test here, rather than quietly scaffolding a project that still calls itself world-of-wonder and still pays in Gold.

This package installs nothing of its own, either — not even to unpack a tarball. It is a program that writes files, and the first thing you wait for is your game's dependencies.

Part of kei-transaction. SPEC §11.3.