> For the complete documentation index, see [llms.txt](https://docs.sparkframework.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkframework.dev/documentation/user-guide/plugins/customization/colors.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.