# Colors

Customization colors modify material properties on the character — such as hair color, skin tone, or eye color.

## Creating a Color Entry

Open the Spark Editor, go to **Character Customization > Colors** and click **Create New**.

Each color entry defines:

| Field                  | Description                                                                                               |
| ---------------------- | --------------------------------------------------------------------------------------------------------- |
| Display Name           | Color option name shown in the customization UI (e.g., "Hair Color", "Skin Tone", "Eye Color").           |
| Category               | The customization category this color belongs to.                                                         |
| Material Property Name | The shader property to modify on the character's material (e.g., "\_BaseColor", "\_HairTint").            |
| Available Colors       | List of color options the player can choose from. Each option has a **Color Name** and a **Color** value. |
| Sort Order             | Display order within the category.                                                                        |

## How Colors Work

Colors modify material properties on specific renderers. In the **CharacterCustomizationEntity** component, each color entry is paired with a list of target renderers on the character model. When the player selects a color, the specified material property is updated on all target renderers.

For example, a "Hair Color" entry with material property "\_HairTint" and available colors like "Black", "Brown", "Blonde", and "Red" would let the player change their character's hair color by modifying the \_HairTint property on the hair mesh renderer.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sparkframework.dev/documentation/user-guide/plugins/customization/colors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
