vrm-springbone-physics

What problem does it solve?

This Skill helps developers identify and fix VRM SpringBone physics issues in three-vrm, such as hair and clothing physics behaving unnaturally.

Core Features & Use Cases

• Delta-time aware physics: Correctly drive SpringBone updates using seconds-based delta time to prevent explosions.
• Collider radius tuning: Provide adjustable collider radii to compensate for UniVRM export quirks.
• Runtime scaling awareness: Ensure colliders scale with the VRM model when the scene or model is scaled.
• Use Case: A developer loads a VRM model with hair physics that flies upward and applies the recommended fixes to stabilize the simulation.

Quick Start

1. Load a VRM model and call initializeVRMPhysics(vrm) before starting the render loop.
2. Use a THREE.Clock to obtain delta time, clamp it to 0.05 seconds, and call vrm.update(delta) each frame.
3. Verify hair and clothing physics behave naturally after applying collider reduction and delta-time fixes.