base on KawaiiPhysics : Simple Bone Physics for UnrealEngine 4 & 5 # Kawaii Physics  [](https://github.com/pafuhana1213/KawaiiPhysics/releases) [](https://github.com/pafuhana1213/KawaiiPhysics/releases) [](https://github.com/pafuhana1213/KawaiiPhysics/discussions) [](https://github.com/pafuhana1213/KawaiiPhysics/graphs/contributors) [](https://opensource.org/licenses/MIT) [](https://deepwiki.com/pafuhana1213/KawaiiPhysics) [](https://twitter.com/pafuhana1213) [English README](https://github.com/pafuhana1213/KawaiiPhysics/blob/master/README_en.md) --- 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)](https://youtu.be/0f-l-SP07Mo) ## 🖼️ ギャラリー (Gallery) <img src="https://github.com/user-attachments/assets/fda69859-b60f-4fde-a683-62da3e2839e4" alt="compare" width="640px"> *キャラクター：[Grayちゃん](http://rarihoma.xvs.jp/products/graychan)* <img src="https://github.com/user-attachments/assets/28d72d0c-4423-41c7-bc52-c5c7c3886e02" alt="dance5" width="640px"> *キャラクター：[オリジナル3Dモデル『ルゼブル』-Lzebul-](https://booth.pm/ja/items/4887691) / モーション：[ミライ小町](https://www.miraikomachi.com/download/)* <img src="https://github.com/user-attachments/assets/63faed3c-8aaa-4d4d-ae33-e98f9c8c15fd" alt="danceKano" width="640px"> *キャラクター：[TA式 鷺宮カノ](https://uzurig.com/ja/uzurig2-rigging-plugin-for-maya-jp/) / モーション：[しかのこのこのここしたんたん](https://booth.pm/ja/items/5975857) / セットアップ：[株式会社TA様](https://xta.co.jp/)* ## ✨ 特徴 (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`を使ったパラメータの保存・共有が可能 ### 参考資料 物理挙動を実装するにあたって、以下の資料を参考にしました。 - [次期アイドルマスター グラフィクス＆アニメーション プログラミング プレビュー](https://cedil.cesa.or.jp/cedil_sessions/view/416) ## 🚀 導入方法 (Getting Started) ### 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.6** - 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` ノードを追加して利用します。 - 詳細なパラメータ設定については、Wikiを参照してください。 - **[各パラメータについて](https://github.com/pafuhana1213/KawaiiPhysics/wiki/%E5%90%84%E3%83%91%E3%83%A9%E3%83%A1%E3%83%BC%E3%82%BF%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6--About-each-parameters)** > **Note:** Blueprintのみのプロジェクトでパッケージ化する際にエラーが出る場合があります。その際は、C++プロジェクトに変換するか、[こちらの記事](https://papersloth.hatenablog.com/entry/2024/02/14/201629)を参考にしてください。 ## 📚 ドキュメント & コミュニティ - **[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)**: 不具合報告 ## 🎓 解説記事 & 動画 (Tutorials) ### 公式 - [揺れ骨用自作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) ## 🎮 サンプル (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様](https://xta.co.jp/)よりご提供 - Copyright (c) 2025 株式会社TA All rights reserved - 利用規約：https://uzurig.com/ja/terms_of_use_jp/ ## 🌟 採用実績 (Showcase) 多くのプロジェクトで採用されています！ - **[採用実績一覧](https://github.com/pafuhana1213/KawaiiPhysics/wiki/%E6%8E%A1%E7%94%A8%E5%AE%9F%E7%B8%BE-Adoption)** - あなたの作品もぜひ [こちら](https://github.com/pafuhana1213/KawaiiPhysics/discussions/65) で教えてください！ - Twitter/Xで作品を共有する際は、ぜひハッシュタグ **[#KawaiiPhysics](https://twitter.com/search?q=%23kawaiiphysics&src=typed_query&f=live)** をお使いください！ ## 📜 ライセンス (License) [MIT License](https://github.com/pafuhana1213/KawaiiPhysics/blob/master/LICENSE) ## 👨‍💻 作者 (Author) [おかず @pafuhana1213](https://twitter.com/pafuhana1213) ## 📅 更新履歴 (Changelog) [Announcements - アナウンス](https://github.com/pafuhana1213/KawaiiPhysics/discussions/categories/announcements-%E3%82%A2%E3%83%8A%E3%82%A6%E3%83%B3%E3%82%B9) --- ## ✨ よろしければご支援を！ このプラグインが、皆さんの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) ", Assign "at most 3 tags" to the expected json: {"id":"13845","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"