Quick Start en

Quick Start

日本語版

This guide explains the basic setup of KawaiiPhysics.

---

Prerequisites

• Unreal Engine 5.3 or later
• Basic knowledge of Animation Blueprint

---

Step 1: Enable the Plugin

1. Open Edit > Plugins
2. Search for "KawaiiPhysics"
3. Check Enabled
4. Restart the editor

---

Step 2: Open Animation Blueprint

Open the Animation Blueprint for the SkeletalMesh you want to add physics to.

1. Double-click the AnimBP in Content Browser
2. Select the AnimGraph tab

---

Step 3: Add KawaiiPhysics Node

1. Right-click in the AnimGraph
2. Search for "kawaii"
3. Add KawaiiPhysics node
4. Connect output pose to Final Animation Pose

[Existing Animation] → [KawaiiPhysics] → [Final Animation Pose]

---

Step 4: Set Root Bone

1. Select the KawaiiPhysics node
2. Set Root Bone in the Details panel
   • Specify the "root" bone of the bone chain you want to animate
   • Example: hair_root for hair, skirt_root for skirt

Important: All descendant bones of the Root Bone will be subject to physics simulation.

---

Step 5: Adjust Basic Parameters

First Parameters to Adjust

Parameter	Description	Reference Value
Damping	Motion decay speed	0.1-0.3
Stiffness	Force to return to original shape	0.05-0.2
World Damping Location	Damping during movement	0.5-0.8
World Damping Rotation	Damping during rotation	0.5-0.8

Parameter Adjustment Tips

• Too much sway → Increase Damping
• Too stiff → Decrease Stiffness
• Erratic during movement → Increase World Damping

---

Step 6: Preview

1. Check in the Preview panel of the AnimBP editor
2. Move the character in the viewport to see the physics
3. Fine-tune parameters

---

Troubleshooting Checklist

1. Is Root Bone set correctly?

   • Make sure it's not set to a non-existent bone name

2. Is the node connected properly?

   • Make sure it's connected to Final Animation Pose

3. Is the plugin enabled?

   • Check in Edit > Plugins

4. Are Damping/Stiffness too high?

   • Try setting both to around 0.1

---

Next Steps

• Parameter Reference - Detailed explanation of all parameters
• Hair Setup Tutorial - Detailed hair physics setup
• Skirt Setup Tutorial - Skirt physics setup
• FAQ - Frequently asked questions