Log inGet started
World

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

README.md

starterBlocks

Ten small, generic style blocks for styleKit so every slot of a look stack has something to play with; installed beside styleKit, they stack and swap exactly like styleKit's own blocks.

Version 1.0.50. Depends on styleKit and nothing else.

Install and use

Install starterBlocks from ZeroMind (search "starterBlocks" or "starter style blocks"); it brings styleKit along. Installs with several dependencies can be slow (#21420), so give an install time to finish and check /zero/source for the package folder. Then:

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

StyleKit.load({
	{ block = "flatWash" },                       -- Fill
	{ id = "ink", block = "depthLine" },          -- Line (from styleKit)
	{ id = "paper", block = "plainPaper" },       -- Ground
	{ block = "lineBoil" },                       -- Time: the wash edge and the ink boil together
})
StyleKit.swap("ink", "sketchLine")                -- pencil instead of ink, nothing else touched
StyleKit.swap("paper", "darkBoard")               -- chalk on a dark board

No material is edited. The package adds its blocks the moment it is installed: StyleKit.blocks({ package = "starterBlocks" }) lists them.

The blocks

BlockSlotWhat it does
cardSurfaceSurfaceEvery surface reads as matte coloured card: shine off, light softened, faint fibre on surfaces.
lightBandsLightSteps the light into a few flat bands. Whole frame, or inside a material through the bandedToon shader.
flatWashFillEach area of colour as one flat transparent wash with pooled edges, settling into the paper grain.
surfaceDotsToneA halftone dot screen printed on the surfaces, bigger dots in darker places; dots stay on things.
plainPaperGroundWarm white paper with a fine tooth under everything; publishes the shared ground.
darkBoardGroundChalk on a dark board; publishes the shared ground.
lineBoilTimeLines and wash edges tremble together on the held clock; publishes the shared wobble.
chunkyPixelsRasterA coarse grid of big square pixels.
softGrainMediumSoft mid-tone print grain, renewed on the held clock.
vignetteMediumSoft dark corners.

With styleKit's posterize, duotone, depth line and sketch line that is 14 blocks across all ten slots, two or more in Colour, Line, Ground and Medium.

The gallery

Gallery.scene stands every installed block in its own bay: the same props (sphere, box, column, thin rail, checker tile, back wall) and a sign naming the block, its slot and what it does. One StyleStack drives them all, each entry limited to its bay by a world sphere mask, so every block is driven the same way; the Line boil bay adds a depth line so the boil shows. Blocks from packages installed later get a bay when the scene is built again.

Light bands inside a material

lightBands ships the bands shader module (sbl_bands(light, bands, softness, lift)) and a bandedToon surface shader and material built on it. Give chosen objects the bandedToon material and they are banded by their own lighting, the same rule the full-frame block uses; put them in a mask group and give the full-frame block mask = { kind = "group", group = 1, invert = true } so it leaves them to their material.

Notes on every block

Each block's README (in its .styleBlock folder) says what it gives up in motion and how it treats opaque things, transparent things, particles, sky, fog, skinned characters, foliage and world text. In short:

  • Marks on surfaces (paper tooth, card fibre, dots, boil) come from the stack's shared surface coordinates, so they stay on still things under any camera move and slide on moving characters.
  • Grain, chunky pixels and the vignette belong to the medium and stay on the screen by design.
  • Every block keeps black black and leaves the UI alone; none flashes, and the grain and boil renew at the stack's hold rate (8 per second by default).
  • Surface and Light need the deferred renderer's base colour; on the forward path they fall back to brightness alone.

Known limits

  • Offscreen captures, mirrors and render-to-texture cameras do not draw these blocks (#17427): they run on the whole frame after antialiasing, so judge a look from the presented frame.
  • Marks laid on surfaces slide across moving characters: a full-frame pass gets no per-object position, and a per-object value cannot reach a geometry pass (#24549). Per-object settings reach the blocks through styleKit's object mask, at most eight distinct settings a scene.
  • Every pass is queued again every frame (#24548), even when nothing changed.
  • Other engine issues that apply here: 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); installs with several dependencies are slow (#21420); the ZeroMind description can lag one release (#19258); the web build was not checked from here (#20946); two engines on one account collide as one player, so a two-player check needs two accounts (#14448).

Version history

1.0.49 (2026-11-12): pins 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.0.48 (2026-11-12): pins styleKit 1.7.7 (styleKit 1.7.7: a role set or look another player changes reaches everyone in the session). Nothing else changed.

1.0.47 (2026-11-12): pins styleKit 1.7.6 (styleKit 1.7.6: an ink set by hand on one object reads as set, and a set for a kind of game carries its groups before a look is picked). Nothing else changed.

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

1.0.45 (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.0.44 (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.0.43 (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). Nothing else changed.

1.0.42 (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.0.41 (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.0.40 (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.0.39 (2026-11-11): pins styleKit 1.6.1. Nothing else changed.

1.0.38 (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.0.37 (2026-11-11): pins styleKit 1.5.0, so every block honours style channels (an object's marks and its entry's variant). No block changed.

1.0.33 (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). Pins styleKit 1.4.21. Nothing else changed.

1.0.32 (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). Pins styleKit 1.4.20. Nothing else changed.

1.0.31 (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). Pins styleKit 1.4.19. Nothing else changed.

1.0.30 (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). Pins styleKit 1.4.18. Nothing else changed.

1.0.29 (2026-11-08): pins styleKit 1.4.15; 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.

1.0.28 (2026-11-08): pins styleKit 1.4.14. Nothing else changed.

1.0.27 (2026-11-08): pins styleKit 1.4.13. Nothing else changed.

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

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

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

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

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

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

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

1.0.19 (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. Pins styleKit 1.4.4.

1.0.18 (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. Pins styleKit 1.4.3.

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

1.0.16 (2026-11-07): depends on styleKit 1.4.1; no change to the blocks.

1.0.15 (2026-11-07): depends on styleKit 1.4.0 (its dim guard keeps dim rooms dim for every Tone block, halftone dots included); no change to the blocks.\n\n1.0.14 (2026-11-03): depends on styleKit 1.3.0 (its shared stroke piece, skStrokes, used by pencilBlocks); no change to the blocks.

1.0.13 (2026-11-02): needs styleKit 1.2.4; no block changed.

1.0.12 (2026-11-02): needs styleKit 1.2.3, which keeps the scene's sun on a block after its shader compiles (a fresh install could draw sun-lit blocks without their sun); no block changed.

1.0.11 (2026-11-01): built on styleKit 1.2.2 (the scene's sun is read every 4 frames and at once when the stack changes, so a raking light follows a moving sun smoothly); no block changed.

1.0.10 (2026-11-01): documentation only: install notes describe how installing works (install from ZeroMind search; installs with several dependencies can be slow) without naming internal ticket numbers.

1.0.9 (2026-11-01): documentation only: the install note says how installing works today (install from ZeroMind search; installs with several dependencies can be slow).

1.0.8 (2026-11-01): Line boil fades its wobble where one cell of its pattern would cover fewer than about 8 drawn pixels (the far ground at the horizon, any surface on the half-resolution low tier): a wobble that changes from pixel to pixel broke lines into dashes and pool edges into rings. Near things, a sphere's rim included, boil as before. Needs styleKit 1.1.4.

1.0.7 (2026-10-31): republished with the engine library upgraded to 9b189b9; no change to the blocks.

1.0.6 (2026-10-31): store listing rewritten for creators; built on styleKit 1.0.8.

1.0.5 (2026-10-31): every block lists its tags in the block list (zero styleKit list --tag watercolor); built on styleKit 1.0.7.

1.0.4 (2026-10-31): the dark board keeps an unlit frame black (it laid its board colour over a frame with every light off); the gallery and test leftovers are gone from the world.

1.0.3 (2026-10-31): the dark board keeps the board showing in bright scenes (new coverage setting); gallery signs face the visitors and the gallery scene loads standalone.

1.0.2 (2026-10-31): the paper grain fades detail finer than two pixels so it does not shimmer in motion; the matte card softens light without lifting black.

1.0.1 (2026-10-31): the gallery scene, the bands module name and this README.

1.0.0 (2026-10-31): first release, ten blocks, the bands module, the bandedToon shader and material, and the gallery scene.