Log inGet started
World

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

README.md

Gallery (scene)

All seventeen paperBlocks papers side by side under ONE style stack, each on its own labelled stand. It is the package cover.

  • The stands. A 6, 6, 5 grid of plinths, each carrying the same still life: a red ball, a blue cube, a green column, a yellow house with a grey gable roof and a pale plaque leaning back toward the sun. A white card in front of each names the paper and its block id (paperKraft). A fairly low sun from the left front rakes across the plinth tops and the plaques, so the tooth, weave, fibres and ruling catch the light, and a strong sky fill keeps the toned and dark papers lit enough to show their put-on lights.
  • One stack, every paper. The first paper entry, p_hotPress (paperHotPress), is unmasked and covers the floor and everything around the stands. Every later paper entry (p_coldPress, p_rough, p_board, p_vellum, p_rice, p_newsprint, p_notebook, p_sketchbook, p_parchment, p_canvas, p_kraft, p_tonedGrey, p_tonedTan, p_black, p_blackboard, p_greenChalkboard) lays its sheet over it inside a world sphere around its own stand (radius 2 m, soft 0.1): styleKit's layered grounds. The washes and lines above feel each region's own paper. Try one in a single change: StyleKit.swap("p_kraft", "paperTonedTan").
  • The live look, fitted to your world every time the scene loads. With watercolorBlocks and inkBlocks installed (StyleKit.block("wcWash") and StyleKit.block("inkPenLine") both found), a watercolor wash with an ink pen line in the earthy pigments: wash (wcWash), bleed (wcBleed), shadow (wcShadowPool, density 0.35), grain (wcGranulation), dry (wcDryBrush, coverage 0.25), edge (wcEdgeDarken), line (inkPenLine, width 1.6) and boil (inkBoil, 8 drawings a second): 25 entries. With paperBlocks alone, styleKit's own pencil instead: depth (depthLine) under line (sketchLine), no pigment set: 19 entries. The scene file is saved with the watercolor and ink look (it was saved in a world that has them), so its entrypoint fits it on every load, in edit and in play and on every peer (PaperGalleryLook.fit()): where any block the saved stack names is not installed, the look entries are replaced with the look this world can draw, every paper entry keeps its mask and settings, and the title card's second line says which look it is ("One stack: a pencil line over every paper (add watercolorBlocks and inkBlocks for a wash)" with paperBlocks alone). A stack whose blocks are all installed is left exactly as it is, your own edits included. So the very first open in a paperBlocks-only world already shows pencil lines over every paper. The line's distance thinning and fade are pushed past the gallery, since its view stands far back.

Labels and the title are left out of the stack by name (exclude = { "GalleryLabels" }), so they stay as made after the scene is saved and loaded again, each on a white card of its own (gallery/materials/galleryCard, unlit). The GalleryView camera stands raised and far back on a 26 degree lens with every stand and label in the frame; it draws all !debug !EditorUI, so editor gizmos never reach the styled frame, and sits below the player camera (priority -10), so it never takes a joining player's view. Give it the viewport in edit with camera.setEditorOverride(entity.find("GalleryView").id). Players get the normal setup and spawn in front of the gallery.

Built by paperBlocks.PaperGallery (stands, labels, look and paper entries), using only the engine's built-in meshes, this package's gallery materials and styleKit, so it builds in any world with paperBlocks installed. Load it with zero scene load paperBlocks.Gallery.

Cost: seventeen layered papers make 70 passes with the watercolor and ink look; a masked paper does no work outside its own sphere, so the gallery measured 14.7 ms of GPU time on high at 2097 x 1409 (33 ms before masked papers learned to skip the rest of the screen). It is a showcase, not a stack to ship in a game: a game picks one or two papers (a single paper is 0.54 to 0.76 ms high and 0.15 to 0.21 ms low at 1920 x 1080 on a fresh install, see the package README).

Known limits

  • The look runs after antialiasing, so offscreen captures do not show it; read the presented frame (#17427).
  • 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 any content starts (#24669).
  • The web build was not checked from here (#20946).