pencilWorld
Turn an existing world, scene or installed kit into a hand-drawn pencil sketch (or a charcoal, conte, coloured pencil, ballpoint or doodle drawing) with pencilBlocks and styleKit, without breaking or losing anything.
pencilWorld
Turn an existing world, scene or installed kit into a hand-drawn pencil sketch (or a charcoal, conte, coloured pencil, ballpoint or doodle drawing) with pencilBlocks and styleKit, without breaking or losing anything.
What it does
- Survey. Reads what is there before changing anything: the scene's entities, the materials in use (emissive, glass and water, bright colours that carry meaning), the lights and whether they change over time, the screen UI, particles, the player and other moving characters, world labels, any stack already in place (kept so it can be put back), any character already painted with
PencilHero, and the pencil blocks and whole looks installed. - Reference. Saves the plain presented frame under
/zero/source/tmp/pencil/<subject>/and picks a reference drawing of the same view: one generated with image generation (theimage_genservice), or, for this world's pencil stage, one of the reference pictures already in/zero/source/design/references/pencilstage. - Choose. Picks a medium and its variant (graphite 2H, HB, 4B, 6B or mechanical; coloured pencil; charcoal; conte; ballpoint; notebook doodle), a line and a paper, or one of the eight whole looks (
pencilSketch,charcoalStudy,whiteCharcoalNight,conteFigureStudy,ballpointNotebook,doodleMargins,coloredPencilWash,fieldNotesOnKraft), with a reason for each. - Build. Builds the stack in one call that replaces rather than duplicates:
StyleKit.applyLook(id), orStyleKit.load(entries, { holdRate, softRadius })withshade,lineandpaperentries. - Tune. Up to three rounds of comparing presented frames against the reference and the asked look, adjusting hardness, pressure, stroke direction and size, layers, tone range, smudge, line weight and distance, and the paper's tooth.
- Content. Paints the player and moving characters with
PencilHero.paint, so their marks travel with them and the full-frame shade and any wash are kept off them; leaves labels a player must read out by name; keeps gameplay colours and screen UI readable. - Check. UI and labels readable, gameplay colours kept, black stays black and a dim room stays dim (styleKit's dim guard), no flashing above 3 Hz and no fine high-contrast stripes, the Lookbook's numbers for the new stack against the old one, and the low quality tier.
- Report. Answers with the medium, the stack before and after, every exclusion, group and mask, every painted character with the call that restores it, the checks, the Lookbook numbers and how to remove it all.
It is non-destructive: the stack edits no material and comes off with StyleKit.clear() (or by deleting the StyleStack entity), and the report gives the exact StyleKit.load(...) call that puts back the stack from before the run. The one change outside the stack it makes is painting characters with PencilHero.paint, which writes derived materials under /zero/source/pencilHero and records the originals; each painted character is reported with PencilHero.unpaint(target, { removeFiles = true }), which puts every original back and deletes the derived files.
What it needs
pencilBlocks installed (it comes with styleKit, paperBlocks, watercolorBlocks, inkBlocks and lookbookKit). The reference drawing uses the image_gen service (it spends credits; the run carries on without one if generation fails, and says so). The Lookbook check uses lookbookKit.
Starting it
zero workflow start --name pencilWorld --args '{"subject":"main","look":"soft graphite sketch with crossed hatching on rough paper"}'
subject names the world, scene or kit (default: the loaded scene); look is the drawing in the asker's words (default: the run proposes one).
Known limits
- Installing a package with several dependencies can take a while (#21420).
- ZeroMind's description of this can lag one release behind what is installed (#19258).
- The web build was not checked from here (#20946).
The package README's Known limits lists the rest.
Scoped to this part · feeds back into the world's score.