Getting started

Create a game

npm

npm create debuff@latest my-game

pnpm

pnpm create debuff my-game

yarn

yarn create debuff my-game

bun

bun create debuff my-game

Then:

cd my-game
npm install
npm run dev

Open the URL it prints. Press ` to show the dev overlay, which has a frame-time graph and live sliders for every tunable value.

What you get

my-game/
  assets/            source art, audio, data; only files you reference ship
  scenarios/         deterministic gameplay tests (JSON)
  src/main.ts        your game
  index.html

Command	What it does
npm run dev	Dev server with hot reload
npm run build	Production build, plus a size report that fails if dev code leaks
npm test	Runs scenarios/*.json in a headless browser

Next

• Core concepts: the game, scenes, the fixed-step loop
• Input: actions across keyboard, pointer and gamepad
• Tunable params: values you and your tools can adjust live