CLI & AI toolsCommand reference
helix bake-lighting
Bake a world's keyframed lighting field from its BUILT bundle (headless, minutes) and point its visual contract at the artifact
CLI version 0.1.27-helix3.551. Run
helix bake-lighting --help for the text your installed build prints.helix bake-lighting
Bake a world's keyframed lighting field from its BUILT bundle (headless, minutes) and point its visual contract at the artifact
helix bake-lighting [options] <directory>| Argument | Required | Description |
|---|---|---|
directory | yes | the world directory to bake — its built bundle is baked, its source contract patched |
| Option | Description |
|---|---|
--keys <n> | sun keyframes to capture; omitted, the engine plans them — ONE for a static sun (cycleSeconds 0), 9 for a cycle |
--timeout <s> | boot budget in seconds; omitted, scales with the bundle size (20 s/MiB, floor 300) |
--gpu | bake on the machine's GPU through a system Chrome/Edge instead of the bundled SwiftShader build — 5-10x faster, not bit-reproducible across machines |
--packed | write the PACKED field (float16, coarse level first, content-addressed, with a phone tier) and a version 2 pointer instead of the JSON store — about 1/80 the size; plays only on a visual runtime that reads version 2 |