Presets
Customization presets define which elements and colors are available for a specific character setup, along with default selections.
Creating a Preset Entry
Open the Spark Editor, go to Character Customization > Presets and click Create New.
Each preset entry defines:
Display Name
Preset name (e.g., "Human Male Preset", "Elf Female Preset").
Category Elements
Visual elements available for this preset, grouped by category.
Category Colors
Color options available for this preset, grouped by category.
Category Elements
Each category element group defines:
Category
The customization category.
Elements
List of element entries available in this category for this preset.
Default Element Index
Which element is selected by default (0-based index).
Category Colors
Each category color group defines:
Category
The customization category.
Colors
List of color entries available in this category for this preset.
Default Color Index
Which color is selected by default (0-based index).
Setting Up the CharacterCustomizationEntity
To enable customization on a character, add a CharacterCustomizationEntity component in the Inspector.
Customization Preset
The preset entry that defines available options for this character.
Element Entry Slots
Visual element slots populated from the preset. Each slot pairs an element entry with a list of visual options — each option has a name and a target GameObject to activate/deactivate.
Element Color Slots
Color slots populated from the preset. Each slot pairs a color entry with target renderers to apply colors to.
The editor provides an Initialize From Preset button that auto-populates the element and color slots from the assigned preset. After initialization, assign the target GameObjects and renderers for each slot.
Additional editor buttons available in Play Mode: Randomize (applies random customization for testing) and Apply Default (resets to preset defaults).
Persistence
Character customization is automatically saved and loaded through Spark's save system. What is saved includes the active element option index for each element and the current color value for each color slot.
Last updated
Was this helpful?
