Enable Color Global

The enable-color-global tag links the children of a category so they all stay in sync with each other, and with any other categories that share the same scope name. When the player picks a color on any item inside a tagged category, every other item under the same scope automatically updates to match. This is useful when a character has multiple body parts spread across separate category groups that should always share the same color.

Usage

The tag is written as [enable-color-global:scopeName], where scopeName is a name you choose to tie categories together. It can also be written as [cg:scopeName] or [color-global:scopeName]. The scope name is optional, but a named scope is required when you want two or more categories to share the same color state.

The tag must be placed on a category folder layer, alongside one of the category type tags: [fixed], [optional], or `[mixed]`. It applies to all children of that category that carry a [color-picker], [color], or [dynamic] tag.

For example, if a "Body" category and an "Arms" category should always display the same active color, tag both category folders with `[enable-color-global:skin]`. Selecting a color swatch in either category will immediately update the other.

Additional Tags to Use with Enable-Color-Global

[color-picker] — A layer item that lets the player choose one color from a fixed set of swatches. When a `[color-picker]` item sits inside a category tagged with `[enable-color-global:scopeName]`, selecting a swatch also updates every other item registered under the same scope.

[color] — A layer item that represents a single color swatch, where the layer's name is the color value in RGB hex format (e.g., `#FF00FF`). When a `[color]` item sits inside a category tagged with `[enable-color-global:scopeName]`, selecting it also updates every other item registered under the same scope.

[dynamic] — A layer item that renders color through [palette] children. When a `[dynamic]` item sits inside a category tagged with `[enable-color-global:scopeName]`, the engine locates each child tagged with `[palette]` and registers it as a member of the global color scope. Selecting a color on any linked item in the scope will update the matching palette child inside every `[dynamic]` item that shares the same scope name.