Lantern Depths: Find the Shade Dash, Slay the Thorn Knight
README.md
looks (module)
The whole-frame art style of each sideScrollerKit theme, as a styleKit stack of published look blocks from the Style Cookbook, swapped by the same theme word as the gates, saves, map and transitions.
Looks.apply(id): one synced change that puts a look on the scene's StyleStack (a look id, a theme id,"theme", or"none"to clear). Safe to call again. Refuses a look whose blocks are not installed and names them.Looks.follow(): swap the stack on every theme change (the Metroidvania component calls it when play starts).Looks.setOverride(id): keep one look whatever the theme (MV.world({ look = ... }));"theme"follows the theme,"none"leaves the scene's own stack alone.Looks.byId: the stacks, editable beforefollow();Looks.ART_PIXELis the art's pixel size in reference pixels (5).
| look | blocks (package) |
|---|---|
| pixel | ditherPalette (sideScrollerKit), chunkyPixels on the art grid, vignette (starterBlocks) |
| fantasy | inkNibLine in brown ink (inkBlocks), paperParchment 0.3 (paperBlocks), warm vignette, softGrain (starterBlocks) |
| scifi | crtScanlines (sideScrollerKit), cool vignette, softGrain (starterBlocks) |
| cartoon | celFill (toonBlocks), bold depthLine (styleKit) |
| minimal | celPoster, calm colour (toonBlocks) |
| gothic | inkPool, inkPenLine (inkBlocks), duotone bone and crimson-black (styleKit), heavy vignette, softGrain (starterBlocks) |
How the blocks treat a twoDKit scene: sprites, tiles and particles are alpha cards that write no depth, so depth lines (depthLine, inkPenLine, inkNibLine) ink only the painted parallax silhouettes and never trace the player or a sprite's rectangle. Mesh-hull lines (toonOutline, toonFarLine, toonSticker) draw nothing on cards, so no look uses them. The kit keeps its own two blocks only where nothing published does the job: ditherPalette (an ordered Bayer dither to a small palette) and crtScanlines (CRT beam lines, phosphor stripe and bloom).
The first swap to a look in a session shows a blank frame for about a second while the engine builds that look's shaders; later swaps to it are instant.
Needs styleKit, starterBlocks, toonBlocks, inkBlocks and paperBlocks (package dependencies). The kit's own blocks live in blocks/ and register on install. Screen UI is drawn after the stack and never touched. Undo: Looks.apply("none") or StyleKit.clear().