Kawaii Physics

English README

---

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

デモ動画 (Demo Video)

目次 (Contents)

• ギャラリー
• 特徴
• 導入方法
• ドキュメント＆コミュニティ
• 解説記事・動画
• サンプル
• 採用実績
• 関連ツール
• ライセンス
• 作者
• 更新履歴

ギャラリー

キャラクター：Grayちゃん

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

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

特徴

• アニメーションやキャラクターの動きに合わせて、揺れものを物理制御します
• AnimGraphにKawaiiPhysicsノードをひとつ追加するだけで使えます
• 球・カプセル・平面のコリジョンに対応。ビューポート上で直感的に調整できます
• 骨の長さを保つので、計算が破綻してもボーンが伸び縮みしません
• PhysXに頼らないシンプルな計算なので、動作が軽いのが特長です
• 風や重力に加えて、演出目的の外力も加えられます
• DataAssetやPhysicsAssetにパラメータを保存して使い回せます
• ボーン間の距離制約で、スカートの裾が足を貫通するのを抑えられます（BoneConstraint)
• アニメ制御下のボーン（足など）の動きを揺れものに同期させ、追従や貫通対策ができます（SyncBone）
• Blueprint・C++から、実行中にパラメータや外力を動的に制御できます

参考資料

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

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

導入方法

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: 不具合報告

解説記事・動画

公式

• 揺れ骨用自作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 ...

サンプル

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

• サンプルレベル: 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/

採用実績

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

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

関連ツール

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

ライセンス

MIT License

作者

おかず @pafuhana1213

更新履歴

Announcements - アナウンス

---

よろしければご支援を！

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

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

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