Kawaii Physics

English README

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

デモ動画 (Demo Video)

🖼️ ギャラリー (Gallery)

キャラクター：Grayちゃん

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

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

✨ 特徴 (Features)

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

参考資料

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

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

🚀 導入方法 (Getting Started)

1. ダウンロード

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

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

2. 対応バージョン

• UE 5.3 ~ 5.6
• 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)

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

• サンプルレベル: 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 をお使いください！

📜 ライセンス (License)

MIT License

👨‍💻 作者 (Author)

おかず @pafuhana1213

📅 更新履歴 (Changelog)

Announcements - アナウンス

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

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

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

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