Log inGet started
World

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

README.md

toonRamp (asset type)

A toon colour ramp: the five colours light runs through on a cel-shaded surface, from deepest shadow to full light. Every toonBlocks block that shades through a ramp (the toonRamp light block and the toonLit material) takes its colours from the ramp picked with ToonBlocks.setRamp(id), so one change re-colours a whole toon look for every player.

A ramp is a folder <id>.toonRamp/ holding:

  • ramp.yaml:
    name: "Sunset"
    summary: "Warm orange light falling into rose and deep violet shadow."
    tags: [warm, evening, sunset]
    dark: "#2a1438"      # deepest shadow (a light colour the surface is multiplied by)
    shadow: "#7a3f74"    # shadow
    mid: "#e07a62"       # where light turns into shadow
    light: "#ffc58a"     # lit
    high: "#fff1d6"      # full light
    shadowAt: 0.25       # where the shadow colour sits, 0 no light to 1 full light
    midAt: 0.5
    lightAt: 0.78
    hard: 0.8            # 0 smooth blend to 1 stepped like cel paint
    
  • README.md: what mood the ramp gives and what it suits.
  • .metadata: search tags.

The colours are light, not paint: each one multiplies the surface's own colour, so a ramp keeps every object its own colour and only says what colour its light and shadow are. high near white keeps lit surfaces true to their colour; a coloured high tints the whole look. ToonBlocks.ramps() lists every ramp installed, ToonBlocks.ramp(id) reads one.

Known limits

  • An asset of this type registers when the engine indexes its files, a moment after they are written.
  • ZeroMind's description of this can lag one release behind what is installed (#19258).

The package README's Known limits lists the rest.