Palette

Tag Info
Syntax	[palette:{id}]
Alias	[pal:{id}]
Used On	[dynamic] children
Requires	—

On the right is an example of how the [palette] tag appears in the PSD file; on the left is how it will look in the game.

The palette tag turns a child layer of a [dynamic] group into a colorable image item. When the player loads, the engine reads the layer's pixels to detect the most prominent color and snaps it to the nearest color in the active palette — that becomes the layer's default active color. In the player, the user can then pick any color from the palette and the layer recolors to match. Without [palette], a child of [dynamic] is a plain image with no color behavior.

Usage

The tag is written as [palette] or [palette:paletteName]. The alias is [pal] or [pal:paletteName].

When written without a value, the layer uses the default built-in palette. To assign a specific palette, add the palette name after a colon: [palette:cottagecore], [palette:skintones], etc. The name must match either one of the built-in palettes (barbiecore, cottagecore, darkmori, goth, scene, basic, skintones) or a custom palette defined in the PSD via [local-palette:name].

Built-in Palettes

Name	Colors
barbiecore
cottagecore
darkmori
goth
scene
basic
skintones

The tag must be placed on a direct child layer of a [dynamic] group. The layer must have no children of its own and must be an image layer.

Example: A hair group has `[dynamic]`. It has child layers: Hair Base and Hair Highlights. Tag Hair Base with `[palette:basic]` so the user can pick a base hair color. Tag Hair Highlights with `[palette:barbiecore]` as well so its highlight tones are independently colorable. Both layers recolor separately, letting the player mix a base shade with a contrasting highlight.

Grande Palette

This is how the Grande Palette modal looks when the user clicks on the color wheel button.

The Grande Palette is a premium color picker feature that gives players access to a full color wheel instead of being limited to the preset palette swatches. When enabled, a color wheel button appears at the top of the color selector in the player UI. Clicking it opens a modal with a hue/saturation wheel and a hex input, letting the player pick any arbitrary color and apply it to the `[palette]` layer.

Compatible tags

[palette] can be combined with the following tags on the same layer:

• [color-link:channel] — links the layer to a global color scope so color picks sync across items.
• [removable] — adds a visibility toggle button in the player UI.
• [visibility-link:scope] — syncs visibility with other items sharing the same scope.
• [visibility-group:group] — makes items in the same visibility-link scope mutually exclusive.
• [ui-hidden] — keeps the layer active in color logic without showing it as a selectable entry.

It can't be combined with tags other than the above.

Additional Tags to Use with Palette

[color-link] — Link the palette layer to a color channel so other layers in the same scope stay in sync when the user picks a color.

[enable-color-global] — Apply to the parent category to activate cross-item color syncing for all [palette] (and [color-picker]/[color]) layers within it.

[visible-when-color-in] — Use on layers (alongside [color-link]) to show or hide alternate details based on which palette color is currently active.

[local-palette:name] — Define a custom set of colors in the PSD for [palette] to reference by name.