BackpackItemは、HopperBinsやツールなどのバックパックアイテムのための抽象クラスです。

BackpackItem

プレイヤーのバックパックに表示されるツールのテクスチャアイコンです。

このプロパティは、Robloxウェブサイトにアップロードされた画像のコンテンツIDに設定する必要があります。このプロパティではアセットURIのみがサポートされています。

このプロパティが空白のままの場合、`Class.Backpack` GUIはツールの名前を表示します。

BackpackItem.TextureContent

プレイヤーのバックパックに表示されるツールのテクスチャアイコンです。
アセットURIのみサポートされています。

プレイヤーのバックパックに表示されるツールのテクスチャアイコンです。

このプロパティは、Robloxウェブサイトにアップロードされた画像のコンテンツIDに設定する必要があります。

このプロパティが空白のままの場合、`Class.Backpack` GUIはツールの名前を表示します。

BackpackItem.TextureId

プレイヤーのバックパックに表示されるツールのテクスチャアイコンです。

以下のサンプルは、オブジェクトのテーブルを受け取り、それらを新しいモデルに親として設定し、そのモデルを返す基本的な関数を含んでいます。


モデルはコンテナオブジェクトであり、オブジェクトをまとめることを意味します。これらは
`Class.BasePart|BaseParts` のコレクションを保持するのに最適であり、機能を拡張するための
いくつかの関数を持っています。

モデルは**幾何学的**なグループを表すことを意図しています。もしあなたのグループが
幾何学的な解釈を持たない場合、例えば `Class.Script|Scripts` のコレクションなどは、
代わりに `Class.Folder` を使用してください。

構成要素がジョイントで結合されているモデル（物理シミュレーションによって移動したり破壊されたりすることができる）には、通常、
`Class.Model.PrimaryPart|PrimaryPart` が設定されており、これはモデルが移動する際に
ピボットとバウンディングボックスが「従う」部分を指定します。静的なモデルは、
一箇所に留まるため、プライマリパートを設定しても利益を得ることはありません。

モデルは、Robloxのプレイヤーキャラクターを含む幅広いアプリケーションを持っています。
また、考慮すべきいくつかのユニークな動作があります：

- `Class.Humanoid` と **Head** という名前の `Class.Part` がモデルの下に親子関係にあるとき、
  モデルの上に名前/健康GUIが表示されます。詳細については、
  [キャラクター名/健康表示](/characters/name-health-display) を参照してください。
- パートの **Y** 軸の位置が `Class.Workspace.FallenPartsDestroyHeight` の値に達し、
  それが `Class.Model` 内の最後のオブジェクトであった場合、モデルも破壊されます。
- `Class.Workspace.StreamingEnabled` が true に設定されている場所で使用されるとき、
  `Class.Model.ModelStreamingMode|ModelStreamingMode` の値は、モデルとその子孫が
  クライアントに複製される方法や削除される方法に関するさまざまな動作を制御します。
  さらに、`Class.Model.LevelOfDetail|LevelOfDetail` の値は、モデルのレンダリングに影響を与えます。

すべての `Class.Instance` タイプと同様に、親の `Class.Model` がクライアントに複製されることは、
そのすべての子が複製されることを保証するものではありません。これは、これらのインスタンスが
クライアント上で実行されているコードによってアクセスされる場合、特に重要です。
`Class.Model.ModelStreamingMode|ModelStreamingMode` を `Enum.ModelStreamingMode|Atomic` のような値で使用することで、
親モデルがクライアントに存在する場合、モデル全体とそのすべての子孫が存在することを保証できます。
または、原子性が望ましくない場合は、`Class.Instance:WaitForChild()|WaitForChild()` を使用できます。


指定されたプレイヤーに対してこのモデルを永続的に設定します。永続的なモデルは、ストリーミング設定や条件に関係なく、プレイヤーのために存在し続けます。

`Class.Model.ModelStreamingMode|ModelStreamingMode` は、追加の結果として動作が変更されるために
`Enum.ModelStreamingMode|PersistentPerPlayer` に設定されなければなりません。


Model:AddPersistentPlayer

playerInstance

このモデルを永続的にする `Class.Player` です。


指定されたプレイヤーに対してこのモデルを永続的に設定します。
`Class.Model.ModelStreamingMode|ModelStreamingMode` は、追加の結果として動作が変更されるために
`Enum.ModelStreamingMode|PersistentPerPlayer` に設定されなければなりません。


このサンプルでは、追加されたすべてのプレイヤーキャラクターモデルのジョイントが
出現から3秒後に壊れます。これらのジョイントを壊すと、ヒューマノイドが
死亡します。

このコードサンプルは、スクリプトの兄弟である二つのパーツ（PartA と PartB）に対して手動でジョイントを作成する方法を示しています。互換性のある表面タイプ（スタッドとインレット）を持つ二つの接触しているパーツにジョイントを作成します。


`BaseParts` 間の接続を切断します。これには、隣接するパーツとの表面接続、
`Class.WeldConstraint|WeldConstraints`、およびすべての `Class.Weld|Welds` と他の `Class.JointInstance|JointInstances` が含まれます。

BreakJoints がプレイヤーキャラクターの `Class.Model` に使用されると、キャラクターの `Class.Humanoid` は首のジョイントに依存しているため、死亡します。

隣接するパーツとの表面接続によって生成されたジョイントは、技術的には `Class.Model:MakeJoints()` を使用して再作成できますが、これは表面によって生成されたジョイントのみを再作成します。開発者は、ジョイントが壊れた後、パーツが互いに接触しなくなる可能性があるため、これに依存すべきではありません。


Model:BreakJoints

`BaseParts` 間の接続を切断します。これには、隣接するパーツとの表面接続、
`Class.WeldConstraint|WeldConstraints`、およびすべての `Class.Weld|Welds` と他の `Class.JointInstance|JointInstances` が含まれます。


Model:breakJoints

 `Class.Model:GetBoundingBox()` を示します。


この関数は、`Class.Model` 内のすべての `Class.BasePart` 子を含むボリュームの説明を返します。ボリュームの向きは、`Class.Model.PrimaryPart|PrimaryPart` の向きに基づいており、モデルが選択されたときにスタジオでレンダリングされる選択ボックスと一致します。`Class.Terrain:FillBlock()` の動作を反映し、バウンディングボックスの中心を表す `Datatype.CFrame` と、そのサイズを表す `Datatype.Vector3` を返します。物理制約が `Class.Model` 内のパーツに作用している場合、サイズは実行時に不正確になる可能性があります。

バウンディングボックスの向きは、`Class.PVInstance.GetPivot|Pivot` の向きに一致します - それは `Class.Model.PrimaryPart|PrimaryPart` のピボット（存在する場合）またはモデルの `Class.Model.WorldPivot|WorldPivot` です。


Model:GetBoundingBox

ボリュームの向きを表す `Datatype.CFrame` と、ボリュームのサイズを表す `Datatype.Vector3`。


モデルのすべてのパーツを含むボリュームの説明を返します。


以下のコードサンプルは、Model.GetExtentsSizeを使用して、パーツを含むバウンディングボックスのサイズを取得する方法を示しています。


モデル内のすべての `Class.BasePart|BaseParts` を含む最小のバウンディングボックスのサイズを返します。向きは、`Class.PVInstance.GetPivot|Pivot` の向きに一致します - それは `Class.Model.PrimaryPart|PrimaryPart` のピボット（存在する場合）またはモデルの `Class.Model.WorldPivot|WorldPivot` です。

この関数は最小のバウンディングボックスのサイズのみを返し、開発者はバウンディングボックスの位置を取得するために独自の方法を使用する必要があります。


Model:GetExtentsSize

モデルの `Datatype.Vector3` の拡張サイズ。


モデル内のすべての `Class.BasePart|BaseParts` を含む最小のバウンディングボックスのサイズを返します。
`Class.Model.PrimaryPart` が設定されている場合は、それに合わせて整列します。


この値は、歴史的にモデルの中心位置の CFrame を返しました。


Model:GetModelCFrame

モデルの中心位置を表す `Datatype.CFrame`。


このコードはモデルを作成し、その中にいくつかのパーツを入れ、ランダムに配置し、
そのサイズを出力します：


GetModelSize 関数は、`Class.Model` の `Datatype.Vector3` サイズを返します。


Model:GetModelSize

モデルの `Datatype.Vector3` サイズ。


モデルの Vector3 サイズを返します。


このメソッドが `Class.Script` から呼び出されると、モデルが永続的であるすべての `Class.Player` オブジェクトを返します。`Class.LocalScript` から呼び出されると、このメソッドはこのモデルが `Class.Players.LocalPlayer|LocalPlayer` に対して永続的であるかどうかのみを確認します。


Model:GetPersistentPlayers

このモデルオブジェクトが永続的であるすべての `Class.Player` オブジェクトを含むテーブル。


このモデルオブジェクトが永続的であるすべての `Class.Player` オブジェクトを返します。動作は、
このメソッドが `Class.Script` または `Class.LocalScript` から呼び出されるかどうかによって異なります。


以下のコードは、GetPrimaryPartCFrameと
SetPrimaryPartCFrameを使用してモデルを回転させる方法を示しています。

Workspaceにシンプルなモデルが作成され、ループが開始されて
モデルがY軸周りに0.2秒ごとに10度回転します。


この関数は、`Class.PVInstance:GetPivot()` に取って代わられ、置き換えとして機能し、コードの動作を変更しません。新しい作業には `Class.PVInstance:GetPivot()` を使用し、便利なときに既存の `Class.Model:GetPrimaryPartCFrame()` 呼び出しを移行してください。

モデルの `Class.Model.PrimaryPart` の `Datatype.CFrame` を返します。

この関数は次のように等価です。

    Model.PrimaryPart.CFrame

この関数は、`Class.Model` にプライマリパートが存在しない場合、エラーをスローします。この動作が望ましくない場合、開発者は次のように行うことができます。プライマリパートが存在しない場合は `nil` になります。

    local cFrame = Model.PrimaryPart and Model.PrimaryPart.CFrame


Model:GetPrimaryPartCFrame

モデルの `Class.Model.PrimaryPart` の `Datatype.CFrame`。


モデルの `Class.Model.PrimaryPart` の `Datatype.CFrame` を返します。
この関数は、`Class.Model` にプライマリパートが存在しない場合、エラーをスローします。


このコードサンプルは、`Class.Model:PivotTo()` と `Class.Model:ScaleTo()` を使用して、木モデルのすべてのコピーの置き換えを示しています。モデルのピボットとスケールは、置き換えモデルの相対的なサイズと位置が元のモデルと一致することを保証するための参照として使用されます。


モデルには永続的な標準スケールファクターが含まれており、新しく作成されたモデルのデフォルトは 1 であり、
`Class.Model:ScaleTo()` を呼び出すことでスケールが変更されます。この関数は、モデルの現在の標準スケールファクターを返します。

現在のスケールファクターは、モデルの下のインスタンスのサイズに直接影響を与えません。これは、モデルが元のサイズに対してどのようにスケールされたかを記憶するために、コンテンツ作成やスクリプト目的で使用されます。

特定のセッション内では、モデルは最初の `Class.Model:ScaleTo()` 呼び出しの後に子孫インスタンスの正確な元のサイズ情報をキャッシュします。これは、`Class.Model:ScaleTo()|ScaleTo(x)` の後に `Class.Model:ScaleTo()|ScaleTo(1)` を呼び出すと、浮動小数点のドリフトなしにモデルの元の構成を正確に戻すことができることを意味します。浮動小数点のドリフトを避けることが、スケール**To** 関数を持つ理由です。

スケールファクターは、エンジンの動作に一つの方法で影響を与えます：モデルのスケールファクターは、モデルの下の `Class.Animation|Animations` で再生されるジョイントオフセットに適用されるため、アニメーションされたリグはスケールされていても正しくアニメーションを再生します。


Model:GetScale

モデルの現在の標準スケールファクター。


モデルの標準スケールを返します。新しく作成されたモデルのデフォルトは 1 であり、
`Class.Model:ScaleTo()` によってスケールされると変更されます。


このコードサンプルは、Model:MakeJoints 関数を使用してジョイントを作成する方法を示しています。

モデルがインスタンス化され、2つのパーツが重なっています。上のパーツは
固定されており、下のパーツは固定されていません。通常、Workspace に親付けされると
下のパーツは Baseplate に落ちます。

しかし、下のパーツの TopSurface プロパティが Enum.SurfaceType.Weld に設定されているため、
Model:MakeJoints が実行されると、両者の間に接続が作成されます。

したがって、モデル内のジョイントが壊れるまで下のパーツは落ちません。
これは通常、Model:BreakJoints を使用して行われますが、この例では
爆発を使用して接続が壊されます。


このコードサンプルは、スクリプトの兄弟である二つのパーツ（PartAとPartB）にジョイントを作成する方法を示しています。互換性のある表面タイプ（スタッズとインレット）を持つ二つの接触しているパーツに対してMakeJointsを使用します。


SurfaceType に基づく結合は非推奨です。新しいプロジェクトには MakeJoints を使用しないでください。代わりに `Class.WeldConstraint|WeldConstraints` と
`Class.HingeConstraint|HingeConstraints` を使用してください。

モデル内のすべての `Class.BasePart|Parts` を通過し、指定されたパーツと任意の平面接触面との間にジョイントを作成します。

- スムーズな表面はジョイントを作成しません
- グルー表面は `Class.Glue` ジョイントを作成します
- ウェルドは、結合不可能な表面を除く任意の表面との `Class.Weld` ジョイントを作成します
- スタッド、インレット、またはユニバーサルは、他の2つの表面のいずれかとの `Class.Snap` ジョイントを作成します（例：スタッドとインレット、ユニバーサル）
- ヒンジおよびモーター表面は `Class.Rotate` および `Class.RotateV` ジョイントインスタンスを作成します

この関数は、パートが `Class.Workspace` の子孫でない場合は機能しません。したがって、MakeJoints を使用する前に、モデルが Workspace に親子関係にあることを確認する必要があります。


Model:MakeJoints

モデル内のすべての `Class.BasePart|BaseParts` を通過します。もし任意のパートの側面がジョイントを作成できる SurfaceType を持っている場合、
隣接するパーツとのジョイントを作成します。


Model:makeJoints

Model:move

location

このサンプルは、`Class.Model:MoveTo()`が衝突を回避する方法を示しています。

シンプルな2部構成の`Class.Model`が作成され、その`Class.Model.PrimaryPart`
が設定されます。大きな障害物のパーツがその隣に配置されます。

5秒後に`Class.Model:MoveTo()`が使用され、モデルを障害物のパーツの中に移動させようとします。
しかし、MoveToはモデルを障害物の中に移動させないため、`Class.Model`はY軸上に移動し、
障害物の上に配置されます。


`Class.Model.PrimaryPart|PrimaryPart` を指定された位置に移動します。プライマリパートが指定されていない場合は、モデルのルートパートが使用されますが、ルートパートは決定論的ではなく、`Class.Model:MoveTo()|MoveTo()` を使用する際には常にプライマリパートを設定することをお勧めします。

モデルを移動する場所に障害物がある場合、例えば `Class.Terrain` や他の `Class.BasePart|BaseParts` がある場合、モデルは何もないところまで垂直に上に移動します。この動作が望ましくない場合は、代わりに `Class.PVInstance:PivotTo()` を使用する必要があります。

`Class.Model:MoveTo()|MoveTo()` を使用してモデルを移動する際には、回転は保持されないことに注意してください。モデルの現在の回転を保持する必要がある場合は、`Class.Model:TranslateBy()|TranslateBy()` または `Class.PVInstance:PivotTo()` を使用することをお勧めします。


Model:MoveTo

position

`Class.Model` が移動する `Datatype.Vector3` です。


`Class.Model.PrimaryPart|PrimaryPart` を指定された位置に移動します。プライマリパートが指定されていない場合は、モデルのルートパートが使用されます。


Model:moveTo

指定されたプレイヤーに対してこのモデルを永続的でなくします。これにより、モデルがプレイヤーのために即座に削除されることは保証されません。このメソッドを呼び出した後、モデルはそのプレイヤーに対して `Enum.ModelStreamingMode|Atomic` として扱われ、ターゲットストリーミング半径内にある限り存在し続けます。

`Class.Model.ModelStreamingMode|ModelStreamingMode` は、削除の結果として動作が変更されるために
`Enum.ModelStreamingMode|PersistentPerPlayer` に設定されなければなりません。


Model:RemovePersistentPlayer

このモデルを永続的でなくする `Class.Player` です。


指定されたプレイヤーに対してこのモデルを永続的でなくします。
`Class.Model.ModelStreamingMode|ModelStreamingMode` は、削除の結果として動作が変更されるために
`Enum.ModelStreamingMode|PersistentPerPlayer` に設定されなければなりません。


モデルのパーツの回転を、以前に設定されたアイデンティティ回転にリセットします。これは、
`Class.Model:SetIdentityOrientation()` メソッドを通じて行われます。


Model:ResetOrientationToIdentity

モデルには永続的な標準スケールファクターが含まれており、新しく作成されたモデルのデフォルトは 1 です。この関数は、ピボット位置を中心に、スケールファクターが 1 のときの見た目に対して相対的にモデルをスケールします。これを達成するために、次の2つのことを行います：

- モデルの現在のスケールファクターを指定された値に設定します
- すべての子孫インスタンスをそれに応じてリサイズおよび再配置します

位置のスケーリングはピボット位置を中心に行われます。

すべての「幾何学的」プロパティは、子孫インスタンスに対してスケールされます。これは明らかにパーツのサイズを含みますが、スケールされるプロパティの他の例もいくつかあります：

- `Class.WeldConstraint|WeldConstraints` や `Class.RopeConstraint` のようなジョイントの長さ
- `Class.HingeConstraint` のような物理的な速度や力
- パーティクルエミッターのサイズのような視覚的プロパティ
- `Class.Sound.RollOffMinDistance` のような他の長さプロパティ


Model:ScaleTo

newScaleFactor

モデルの新しいスケールファクターで、正の非ゼロの数でなければなりません。値 1 はモデルの元のサイズを表します。


モデルのスケールファクターを設定し、すべての子孫インスタンスのサイズと位置を調整して、
それらがスケールファクターが 1 のときの初期サイズと位置に対してそのスケールファクターを持つようにします。


指定されたモデルのアイデンティティ回転を設定し、後で `ResetOrientationToIdentity` メソッドを使用して
モデル全体の回転をリセットできるようにします。


Model:SetIdentityOrientation

この関数は、`Class.PVInstance:PivotTo()` に取って代わられ、よりパフォーマンスの良い置き換えとして機能し、コードの動作を変更しません。新しい作業には `Class.PVInstance:PivotTo()` を使用し、便利なときに既存の `Class.Model:SetPrimaryPartCFrame()` 呼び出しを移行してください。

モデルの `Class.Model.PrimaryPart` の `Class.BasePart.CFrame` を設定します。モデル内の他のすべてのパーツも移動し、`Class.Model.PrimaryPart` に対してそれぞれの向きとオフセットを維持します。

この関数は、モデルに `Class.Model.PrimaryPart` が存在しない場合、エラーをスローします。これは、プライマリパートが設定されていないか、破壊されている場合に問題を引き起こす可能性があります。


Model:SetPrimaryPartCFrame

cframe

設定する `Datatype.CFrame` です。


モデルの `Class.Model.PrimaryPart` の `Class.BasePart.CFrame` を設定します。
モデル内の他のすべてのパーツも移動し、`Class.Model.PrimaryPart` に対してそれぞれの向きとオフセットを維持します。


このサンプルは、`Class.Model:TranslateBy()`が衝突を無視し、モデルの向きを尊重する方法を示しています。

シンプルな2部品の`Class.Model`が作成され、Y軸で45度回転し、
その`Class.Model.PrimaryPart`が設定されます。大きな障害物の部品が
その隣に配置されます。

5秒後に`Class.Model:TranslateBy()`が使用され、モデルが
障害物の部品の中に移動するよう指示されます。モデルは障害物の中に
移動し、現在の向きを維持します。


指定された `Datatype.Vector3` オフセットで `Class.Model` をシフトし、モデルの向きを保持します。もし他の `Class.BasePart` または `Class.Terrain` が新しい位置に既に存在する場合、
`Class.Model` はそのオブジェクトと重なります。

変換はオブジェクト空間ではなくワールド空間で適用されるため、モデルのパーツが異なる向きであっても、標準軸に沿って移動します。


Model:TranslateBy

delta

`Class.Model` を移動させる `Datatype.Vector3` です。


指定された `Datatype.Vector3` オフセットで `Class.Model` をシフトし、モデルの向きを保持します。もし他の `Class.BasePart` または `Class.Terrain` が新しい位置に既に存在する場合、
`Class.Model` はそのオブジェクトと重なります。


Model

インスタンスの[ストリーミング](/workspace/streaming)が有効な体験のためにモデルの詳細レベルを設定します。
合成メッシュやインポスターメッシュは物理、衝突検出、またはレイキャスティングをサポートしません。

`Enum.ModelLevelOfDetail|StreamingMesh` に設定されている場合、低解像度の「インポスター」メッシュ（モデルのすべての子パートを包む粗いメッシュ）がストリーミング半径の外側でレンダリングされます。テクスチャはサポートされません。

`Enum.ModelLevelOfDetail|SLIM` に設定されている場合、**SLIM** モデル（スケーラブル軽量インタラクティブモデル）は、ストリーミング半径に基づいて、すべての子パートの合成を徐々に低解像度でレンダリングします。これは、`Enum.ModelLevelOfDetail|StreamingMesh` よりも視覚的な品質を大幅に向上させます。

`Enum.ModelLevelOfDetail|Disabled` または `Enum.ModelLevelOfDetail|Automatic` に設定されている場合、低解像度のメッシュは表示されません。


Model.LevelOfDetail

インスタンスストリーミングが有効な体験のためにモデルの詳細レベルを設定します。


インスタンスの[ストリーミング](/workspace/streaming)が有効なときに、`Class.Model|Models` がどのようにストリーミングされるかを制御します。
動作は選択された列挙型に依存します。ストリーミングが無効な場合は影響を与えません。

このプロパティは、ストリーミングが有効なときにスタジオの[プロパティ](/studio/properties)ウィンドウでのみ変更する必要があります。または、`Class.Script|Scripts` で変更できますが、`Class.LocalScript|LocalScripts` では決して変更しないでください（そうすると未定義の動作が発生する可能性があります）。


Model.ModelStreamingMode

インスタンスストリーミングが有効なときの `Class.Model|Models` のストリーミング動作を制御します。


このコードサンプルはサイコロモデルを作成して投げ、青い面が上を向いて着地したかどうかを出力します。
`Class.Model.PrimaryPart`が設定されていない場合、サイコロのピボット/バウンディングボックスは回転し、内部のパーツはロール中に物理的にシミュレートされます。


`Class.Model` のプライマリパートを指します。プライマリパートは、モデルのピボットの物理的な参照として機能する `Class.BasePart` です。つまり、モデル内のパーツが物理シミュレーションや他の手段によって移動されると、ピボットはプライマリパートと同期して移動します。

`Class.Model|Models` はデフォルトで `PrimaryPart` が設定されていないことに注意してください。物理によって作用される必要があるモデルを作成する場合は、スタジオまたはスクリプト内で手動でこのプロパティを設定する必要があります。プライマリパートが**設定されていない**場合、モデル内のパーツが移動してもピボットはワールド空間の同じ位置に留まります。

このプロパティを設定する際には、モデルの子孫である `Class.BasePart` でなければなりません。モデルの子孫でない `Class.BasePart` に `Class.Model.PrimaryPart` を設定しようとすると、そのパートに設定されますが、次のシミュレーションステップで `nil` にリセットされます。これは、スクリプトがモデルの子孫でない `Class.BasePart` に一時的にプライマリパートを設定できると仮定しているためのレガシー動作です。

モデルに関する一般的なルールは次のとおりです：

- `Class.WeldConstraint|WeldConstraints` や `Class.Motor6D|Motor6Ds` のような物理ジョイントで結合されたパーツを持つモデルは、プライマリパートを割り当てる必要があります。たとえば、Robloxキャラクターモデルはデフォルトで `Class.Model.PrimaryPart` を **HumanoidRootPart** に設定しています。
- 静的（通常は `Class.BasePart.Anchored|Anchored`）モデルは、スクリプトが明示的に移動しない限り一箇所に留まるため、`Class.Model.PrimaryPart` を必要とせず、設定しても利益を得ることはありません。


Model.PrimaryPart

`Class.Model` のプライマリパート、または明示的に設定されていない場合は `nil` です。


プロパティウィンドウでこのプロパティを設定すると、`Class.Model:ScaleTo()` が呼び出されたかのようにモデルがスケールされ、
材料、画像、パーツの3Dジオメトリなど、モデル内のすべての子孫インスタンスが元のサイズに対して指定されたスケールファクターを持つようにリサイズされます。

このプロパティはスタジオでのみ利用可能であり、`Class.Script` または `Class.LocalScript` で使用するとエラーが発生します。スクリプトからは `Class.Model:ScaleTo()` と `Class.Model:GetScale()` を使用する必要があります。


Model.Scale

モデルのピボットを中心にスケールを調整するためのエディター専用プロパティです。このプロパティを設定すると、
`Class.Model:ScaleTo()` が呼び出されたかのようにスケールが移動します。


このコードサンプルは、モデルのピボットをそのモデルのバウンディングボックスの中心にリセットするカスタム関数を示しています。


`Class.Model.WorldPivot`を示します。


このプロパティは、設定されていない `Class.Model` のピボットがどこにあるかを決定します。もし `Class.Model` が
**プライマリパート**を持っている場合、`Class.Model` のピボットはそのプライマリパートのピボットと等しくなり、この `Class.Model.WorldPivot|WorldPivot` プロパティは無視されます。

新しく作成された `Class.Model` の場合、そのピボットは、**最初に** `Class.Model.WorldPivot` プロパティが設定されるまで、その内容のバウンディングボックスの中心として扱われます。最初にワールドピボットが設定されると、この初期の動作を復元することは不可能になります。

最も一般的には、スタジオツールを使用してモデルを移動したり、`Class.PVInstance:PivotTo()` や `Class.Model:MoveTo()` のようなモデル移動関数を使用すると、ワールドピボットが設定され、この新しいモデルの動作が終了します。

この動作の目的は、Luauコードが新しいモデルを作成し、オブジェクトをそのモデルに親子関係にすることで、明示的に `Class.Model.WorldPivot` を設定する必要がなく、合理的なピボットを取得できるようにすることです。


Model.WorldPivot

`Class.Model` に設定されていない `Class.Model.PrimaryPart` のピボットがどこにあるかを決定します。


モデルはコンテナオブジェクトであり、オブジェクトをまとめることを意味します。これらは
`Class.BasePart|BaseParts` のコレクションを保持するのに最適であり、機能を拡張するための
いくつかの関数を持っています。


A `Class.PVInstance`は作成できない抽象クラスです。それは
世界に物理的位置を持つすべてのオブジェクトの基盤です。

このコードサンプルは、<kbd>F</kbd>キーを押すと、現在向いている方向にキャラクターを10&nbsp;スタッド前方に移動させるシンプルなテレポートスクリプトです。これは、`Class.PVInstance:GetPivot()`で現在のピボットを取得し、`PVInstance|PivotTo`を呼び出してキャラクターを前方に移動させることで実現します。


この関数は`Class.PVInstance`のピボットを取得します。これはしばしば
`Class.PVInstance:PivotTo()`と共に使用されてモデルを移動させます。

`Class.Model|Models`と`Class.BasePart|BaseParts`は両方とも
`Class.PVInstance|PVInstances`（"Position Velocity Instances"）であり、したがって両方が
この関数を持っています。

PVInstance:GetPivot

インスタンスのピボットのワールド空間`Datatype.CFrame`です。


`Class.PVInstance`のピボットを取得します。

`Class.PVInstance`とそのすべての子孫の`Class.PVInstance|PVInstances`を変換し、ピボットを指定された
`Datatype.CFrame`に位置させます。これはスクリプトを通じて`Class.Model|Models`を移動させるために
使われる主要な関数です。

`Class.BasePart|BaseParts`は必要なオフセットによってその`Datatype.CFrame`が変換されることで
この方法で移動します。
`Class.Model|Models`は必要なオフセットによってその`Class.Model.WorldPivot`が変換されることで
この方法で移動します。

効率を考慮して、`Class.BasePart|BaseParts`の`Class.BasePart.Position|Position`と
`Class.BasePart.Orientation|Orientation`に対して、
この方法で移動した場合は`Class.Object.Changed`イベントは発火されません；それらは
`Datatype.CFrame`に対してのみ発火されます。

`Class.Model|Models`に対して`Class.PVInstance:PivotTo()|PivotTo`を呼び出すと、
子孫のパーツとモデルのオフセットがキャッシュされるため、
同じモデルに対する後続の`Class.PVInstance:PivotTo()|PivotTo`呼び出しで
パーツ間の浮動小数点漂流が蓄積されることはありません。

`Class.Model|Models`と`Class.BasePart|BaseParts`は両方とも
`Class.PVInstance|PVInstances`（"Position Velocity Instances"）であり、したがって両方が
この関数を持っています。

PVInstance:PivotTo

targetCFrame

移動後に`Class.PVInstance`のピボットが等しくなるべき`Datatype.CFrame`。

`Class.PVInstance`とそのすべての子孫の`Class.PVInstance|PVInstances`を変換し、ピボットを指定された
`Datatype.CFrame`に位置させます。

PVInstance

エディタ専用プロパティで、スタジオのプロパティウィンドウに**原点位置**および**原点方向**として表示されます。値はインスタンスのピボットのワールド空間`Datatype.CFrame`であり、これを読み取ると`Class.PVInstance:GetPivot()`と同じ`Datatype.CFrame`が返されます。自身の保存された値はなく、常に現在のピボットを反映します。

プロパティウィンドウから設定すると、インスタンス全体が移動し、そのピボットが新しい`Datatype.CFrame`に位置します。これは`Class.PVInstance:PivotTo()`に似ています。プロパティウィンドウを通じて編集すると、移動のために他のオブジェクトへの`Class.WeldConstraint|WeldConstraints`が一時的に無効になります。`PivotTo`はジョイントを変更しません。

スクリプトでは使用できません。代わりにランタイムで`Class.PVInstance:GetPivot()`および`Class.PVInstance:PivotTo()`を使用してください。


PVInstance.Origin

エディタ専用プロパティで、`Class.PVInstance`のピボットのワールド`Datatype.CFrame`を読み取り、設定します。スタジオのプロパティウィンドウから変更すると、インスタンス全体が移動します。


エディタ専用プロパティで、スタジオのプロパティウィンドウに**ピボット位置**および**ピボット方向**として表示されます。これはインスタンスの自身のフレームに対するピボットの`Datatype.CFrame`です。

プロパティウィンドウから変更すると、インスタンスはそのままでピボットがインスタンスに対して移動します。`原点`とは異なり、インスタンス全体は移動しません。`Class.BasePart`の場合、オフセットはデフォルトでアイデンティティの`Datatype.CFrame`となるため、ピボットはパーツの中心と一致します。`Class.Model`の場合、このプロパティはモデルに`Class.Model.PrimaryPart|PrimaryPart`があるときのみ表示され、そのパーツの`Class.BasePart.PivotOffset|PivotOffset`を反映および編集します。また、`Class.Model:GetPivot()`はプライマリパートのピボットをエイリアスします。

スクリプトでは使用できません。スクリプトは、`Class.BasePart.PivotOffset`などの具体的なクラスを通じて同等の読み書きを行います。


PVInstance.Pivot Offset

エディタ専用プロパティで、インスタンスに対するピボットの`Datatype.CFrame`を表示および編集します。ピボットのみが移動し、インスタンスはそのままです。


世界に物理的位置を持つすべてのオブジェクトのための抽象クラス。

`Instance` は、`Class.DataModel` ツリーの一部となることができる Roblox クラス階層内のすべてのクラスの基本クラスです。

ルート `Instance` オブジェクトを直接作成することはできませんが、特別な `Datatype.Instance.new()` コンストラクタを使用して、クラスの名前をパラメータとして受け取り、作成されたオブジェクトを返します。


インスタンスの系譜に対する変更を検出する方法を示します。
`Class.Instance.AncestryChanged` イベントに接続することで実現します。

ChangingPart の親は時間とともに異なる値に設定されます。パーツの親はパーツの先祖であるため、
`Class.Instance.AncestryChanged` イベントは変更されるたびに発火します。

このインスタンスが再親子化されたとき、またはその祖先のいずれかが再親子化されたときに発火します。

このイベントを使用して、スタジオ内でインスタンスの削除を追跡できます。たとえば、エクスプローラーでの手動削除やプラグインを通じての削除などです。`Class.Instance:Destroy()` を使用してインスタンスが破壊されたときに検出する必要がある場合は、代わりに `Class.Instance.Destroying` イベントを使用してください。


Instance.AncestryChanged

child

`Class.Instance.Parent|Parent` プロパティが変更されたインスタンス。これはこのインスタンスまたはより遠い祖先であり、必ずしもハンドラが接続されているインスタンスではありません。


parent

`child` パラメータの新しい親。


このオブジェクトまたはその祖先の `Class.Instance.Parent` プロパティが変更されたときに発火します。


このイベントは、インスタンスの属性が変更されるたびに発火します。属性が `nil` に設定されるときも含まれます。変更された属性の名前が接続された関数に渡されます。

たとえば、次のコードスニペットは、パーツの属性のいずれかが変更されるたびに `attributeChanged()` 関数を発火させます：

```lua
local Workspace = game:GetService("Workspace")

local part = Workspace.Part

local function attributeChanged(attributeName)
	print(attributeName, "changed")
end

part.AttributeChanged:Connect(attributeChanged)
```

`Class.Instance:GetAttributeChangedSignal()` も参照してください。これは、特定の属性が変更されたときに発火するイベントを返します。


Instance.AttributeChanged

attribute

インスタンスの属性が変更されるたびに発火します。


このスニペットは、オブジェクトがWorkspaceに追加されると、その名前を出力します:

この `Class.Instance` にオブジェクトが親付けされた後に発火します。

クライアントでサーバーによって作成されたオブジェクトを検出するためにこのメソッドを使用する場合、これらのオブジェクトの子孫をインデックスする際に `Class.Instance:WaitForChild()` を使用する必要があります。これは、オブジェクトとその子孫がサーバーからクライアントに同時に複製されることが保証されていないためです。たとえば：

```
local Workspace = game:GetService("Workspace")

Workspace.ChildAdded:Connect(function(child)
	-- 子孫がまだ複製されていない可能性があるため、WaitForChild() を使用します
	local head = child:WaitForChild("Head")
end)
```
このイベントは、`Class.Instance` の直接の子に対してのみ機能します。すべての子孫をキャプチャするイベントには、`Class.Instance.DescendantAdded` を使用してください。

`Class.Instance.ChildRemoved` も参照してください。


Instance.ChildAdded

この `Class.Instance` にオブジェクトが親付けされた後に発火します。


Instance.childAdded

このスニペットは、オブジェクトがワークスペースから削除されるときにその名前を表示します:

この `Class.Instance` から子が削除された後に発火します。

削除とは、オブジェクトの親がこの `Class.Instance` から他の何かに変更されることを指します。このイベントは、子が破壊されたとき（`Class.Instance:Destroy()` を使用）にも発火します。なぜなら、破壊関数はオブジェクトの親を `nil` に設定するからです。

このイベントは、`Class.Instance` の直接の子に対してのみ機能します。すべての子孫をキャプチャするイベントには、`Class.Instance.DescendantRemoving` を使用してください。

`Class.Instance.ChildAdded` も参照してください。


Instance.ChildRemoved

この `Class.Instance` から子が削除された後に発火します。


次の例では、Workspaceに追加されたオブジェクトの名前を印刷します:

このイベントは、子孫が `Class.Instance` に追加された後に発火します。

すべての子孫に対して発火するため、オブジェクトを `Class.Instance` に親付けすると、このオブジェクトとそのすべての子孫に対して個別にイベントが発火します。

`Class.Instance` の **直接の子** のみを気にする場合は、代わりに `Class.Instance.ChildAdded` を使用してください。

`Class.Instance.DescendantRemoving` も参照してください。


Instance.DescendantAdded

descendant

子孫が `Class.Instance` に追加された後に発火します。


次の例は、Workspace から削除されるときに、任意の子孫の名前を印刷します:

このイベントは、親 `Class.Instance` が変更され、**子孫** インスタンスがもはや子孫でなくなる直前に発火します。`Class.Instance:Destroy()|Destroy()` はインスタンスの `Class.Instance.Parent|Parent` を `nil` に変更するため、親の子孫に対してこのメソッドを呼び出すと、このイベントが発火します。

このイベントは、子孫の削除の **前** に発火するため、このイベントが発火する時点では子孫の親は変更されていません。子孫が親の **直接の子** でもある場合、このイベントは `Class.Instance.ChildRemoved` の前に発火します。

子孫が子を持つ場合、このイベントは最初に子孫で発火し、その後にその子孫で発火します。

#### 警告

このイベントは、削除される子孫オブジェクトで発火します。子孫の `Class.Instance.Parent|Parent` を他の何かに設定しようとすると失敗します。以下はこれを示す例です：

```
local Workspace = game:GetService("Workspace")

Workspace.DescendantRemoving:Connect(function(descendant)
	-- この関数内で子孫の親を操作しないでください！
	-- このイベントは親が操作されたために発火し、変更はまだ行われていません
	-- したがって、親をこのように変更することは問題があります：
	descendant.Parent = game
end)

local part = Instance.new("Part")
part.Parent = Workspace
part.Parent = nil
```

`Class.Instance.DescendantAdded|DescendantAdded` も参照してください。


Instance.DescendantRemoving

この `Class.Instance` の子孫が削除される直前に発火します。


このサンプルは、Immediate シグナル動作を使用する際に、
インスタンスが破棄されるまで、接続された関数が yield するまでその位置に留まることを示しています。

このサンプルは、Deferredシグナルの動作を使用する際に、インスタンスがシグナルが発火する前に破棄される方法を示しています。

接続された関数がまだ使用している間、`Class.Instance` はメモリから削除されることはありません。ただし、関数が任意の時点で待機すると、`Class.Instance` とその子孫は `nil` に親付けされます。

`Class.Workspace.SignalBehavior` プロパティが `Enum.SignalBehavior.Immediate` に設定されている場合、このイベントは `Class.Instance` またはその祖先のいずれかが `Class.Instance:Destroy()` で破壊される直前に発火します。

`Class.Workspace.SignalBehavior` プロパティが `Enum.SignalBehavior.Deferred` に設定されている場合、このイベントは次の再開ポイントで発火します。これは、`Class.Instance` またはその祖先のいずれかが `Class.Instance:Destroy()` で破壊された後です。

`Enum.SignalBehavior.Deferred|Deferred` の動作では、スクリプトを自分自身の `Class.Instance.Destroying` イベントに接続することは問題があります。なぜなら、スクリプトはコールバックが呼び出される前に破壊されるため（つまり、実行されません）。

スタジオで `Class.Instance` を削除する場合、たとえば [Explorer](/studio/explorer) を介して手動で削除する場合やプラグインを介して削除する場合、`Class.Instance` は破壊されません。代わりに、親が `nil` に設定され、これを `Class.Instance.AncestryChanged` で追跡できます。


Instance.Destroying

インスタンスが `Class.Instance:Destroy()` を介して破壊される直前に発火します。


 `Class.Instance.StyledPropertiesChanged` を示します。


このイベントは、インスタンスのスタイルプロパティが変更されるたびに発火します。プロパティが `nil` に設定されるときも含まれます。


Instance.StyledPropertiesChanged

インスタンスのスタイルプロパティが変更されるたびに発火します。プロパティが `nil` に設定されるときも含まれます。


このメソッドは、インスタンスにタグを適用します。タグがすでに適用されている場合は効果がありません。タグを正常に追加すると、指定されたタグで `Class.CollectionService:GetInstanceAddedSignal()` によって作成された信号が発火します。

#### 警告

- クライアント側で追加されたインスタンスのタグは、サーバーが後でそのインスタンスにタグを追加または削除すると削除されます。サーバーはすべてのタグを一緒に複製し、以前のタグを上書きします。

- インスタンスにタグを付けるときは、タグの機能を提供するためにいくつかのリソースが使用されることが一般的です。たとえば、イベント接続やテーブルです。メモリリークを防ぐために、タグが不要になったときにこれらをクリーンアップすることをお勧めします（切断、`nil` に設定するなど）。これは、`Class.Instance:RemoveTag()` を呼び出すとき、`Class.Instance:Destroy()` を呼び出すとき、または `Class.CollectionService:GetInstanceRemovedSignal()` によって返された信号に接続された関数内で行います。


Instance:AddTag

インスタンスに適用するタグ。


インスタンスにタグを適用します。


子供関数は、オブジェクトの子供の配列を返します。


Instance:children

子オブジェクト/インスタンスの配列。


オブジェクトの子供の配列を返します。


このメソッドは、インスタンスのすべての子供と子孫を破壊します。

```
local part = Instance.new("Part")

-- いくつかのスパークルを追加
for i = 1, 3 do
	local sparkles = Instance.new("Sparkles")
	sparkles.Parent = part

  local sc = Instance.new("Sparkles")
  sc.Parent = sparkles
end

print("Children:", #part:GetChildren())  --> Children: 3

part:ClearAllChildren()

print("Children:", #part:GetChildren())  --> Children: 0
```
すべての子供と子孫を破壊したくない場合は、`Class.Instance:GetChildren()` または `Class.Instance:GetDescendants()` を使用してそれらの子供/子孫をループし、破壊するものを選択します。たとえば、次のコードサンプルは、`Class.Model` から降りてくるすべての `Class.BasePart|BaseParts` を破壊します：

```
local Workspace = game:GetService("Workspace")

local model = Workspace:FindFirstChild("TestModel")

for _, descendant in model:GetDescendants() do
	if descendant:IsA("BasePart") then
		descendant:Destroy()
	end
end
```


Instance:ClearAllChildren

このメソッドは、インスタンスのすべての子供を破壊します。


`Class.Instance:Clone()`を使用してモデルをクローンすることを示します。

`Clone()` は、インスタンスとそのすべての子孫のコピーを作成し、`Class.Instance.Archivable|Archivable` でないすべてのインスタンスを無視します。ルートインスタンスのコピーはこのメソッドによって返され、その `Class.Instance.Parent|Parent` は `nil` に設定されます。インスタンス自体が `Class.Instance.Archivable|Archivable` を `false` に設定されている場合、このメソッドは `nil` を返します。

`Class.ObjectValue.Value` のような参照プロパティがクローンされたインスタンスに設定されている場合、コピーのプロパティの値は元の値に依存します：

- 参照プロパティが **クローンされた** インスタンスを参照している場合、コピーはそのコピーを参照します。
- 参照プロパティが **クローンされていない** インスタンスを参照している場合、同じ値がコピーに保持されます。


Instance:Clone

インスタンスのコピー、またはインスタンスが `Class.Instance.Archivable|Archivable` でない場合は `nil`。


インスタンスとそのすべての子孫のコピーを作成し、`Class.Instance.Archivable|Archivable` でないインスタンスを無視します。


Instance:clone

このサンプルは、`Class.Instance:Destroy()` 関数を使用してパーツを削除する方法を示します。

この関数は、もはや必要ないオブジェクトを処理する正しい方法です。

`Class.Instance.Parent` プロパティを `nil` に設定し、`Class.Instance.Parent` プロパティをロックし、すべての接続を切断し、すべての子供に対して `Destroy()` を呼び出します。このメソッドは、もはや必要ないオブジェクトを処分する正しい方法です。

不要なオブジェクトを処分することは重要です。なぜなら、場所に不要なオブジェクトや接続があると、メモリを消費し、時間の経過とともに深刻なパフォーマンスの問題を引き起こす可能性があるからです。

`Destroy()` をオブジェクトに呼び出した後のベストプラクティスとして、オブジェクト（またはその子孫）を参照する変数を `nil` に設定します。これにより、コードがオブジェクトに関連するものにアクセスできなくなります。

```lua
local part = Instance.new("Part")
part.Name = "Hello, world"
part:Destroy()
-- これをしないでください：
print(part.Name)  --> "Hello, world"
-- 上記の行が機能しないようにするには、これを行います：
part = nil
```
このメソッドによって `Class.Instance` が破壊されると、それを再利用することはできません。なぜなら、`Class.Instance.Parent` プロパティがロックされるからです。オブジェクトを破壊するのではなく **一時的に** 削除するには、`Class.Instance.Parent|Parent` を `nil` に設定します。たとえば：

```
local Workspace = game:GetService("Workspace")

object.Parent = nil
task.wait(2)
object.Parent = Workspace
```
設定した時間後にオブジェクトを破壊するには、`Class.Debris:AddItem()` を使用します。


Instance:Destroy

`Class.Instance.Parent` プロパティを `nil` に設定し、`Class.Instance.Parent` プロパティをロックし、すべての接続を切断し、すべての子供に対して `Destroy()` を呼び出します。


Instance:destroy

`Class.Instance.Name` が指定された名前と等しい最初の祖先を返します。

このメソッドは上向きに機能し、インスタンスの直近の `Class.Instance.Parent` から始まり、`Class.DataModel` に向かって進みます。一致する祖先が見つからない場合は `nil` を返します。

次のコードスニペットは、`Car` という名前のオブジェクトの最初の祖先を見つけます。

```
local car = object:FindFirstAncestor("Car")
```
特定のクラスの祖先を見つけるこのメソッドのバリアントについては、`Class.Instance:FindFirstAncestorOfClass()` および `Class.Instance:FindFirstAncestorWhichIsA()` を参照してください。


Instance:FindFirstAncestor

name

`Class.Instance.Name` が指定された名前と等しい最初の祖先を返します。


`Class.Object.ClassName` が指定された className と等しい最初の祖先を返します。

このメソッドは上向きに機能し、インスタンスの直近の `Class.Instance.Parent` から始まり、`Class.DataModel` に向かって進みます。一致する祖先が見つからない場合は `nil` を返します。

このメソッドの一般的な使用法は、`Class.BasePart` が属する `Class.Model` を見つけることです。たとえば：

```
local model = part:FindFirstAncestorOfClass("Model")
```
このメソッドは、`Class.Instance:FindFirstAncestor()` のバリアントであり、`Class.Object.ClassName` プロパティをチェックします。`Class.Instance:FindFirstAncestorWhichIsA()` も存在し、`Class.Object:IsA()` メソッドを使用してクラスの継承を尊重します。


Instance:FindFirstAncestorOfClass

className

探すべき `Class.Object.ClassName`。


`Class.Object.ClassName` が指定された className と等しい最初の祖先を返します。


Instance

`Instance` は、`Class.DataModel` ツリーの一部となることができる Roblox クラス階層内のすべてのクラスの基本クラスです。


/reference/engine/classes/BackpackItem.yaml

概要