Style Cookbook: Mix Your Own Art Style from Stackable Look Blocks
- ..
- README.md2.1 KB
- about.yaml723 B
- behavior.luau813 B
- type.yaml926 B
README.md
pigmentSet (asset type)
A pigment set is a palette of paints that every styleKit block reading pigments mixes from: up to eight pigments, each with how much it granulates, plus the pigment shadows pool in, the tint lit areas thin toward and the colour far things lift toward. One change (StyleKit.setPigments(id)) re-colours a whole painted look for every player, because the set is named on the scene's synced StyleStack.
Folder shape
earthy.pigmentSet/
pigments.yaml the palette (required)
README.md what it is for and the mood it gives (required)
.metadata { "tags": ["pigment set", "watercolor", "earthy"] } (required)
pigments.yaml
name: "Earth pigments"
summary: "Ochres, siennas and umbers with a cool grey: a warm, granulating landscape palette."
tags: [earthy, warm, landscape]
pigments: # up to eight; colour is the masstone as picked (#rrggbb)
- { name: "yellow ochre", colour: "#d1a24a", granulation: 0.35 }
- { name: "burnt sienna", colour: "#a4512b", granulation: 0.5 }
- { name: "ultramarine", colour: "#3c4fa8", granulation: 0.9 }
shadow: { colour: "#4b4470", strength: 0.6 } # what shadows pool toward
light: { colour: "#ffe3b8", strength: 0.5 } # what lit areas thin toward
air: { colour: "#ece6d6", strength: 0.4 } # what distance and fog lift toward
pull: 0.75 # how hard colours are re-mixed from the pigments, 0..1
darkest: 0.05 # the darkest value the set reaches (display, 0..1)
saturation: 1.0 # 1 keeps the pigments' own chroma, lower greys them
A block reads the set through the skPigmentSet shader module (skg_remix, skg_shadow, skg_light, skg_air). With no set picked (StyleKit.setPigments("")) blocks keep the scene's own colours. The id is the folder name without .pigmentSet; list them with StyleKit.pigmentSets().
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.