paperWorld

Put an existing world, scene or installed kit on paper with paperBlocks and styleKit, and leave it undoable.

What it does

1. Survey. Reads the scene's stack exactly as it is (every entry with its id, block, strength, on, mask and settings, and the stack options), finds its Ground entry if it has one, and lists the lights (is there a sun, is it low), the screen UI, the world labels, the characters and the colours that carry gameplay meaning. The recorded stack is the undo.
2. Choose. Picks one of the seventeen papers from the reference picture (when one is given) or the asker's words, with the reason, what the paper needs from the scene's light, and the settings to start from. On a toned or dark sheet it says honestly what happens: a white paper's lights become put-on gouache, chalk or white ink, and transparent washes on a blackboard or black paper become chalk or white ink.
3. Apply. In one call: StyleKit.swap(<the Ground entry>, <paper>) when the stack has a Ground block (strength and mask stay, and the entry remembers the old paper's settings), or StyleKit.add(<paper>, { id = "paper" }) when it has none.
4. Tune. At most two rounds of StyleKit.set on the paper's shared settings (tooth, thirst, lights, sheen, mottle, dust) against the reference and the scene's light, on presented frames.
5. Check. Screen UI and world labels readable over the palest and darkest parts of the sheet, characters and gameplay colours still read, black stays black with the lights off, the low tier, and the Lookbook's numbers for the stack before and after when lookbookKit is installed (it says so when it is not).
6. Report. The paper chosen and why, the stack before and after, every setting changed, the checks, the numbers, and the undo.

Undo. Nothing outside the stack is changed. When the paper was swapped in, StyleKit.swap(<entry>, <old paper>) puts the old paper back with exactly its settings (styleKit 1.2.0 swap memory), and the frame returns as it was. When it was added, StyleKit.remove("paper") takes it off. The report also carries the full StyleKit.load(...) call of the stack from before the run, which restores everything regardless of what happened since.

What it needs

paperBlocks installed (it brings styleKit 1.2.0). watercolorBlocks and inkBlocks are optional: their bleed, rims and ink lines read the paper's thirst and dark ground when they are in the stack. The Lookbook check uses lookbookKit when the world has it.

Starting it

zero workflow start --name paperWorld --args '{"subject":"main","paper":"brown kraft with white gouache highlights"}'

subject names the world, scene or kit (default: the loaded scene); paper is the paper in the asker's words or a block id (default: the run proposes one); reference is an optional path to a reference picture.