Log inGet started
World

Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks

Merged

pencilBlocks 1.1.12: suite survives a second run (rebuild collected room materials); lights-off and skipped-case docs

#1
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.