Skip to content

htdt/godogen / skills/engine-guide

engine-guide

Verified

Building on Godot 4 (C# or GDScript), Bevy, Babylon.js, three.js or HTML: which to choose, installing its toolchain, the project sketch, build commands, headless capture to screenshots and video, and the traps that fail silently. Use when starting or working on a game, a video made in an engine (presentation, explainer, trailer, product showcase), an interactive 3D or 2D page, or anything else built on one of these engines.

FileKindSize
SKILL.mdskill md5.0 KB
babylon.mdmarkdown2.8 KB
bevy.mdmarkdown4.0 KB
godot-gdscript.mdmarkdown6.5 KB
godot.mdmarkdown5.7 KB
html.mdmarkdown3.0 KB
setup.mdmarkdown3.0 KB
threejs.mdmarkdown3.7 KB
# HTML engine guide

Stack: **DOM + CSS + TypeScript**, **Vite**, Node (current LTS), with `<canvas>` and **three.js** wherever motion or a scene makes the game better. No UI framework: the page is the game. Made for 2D games built around text and UI — interactive fiction, card and board games, roguelikes on a character grid, puzzles, management and incremental games.

## Project shape

Scaffold a plain Vite + TS project (`npm create vite@latest . -- --template vanilla-ts`), then:

- One game-state object is the source of truth; rules are functions of state, and a `render()` brings the DOM up to date after every action.
- Fonts are self-hosted (`@fontsource/<name>`), the palette lives in CSS variables, and generated images (portraits, card art, backdrops) live under `src/assets/`, imported through Vite.
- Text and controls are DOM; animation and interactive elements can be canvas or three.js layered with it — don't limit the look to plain HTML.
- Build for the device the user plays on — the one the brief names, else a desktop browser — and make it look its best there: a rich page on that device beats a plain one that runs on any old phone.

Commands: `npm install` · `npm run dev` · `npm run build`.

**Bind the dev server to `0.0.0.0` on a fixed port** (`server: { host: true, port: 5173 }`) so `http://<host>:5173` is reachable from other machines on the LAN or through a tunnel.

## Quirks worth knowing (silent-failure)

- **Every edit reloads the page** and resets the game the user is in the middle of. Autosave state to `localStorage` after each action and restore on load. Version the save and discard a mismatched one — an old save loaded into a new state shape throws, and looks like a new bug. `?new` starts clean and `?seed=N` fixes the RNG.
- **Rewriting `innerHTML` destroys what lived there**: a text input's focus and caret, a log's scroll position, running transitions, listeners on children. Keep the command line and the scrolling log outside the re-rendered region (append to the log), and handle clicks by delegation on a stable parent.
- **Headless Chrome renders WebGL in software** (SwiftShader), slowly or blank, so a three.js layer can be missing from a capture and fine in a browser. On Linux run under `xvfb-run` with `--use-angle=vulkan`, and read the WebGL `RENDERER` string before trusting the shot.
- **Glyph fallback.** A character missing from the font is drawn from whatever system font has it, at its own width — a character grid drifts out of line, and a machine without an emoji font draws emoji as empty boxes. Pick a monospace font that covers the glyph set (box drawing, arrows, suits) and keep emoji out of grids.
- **Hidden tabs stall time.** `requestAnimationFrame` stops and timers drop to about once a second in a background tab. Compute idle and real-time progress from elapsed wall-clock time, not from tick counts.
- **Sound needs a gesture.** An `AudioContext` created before the first click or key stays suspended, and `play()` rejects, with only a console warning. Resume it in the first input handler.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall