animeBlocks.package
- ..
- .metadata124 B
- README.md2.9 KB
- block.yaml5.7 KB
This package holds more than this page lists. See all of its files in its world.
README.md
Anime cel: pastel chibi (styleBlock, Light)
Pastel chibi anime shading: soft two-tone with gentle pink shadows, light and airy, with faces kept fully clean.
Cute and soft: shadows are a light rose and faces stay clean.
Every anime cel block runs the one animeCel shader with its own defaults, so any of them swaps for any other with StyleKit.swap("light", "<block>"), and { keepSettings = true } carries your tuning across. Settings: tones (2 or 3), shadowAt, deepAt, edge (the soft edge between light and shadow), litColour, shadowColour, deepColour, shadowSaturation, highStep, highAt, highColour, faceClean, faceShadow, warmth, shape, shadeLevel, castBelow, fullLight, keepLightColour.
Clean faces: give a face (or a whole mascot) a StyleChannel value above 0, require("~animeBlocks.AnimeBlocks").cleanFace(entity), and it takes the lit tone with at most one soft shadow tone (faceShadow), never blotches. The light is read the way toonBlocks' ramp reads it (the frame divided by the surface's base colour, redrawn cleanly from the sun by shape), so cast shadows stay shadows. The rim is its own part: add an anime rim block (animeRimThinWarm, animeRimBackLight, animeRimColour) or the Cookbook's toonRim after it, and a highlight shape block after that. The built-in rim (rimStrength, off by default) is a cheaper rim inside this pass for when no separate rim entry is wanted.
What it gives up in motion
Tone edges follow the light, so a moving sun moves the edge between light and shadow across surfaces, as painted cels do between shots. The light is read from a smoothed 8 x 8 mean, so the edge never crawls with texture grain; it is stable under a still sun and a moving camera. Nothing changes on its own over time, and nothing flashes.
How it treats content
- Opaque things: shaded into flat tones from their own base colour.
- Transparent things (glass, water): not in the surface copy, so they keep the frame as drawn behind the toned surfaces.
- Particles and smoke: left as drawn; the tones are laid on the surface behind them.
- Sky: left exactly as rendered (pair it with paintedSkies for a painted sky).
- Fog: fog in the frame lowers the read light, so far things drift toward the shadow tone; use a depth mask to keep far things lit.
- Skinned characters: toned like everything else, every frame; give the face a StyleChannel value for a clean face.
- Foliage: toned from its base colour; alpha cut leaves take the tone of the leaf.
- World text: toned like a surface; exclude labels a player must read (
StyleKit.options({ exclude = { id } })). - Black stays black: returns through styleKit's
sk_finish, and zero light stays zero (tone times light presence). - Dim rooms: tones scale with the light that arrived, so a dim room stays dim; it is a Light block and adds no light sheet, so it does not ask for the dim guard.