Log inGet started
World

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

README.md

paperBlocks

Put your game on paper: seventeen papers a stylized look is drawn on, from cold-press watercolor paper and thirsty rice paper to brown kraft, parchment, canvas, a dusty blackboard and black paper for white ink. Each paper is a styleKit Ground block, so it swaps for any other paper in one change, stays on the surfaces it covers while the camera moves, and lets the blocks above it feel it: washes granulate into its tooth and run further on a thirsty sheet, ink lines break on rough grain and feather on soft fibres, and on toned and dark sheets the picture's lights are put on in white gouache, chalk or white ink. Parts of one world can sit on different papers (a village on cold press, a map room on parchment), and every player sees the same paper.

Version 1.2.3. Built on styleKit 1.7.8 (style channels: how much paper shows through on each object).

Install and use

Install paperBlocks from ZeroMind (search "paperBlocks" or "paper texture for a watercolor game"). It brings what its own files use, and nothing needs installing by hand: styleKit (the look stack its shaders build on), and lookbookKit with starterBlocks (the package's test suite measures at the Lookbook's every-light-off moment, and the Lookbook uses starterBlocks' blocks). It does not bring watercolorBlocks or inkBlocks: those are separate installs, and the papers work without them. Checked on 2026-11-01 by installing paperBlocks from ZeroMind into a brand new private world: 617 files in about 3 s, and the example below ran there line by line exactly as written (the frame changed on load, kraft read clearly differently, swapping back brought cold press back with its deeper tooth, and clear() returned the frame to exactly its unstyled brightness). Installs with several dependencies can be slow (#21420): give the install time to finish and check /zero/source for the paperBlocks.package folder.

Then, in a fresh world with only paperBlocks installed, from the console or any script:

local StyleKit = require("~styleKit.StyleKit")

StyleKit.load({
    { id = "line",  block = "depthLine" },          -- styleKit's own clean ink outline
    { id = "paper", block = "paperColdPress" },     -- the picture laid on cold-press paper
})
StyleKit.set("paper", { toothHeight = 1 })          -- a deeper tooth: one change
StyleKit.swap("paper", "paperKraft")                -- the same picture on brown kraft, lights in white gouache
StyleKit.swap("paper", "paperColdPress")            -- back on cold press, with the deeper tooth it had
StyleKit.clear()                                    -- the frame exactly as rendered again

Swapping back puts back exactly the settings the paper had (styleKit 1.2.0 remembers them on the entry), so the frame returns as it was. The stack lives on the scene's synced StyleStack, so every player sees the same paper, and it is saved with the scene.

To see what is installed: StyleKit.blocks({ package = "paperBlocks" }), or in the shell zero styleKit list ground and zero styleKit list --tag paper.

The papers

Every paper is the same paper model with its own defaults, so a setting means the same thing on every paper and a paper you tuned on one block carries its meaning to another. "Lights" says what the paper needs from the picture's light: on a white sheet the lights are bare paper; on a toned or dark sheet they are put on in an opaque light, which only shows where the scene really is lit.

PaperBlockCharacterBest forWhat lights need
Cold presspaperColdPressWarm white, a rough felt tooth, the standard thirst the watercolor and ink blocks were tuned on.Watercolor, line and wash, picture books: the default sheet.Nothing special: lights are bare paper.
RoughpaperRoughThe deepest, largest tooth, warm white, a little thirstier.Loose washes full of granulation, broken dry brush, scratchy lines.A low sun across surfaces shows the tooth most.
Hot presspaperHotPressSmooth, almost no tooth, crisp white, hard-sized.Crisp washes with hard edges and dark dried rims, exact ink lines, botanical and technical illustration.Nothing special.
Rice paperpaperRiceThin and soft with long visible fibres, very thirsty.Ink wash painting, soft washes that feather, lines that bleed along the fibres.Nothing special.
NewsprintpaperNewsprintGrey-cream, a little yellowed, a fine flat grain and darker fibres, thirsty.Zines, cheap comics, fuzzy print-like ink.The sheet's grey-cream is the lightest light.
KraftpaperKraftBrown, fibrous, a mid-tone ground.Toned sketches, crafts and cardboard, gouache highlights.A clear lit side: lights are put on in white gouache only where the picture is brighter than about halfway from the brown to white. A flat, dim scene stays brown.
ParchmentpaperParchmentWarm cream, strongly blotchy, a few age spots, a soft sheen, fairly hard-sized.Old maps, documents, scrolls, a map room.The sheen shows only where light reaches a surface, most under raking light.
CanvaspaperCanvasPrimed canvas: a plain weave of threads under everything.Painterly looks; a weave showing through paint and line.Raking light shows the weave.
Illustration boardpaperBoardHard, smooth, bright and even.Clean comic ink, controlled washes, graphic looks.Nothing special.
BlackboardpaperBlackboardDark slate with sharp grit, chalk dust and the ghosts of old wiping, very hard-sized, dead matte.Chalk drawings, classrooms, puzzle rooms, night sketches.The picture is made of chalk: only lit things are drawn. A dark scene is bare board.
Green chalkboardpaperGreenChalkboardA green school board, dustier than the slate.The same as the blackboard, friendlier and more schoolroom.As the blackboard.
Black paperpaperBlackNear-black with a soft tooth.White ink drawings, silhouettes, night.The picture is drawn in white ink: only lit things are drawn.
Aged sketchbookpaperSketchbookYellowed, mottled, foxed with brown age spots that show through the paint.Travel journals, old sketchbooks, memories.Nothing special: lights are the yellowed sheet.
Toned greypaperTonedGreyA mid-grey drawing paper.Toned drawings: darks laid in, highlights in white chalk and gouache.Lights are put on in white from about 40% of the way from the grey to white; the values between stay bare grey, the middle tone.
Toned tanpaperTonedTanA warm tan drawing paper.Warm toned drawings with white highlights.As toned grey.
Ruled notebookpaperNotebookSmooth bright paper with pale blue rules, a little thirsty.Doodles, school-book and diary looks.Nothing special; the rules show through every wash.
VellumpaperVellumCool cream, a cloudy formation, a satin sheen, very hard-sized.Drafting and technical looks, washes that pool on top with hard edges.The sheen needs light on the surface.

How the papers change watercolor and ink blocks, paper by paper, is in the guide "How paper changes watercolor and ink"; how to pick and tune one is in "How to choose a paper for my art style".

Whole looks

Three looks made only of paperBlocks' papers and the blocks it brings (styleKit's and starterBlocks'), each on in one call:

LookWhat it is
paperCutoutGame (Paper cutout game)Card on kraft: matte card surfaces, two flat light bands, flat colour and a white die-cut border round every object. styleRoles' paper cutout set is made for it.
chalkboardLesson (Chalkboard lesson)A lesson in chalk: a few flat tones, a bold white chalk line, lights put on in chalk, on a dusty blackboard.
parchmentMap (Parchment map)An old map or a quest journal: sepia and cream inks, soft light bands and a brown ink line, on parchment.
require("~styleKit.StyleKit").applyLook("chalkboardLesson")

The shared settings

Every paper takes the same settings (each paper starts from its own defaults; StyleKit.settingsOf("paperKraft") lists them with that paper's defaults and the ranges). Change them with StyleKit.set(entry, { name = value }); colours take "#rrggbb".

SettingRangeWhat it does
tintcolourThe sheet's colour. On a white paper the bright areas become this colour; on a toned or dark sheet it is the ground the darks sink into and the lights are put on over.
toothHeight0 to 1How tall the tooth is: how much it shades the sheet, how deep paint settles into it, and how strongly granulation, dry brush and ink lines feel it.
toothSharpness0 to 10 soft rounded felt bumps, 1 sharp grit. Sharp grit makes put-on lights catch the peaks first (chalk on slate).
toothSize1 to 40How large one tooth looks, in reference pixels (1080p). It keeps about this size at any distance.
fibre, fibreLength, fibreTone0 to 1, 1 to 30, -1 to 1How many long fibres show, how long they are (in teeth), and whether they read lighter (above 0) or darker (below 0) than the sheet.
weave0 to 1How much canvas weave replaces the tooth.
mottle0 to 1How blotchy and uneven the sheet's tone is (warmer where darker).
foxing0 to 1How many brown age spots the sheet carries.
rule, ruleColour, ruleSpacing0 to 1, colour, 8 to 200Ruled lines: how strongly they show, their colour, and their spacing in reference pixels.
thirst0 to 1How thirsty the sheet is: 0 hard-sized (crisp wash edges, dark dried rims, exact lines), 0.5 the standard sheet the watercolor and ink blocks were tuned on (nothing changes), 1 thirsty (washes spread and feather, lines bleed into the fibres). Felt only by blocks that read the paper field.
emboss0 to 1How strongly the tooth catches light, strongest where the scene's sun rakes low across a surface.
sheen0 to 1How much the sheet shines where light reaches it. Sheen is light the scene sends: none where there is none.
lights0 to 1How much of the picture's light can be put on in an opaque light (gouache, chalk, white ink) instead of being left as bare sheet. 0 for white papers. Any amount above about 0.25 makes the sheet a toned ground (the darks sink into it) and the value is then the most light put on: the boards use 0.6, so a chalk drawing stays marks over slate even where the scene is brightest.
lightColour, lightTintcolour, 0 to 1The colour of the put-on lights, and how much of the picture's own colour they keep.
lightsFrom0 to 1Where lights start being put on, as a share of the way from the sheet's value to white: 0 everything lighter than the sheet, toward 1 only the brightest lights.
dust0 to 1Chalk dust and the ghosts of old wiping on a board.

How a paper draws

  • Darks go into the sheet as transparent media: multiplied onto the sheet's colour and settling into the valleys of its tooth, thinner on its peaks.
  • Lights are put on on toned and dark sheets (lights above 0), from lightsFrom of the way between the sheet's value and white; on sharp grain they catch the tooth's peaks first, on soft grain they lie more evenly.
  • The tooth is lit by the scene's sun (the first directional light, read every few frames and written again whenever the paper's shader compiles), so a low raking sun shows it most, plus a little relief from the upper left as a sheet reads on a table.
  • Everything sits on surfaces and keeps its size in the picture: the tooth, fibres, blotches, spots and rules are laid on world position, so they stay on things under a pan, a dolly or a zoom, and any part finer than about two drawn pixels fades to its average, so nothing shimmers in the distance or on the low tier. They slide across moving characters, as every full-frame mark does.
  • Black stays black. Every pixel goes through styleKit's shared exit, so with every light off the frame is black on every paper, white paper and chalkboard alike.

Each paper publishes the stack's shared ground (the sheet's colour and tooth height, which granulation, dry brush and ink lines read) and the paper field (thirst, sheen, fibre and whether the sheet is dark), which the watercolor and ink blocks read. The paper field is made only when a block in the stack reads it, so a paper under styleKit's own blocks costs nothing for it.

Regions on different papers

A later paper in the stack lays its ground and paper field over the one before by its strength and mask, so regions of one world sit on different papers:

StyleKit.add("paperColdPress", { id = "paper" })                    -- the whole world on cold press
StyleKit.add("paperParchment", { id = "mapRoom",
    mask = { kind = "sphere", center = { 40, 2, -12 }, radius = 6 } })  -- the map room on parchment

Every mask kind works (depth, rect, sphere, group; invert = true flips it). The older papers (plainPaper, darkBoard, inkPaper, wcColdPress) do not layer: one of them can be the first paper under a paperBlocks region, but not a region laid over another paper.

A paper on an object

The papers above lay the sheet over the whole frame from world position, so a prop that moves, or a character that walks, slides under the tooth. To put an object on the same paper with the tooth on its own surface, give it the paper as a material:

local PaperMaterial = require("~paperBlocks.PaperMaterial")

PaperMaterial.paint(heroId)                                   -- the paper the stack is on, with its tuned settings
StyleKit.options({ groups = { { "Hero" } } })                 -- name the object (or its parent) as mask group 1
StyleKit.setMask("paper", { kind = "group", group = 1, invert = true })   -- the full-frame paper leaves it to its own material

paint gives every Model at or under the entity a material on paperBlocks' paperSurface shader, derived from the one it wears: its base colour and texture are kept (the original collection is never rewritten), and it takes every setting of the paper the stack's first paperBlocks Ground entry uses, your tuning included. PaperMaterial.paint(heroId, "paperCanvas", { emboss = 0.8 }) names another paper and overrides any setting. What the material does:

  • The tooth stays on the object. Tooth, fibres, weave, blotches, foxing and rules are laid on the object's own position, so they ride with it as it moves (on a skinned character, the bind pose, so it stays on the body as it animates). They keep about the full-frame paper's size in the picture: the object's PaperSurface component keeps each machine's screen height in the material, so it matches on every screen.
  • Every light rakes it. The tooth bends the surface normal and the engine's own lighting does the rest, so the sun, point lights and shadows show the tooth the way raking light shows it on the frame; sheen makes it shine where light reaches it.
  • The same picture rules. Darks go into the sheet and its valleys; on toned and dark papers the lights are put on in lightColour from lightsFrom up; nothing is brighter than the light that reached it, so an unlit object stays black.
  • One paper, not two. The group mask keeps the full-frame paper off the object, so the tooth is not laid twice (once sliding, once riding). If you would rather keep the full-frame paper on it, paint with { sheet = 0 }: the material then adds only the tooth's relief and tone, and the frame lays the sheet.

The blocks above the paper (washes, granulation, lines) still run over the object as they run over everything; granulation and dry brush read the frame's tooth there, so on a moving object keep those off it with a group mask too. PaperMaterial.unpaint(heroId, { removeFiles = true }) puts every original material back and deletes the materials it wrote; PaperMaterial.list() names every painted entity. The materials are world assets (in /zero/source/paperMaterials by default) and the swap is a synced change, so every player sees the paper on the object.

Limits: see-through materials (glass, water) are left as they are. A material whose own shader lays its texture in its own way (a pixel-art atlas, world-space tiling) keeps its colour and texture but the texture is then laid on the mesh's own UVs, so check it after painting. The material reads no style stack: if you retune the stack's paper, paint the object again to match.

Mixing with watercolorBlocks and inkBlocks

The papers are Ground blocks, which run after Fill and Line, so washes and lines are laid first and the paper takes them. With watercolorBlocks or inkBlocks installed beside paperBlocks:

StyleKit.applyLook("watercolor")              -- watercolorBlocks' whole look, on its own cold press
StyleKit.swap("paper", "paperRice")           -- on rice paper: washes run further and rims soften
StyleKit.swap("paper", "paperHotPress")       -- on hot press: crisp washes, darker narrower rims

StyleKit.applyLook("brushAndWash")            -- inkBlocks' ink wash painting
StyleKit.swap("paper", "paperRice")           -- the brush line feathers into the fibres
StyleKit.swap("paper", "paperBlackboard")     -- the ink is drawn light, the picture in chalk

wcBleed and wcEdgeDarken (watercolorBlocks 1.1.0) and every inkBlocks line and fill (inkBlocks 1.0.4) read the paper field. Granulation, dry brush and every ink line's paperBreak read the tooth through the shared ground, so they feel how much tooth each paper really has (almost none on hot press and board). On cold press with its standard thirst every block draws exactly as it did on the paper it was tuned on.

Relation to the other papers

PaperPackageWhat it isNext to paperBlocks
plainPaperstarterBlocksPlain warm white paper with a fine grain.Swaps with any paperBlocks paper in one change. Publishes no paper field, so the blocks that read it draw as on the standard sheet.
darkBoardstarterBlocksA simple chalk board with a ceiling on chalk coverage.paperBlackboard is the fuller board: slate grain, dust, wiping ghosts, layering, and a paper field that tells ink blocks to draw light.
inkPaperinkBlocksA copy of plainPaper, shipped so inkBlocks' looks need nothing else.Swaps in one change; no paper field.
wcColdPresswatercolorBlockswatercolorBlocks' rough cold-press paper.Swaps in one change; no paper field. paperColdPress is the same kind of sheet in the shared paper model.

None of the older papers publishes the paper field, so the frame under them stays exactly as before.

Quality

The papers follow the stack's quality tier. On low the chain runs at half resolution: the paper keeps its tooth at the same size in the picture, and any part too fine to draw at half resolution fades to its average instead of shimmering. StyleKit.setQuality("low") forces the low tier on this machine; StyleKit.setQuality(nil) follows the device again.

A paper costs one pass for the picture and one for its ground; the paper field adds one more pass, made only when a block in the stack reads it. Each extra region on another paper adds its own picture pass, ground pass and (when read) paper field pass.

Multiplayer

The paper is an entry on the scene's synced StyleStack, so every player sees the same paper, settings and regions, and any player's change reaches everyone through the stack's owner. Swap memory is kept on the entry, so it is shared too. The papers keep no state of their own. Only the quality tier is per machine.

What is in the package

AssetWhat it is
blocks/The seventeen papers (<name>.styleBlock) and the three shaders they all share: paper.shader (the picture on the sheet), paperField.shader (the shared ground) and paperTakes.shader (the paper field).
shaders/paperTooth.shaderModuleThe pure tooth math (felt tooth and grit, fibres, weave, rules, foxing) shared by the full-frame papers and the paper material.
shaders/paperCore.shaderModuleThe full-frame paper model built on it: tooth, fibres, weave, blotches, foxing, rules, chalk dust laid on surfaces.
shaders/paperSurface.shaderThe paper as a material for an object: the same tooth on the object's own position, lit by the scene's lights.
PaperMaterial, PaperSurfacePut an object on paper (paint, unpaint, list) and the component that records its original materials and keeps the tooth's size right on each screen.
Gallery.scene, PaperGallery, PaperGalleryLookEvery paper side by side under one stack, each around its own stand as a layered region; the look over them is fitted to what your world has installed every time the scene loads.
guides/How to choose a paper for my art style, how paper changes watercolor and ink, and a worked example level on paper.
workflows/paperWorld.workflowPut an existing world on paper, check it, and leave it undoable.
tests/The package's test suite.

How much paper shows through each object

Every paper is a Ground block, so styleKit's style channels decide how much of it shows through on each object: an object whose channel (or game role) says marks.paper = 0 stays clean printed card on any sheet, 0.33 lets a little grain through, 1 lays it fully on the paper. The styleRoles package's paper cutout set uses it: the hero printed clean, enemies on the paper's grain, coins as bright clean card.

Known limits

  • Installs with several dependencies can be slow (#21420). paperBlocks brings styleKit, lookbookKit and starterBlocks; the check above took about 3 s, but give a busy engine time to finish before using it.
  • The web build was not checked from inside (#20946: an agent cannot start a web engine). zero lookbook report is the one command to run there.
  • A second machine was not tried (#14448: a second engine on the same account joins as the same player). The stack's fields are replicated, the papers keep no state, and the held clock is wall-clock UTC.
  • Frame rate on the web and in the web gallery is lower than on desktop; start slower machines on the low tier with StyleKit.setQuality("low").
  • The full-frame sheet slides across moving characters. It is laid on world position. Put the character on paper inside its own material instead (PaperMaterial.paint, "A paper on an object" above), and keep the full-frame paper off it with a group mask.
  • Glass, water and particles have no depth, so the sheet under them is the sheet of the surface behind.
  • Offscreen captures and render-to-texture cameras do not draw the stack (styleKit's Known limits).
  • Older papers do not layer. plainPaper, darkBoard, inkPaper and wcColdPress can only be the first paper of a stack with regions.
  • Other engine issues that apply here: every render pass is queued again every frame, so script cost grows with the passes a look queues (#24548); a per-object value cannot reach a geometry pass, so per-object looks go through styleKit's object mask (at most eight distinct settings) or need passes of their own (#24549); a two-client editor sometimes refuses to load two different scenes at once (#24666, #24667); a world boot can wait about 30 s on a network handshake before content starts (#24669); the ZeroMind description can lag one release (#19258).

Removing it

StyleKit.swap("paper", "<the paper you had>") returns the old paper with exactly its settings; StyleKit.remove("paper") takes the paper off; StyleKit.clear() takes the whole look off. paperBlocks edits no material and nothing outside the stack, so nothing else needs putting back. Uninstalling the package leaves a stack that names its papers drawing without them until they are swapped out.

Version history

1.2.2 (2026-11-12): pins starterBlocks 1.0.49, styleKit 1.7.8 (styleKit 1.7.8 logs no second refusal for the old roles field on a scene saved before styleKit 1.5). Nothing else changed.

1.2.1 (2026-11-12): Chalkboard lesson reads as a board: on a light scene it came out flat grey, because the blackboard paper draws everything in light marks; a two-ink step now maps the mid tones onto the dark board and only the lit parts onto chalk (the squint test with roles on went from 23.9 to 27.1). The test suite names the Lookbook indirectly, so installing paperBlocks no longer brings lookbookKit along. Pins styleKit 1.7.7 and starterBlocks 1.0.48.

1.2.0 (2026-11-12): paper gets whole looks of its own, three of them, each made only of paperBlocks' papers and the blocks paperBlocks brings (styleKit's and starterBlocks', now a dependency): Paper cutout game (paperCutoutGame, card on kraft with a white die-cut border; it lived in toonBlocks made of toon blocks, and toonBlocks brought paperBlocks just for it), Chalkboard lesson (chalkboardLesson, a lesson in white chalk on a dusty blackboard) and Parchment map (parchmentMap, sepia and cream inks with a brown line on parchment, for a fantasy map or a quest journal). styleRoles' paper cutout role set follows all three. Pins styleKit 1.7.6 and starterBlocks 1.0.47.

1.1.32 (2026-11-12): pins styleKit 1.7.5 (styleKit 1.7.5: its checks pass where styleKit is installed alone). Nothing else changed.

1.1.31 (2026-11-12): pins styleKit 1.7.4 (styleKit 1.7.4: installs on its own into an empty world again). Nothing else changed.

1.1.30 (2026-11-12): pins styleKit 1.7.3 (styleKit 1.7.3: a role reaches what a kit draws in an object's place (pickupsKit's coins), and looks installed after the first scan are found). Nothing else changed.

1.1.29 (2026-11-12): pins styleKit 1.7.0 (styleKit 1.7.0: role sets' glazes tell groups sharing a material apart, things with no role keep the plain line under a toon look, a look switched on never flashes black while its shaders compile). Known limits no longer cite #20750, which is closed. Nothing else changed.

1.1.28 (2026-11-11): pins styleKit 1.6.5 (styleKit 1.6.5 draws a newly switched-on look's settled picture from its first frames instead of a lighter, half-set one for two to four seconds; lookbookKit 1.0.44 finds its Lookbook scene where it is installed). Nothing else changed.

1.1.27 (2026-11-11): pins styleKit 1.6.4 (styleKit 1.6.4 puts a role given to a player template on the body every joining player is copied from and rebuilds the role mask at most four times a second, and toonBlocks 1.3.6 starts its toon ink by itself and draws every role ink through one shared flood). Every README in the package (each block, look, shader and guide) now ends with a Known limits section naming the engine issues that apply there.

1.1.26 (2026-11-11): pins styleKit 1.6.2 (styleKit 1.6.2 finds the scene's stack again when the one it held was removed (after a play restart a look or role set change failed with "the component this proxy names was removed")). Nothing else changed.

1.1.25 (2026-11-11): a style channel test on styleKit's ChannelProbe (the paper mark reaches the ground on the presented frame); pins styleKit 1.6.1.

1.1.24 (2026-11-11): pins styleKit 1.5.1 (styleKit 1.5.1 keeps the scene's role set working in an editor that had an older styleKit open). Nothing else changed.

1.1.23 (2026-11-11): documents how much paper shows through each object with styleKit 1.5.0's style channels. No block changed. Pins styleKit 1.5.0.

1.1.22 (2026-11-08): moves to the engine's current built-in library (@builtin e89b9db), whose update rewrote small reference files inside the package (a world on an older built-in library is hidden from players). The package description now says what it gives you and how to install and use it. Nothing else changed.

1.1.21 (2026-11-08): moves to the engine's current built-in library (@builtin edb50c2), whose update rewrote small reference files inside the package (a world on an older built-in library is hidden from players). Nothing else changed.

1.1.20 (2026-11-08): moves to the engine's current built-in library (@builtin f4425a5), whose update rewrote small reference files inside the package (a world on an older built-in library is hidden from players). Nothing else changed.

1.1.19 (2026-11-08): moves to the engine's current built-in library (@builtin f39f044), whose update rewrote small reference files inside the package (a world on an older built-in library is hidden from players). Nothing else changed.

1.1.18 (2026-11-08): the package's description now reads as a store listing (what you get and how to start), without a version number or a list of changes. No paper changed.

1.1.17 (2026-11-08): moves to the engine's current built-in library (@builtin f110cb3), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.16 (2026-11-08): moves to the engine's current built-in library (@builtin a29b227), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.15 (2026-11-08): moves to the engine's current built-in library (@builtin c61f473), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.14 (2026-11-07): moves to the engine's current built-in library (@builtin 7ca1f19), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.13 (2026-11-07): moves to the engine's current built-in library (@builtin fdc9a99), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.12 (2026-11-07): moves to the engine's current built-in library (@builtin 7e13a48), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.11 (2026-11-07): moves to the engine's current built-in library (@builtin 2809239), whose update rewrote small reference files inside the package. Nothing else changed.

1.1.10 (2026-11-07): moves to the engine's current built-in library (@builtin 278f02f), whose update rewrote small reference files inside the package. No block, look or shader changed.

1.1.9 (2026-11-07): moves to the engine's current built-in library (@builtin 6656162), whose update rewrote small reference files inside the package. No block, look or shader changed.

1.1.8 (2026-11-07): moves to the engine's current built-in library (@builtin 808b4a1), whose update rewrote small reference files inside the package. No block, look or shader changed.

1.1.7 (2026-11-02): "Lookbook numbers" records the check made on a fresh install of 1.1.6: cold press, kraft and blackboard measured twice each in one unattended batch, every run finished on its own and matched the table within 0.01, the unstyled frame 2.30 every time. No paper changed.

1.1.6 (2026-11-02): the measurement in this README stalled partway and its numbers drifted because the Lookbook stepped once per drawn frame while the engine stopped drawing a still picture; lookbookKit 1.0.14, which a fresh install now brings, holds every-frame drawing during a run. "Lookbook numbers" says so, says how much a run can still move (a first, warm-up run by about 0.05), and withdraws 1.1.5's explanation (#19849), which was wrong. No paper changed.

1.1.5 (2026-11-02): needs styleKit 1.2.4. Documentation: a reviewer's two new findings, a stall partway through a long measurement (#19849) and a mismatch beyond 0.05 on cold press and blackboard not seen here, are written up under "Lookbook numbers" with what is known and not known about them. No block changed.

1.1.4 (2026-11-02): needs styleKit 1.2.3, and the Lookbook table is new. A reviewer could not reproduce the 1.1.3 table on a fresh install. The cause was styleKit 1.2.2 losing the scene's sun on a paper whenever its shader compiled, so each run drew the tooth with or without sun relief depending on timing (see "Why the earlier table did not reproduce"). styleKit 1.2.3 fixes it, and every paper now measures the same on both runs of a fresh install: all seventeen papers measured twice with exactly the call the README names. No block changed.

1.1.3 (2026-11-01): documentation only: the Gallery's README quotes a single paper's cost as a fresh install measures it (0.52 to 0.74 ms high, 0.15 to 0.20 ms low at 1920 x 1080).

1.1.2 (2026-11-01): documentation only. The Lookbook numbers are now what a fresh install measures: every paper twice in a brand new world with only paperBlocks installed, right after the engine started, at 1920 x 1080. Where a paper also showed a second repeatable outcome (kraft on a fresh install; several papers in a long session) the table lists it, since which outcome a run lands on depends on what ran before it in the engine. The 1.1.1 table came from a long session and held some of those second outcomes (cold press 3.13 / +0.18 / 1.86 where a fresh install gives 3.64 / -0.05 / 1.57). No block changed.

1.1.1 (2026-11-01): the Gallery fits its look to your world every time it loads (in edit, in play, on every peer), so the first open in a paperBlocks-only world already draws styleKit's pencil line over every paper and its title card says so; before, only a rebuild did. Lookbook numbers measured again on styleKit 1.2.2 and lookbookKit 1.0.11: the earlier numbers had been taken in one long batch in which each paper's first second of path was embossed under the sun left over from the run before (styleKit read the sun about once a second), so they did not match a run on its own. The section now states the exact call and view size, and how the numbers move with the view size.

1.1.0 (2026-11-01): a paper on an object: the paperSurface material lays any paper's tooth, fibres, weave and tone on an object's own position, lit by the scene's own lights, and PaperMaterial.paint(entityId) puts an object on the stack's paper (or a named one) and unpaint puts it back (see "A paper on an object"); the pure tooth math moved into paperTooth, shared by the frame and the material, with no change to how any paper draws; a test for painting and unpainting.

1.0.1 (2026-11-01): the README says exactly what an install brings (styleKit, lookbookKit and starterBlocks), as a fresh-world install showed; no block changed.

1.0.0 (2026-11-01): first release: seventeen papers sharing one paper model and one set of settings, the Gallery, guides, the paperWorld workflow and the test suite.

Lookbook numbers

What a fresh install measures. Every paper alone, measured twice on 2026-11-02 in a brand new private world: paperBlocks installed from ZeroMind (which brought styleKit, lookbookKit 1.0.11 and starterBlocks 1.0.11) and nothing else, the stack empty before and after every run (no entries, hold rate 8, soft radius 10, no pigment set), desktop GPU, the Lookbook's 3D view at exactly 1920 x 1080 (checked before every run), one discarded warm-up run first, no missed frames. Each paper was measured with exactly this call and nothing else on the stack:

local Lookbook = require("~lookbookKit.Lookbook")
local r = Lookbook.measure({ stack = { { id = "paper", block = "paperKraft" } } })
print(r.size[1], r.size[2], r.stylized.all.warpedDiff, r.stylized.markStuck, r.stylized.screenStuck, r.stylized.zoomMarks.growth, r.passMs.high.total, r.passMs.low.total)

zero viewport size reports the 3D view as sceneWidth and sceneHeight; the window is larger than the view by the editor's panels, and the Lookbook refuses a run whose view changes size. The styleKit these numbers were taken on carries the sun fix styleKit 1.2.3 ships (below), which paperBlocks 1.1.4 needs: the published styleKit was still 1.2.2 that night, so the one-line fix was put into the fresh install's styleKit by hand. Every paper's two runs agree (to 0.01 where they differ at all), and the unstyled frame the same call measures was identical in all 34 runs: 2.30 (whole path), 6.57 (pan), 0.00, -0.53, 7.88. The runs are in design/lookbook/paper_fresh_runs.txt in the Style Cookbook world.

Why the earlier table did not reproduce. The Gallery's stack settings were not the cause: the Lookbook replaces the Gallery scene before it measures, the measured stack was empty with the default hold rate and soft radius before and after every run, and those defaults are the Gallery's own values anyway. The cause was a styleKit bug. styleKit 1.2.2 writes the scene's sun to a block only when the sun changes, and whenever a block's shader is compiled (the first time a paper is used in a fresh install) or recompiled, the engine puts the block's values back to their defaults, which for the sun means "no sun". So a run drew the paper with or without the sun raking its tooth depending on timing. With paperBlocks 1.1.3 and styleKit 1.2.2 freshly installed, 11 of the 17 papers gave two different results on their two runs (kraft 2.26 / +0.41 / 1.81, then 1.93 / +0.50 / 2.59; cold press 3.13 / +0.18 / 1.86 on both runs right after a warm-up of 3.64 / -0.05 / 1.57), while the unstyled frame never changed. The sunless result is the one with higher mark growth and a little less swimming; the earlier table's last column ("other repeatable outcome") was that result, and its two kraft rows were one of each. With the fix put in, the same fresh install gave every paper the same numbers twice. A mark growth of about 1.0 was not seen in any of 87 runs on this machine (the lowest is 1.57, cold press): if your runs show it, zero lookbook report and your GPU would help find out why.

A run used to stall partway and drift; it no longer does (lookbookKit 1.0.14). A reviewer running the call above in a fresh world saw every run stop partway (usually around step 90 of 780) and sit there until the engine was poked every few seconds; when the runs did finish, kraft matched this table but cold press and blackboard did not (cold press 3.73 / growth 1.29 on one run, blackboard 2.95 and growth 1.35 on one run and 2.43 on the other), and the unstyled frame read 2.32 to 2.41 instead of 2.30. All of it had one cause, and it was in the Lookbook, not in the papers. The engine draws only frames that show something new unless it is told to draw every frame; the Lookbook advances one camera pose per drawn frame, so once the renderer judged the picture still it stopped drawing and the run waited, and each poke let it on for a few frames at uneven moments, so the frames it measured were not the frames an unbroken run measures. These numbers were taken by runs that never stalled, because the tool calls of the agent taking them kept the engine drawing. From lookbookKit 1.0.14 on (a fresh paperBlocks install brings it), Lookbook.measure and Lookbook.run hold every-frame drawing for their whole length and put the setting back afterwards, so a run finishes on its own, with no one touching the engine, and plays the same frames every time. An earlier version of this README blamed a task-scheduling issue (#19849): that was wrong.

How much a run can still move. The first run after a paper is first used in a session (its shader compiles while the path plays) can differ from the later ones by about 0.05 in the warped difference and the marks score; that is the warm-up run discarded above. After it, two runs of the same paper agree to 0.01, and the unstyled frame reads 2.30 every time. A difference beyond that, with lookbookKit 1.0.14 or later, is worth reporting with the paper and zero lookbook report.

Checked on a fresh install after the fix. On 2026-11-02 (18:50 to 18:57 UTC), in a brand new private world with only paperBlocks 1.1.6 installed from ZeroMind (it brought lookbookKit 1.0.14, styleKit 1.2.4 and starterBlocks), the 3D view at 1920 x 1080, the call above was run for cold press (a warm-up, then twice), kraft and blackboard (twice each), one after another in a single unattended batch. Every run finished on its own; the renderer held every-frame drawing for 377 of 382 one-second samples taken during the batch (the other five fall between runs) and gave the setting back afterwards; no frame was missed. Cold press read 3.64, 3.64 and 3.63 / 7.30 / -0.05 / -0.54 / 1.57, kraft 2.26 / 4.90 / +0.41 / -0.53 / 1.81 twice, blackboard 2.87 and 2.88 / 4.51 / +0.37 / -0.60 / 2.43, and the unstyled frame 2.30 / 6.57 / 0.00 / -0.53 / 7.88 in all seven runs: the table's rows, within 0.01.

How to read them, against the unstyled frame rather than as pass marks:

  • Warped difference (0..255, lower is steadier; "how much the picture swims"): how much each frame differs from the one before once the camera's motion is taken out. Unstyled: 2.30 (whole path), 6.57 (pan).
  • Marks on things (the shower-door score): negative means the stack's own marks line up with the surfaces when the camera pans, positive that they line up with the screen. Read the warning below.
  • Screen-stuck in the pan: the whole picture's detail against the same spot on the screen (more negative is less stuck). Unstyled: -0.53.
  • Mark growth over the 10x zoom: about 1 means marks keep their size in the picture, about 10 that they grow with the things they sit on (unstyled 7.88). Papers with almost no tooth (vellum, board, hot press, the notebook's rules) mostly follow the scene.
  • GPU ms high / low: the style passes alone at the pan, on the high and the low quality tier.
  • Every light off: the frame's mean brightness at the Lookbook's every-light-off moment, one frame per paper (unstyled 1.22): it must stay at the unstyled frame's black.
PaperRunWarped difference, whole pathWarped difference, panMarks on thingsScreen-stuck in the panMark growth over the 10x zoomGPU ms highGPU ms lowEvery light off (0..255)
Cold press (paperColdPress)13.637.30-0.05-0.541.570.640.171.15
Cold press (paperColdPress)23.637.30-0.05-0.541.570.640.18
Rough (paperRough)14.127.96-0.06-0.521.580.640.171.17
Rough (paperRough)24.117.96-0.06-0.521.580.640.18
Hot press (paperHotPress)12.356.42+0.45-0.533.860.640.171.19
Hot press (paperHotPress)22.356.42+0.45-0.533.860.640.18
Rice paper (paperRice)12.876.56+0.15-0.532.020.640.181.18
Rice paper (paperRice)22.876.56+0.15-0.532.020.640.17
Newsprint (paperNewsprint)12.195.71+0.84-0.533.260.640.171.06
Newsprint (paperNewsprint)22.195.71+0.84-0.533.260.640.17
Kraft (paperKraft)12.264.90+0.41-0.531.810.640.181.14
Kraft (paperKraft)22.264.90+0.41-0.531.810.640.18
Parchment (paperParchment)12.376.25+0.65-0.532.100.710.201.08
Parchment (paperParchment)22.366.25+0.65-0.532.100.710.20
Canvas (paperCanvas)14.107.79+0.05-0.443.940.700.191.08
Canvas (paperCanvas)24.097.79+0.05-0.443.940.700.19
Illustration board (paperBoard)12.286.35+0.78-0.536.070.540.151.15
Illustration board (paperBoard)22.286.35+0.78-0.536.070.540.15
Blackboard (paperBlackboard)12.884.51+0.37-0.602.430.670.181.17
Blackboard (paperBlackboard)22.874.51+0.37-0.602.430.670.18
Green chalkboard (paperGreenChalkboard)12.102.42+0.67-0.592.480.670.181.33
Green chalkboard (paperGreenChalkboard)22.102.42+0.67-0.592.480.670.18
Black paper (paperBlack)13.458.74-0.56-0.552.090.640.171.10
Black paper (paperBlack)23.458.74-0.56-0.552.090.640.18
Aged sketchbook (paperSketchbook)12.676.07+0.47-0.531.710.760.211.03
Aged sketchbook (paperSketchbook)22.676.07+0.47-0.531.710.760.21
Toned grey (paperTonedGrey)12.726.62+0.07-0.531.770.640.171.20
Toned grey (paperTonedGrey)22.726.62+0.07-0.531.770.640.18
Toned tan (paperTonedTan)12.867.08-0.10-0.531.770.640.171.17
Toned tan (paperTonedTan)22.867.08-0.10-0.531.770.640.17
Ruled notebook (paperNotebook)12.546.39+0.20-0.524.480.660.181.19
Ruled notebook (paperNotebook)22.546.39+0.20-0.524.480.660.18
Vellum (paperVellum)12.236.22+0.91-0.537.410.640.181.13
Vellum (paperVellum)22.236.22+0.91-0.537.410.640.18

What they say:

  • The shower-door score does not show the tooth staying on things at 1080p, for most papers. At 1920 x 1080 most papers score positive (+0.05 to +0.91); cold press, rough, black paper and toned tan score negative. A paper's tooth is laid on world position, so this points at the Lookbook's mark comparison at this size rather than at the papers, but it is not proved. Check sliding by eye with a slow pan in your own scene. The screen-stuck column, which reads the whole picture, is -0.44 to -0.60 for every paper: nothing glues the picture to the screen.
  • Swimming. Smooth papers add almost nothing to the unstyled path (hot press 2.35, board 2.28, vellum 2.23, newsprint 2.19, kraft 2.26 against 2.30). Deep tooth adds detail that moves with the surfaces: cold press 3.63, rough 4.12, canvas 4.10, black paper 3.45.
  • Black stays black. With every light off every paper stays at the unstyled frame's black (1.03 to 1.33 against 1.22).
  • Cost at 1920 x 1080. A paper alone is 0.54 to 0.76 ms on the high tier and 0.15 to 0.21 ms on the low tier, about four times cheaper; most of it is the paper's ground field (about 0.5 ms high), the picture pass about 0.14 ms. Under blocks that read the paper field (watercolorBlocks' bleed and edge darkening, every inkBlocks block) the paper field adds one more pass of about 0.5 ms high.
  • Line and wash on paper (watercolorBlocks and inkBlocks installed; from an earlier long session on styleKit 1.2.2, so its two runs can differ by the sun bug above): 4.55 to 4.71 ms high and 0.93 to 1.00 ms low; calmer than unstyled on hot press (1.25) and 2.5 to 3.8 on cold press and canvas.
  • The Gallery and the Paper Swatches recipe run seventeen papers at once (70 passes with the line and wash look): 14.7 ms of GPU time on high at 2097 x 1409. They are swatch books, not stacks to ship; a game picks one or two papers.
  • Web frame rate: run zero lookbook report in the web build; it has not been measured from here (#20946).

Line and wash, and the unstyled baseline, from the earlier long session on styleKit 1.2.2 (design/lookbook/paper_runs.json; columns: warped whole path, warped pan, marks, screen-stuck, growth, GPU high, GPU low, every light off):

StackRunWarped difference, whole pathWarped difference, panMarks on thingsScreen-stuck in the panMark growth over the 10x zoomGPU ms highGPU ms lowEvery light off (0..255)
baseline12.306.570.00-0.537.88--1.22
baseline22.306.570.00-0.537.88--
lineAndWash:paperHotPress11.251.430.73-0.613.814.550.931.04
lineAndWash:paperHotPress21.251.430.73-0.613.814.560.93
lineAndWash:paperColdPress12.462.130.65-0.621.824.570.931.03
lineAndWash:paperColdPress23.133.390.52-0.581.494.560.93
lineAndWash:paperCanvas12.973.110.62-0.214.844.711.001.02
lineAndWash:paperCanvas23.794.720.49-0.183.274.711.00
lineAndWash:paperHotPressbleed.wcBleed0.390.390.100.10
lineAndWash:paperHotPressdry.wcDryBrush0.270.270.070.07
lineAndWash:paperHotPressedge.wcEdgeDarken0.200.210.050.05
lineAndWash:paperHotPressgrain.wcGranulation0.230.230.070.06
lineAndWash:paperHotPressline.inkPenLine1.191.190.150.15
lineAndWash:paperHotPresspaper.paperHotPress0.140.140.030.03
lineAndWash:paperHotPresspaper.paperHotPress.field0.500.500.130.13
lineAndWash:paperHotPresspaper.paperHotPress.paper0.500.500.130.13
lineAndWash:paperHotPresswash.wcWash1.121.120.200.20
lineAndWash:paperColdPressbleed.wcBleed0.400.400.100.10
lineAndWash:paperColdPressdry.wcDryBrush0.270.270.070.07
lineAndWash:paperColdPressedge.wcEdgeDarken0.210.210.050.05
lineAndWash:paperColdPressgrain.wcGranulation0.230.230.070.07
lineAndWash:paperColdPressline.inkPenLine1.191.190.150.15
lineAndWash:paperColdPresspaper.paperColdPress0.140.140.030.03
lineAndWash:paperColdPresspaper.paperColdPress.field0.500.500.130.13
lineAndWash:paperColdPresspaper.paperColdPress.paper0.500.500.130.13
lineAndWash:paperColdPresswash.wcWash1.121.120.200.20
lineAndWash:paperCanvasbleed.wcBleed0.400.400.100.10
lineAndWash:paperCanvasdry.wcDryBrush0.280.280.080.07
lineAndWash:paperCanvasedge.wcEdgeDarken0.210.210.050.06
lineAndWash:paperCanvasgrain.wcGranulation0.230.230.070.07
lineAndWash:paperCanvasline.inkPenLine1.201.200.160.16
lineAndWash:paperCanvaspaper.paperCanvas0.140.140.030.04
lineAndWash:paperCanvaspaper.paperCanvas.field0.570.570.150.15
lineAndWash:paperCanvaspaper.paperCanvas.paper0.560.560.150.15
lineAndWash:paperCanvaswash.wcWash1.131.130.200.20

Each pass's GPU milliseconds in the long session, both runs, both tiers:

StackPassHigh, run 1High, run 2Low, run 1Low, run 2
paperColdPresspaper.paperColdPress0.130.130.040.04
paperColdPresspaper.paperColdPress.field0.500.500.130.13
paperRoughpaper.paperRough0.130.130.040.04
paperRoughpaper.paperRough.field0.500.500.130.13
paperHotPresspaper.paperHotPress0.130.130.040.04
paperHotPresspaper.paperHotPress.field0.500.500.130.13
paperRicepaper.paperRice0.130.130.040.04
paperRicepaper.paperRice.field0.500.500.130.13
paperNewsprintpaper.paperNewsprint0.130.130.040.04
paperNewsprintpaper.paperNewsprint.field0.500.500.130.13
paperKraftpaper.paperKraft0.130.140.040.04
paperKraftpaper.paperKraft.field0.500.500.130.13
paperParchmentpaper.paperParchment0.140.140.040.04
paperParchmentpaper.paperParchment.field0.580.580.150.15
paperCanvaspaper.paperCanvas0.140.130.040.04
paperCanvaspaper.paperCanvas.field0.560.560.150.15
paperBoardpaper.paperBoard0.130.130.040.04
paperBoardpaper.paperBoard.field0.400.400.110.11
paperBlackboardpaper.paperBlackboard0.140.140.040.04
paperBlackboardpaper.paperBlackboard.field0.540.540.140.14
paperGreenChalkboardpaper.paperGreenChalkboard0.140.140.040.04
paperGreenChalkboardpaper.paperGreenChalkboard.field0.540.540.140.14
paperBlackpaper.paperBlack0.140.130.040.04
paperBlackpaper.paperBlack.field0.510.500.130.13
paperSketchbookpaper.paperSketchbook0.130.130.040.04
paperSketchbookpaper.paperSketchbook.field0.620.630.170.17
paperTonedGreypaper.paperTonedGrey0.140.140.040.04
paperTonedGreypaper.paperTonedGrey.field0.510.500.140.13
paperTonedTanpaper.paperTonedTan0.130.140.040.04
paperTonedTanpaper.paperTonedTan.field0.500.500.130.13
paperNotebookpaper.paperNotebook0.130.130.040.04
paperNotebookpaper.paperNotebook.field0.530.530.140.14
paperVellumpaper.paperVellum0.130.130.040.04
paperVellumpaper.paperVellum.field0.500.490.130.13
lineAndWash:paperHotPressbleed.wcBleed0.390.390.100.10
lineAndWash:paperHotPressdry.wcDryBrush0.270.270.070.07
lineAndWash:paperHotPressedge.wcEdgeDarken0.200.210.050.05
lineAndWash:paperHotPressgrain.wcGranulation0.230.230.070.06
lineAndWash:paperHotPressline.inkPenLine1.191.190.150.15
lineAndWash:paperHotPresspaper.paperHotPress0.140.140.030.03
lineAndWash:paperHotPresspaper.paperHotPress.field0.500.500.130.13
lineAndWash:paperHotPresspaper.paperHotPress.paper0.500.500.130.13
lineAndWash:paperHotPresswash.wcWash1.121.120.200.20
lineAndWash:paperColdPressbleed.wcBleed0.400.400.100.10
lineAndWash:paperColdPressdry.wcDryBrush0.270.270.070.07
lineAndWash:paperColdPressedge.wcEdgeDarken0.210.210.050.05
lineAndWash:paperColdPressgrain.wcGranulation0.230.230.070.07
lineAndWash:paperColdPressline.inkPenLine1.191.190.150.15
lineAndWash:paperColdPresspaper.paperColdPress0.140.140.030.03
lineAndWash:paperColdPresspaper.paperColdPress.field0.500.500.130.13
lineAndWash:paperColdPresspaper.paperColdPress.paper0.500.500.130.13
lineAndWash:paperColdPresswash.wcWash1.121.120.200.20
lineAndWash:paperCanvasbleed.wcBleed0.400.400.100.10
lineAndWash:paperCanvasdry.wcDryBrush0.280.280.080.07
lineAndWash:paperCanvasedge.wcEdgeDarken0.210.210.050.06
lineAndWash:paperCanvasgrain.wcGranulation0.230.230.070.07
lineAndWash:paperCanvasline.inkPenLine1.201.200.160.16
lineAndWash:paperCanvaspaper.paperCanvas0.140.140.030.04
lineAndWash:paperCanvaspaper.paperCanvas.field0.570.570.150.15
lineAndWash:paperCanvaspaper.paperCanvas.paper0.560.560.150.15
lineAndWash:paperCanvaswash.wcWash1.131.130.200.20

The fresh-install runs are in design/lookbook/paper_fresh_runs.txt in the Style Cookbook world.