アセンブリは、剛体 WeldConstraint で溶接された1つ以上の パーツ または、 Motor6Ds のような可動ジョイントで接続されたものです。パーツのアセンブリを モデル コンテナにグループ化して、アセットとしてパーツや関連オブジェクトを迅速に整理できます。
物理学の観点から、アセンブリは単一の剛体と見なされ、関連パーツを互いに押したり引いたりする力を受けることはできず、単一のユニットとして移動します。特定の BasePart に加えられたすべての力は、そのアセンブリに適用されます。たとえば、BasePart:ApplyImpulse() は BasePart.AssemblyCenterOfMass でアセンブリにインパルスを適用します。
複数のパーツをアセンブリに統合するジョイントは、Workspace または他の WorldModel インスタンスでのみアクティブです。他の場所にパーツが格納されている場合、アセンブリにパーツを統合する溶接や接続は機能しません。
単一の剛体アセンブリを視覚化するために、3Dビューポートの右上隅にある 視覚化オプション ウィジェットからアセンブリをオンにすると、パーツの周りに色付きのアウトラインが表示されます。
アセンブリのプロパティ
以下の BasePart プロパティは、そのアセンブリに関するデータを示します。これらの値は、同じアセンブリ内の任意のパーツで同じになるため、どのパーツを使用しても問題ありません。
| プロパティ | 説明 |
|---|---|
| BasePart.AssemblyLinearVelocity | パーツのアセンブリの線形速度ベクトル。速度を直接設定すると非現実的な動きになる可能性があるため、VectorForce または LinearVelocity 制約の使用が推奨されるか、瞬時に線形速度を変えるために BasePart:ApplyImpulse() を使用します。 |
| BasePart.AssemblyAngularVelocity | パーツのアセンブリの角速度ベクトル。速度を直接設定すると非現実的な動きになる可能性があるため、Torque または AngularVelocity 制約の使用が推奨されるか、瞬時に角速度を変えるために BasePart:ApplyAngularImpulse() を使用します。 |
| BasePart.AssemblyCenterOfMass | アセンブリ内のすべてのパーツの質量と位置によって計算された読み取り専用の位置。重心にかかる力は角加速度を引き起こさず、線形加速度のみを引き起こします。 |
| BasePart.AssemblyMass | アセンブリ内のすべてのパーツの BasePart.Mass の合計。アセンブリに固定されたパーツがある場合、アセンブリの質量は無限と見なされます。 |
| BasePart.AssemblyRootPart | アセンブリの ルートパーツ を表すために自動的に選択されるパーツ。 |
アセンブルートパーツ
すべてのアセンブリには、AssemblyRootPart プロパティで示されるルートパーツがあります。これは、Motor6D の変換が更新されたときに動かないパーツであり、一貫した物理複製とネットワーク所有権を維持するために使用されるパーツです。
ルートパーツを明示的に設定することはできませんが、以下の要因が優先度に影響を与えます。最も高いものから最低のものへ：
Anchored パーツは常にルートパーツとして割り当てられます。
Massless がfalse（デフォルト）に設定されているパーツが優先されます。
高い RootPriority 値が優先されます。
パーツのサイズ（最大の面積）に基づく優先度、特定のパーツタイプには乗数があります。Seats と VehicleSeats は最高の乗数を受け取り、次にHumanoidRootPartという名前のパーツ、その後Torsoという名前のパーツが続きます。
アンカー動作
アセンブリのパーツの1つが固定されている場合、そのパーツはルートパーツとなり、他のすべてのパーツはそれとともに暗黙的に固定されます。以下のシーケンスはこの動作を示しています。
以下のように、4つのパーツが WeldConstraints（緑のバー）で溶接されてアセンブリとなり、同じ色のアウトラインで示されています。
一つのアセンブリとなるように溶接された4つのパーツ アセンブリ内の1つだけのパーツが固定されている場合、アセンブリは変化せず、ルートパーツが変わる可能性があります（固定されたパーツは常にルートパーツになるための優先度が最も高くなります）。
固定されたパーツ（アンカーアイコンで示される）は新しいルートパーツになる 2つ以上のパーツが固定されると、アセンブリは分離します。以下では、左と上のパーツの両方が固定されているため、元のアセンブリは色付きのアウトラインで示されるように2つのアセンブリに分割されます。また、2つのアセンブリ間の WeldConstraint は無効化されます。固定されたアセンブリ間にアクティブな溶接があってはならないためです。
それぞれのルートパーツとして固定されたパーツを持つ2つのアセンブリ アセンブリ内のすべてのパーツを固定したい場合は、アセンブリのルートパーツを固定するだけで済みます。すべてのパーツを固定すると、実際にはパフォーマンスが低下し、より多くのアセンブリが生成されるためです。
