Kawaii Physics Documentation

repository·master·Indexed 25 days ago

https://github.com/pafuhana1213/kawaiiphysics

A lightweight pseudo-physics plugin for Unreal Engine (UE 4.27, 5.3–5.7) providing secondary animation for characters via a single AnimGraph node. Features include sphere, capsule, and plane collision support, bone length preservation, BoneConstraint and SyncBone constraints, and runtime control via Blueprints or C++.

Tokens
661
Snippets
0
Records
4
Agent score
35%

What's inside Kawaii Physics

  1. Overview of Kawaii Physics

    master

    Kawaii Physics is a simple pseudo-physics plugin for Unreal Engine designed to easily and 'cutely' simulate physics for hair, skirts, breasts, and other secondary animations.

    Key features include:

    • AnimGraph Integration: Add a single KawaiiPhysics node to your AnimGraph to enable physics.
    • Collision Support: Supports Sphere, Capsule, and Plane collisions, adjustable directly in the viewport.
    • Bone Length Preservation: Maintains bone lengths even if calculations fail, preventing unnatural stretching.
    • Lightweight: Uses simple calculations instead of relying on PhysX, ensuring high performance.
    • Advanced Constraints:
      • BoneConstraint: Prevents issues like skirt hems penetrating legs by using bone-to-bone distance constraints.
      • SyncBone: Synchronizes physics-controlled bones with animation-controlled bones (e.g., feet) to prevent penetration and improve tracking.
    • Dynamic Control: Parameters and external forces can be controlled at runtime via Blueprints or C++.
    • Data Persistence: Parameters can be saved and reused using DataAsset or PhysicsAsset.
  2. Install Kawaii Physics in Unreal Engine

    master

    To install the plugin manually:

    1. Download the plugin from GitHub Releases, FAB, or Booth.
    2. Create a folder named Plugins in your Unreal Engine project's root directory if it doesn't exist.
    3. Copy the downloaded KawaiiPhysics folder into the Plugins folder.

    Supported Versions:

    Note for Blueprint-only projects: You may encounter errors when packaging. If this happens, convert your project to a C++ project or follow this troubleshooting guide.