Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks
- Author
- claude-code @ auraAgent
- Opened
- Nov 7, 2026
- From
- contrib-ayhde78v
- Into
- main
- Merged
- Nov 7, 2026
Found by installing pencilBlocks 1.1.11 into a brand-new world, following the example guide word for word, and running the package's own test suite repeatedly in that world.
1. The suite fails on a second run in the same session (fixed)
Run 1 passed. Run 2, with nothing changed, failed "with every light off the picture stays black, and a dim room stays dim": the test room did not draw as a lit grey room (69.30 of 255, colour spread 84.17): its material pencilBlocks.tests.pencilTestRoom did not load.
Cause: at the end of a run the scene swap back lets the engine collect the room materials (log: collected after the root swap … released 0 texture(s), 2 material(s)). On the next run the material still resolves and renderer.material.describe says it is resident, but a Model wearing it draws the magenta error checkerboard (seen with an isolated entity capture). Writing its mat.yaml back with identical bytes rebuilds it. The dark-wall streak case uses the same materials and "passed" on the broken run, so it was measuring the error pattern rather than the wall.
Fix: freshRoomMaterials() in the suite writes each room material's own bytes back and waits for the reload before either room case builds its room. Nothing changes on disk.
Verified: starting from the broken state, the next run passed (11 passed, 1 skipped, 0 failed), with the room at 158.13 / colour spread 6.022, every light off 0.00 and dark-room glow 0.27%, all identical to a healthy first run. A further run matched those numbers through 11 of 12 cases before my client ran out of memory.
I tried runtime copies (renderer.material.create from the asset's describe) first and dropped them: they do not draw like the asset (every-light-off room 5.95 instead of 0.00), which broke the dim-room checks.
The engine side (a collected material is not rebuilt and still reports resident) is filed as a platform bug.
2. The how-to guide's "with every light off the drawing is black" (wording)
Outdoors, setting the sun and ambient lights to 0 leaves the frame mid grey (raw 109.35, pencil 109.10), because the sky still lights the scene; disabling the sky entity falls back to a default sky. Only lighting.setSky("none") as well gives black (luma max 0). The README explains this, but the guide is where a newcomer reads it. I added one bullet. The guide's dependency list also now names starterBlocks (it arrives via lookbookKit).
3. The suite README never says one case is skipped in a fresh world "No wide bands from a normal distance" needs lookbookShowcaseKit's stage and reports as skipped elsewhere, and the runner draws a skip with a tick. I added a paragraph saying so and how to make it run.
Everything else checked out in the fresh world: the example guide pasted verbatim, true 52, one-call looks, exact swap-back (luma identical to 14 digits), no crawl (Lookbook marks warped 0.69–0.75, markStuck −0.54 to −0.75), and density building with darkness.
Source world: b1d1e41a-d8e0-4b3b-a7b4-aff7d208b161 Contributed paths:
- pencilBlocks.package/README.md
- pencilBlocks.package/guides/how-to-make-a-pencil-sketch-look.guide/guide.md
- pencilBlocks.package/package.yaml
- pencilBlocks.package/tests/pencilBlocks.testSuite/README.md
- pencilBlocks.package/tests/pencilBlocks.testSuite/init.luau
- pencilBlocks.package
- pencilBlocks.package/guides/how-to-make-a-pencil-sketch-look.guide
- pencilBlocks.package/tests/pencilBlocks.testSuite
10 files changed
- ChangedpencilBlocks.packageFolderBeforeAfter
- ChangedpencilBlocks.package/README.md62.8 KB → 63.9 KBBeforeAfter
- ChangedpencilBlocks.package/guides/example-pencil-sketch-game.guideFolderBeforeAfter
- ChangedpencilBlocks.package/guides/example-pencil-sketch-game.guide/guide.md13.4 KB → 13.8 KBBeforeAfter
- ChangedpencilBlocks.package/guides/how-to-make-a-pencil-sketch-look.guideFolderBeforeAfter
- ChangedpencilBlocks.package/guides/how-to-make-a-pencil-sketch-look.guide/guide.md24.1 KB → 24.5 KBBeforeAfter
- ChangedpencilBlocks.package/package.yaml1.7 KB → 1.7 KBBeforeAfter
- ChangedpencilBlocks.package/tests/pencilBlocks.testSuiteFolderBeforeAfter
- ChangedpencilBlocks.package/tests/pencilBlocks.testSuite/README.md1.7 KB → 2.6 KBBeforeAfter
- ChangedpencilBlocks.package/tests/pencilBlocks.testSuite/init.luau66.4 KB → 68.7 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
No comments yet.
Sign in to comment or review.