Kawaii Physics

English README

---

Kawaii Physicsは、Unreal Engine向けのシンプルな疑似物理プラグインです。
髪、スカート、胸などの揺れものを「かんたんに」「かわいく」揺らすことができます。

<a href="https://youtu.be/0f-l-SP07Mo"> <img src="https://github.com/user-attachments/assets/0bc33f5c-c7db-49b3-8e98-75dc062a4e2a" alt="Demo Video" width="640px"> </a>

デモ動画 (Demo Video)

🖼️ ギャラリー (Gallery)

<img src="https://github.com/user-attachments/assets/fda69859-b60f-4fde-a683-62da3e2839e4" alt="compare" width="640px">

キャラクター：Grayちゃん

<img src="https://github.com/user-attachments/assets/28d72d0c-4423-41c7-bc52-c5c7c3886e02" alt="dance5" width="640px">

キャラクター：オリジナル3Dモデル『ルゼブル』-Lzebul- / モーション：ミライ小町

<img src="https://github.com/user-attachments/assets/63faed3c-8aaa-4d4d-ae33-e98f9c8c15fd" alt="danceKano" width="640px">

キャラクター：TA式 鷺宮カノ / モーション：しかのこのこのここしたんたん / セットアップ：株式会社TA様

✨ 特徴 (Features)

<table> <tr> <td><img src="https://github.com/pafuhana1213/Screenshot/blob/master/KawaiiPhysics2.jpg?raw=true" width="320"></td> <td><img src="https://github.com/pafuhana1213/Screenshot/blob/master/KawaiiPhysics4.gif?raw=true" width="320"></td> </tr> </table>

• アニメーションやキャラクターの動きに基づいた物理制御
• AnimGraph内のKawaiiPhysicsノード一つで簡単にセットアップ
• 球・カプセル・平面のコリジョンに対応し、ビューポートで直感的に調整可能
• 計算が破綻してもスケルトンが伸び縮みしない安定性
• PhysX非依存の軽量なアルゴリズム
• 風や重力だけでなく、演出目的の外力も適用可能
• DataAssetやPhysicsAssetを使ったパラメータの保存・共有が可能

参考資料

物理挙動を実装するにあたって、以下の資料を参考にしました。

• 次期アイドルマスター グラフィクス＆アニメーション プログラミング プレビュー

🚀 導入方法 (Getting Started)

1. ダウンロード

C++ビルド環境がない方は、以下のリンクからプラグインをダウンロードしてください。

• GitHub Releases
• FAB (内容はGitHub版と同じです）
• Booth (ストアをフォローすると更新通知が届きます)

2. 対応バージョン

• UE 5.3 ~ 5.7
• UE4.27: v1.11.1

3. インストール

1. プロジェクトのルートに Plugins フォルダを作成します。
2. ダウンロードした KawaiiPhysics フォルダを Plugins フォルダにコピーします。

4. 使い方

• Animation BlueprintのAnimGraphで KawaiiPhysics ノードを追加して利用します。
• 詳細なパラメータ設定については、Wikiを参照してください。
  • 各パラメータについて

Note: Blueprintのみのプロジェクトでパッケージ化する際にエラーが出る場合があります。その際は、C++プロジェクトに変換するか、こちらの記事を参考にしてください。

📚 ドキュメント & コミュニティ

• Wiki: 公式ドキュメント（整備中）
• DeepWiki: AIによる自動生成ドキュメント
• Discussions: 質問、要望、雑談などはこちらへ
• Issues: 不具合報告

🎓 解説記事 & 動画 (Tutorials)

公式

• 揺れ骨用自作AnimNode「Kawaii Physics」の内部実装解説的なもの その1
• #ControlRig を使ったスカートの突き抜け対策と#KawaiiPhysics を併用してみるテスト

非公式 (ありがとうございます！)

• 揺れモノ超ド素人がKawaiiPhysicsを使って、感覚を頼りに女性キャラクターモデルのKawaiiを増す方法まとめ
• 揺れものとコントロールリグ UEを使用したバーチャルライブでの実例
• 【UE】揺れ物設定（Kawaii Physics）
• 【UE4】Kawaii Physicsチュートリアル#1
• How To Setup Kawaii Physics in Unreal Engine 5
• ５分でわかるKawaii Physicsの使い方！【UE5】【tutorial】
• The Hidden Physics “Engine” Behind Unreal's Most Stylish Games ...

🎮 サンプル (Sample)

<img src="https://github.com/user-attachments/assets/0d866ad2-f803-400b-bd23-2d46ab17b8ae" alt="sample2" width="640px">

プロジェクト内にサンプルレベルとキャラクターが含まれています。

• サンプルレベル: Content/KawaiiPhysicsSample/L_KawaiiPhysicsSample
• 使用キャラクター:
  • Grayちゃん: http://rarihoma.xvs.jp/products/graychan
  • TA式 鷺宮カノ: 株式会社TA様よりご提供
    • Copyright (c) 2025 株式会社TA All rights reserved
    • 利用規約：https://uzurig.com/ja/terms_of_use_jp/

🌟 採用実績 (Showcase)

多くのプロジェクトで採用されています！

• 採用実績一覧
• あなたの作品もぜひ こちら で教えてください！
• Twitter/Xで作品を共有する際は、ぜひハッシュタグ #KawaiiPhysics をお使いください！

関連ツール(Related tools)

• VRM SpringBoneをKawaiiPhysicsに変換するツール

📜 ライセンス (License)

MIT License

👨‍💻 作者 (Author)

おかず @pafuhana1213

📅 更新履歴 (Changelog)

Announcements - アナウンス

---

✨ よろしければご支援を！

このプラグインが、皆さんのUEプロジェクトに少しでも役立っていれば、とても嬉しいです。

開発は私個人が趣味と実益を兼ねて、開発時間の確保やコーヒー代を自腹でやりくりしながら進めています☕
もし「なかなか良いじゃん！」と思っていただけたら、FABでの購入やGitHub Sponsorsで応援していただけると、
開発を続ける上で大きな励みになります（FABでの販売を開始に関して詳細な経緯はこちら）。

💖FABで購入する
💖 GitHub Sponsorsで応援する