Skip to content

pafuhana1213/KawaiiPhysics

Repository files navigation

Kawaii Physics

UE Version GitHub release (latest by tag) Downloads Discussions GitHub contributors License: MIT Ask DeepWiki X (formerly Twitter) Follow

English README


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

Demo Video

デモ動画 (Demo Video)

目次 (Contents)

ギャラリー

compare

キャラクター:Grayちゃん

dance5

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

danceKano

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

特徴

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

参考資料

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

導入方法

1. ダウンロード

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

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

2. 対応バージョン

3. インストール

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

4. 使い方

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

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

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

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

解説記事・動画

公式

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

サンプル

sample2

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

採用実績

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

関連ツール

ライセンス

MIT License

作者

おかず @pafuhana1213

更新履歴

Announcements - アナウンス


よろしければご支援を!

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

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

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

About

KawaiiPhysics : Simple Bone Physics for UnrealEngine 4 & 5

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors