hakowork/rojo
3
0
Fork 0
mirror of https://github.com/rojo-rbx/rojo.git synced 2026-10-25 04:54:07 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

rules

Browse source
This commit is contained in:
Joe 2026-02-02 12:08:47 -06:00
parent a9b4f8e83b
commit e6efc04756
8494 changed files with 495610 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

156
.cursor/rules/roblox/studio/pivot-tools.md Normal file
View file

@ -0,0 +1,156 @@
---
title: Pivot tools
description: Pivot tools and properties give you full control over the points around which objects rotate and translate.
---
The **pivot** tools and related properties give you full control over the points around which objects rotate and translate.
## Interactive Studio tools
The interactive Studio tools are located in the **Model** tab toolbar.
<img src="../assets/studio/general/Toolbar-Pivot.png" width="800" alt="Pivot tool highlighted in Studio's toolbar." />
When **Pivot** is toggled on, you can move or rotate the pivot point of a [part](../parts/index.md) or [model](../parts/models.md). Once set, rotation and scaling occur around the pivot point. For more information, see [setting a primary part](../parts/models.md#set-a-primary-part).
The following diagrams show example pivot locations in relation to object bounds.
<Tabs>
<TabItem label="Center">
<img src="../assets/studio/pivot-tools/Edit-Pivot-Center-A.jpg" width="720" height="405" alt="A blue cube with its pivot point set in the center of the cube. A green circle represents the object's rotation in relation to its pivot point." />
</TabItem>
<TabItem label="Corner">
<img src="../assets/studio/pivot-tools/Edit-Pivot-Corner-A.jpg" width="720" height="405" alt="A blue cube with its pivot point set on a corner of the cube. A green circle represents the object's rotation in relation to its pivot point." />
</TabItem>
<TabItem label="Outside Object Bounds">
<img src="../assets/studio/pivot-tools/Edit-Pivot-Outside-A.jpg" width="720" height="405" alt="A blue cube with its pivot point set on outside of the cube's geometry. A green circle represents the object's rotation in relation to its pivot point." />
</TabItem>
</Tabs>
When you rotate the pivot of a [model](../parts/models.md), the bounding box of the model also rotates.
<Tabs>
<TabItem label="Orientation = (0, 90, 0)">
<img src="../assets/studio/pivot-tools/Edit-Pivot-Model-A.jpg" width="720" height="405" alt="A model of a purple, blue, and red block with its pivot point set on a the edge of the model's bounding box. A green circle represents the object's rotation in relation to its pivot point." />
</TabItem>
<TabItem label="Orientation = (0, 135, 0)">
<img src="../assets/studio/pivot-tools/Edit-Pivot-Model-B.jpg" width="720" height="405" />
</TabItem>
<TabItem label="Orientation = (0, 180, 0)">
<img src="../assets/studio/pivot-tools/Edit-Pivot-Model-C.jpg" width="720" height="405" />
</TabItem>
</Tabs>
You can specify a `Class.Model.PrimaryPart|PrimaryPart` for models, which is a `Class.BasePart` within the model that you can use as a positional basis. In terms of pivot points:
<ol type="A">
<li>When you assign a `Class.Model.PrimaryPart|PrimaryPart` to a model, the existing pivot changes to the pivot point of the `Class.Model.PrimaryPart|PrimaryPart`. If you later unassign/clear the `Class.Model.PrimaryPart|PrimaryPart`, the pivot point resets to the **center** of the model's bounding box.</li>
<li>If you **delete** the `Class.Model.PrimaryPart|PrimaryPart` from a model, the pivot point remains in the same location and does **not** revert to its previous position. This prevents a sudden "jump" if you delete any parts from the model.</li>
</ol>
<Tabs>
<TabItem label="Initial Pivot Point">
<img src="../assets/studio/pivot-tools/PrimaryPart-1.jpg" width="720" height="405" />
</TabItem>
<TabItem label="A. PrimaryPart Assigned">
<img src="../assets/studio/pivot-tools/PrimaryPart-2.jpg" width="720" height="405" />
</TabItem>
<TabItem label="B. PrimaryPart Deleted">
<img src="../assets/studio/pivot-tools/PrimaryPart-3.jpg" width="720" height="405" />
</TabItem>
</Tabs>
### Snap
The **Snap** checkbox, available by click‑holding the small corner arrow on the **Pivot** button, toggles whether the pivot point snaps to **hotspots** such as corners, edges, or centers when you move it with the **Edit&nbsp;Pivot** tool. When snapping is enabled, hotspots display as small magenta points.
<GridContainer numColumns="2">
<figure>
<img src="../assets/studio/pivot-tools/Hotspots-Part.jpg" />
<figcaption>Hotspots on a part</figcaption>
</figure>
<figure>
<img src="../assets/studio/pivot-tools/Hotspots-Model.jpg" />
<figcaption>Hotspots on a model</figcaption>
</figure>
</GridContainer>
### Reset
The **Reset** button moves the pivot point to the **center** of an object or model's bounding box. This operation is useful after you've changed the composition of a model and wish to place its pivot point at the center of its new bounding box.
<img src="../assets/studio/general/Toolbar-Pivot-Reset.png" width="800" alt="Pivot Reset tool highlighted in Studio's toolbar." />
## Pivot properties
In addition to the interactive tools, pivot values can be directly set in the [Properties](../studio/properties.md) window.
<table>
<thead>
<tr>
<th>Property</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>**Origin Position**</td>
<td>Current world location of the object based on its pivot point rather than its bounding box. Useful for setting the precise location of a `Class.Model`.</td>
</tr>
<tr>
<td>**Origin Orientation**</td>
<td>Current orientation of the object based around its pivot point rather than its bounding box.</td>
</tr>
<tr>
<td>**Pivot Offset Position**</td>
<td>Precise location of the pivot relative to the object.&sup1;</td>
</tr>
<tr>
<td>**Pivot Offset Orientation**</td>
<td>Precise pivot orientation.&sup1;</td>
</tr>
<tr>
<td>**World Pivot Position**</td>
<td>The precise world location of the pivot for `Class.Model|Models` without a `Class.Model.PrimaryPart|PrimaryPart`. If a `Class.Model.PrimaryPart|PrimaryPart` is set, the model will use **Pivot&nbsp;Offset&nbsp;Position** since the pivot becomes relative to that part.&sup1;</td>
</tr>
<tr>
<td>**World Pivot Orientation**</td>
<td>The precise world orientation for `Class.Model|Models` without a `Class.Model.PrimaryPart|PrimaryPart`. If a `Class.Model.PrimaryPart|PrimaryPart` is set, the model will use **Pivot&nbsp;Offset&nbsp;Orientation** since the pivot becomes relative to that part.&sup1;</td>
</tr>
</tbody>
</table>
<figcaption><sup>1</sup> Changing this property will not move or rotate the object.</figcaption>
## Manipulate pivots in scripts
Beyond the Studio tools, pivot points can be accessed and manipulated in scripts.
<table>
<thead>
<tr>
<th>Function or Property</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>`Class.PVInstance:GetPivot()|GetPivot()`</td>
<td>Queries the current world location of an object's pivot as a `Datatype.CFrame`. This returns an object's position in 3D space regardless of whether it's an individual part or a `Class.Model`.</td>
</tr>
<tr>
<td>`Class.PVInstance:PivotTo()|PivotTo()`</td>
<td>Moves the object such that its pivot will be located at the specified `Datatype.CFrame`. This allows for uniform object movement of both individual parts and models.</td>
</tr>
<tr>
<td>`Class.BasePart.PivotOffset`</td>
<td>The `Datatype.CFrame` which specifies the pivot offset; effectively the offset of the pivot from the `Datatype.CFrame` of the `Class.BasePart`.&sup2;</td>
</tr>
<tr>
<td>`Class.BasePart.PivotOffset|Model.WorldPivot`</td>
<td>For `Class.Model|Models` without a `Class.Model.PrimaryPart|PrimaryPart`, the `Datatype.CFrame` which specifies the model's pivot in world space. If a `Class.Model.PrimaryPart|PrimaryPart` is set, the model will use `Class.BasePart.PivotOffset` since the pivot becomes relative to that part.&sup2;</td>
</tr>
</tbody>
</table>
<figcaption><sup>2</sup> Changing this property will not move or rotate the object.</figcaption>