# Kawaii Physics
[English README](https://github.com/pafuhana1213/KawaiiPhysics/blob/master/README_en.md)
---
Kawaii Physicsは、Unreal Engine向けのシンプルな疑似物理プラグインです。
髪、スカート、胸などの揺れものを「かんたんに」「かわいく」揺らすことができます。
[デモ動画 (Demo Video)](https://youtu.be/0f-l-SP07Mo)
目次 (Contents)
- [ギャラリー](#ギャラリー)
- [特徴](#特徴)
- [導入方法](#導入方法)
- [ドキュメント＆コミュニティ](#ドキュメントコミュニティ)
- [解説記事・動画](#解説記事動画)
- [サンプル](#サンプル)
- [採用実績](#採用実績)
- [関連ツール](#関連ツール)
- [ライセンス](#ライセンス)
- [作者](#作者)
- [更新履歴](#更新履歴)
## ギャラリー
*キャラクター：[Grayちゃん](http://rarihoma.xvs.jp/products/graychan)*
*キャラクター：[オリジナル3Dモデル『ルゼブル』-Lzebul-](https://booth.pm/ja/items/4887691) / モーション：[ミライ小町](https://www.miraikomachi.com/download/)*
*キャラクター：[TA式 鷺宮カノ](https://uzurig.com/ja/uzurig2-rigging-plugin-for-maya-jp/) / モーション：[しかのこのこのここしたんたん](https://booth.pm/ja/items/5975857) / セットアップ：[株式会社TA様](https://xta.co.jp/)*
## 特徴
- アニメーションやキャラクターの動きに合わせて、揺れものを物理制御します
- AnimGraphに`KawaiiPhysics`ノードをひとつ追加するだけで使えます
- 球・カプセル・平面のコリジョンに対応。ビューポート上で直感的に調整できます
- 骨の長さを保つので、計算が破綻してもボーンが伸び縮みしません
- PhysXに頼らないシンプルな計算なので、動作が軽いのが特長です
- 風や重力に加えて、演出目的の外力も加えられます
- `DataAsset`や`PhysicsAsset`にパラメータを保存して使い回せます
- ボーン間の距離制約で、スカートの裾が足を貫通するのを抑えられます（BoneConstraint)
- アニメ制御下のボーン（足など）の動きを揺れものに同期させ、追従や貫通対策ができます（SyncBone）
- Blueprint・C++から、実行中にパラメータや外力を動的に制御できます
- その他の最新機能は [更新履歴（KawaiiPhysics Portal）](https://pafuhana1213.github.io/KawaiiPhysics-Portal/docs/changelog) を参照
### 参考資料
物理挙動を実装するにあたって、以下の資料を参考にしました。
- [次期アイドルマスター グラフィクス＆アニメーション プログラミング プレビュー](https://cedil.cesa.or.jp/cedil_sessions/view/416)
## 導入方法
### 1. ダウンロード
C++ビルド環境がない方は、以下のリンクからプラグインをダウンロードしてください。
- **[GitHub Releases](https://github.com/pafuhana1213/KawaiiPhysics/releases/)**
- **[FAB](https://www.fab.com/ja/listings/f870c07e-0a02-4a78-a888-e52a22794572)** (内容はGitHub版と同じです）
- **[Booth](https://pafuhana1213.booth.pm/items/5943534)** (ストアをフォローすると更新通知が届きます)
### 2. 対応バージョン
- **UE 5.3 ~ 5.8**
- UE4.27: [v1.11.1](https://github.com/pafuhana1213/KawaiiPhysics/releases/tag/20230830-v1.11.1)
### 3. インストール
1. プロジェクトのルートに `Plugins` フォルダを作成します。
2. ダウンロードした `KawaiiPhysics` フォルダを `Plugins` フォルダにコピーします。
### 4. 使い方
- Animation BlueprintのAnimGraphで `KawaiiPhysics` ノードを追加して利用します。
- 詳細なパラメータ設定については、[ドキュメント](https://pafuhana1213.github.io/KawaiiPhysics-Portal/docs/parameters/physics)を参照してください。
> **Note:** Blueprintのみのプロジェクトでパッケージ化する際にエラーが出る場合があります。その際は、C++プロジェクトに変換するか、[こちらの記事](https://papersloth.hatenablog.com/entry/2024/02/14/201629)を参考にしてください。
## ドキュメント＆コミュニティ
- **[Portal](https://pafuhana1213.github.io/KawaiiPhysics-Portal/docs)**: 公式ドキュメント（最新）
- **[Wiki](https://github.com/pafuhana1213/KawaiiPhysics/wiki)**: 旧ドキュメント（最新情報はポータルへ移動しました）
- **[DeepWiki](https://deepwiki.com/pafuhana1213/KawaiiPhysics)**: AIによる自動生成ドキュメント
- **[Discussions](https://github.com/pafuhana1213/KawaiiPhysics/discussions)**: 質問、要望、雑談などはこちらへ
- **[Issues](https://github.com/pafuhana1213/KawaiiPhysics/issues)**: 不具合報告
## 解説記事・動画
### 公式
- [揺れ骨用自作AnimNode「Kawaii Physics」の内部実装解説的なもの その1](http://pafuhana1213.hatenablog.com/entry/2019/07/26/171046)
- [#ControlRig を使ったスカートの突き抜け対策と#KawaiiPhysics を併用してみるテスト](https://twitter.com/pafuhana1213/status/1300454762542817280)
### 非公式 (ありがとうございます！)
- [揺れモノ超ド素人がKawaiiPhysicsを使って、感覚を頼りに女性キャラクターモデルのKawaiiを増す方法まとめ](https://qiita.com/YuukiOgino/items/7f3198a90dab43019f26)
- [揺れものとコントロールリグ UEを使用したバーチャルライブでの実例](https://www.docswell.com/s/indieusgames/K4Q2XJ-2024-06-14-175045)
- [【UE】揺れ物設定（Kawaii Physics）](https://techblog.sumelagi.co.jp/unrealengine/147/)
- [【UE4】Kawaii Physicsチュートリアル#1](https://www.youtube.com/watch?v=hlgXuVML_is)
- [How To Setup Kawaii Physics in Unreal Engine 5](https://dev.epicgames.com/community/learning/tutorials/d1Z9/unreal-engine-how-to-setup-kawaii-physics-in-unreal)
- [５分でわかるKawaii Physicsの使い方！【UE5】【tutorial】](https://www.youtube.com/watch?v=TliP9vSxm4c)
- [The Hidden Physics “Engine” Behind Unreal's Most Stylish Games ...](https://www.youtube.com/watch?v=9ThmoMHnHhw)
## サンプル
プロジェクト内にサンプルレベルとキャラクターが含まれています。
- **サンプルレベル**: `Content/KawaiiPhysicsSample/L_KawaiiPhysicsSample`
- **使用キャラクター**:
- **Grayちゃん**: http://rarihoma.xvs.jp/products/graychan
- **TA式 鷺宮カノ**: [株式会社TA様](https://xta.co.jp/)よりご提供
- Copyright (c) 2025 株式会社TA All rights reserved
- 利用規約：https://uzurig.com/ja/terms_of_use_jp/
## 採用実績
多くのプロジェクトで採用されています！
- **[採用実績一覧](https://pafuhana1213.github.io/KawaiiPhysics-Portal/adoption)**
- あなたの作品もぜひ [こちら](https://github.com/pafuhana1213/KawaiiPhysics/discussions/65) で教えてください！
- Twitter/Xで作品を共有する際は、ぜひハッシュタグ **[#KawaiiPhysics](https://twitter.com/search?q=%23kawaiiphysics&src=typed_query&f=live)** をお使いください！
## 関連ツール
- [VRM SpringBoneをKawaiiPhysicsに変換するツール](https://yumetengu.booth.pm/items/7943387)
## ライセンス
[MIT License](https://github.com/pafuhana1213/KawaiiPhysics/blob/master/LICENSE)
## 作者
[おかず @pafuhana1213](https://twitter.com/pafuhana1213)
## 更新履歴
- [Announcements - アナウンス](https://github.com/pafuhana1213/KawaiiPhysics/discussions/categories/announcements-%E3%82%A2%E3%83%8A%E3%82%A6%E3%83%B3%E3%82%B9)
- [更新履歴 - Changelog (KawaiiPhysics Portal)](https://pafuhana1213.github.io/KawaiiPhysics-Portal/docs/changelog)
---
## よろしければご支援を！
このプラグインが、皆さんのUEプロジェクトに少しでも役立っていれば、とても嬉しいです。
開発は私個人が趣味と実益を兼ねて、開発時間の確保やコーヒー代を自腹でやりくりしながら進めています☕
もし「なかなか良いじゃん！」と思っていただけたら、FABでの購入やGitHub Sponsorsで応援していただけると、
開発を続ける上で大きな励みになります（[FABでの販売を開始に関して詳細な経緯はこちら](https://github.com/pafuhana1213/KawaiiPhysics/discussions/170)）。
[**FABで購入する**](https://www.fab.com/ja/listings/f870c07e-0a02-4a78-a888-e52a22794572)
[ **GitHub Sponsorsで応援する**](https://github.com/sponsors/pafuhana1213)