> For the complete documentation index, see [llms.txt](https://docs.cainos.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cainos.net/customizable-pixel-character/setup-guide.md).

# SETUP GUIDE

### Input System Compatibility in Unity 6

By default, this asset uses the legacy **Input Manager** for backward compatibility. Since Unity 6 no longer enables the legacy Input Manager by default, you may experience non-responsive inputs.

To resolve this, choose one of the following options:

* **Keep Using Legacy Input**: Go to **Project Settings > Player** and change **Active Input Handling** to **Both** . (Note: Setting this to Input Manager (Old) will not work if the new Input System package is installed in your project.)
* **Upgrade to New Input System**: Import the provided **Patch - Input System** package to upgrade the default controls to the new Input System.

<figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2Fo3i6ZxhhRxQIJsxyJDje%2FUnity%206.1%20Input%20Handling.png?alt=media&amp;token=6641149d-af54-4987-94b2-e466e10308b1" alt="" width="375"><figcaption></figcaption></figure>

### Layer Collision Settings

To prevent a character from colliding with its own weapon, place the character and weapon on separate layers and disable collision between those layers in your project's 2D Physics settings.

In this setup, assign characters to the **Player** layer and weapons to the **Player Weapon** layer (adjust as needed for your project structure).

To apply these settings quickly using the provided preset files:

1. Go to **Project Settings > Physics 2D**.
2. Click the Preset icon in the top-right corner and select the **Settings - Physics 2D** preset file.
3. Repeat this process in **Project Settings > Tags and Layers** using the **Settings - Tags and Layers** preset file.

**Note:** If you are applying presets to an existing project, back up your original settings before proceeding.

<div><figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2Fg40GHMT8zCmgy3ErKMQi%2FPhysics%202D%20Settings.png?alt=media&amp;token=58611b02-0253-4849-8a05-2dcc697db51d" alt=""><figcaption></figcaption></figure> <figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FwqI3WnNZ3NUuyLW79akK%2FTags%20and%20Layers%20Settings.png?alt=media&amp;token=13b26be1-88f6-4cd5-93b4-090a249b62e4" alt=""><figcaption></figcaption></figure></div>

All the character presets are variation prefabs of `Cainos\Customizable Pixel Character\Prefab\PF Pixel Character`. So for overall changes you only need to modify this one.

### Custom Sort Axis&#xD;

It is recommended that you set `Transparency Sort Mode` to `Custom Axis` and `Transparency Sort Axis` to `(0,0,1)` at the Graphics settings.

<figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FReyaJKcfwtn51FsHYhpq%2Fcustom_sort_axis.png?alt=media&amp;token=69d1fe6a-b329-4c9f-ba8e-a79361f2aba7" alt="" width="375"><figcaption></figcaption></figure>

### Lighting Support

By default, the character shaders behave like an unlit sprite shader, and can be used in any render pipeline.

But if you need lighting on the character, you need to install additional shaders to make them support lighting.

Currently lighting on character only supports `Universal Render Pipeline`.

### Universal Render Pipeline 2D Lighting

Import the patch version that corresponds to your Unity version. It will replace current character shaders with versions that support URP 2D Lighting.

* Before Unity 6: Import **Patch - URP 2D Lit**
* Unity 6.0 to 6.2: Import **Patch - URP 2D Lit - Unity 6.0 to 6.2**
* Unity 6.3 or newer: Import **Patch - URP 2D Lit - Unity 6.3 or newer**

Make sure your 2D lighting is properly set up so the character can be displayed correctly.

If the water in the demo scene is not displayed correctly, you also need to setup the water rendering. Please follow the [**Interactive Pixel Water | Setup Guide**](https://docs.cainos.net/interactive-pixel-water/setup-guide)

### Universal Render Pipeline 3D Lighting

Import the patch version that corresponds to your Unity version. It will replace current character shaders with versions that support URP 3D Lighting.

* Before Unity 6: Import **Patch - URP Lit**
* Unity 6.x: Import **Patch - URP Lit - Unity 6**

If the water in the demo scene is not displayed correctly, you also need to setup the water rendering. Please follow the [**Interactive Pixel Water | Setup Guide**](https://docs.cainos.net/interactive-pixel-water/setup-guide)

### Fixing Missing UI Text

The demo UI utilizes Text Mesh Pro. If your project does not already include it, a prompt to Import TMP Essentials will appear when you open the scene. Please complete the import and then reopen the scene to ensure the text displays correctly.

If the prompt does not appear automatically, you can trigger it manually by selecting any Text Mesh Pro object in the Hierarchy.

### Skin Weights&#xD;

For best animation quality, in **Project Settings>Quality**, **Skin Weights** should be set to at least **2 Bones**.

<figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FqeuTRsYH4edqxgm7KNRb%2Fskin_weights.png?alt=media&amp;token=1d8cda51-7310-4c11-9463-da86c201b610" alt="" width="375"><figcaption></figcaption></figure>

### Color Space

It is recommended to use `Linear` color space with this asset. You can find it in `Project Settings/Player/Other Settings`.

<figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2Fd8MnEKhWwepBc70ttib1%2Fcolor_space.png?alt=media&amp;token=98e32829-df26-4457-ac1d-860834919120" alt="" width="375"><figcaption></figcaption></figure>

### Sorting Order Glitch When Using Multiple Character&#xD;

You may see some glitch when two characters are too close. It happens when the two characters take up the same z space. Give them different z position value will solve the problem.\
You can set the character’s z scale to a smaller value like `0.1` (but avoid setting it to `0.0`), so that it takes up less z space.

<div><figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FxfN1q9d5OWDY6erSttG7%2Fsor_order_glitch_01.png?alt=media&amp;token=52795121-15e4-43a0-afe5-c1863e1fecca" alt="" width="177"><figcaption></figcaption></figure> <figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FXrBngNP6SyuygOjV9DNO%2Fsor_order_glitch_02.png?alt=media&amp;token=345b02f9-cc15-4e47-ba12-6840d1096adc" alt="" width="161"><figcaption></figcaption></figure></div>

### Parts of the Character Not Visible When Using a Background

The background may be positioned at the same z-coordinate as the character, causing it to occlude parts of the model. Since the character is not a flat plane (it has 3D depth), overlapping z-positions can result in rendering conflicts.

Adjust the background’s position by moving it backward along the z-axis (assigning it a larger z-value). This ensures proper depth sorting, allowing the character to render fully in front of the background.

<figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FSgvcJjKzRxDey8HbukN5%2Fparts_of_character_no_visible%2001.png?alt=media&amp;token=fdf13288-6628-49f1-aa3a-cbc4d98f2708" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://2697269646-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVAsWZLJR6xuMkfJM3gAU%2Fuploads%2FL3w1EUPV81YuOlgjxApC%2Fparts_of_character_no_visible%2002.png?alt=media&amp;token=63d2fc89-40e3-4faf-b3f7-81a720266412" alt="" width="563"><figcaption></figcaption></figure>
