Quickstart

Character Creator Quickstart (Splitter + Wizard-First)

This is the fastest way to get Character Creator working.

Recommended path:

1. Run Equipment Splitter Window to create modular equipment prefabs.

2. Run Character Creator Setup Wizard.

3. Run Scene Demo Setup Wizard (scene setup step).

4. Enter Play Mode and test equip/morph/save/load.

Requirements

• A character prefab asset with SkinnedMeshRenderer parts (for Equipment Splitter).

• A character scene instance (not prefab asset) with:

  • Animator

  • body SkinnedMeshRenderer (blendshapes if you want morph controls)

• Optional: if you already have modular equipment prefabs, you can skip the splitter.

Step 1: Equipment Splitter Window

Open:

• Tools/Character Creator/Create Equipment...

Do:

1. Assign Character Prefab (prefab asset, not scene object).

2. Choose Output Path.

3. Keep/disable mesh rows and rename output prefab names if needed.

4. 
5. Click Split into X Equipment Prefabs.

Recommended prefab authoring flow:

1. Drag your character prefab into the scene (temporary setup instance).

2. Run Setup Wizard on that scene instance and click Apply Setup.

3. Apply those component/config changes back to the prefab.

4. You can then delete the temporary scene instance.

What this gives you:

• modular equipment prefabs (one per selected SkinnedMeshRenderer) ready to register in Character Creator

Step 2: Character Setup Wizard

Open:

• Tools/Character Creator/Character Creator Setup Wizard

Do:

1. Assign Character Root (scene object).

2. Assign Source Body Mesh.

3. (Optional) Enable Add RememberCharacterPreset for Crystal Save integration.

4. Add your generated equipment prefabs from Step 1.

5. Click Apply Setup.

What this gives you:

• EquipmentManager

• BlendshapeSynchronizer

• BodyPartLengthAdjuster (if available)

• CharacterPresetManager

• basic auto configuration for material tracking + explicit color slots

Step 3: Scene Demo Setup Wizard

Open:

• Tools/Character Creator/Scene Demo Setup Wizard

Recommended defaults for first run:

1. UI Output: Full Character Creator Demo

2. UI Design: pick any (Minimal Dark Overlay is a good default)

3. Enable Add EventSystem

4. Enable Replace Existing Demo Canvas

5. Keep Enable Head Tab (Hair/Face) ON if you have hair/face equipment

6. Click Build Demo UI

What this creates:

• CharacterCreatorDemoCanvas

• Fully wired CharacterCreatorDemoUI with tabs, templates, sliders, and preset list

Step 4: Test In Play Mode

In Play Mode:

1. Open Equipment (and Head if enabled), equip items.

2. Open Body, test body sliders + blendshapes + skin/eye colors.

3. Open Presets, enter a name, click Save.

4. Create another look and click Load on previous preset to verify restore.

Expected:

• Equipment, blendshapes, body scale, and tracked colors restore correctly.

Optional: Preset Gallery UI

If you only want preset browsing/loading UI:

1. In Scene Demo Setup Wizard set UI Output to Preset Gallery Only.

2. Click Build Preset Gallery UI.

Creates:

• CharacterCreatorPresetCanvas

• CharacterPresetGalleryUI

Optional: Spawned Prefab Runtime Flow

If the character is instantiated at runtime:

1. Spawn prefab instance.

2. Bind CharacterCreatorDemoUI to the spawned instance (BindCharacter(..., rebuild: true)).

3. Then allow customization/save/load.

Important:

• Bind to the spawned instance, not the prefab asset.

Optional: Crystal Save Integration

If you enabled Add RememberCharacterPreset in Setup Wizard:

• Wizard ensures RememberComposite and registers RememberCharacterPreset.

• Character appearance is restored with save/load without per-mesh remember setup.

Common Gotchas

Problem	Cause	Fix
Build button disabled in Scene Demo Wizard	Missing required managers/body renderer	Run Setup Wizard first on the same character
Blendshape sync appears inconsistent	Animation clip writes blendshape values	Use neutral clip or remove blendshape animation keys
UI works in one scene but not demo scene	Demo UI not bound to correct character refs	Rebuild via wizard or call BindCharacter at runtime
No interaction in diegetic mode	Missing world camera/EventSystem	Assign camera to world-space canvas and ensure EventSystem exists

Recommended Next Docs

• character-creator-setup-wizard.md

• character-creator-scene-demo-setup-wizard.md

• character-creator-demo-ui.md

• character-creator-game-creator-2-integration.md