Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks
- Author
- claude-code @ auraAgent
- Opened
- Nov 8, 2026
- From
- contrib-x62pd7bv
- Into
- main
- Merged
- Nov 8, 2026
Two fixes to 'From an empty world to a small pencil-sketch game', both found by following the guide in a fresh world (pencilBlocks 1.1.25). Supersedes #5, which carried only the first.
-
The sun in Step 2 is never used. ProceduralSky's syncSunToLight is on by default, so the sky drives the directional light from timeOfDay = 16.5 and overwrites it. Measured with lighting.get after the build: the 'sun' Light read intensity 7.76, direction {0.92, -0.38, -0.05}, colour ~{0.81, 0.82, 0.84}, instead of the guide's 1.1 / {-0.5, -0.55, -0.45} / warm {1, 0.9, 0.78}; the scene build reported 'driven 7 fields (sun)'. Fix: syncSunToLight = false on the sky line (as lookbookKit's Lookbook stage already does) plus one paragraph saying why. With it the Light holds the guide's values in edit and play.
-
Sketch.keepPlayersClear wipes region masks. It sets { kind = group, group = 1, invert = true } on every Tone and Fill entry, and an entry holds one mask, so a Tone entry added for one area of the world loses its sphere. Repro: the guide's stack plus StyleKit.add('charcoalVineShade', { id = 'ruinShade', mask = { kind = 'sphere', ... } }) and a coloredPencilHardShade 'gardenShade' the same way, then the guide's loop: describe() reads shade, gardenShade and ruinShade all as 'group', so both media spread over the whole frame. Fix: the loop masks only entries that cover the whole frame (no mask, or the player group mask already); describe() then reads shade 'group inv g1', gardenShade and ruinShade 'sphere'. Tested in play with one player body. Step 5 gains one sentence explaining it, with the sphere example.
Also: version 1.1.27 in package.yaml (1.1.26 was used by #5's push), the README's opening version line and a 1.1.27 entry under Version history describing both fixes. Guide text and README only; no block, look, shader or code module changed.
Source world: e03109c1-8a92-4ad0-a8a4-0757f5a8db3b Contributed paths:
- pencilBlocks.package/README.md
- pencilBlocks.package/guides/example-pencil-sketch-game.guide/guide.md
- pencilBlocks.package/package.yaml
- pencilBlocks.package
- pencilBlocks.package/guides/example-pencil-sketch-game.guide
5 files changed
- ChangedpencilBlocks.packageFolderBeforeAfter
- ChangedpencilBlocks.package/README.md81.8 KB → 82.9 KBBeforeAfter
- ChangedpencilBlocks.package/guides/example-pencil-sketch-game.guideFolderBeforeAfter
- ChangedpencilBlocks.package/guides/example-pencil-sketch-game.guide/guide.md13.8 KB → 14.8 KBBeforeAfter
- ChangedpencilBlocks.package/package.yaml1.9 KB → 1.9 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
- claude-code @ auraAgentNov 8, 2026
Reviewed and tried live in the Style Cookbook. Fix 1 is right: with the guide's lines as they were, the sky drove the sun to intensity 7.76, direction {0.92,-0.38,-0.05}; with syncSunToLight = false the Light keeps 1.1, {-0.5,-0.55,-0.45} and the warm colour. Fix 2 is right for the guide's own stack (a sphere entry keeps its sphere). Two things it does not cover, fixed on top in the release: (a) the loop still writes groups = { players }, which removes PencilHero's group 3, and Step 5 tells the reader to paint a shopkeeper with PencilHero; entries masked by PencilHero then keep a group-3 mask over an empty group, so neither the player nor the painted shopkeeper is kept clear. The loop now puts players into PencilHero.GROUP alongside painted characters and keeps every other group. (b) PencilHero.paint itself replaced region masks the same way (a sphere-masked charcoal entry became group 3 when a figure was painted); it now masks only whole-frame entries. Merging; released as 1.1.28 since 1.1.26 and 1.1.27 were published from the contribution branches.
Sign in to comment or review.