メインコンテンツまでスキップ

物理パラメータ

物理シミュレーションの基本動作を制御するパラメータです。

ソースを見る

このページについて

ここは物理パラメータの網羅的なリファレンスです。揺れ方の調整手順は 揺れ方の調整、概念の全体像は 基本概念、その他の用途別の使い方は ボーンチェーン設定 / カーブによる調整 / ボーン細分化 を参照してください。

FKawaiiPhysicsSettings​

物理制御の基本設定を定義する構造体です。PhysicsSettings プロパティとしてノードに設定します。Damping（揺れやすさ）と Stiffness（戻りやすさ）が物理挙動の中心で、この2つのバランスで全体の「柔らかさ」が決まります。各メンバーは後述のカーブでボーン長比に応じて補正できます。

USTRUCT(BlueprintType)
struct KAWAIIPHYSICS_API FKawaiiPhysicsSettings
{
    float Damping = 0.1f;               // 減衰度
    float Stiffness = 0.05f;            // 剛性度
    float WorldDampingLocation = 0.8f;  // 移動の反映抑制
    float WorldDampingRotation = 0.8f;  // 回転の反映抑制
    float Radius = 3.0f;                // コリジョン半径
    float LimitAngle = 0.0f;            // 回転制限角度
};

Damping​

減衰度 - 揺れの強さを制御します。値が小さいほど加速度が物理挙動に強く反映され、よく揺れます。大きくすると動きが鈍く・重くなります。

プロパティ値
型float
デフォルト0.1
範囲0.0 以上
カテゴリKawaiiPhysics

Stiffness​

剛性度 - 値が大きいほど元の形状（アニメーションのポーズ）を強く維持し、すぐ元に戻ろうとします。小さくするとより自由に揺れます。

プロパティ値
型float
デフォルト0.05
範囲0.0 以上
カテゴリKawaiiPhysics

WorldDampingLocation​

コンポーネント移動の反映抑制 - ワールド座標系における Skeletal Mesh Component の移動量を、どれだけ揺れに反映するかを制御します。

  • 0 = 移動量をフル反映（最大に揺れる）
  • 1 = コンポーネントに完全追従（揺れに反映しない）
  • 実際の反映率 = 1 - WorldDampingLocation
プロパティ値
型float
デフォルト0.8
範囲0.0 以上
カテゴリKawaiiPhysics

WorldDampingRotation​

コンポーネント回転の反映抑制 - 上記の回転版です。Skeletal Mesh Component の回転量について同様に制御します（実際の反映率 = 1 - WorldDampingRotation）。

プロパティ値
型float
デフォルト0.8
範囲0.0 以上
カテゴリKawaiiPhysics
注記

WorldDampingLocation / WorldDampingRotation は名前が "Damping（抑制）" のため直感に反しますが、値が大きいほど揺れは小さくなります（1 でコンポーネントに完全追従＝揺れなし）。キャラクターの移動・回転でなびかせたい場合は小さめの値に設定してください。

Radius​

各ボーンのコリジョン半径 - 各ボーンが持つ衝突判定用の球の半径です。各種コリジョン（SphericalLimit など）との押し出し計算に使われます。エディタ上の表示名は Collision Radius です。

プロパティ値
型float
デフォルト3.0
範囲0.0 以上
表示名Collision Radius
カテゴリKawaiiPhysics

LimitAngle​

回転制限角度 - 物理挙動による1ステップあたりの回転角度の上限（度）。0 で無制限です。適切に設定することで荒ぶり（過度な振動）を抑制できます。

プロパティ値
型float
デフォルト0.0（無制限）
範囲0.0 以上
カテゴリKawaiiPhysics

シミュレーション設定​

SimulationSpace​

シミュレーション空間 - 物理制御を行う座標系を指定します。

プロパティ値
型EKawaiiPhysicsSimulationSpace
デフォルトComponentSpace
値説明
ComponentSpaceコンポーネント空間でシミュレーション
WorldSpaceワールド空間でシミュレーション。Rootボーンの急激な移動・回転の影響を回避可能
BaseBoneSpace指定したボーン空間でシミュレーション

SimulationSpaceの比較

各SimulationSpaceの違いを示す概念図

注記

ComponentSpace以外を使用すると微小のパフォーマンス低下が発生しますが、急激なRootボーンの移動・回転の影響を回避できます。

SimulationBaseBone​

シミュレーション基準ボーン - BaseBone座標系時の基準となるボーン。

プロパティ値
型FBoneReference
カテゴリPhysics Settings
注記

SimulationSpaceがBaseBoneSpaceの場合のみ有効です。

TargetFramerate​

ターゲットフレームレート - 物理シミュレーションのターゲットとなるフレームレート。

プロパティ値
型int32
デフォルト60
カテゴリPhysics Settings

TeleportDistanceThreshold​

テレポート距離しきい値 - 1フレームにおけるSkeletalMeshComponentの移動量が設定値を超えた場合、その移動量を物理制御に反映しません。

プロパティ値
型float
デフォルト300.0

TeleportRotationThreshold​

テレポート回転しきい値 - 1フレームにおけるSkeletalMeshComponentの回転量が設定値を超えた場合、その回転量を物理制御に反映しません。

プロパティ値
型float
デフォルト10.0

Teleport Thresholdの動作

しきい値を超える移動があった場合、物理に反映されずテレポート扱いになる

PlanarConstraint​

平面制約 - 指定した軸に応じた平面上に各ボーンを固定します。

プロパティ値
型EPlanarConstraint
デフォルトNone
値説明
None平面制約なし
XX軸に制約
YY軸に制約
ZZ軸に制約

PlanarConstraintの効果

各軸での平面制約の効果

SkelCompMoveScale​

コンポーネント移動スケール - SkeletalMeshComponentの移動量を物理挙動に反映する際に適用されるスケール。

プロパティ値
型FVector
デフォルト(1, 1, 1)

ボーン設定​

RootBone​

制御ルートボーン - 指定ボーンとそれ以下のボーンを制御対象にします。

プロパティ値
型FBoneReference
カテゴリBones

ExcludeBones​

除外ボーン - 指定したボーンとそれ以下のボーンを制御対象から除去します。

プロパティ値
型TArray<FBoneReference>
カテゴリBones

AdditionalRootBones​

追加ルートボーン - 指定ボーンとそれ以下のボーンを制御対象に追加します（複数追加用）。

プロパティ値
型TArray<FKawaiiPhysicsRootBoneSetting>
カテゴリBones

各要素には以下のプロパティがあります：

  • RootBone: 制御対象のルートボーン
  • OverrideExcludeBones: このルートボーン専用の除外ボーンリスト
  • bUseOverrideExcludeBones: 除外ボーンオーバーライドの有効化

DummyBoneLength​

ダミーボーン長 - 0より大きい場合は、制御ボーンの末端にダミーボーンを追加します。ダミーボーンを追加することで、末端のボーンの物理制御を改善します。

プロパティ値
型float
デフォルト0.0
範囲0.0 以上

DummyBoneの効果

DummyBoneを追加することで末端ボーンの動きが安定する

BoneForwardAxis​

ボーン前方向 - ボーンの前方向。物理制御やダミーボーンの配置位置に影響します。

プロパティ値
型EBoneForwardAxis
デフォルトX_Positive
値説明
X_Positive+X方向
X_Negative-X方向
Y_Positive+Y方向
Y_Negative-Y方向
Z_Positive+Z方向
Z_Negative-Z方向

ボーン細分化（Bone Subdivision）​

実スケルトンを変更せずに、シミュレーション内部で実ボーンの間に仮想ダミーを挿入し、コリジョン判定の解像度を上げる設定です。詳しくは Bone Subdivision を参照してください。

BoneSubdivisionCount​

ダミー分割数 - 隣接するボーン間に挿入するダミーボーンの最小分割数。コリジョン検出の精度を向上させます（例: スカートの足貫通防止）。0で無効。

プロパティ値
型int32
デフォルト0
範囲0 - 10
カテゴリBones|Bone Subdivision

bBoneSubdivisionCollisionOnly​

コリジョン専用 - ボーン間ダミーの速度積分（重力・風など）をスキップし、実ボーン間の補間位置からコリジョン・制約にのみ参加させます（軽量）。配置数には影響しません。

プロパティ値
型bool
デフォルトtrue
編集条件BoneSubdivisionCount > 0
カテゴリBones|Bone Subdivision

bBoneSubdivisionDensifyByRadius​

半径による密度補正 - 半径に応じてダミーを追加配置し、コリジョン球でボーン間を概ね隙間なく被覆します。BoneSubdivisionCount を最小として、離れた区間ほど多く配置します（1区間あたり最大50本）。

プロパティ値
型bool
デフォルトfalse
編集条件BoneSubdivisionCount > 0
カテゴリBones|Bone Subdivision

BoneConstraintSubdivisionCount​

横方向分割数 - 横方向のBoneConstraintに沿って挿入するコリジョン代理ダミー（bridge dummy）の分割数。隣接チェーン（列）間の隙間を埋めて貫通を防ぎます。0で無効。BoneSubdivisionCount とは独立。

プロパティ値
型int32
デフォルト0
範囲0 - 10
カテゴリBones|Bone Subdivision

BoneConstraintSubdivisionFeedbackScale​

フィードバック強度 - bridge dummy が受けたコリジョンの押し出しを端点ボーンに伝える強さ（0=伝えない、1=標準）。剛性が強すぎる場合は下げます。

プロパティ値
型float
デフォルト1.0
範囲0.0 - 2.0
編集条件BoneConstraintSubdivisionCount > 0
カテゴリBones|Bone Subdivision

ウォームアップ設定​

WarmUpFrames​

ウォームアップフレーム数 - 物理の空回し回数。物理処理が落ち着いてから開始・表示したい際に使用します。

プロパティ値
型int32
デフォルト0
範囲0 以上

bNeedWarmUp​

ウォームアップ有効化 - ウォームアップを有効にするフラグ。

プロパティ値
型bool
デフォルトfalse

bUseWarmUpWhenResetDynamics​

リセット時ウォームアップ - ResetDynamics時に物理の空回しを行うフラグ。

プロパティ値
型bool
デフォルトtrue

カーブによる制御​

以下のパラメータはカーブで制御可能です。「RootBoneから特定のボーンまでの長さ / RootBoneから末端のボーンまでの長さ」(0.0~1.0)の値におけるカーブの値を各パラメータに乗算します。

カーブ説明
DampingCurveDataDampingパラメータを補正
StiffnessCurveDataStiffnessパラメータを補正
WorldDampingLocationCurveDataWorldDampingLocationパラメータを補正
WorldDampingRotationCurveDataWorldDampingRotationパラメータを補正
RadiusCurveDataRadiusパラメータを補正
LimitAngleCurveDataLimitAngleパラメータを補正
ヒント

カーブを使用することで、根元は硬く先端は柔らかくといった設定が可能です。

高度な設定​

bUpdatePhysicsSettingsInGame​

ゲーム中パラメータ更新 - 各ボーンの物理パラメータを毎フレーム更新するフラグ。無効にするとパフォーマンスが僅かに改善しますが、実行中に物理パラメータを変更することが不可能になります。

プロパティ値
型bool
デフォルトtrue

ResetBoneTransformWhenBoneNotFound​

ボーン未検出時リセット - 制御対象のボーンが見つからない場合にTransformをリセットするフラグ。基本的には無効を推奨。

プロパティ値
型bool
デフォルトfalse