place_on
Positions a Part or Model flush on a raycast surface using its bounding box to avoid clipping or floating; supports screen/top-target/ground modes, grid snap, normal alignment, and dry-run preview.
Instructions
Compute and apply an accurate placement: raycast to a surface (a screen point, a target instance's TOP via onTarget, or straight down via ground), then sit the object FLUSH on it — offset by the object's bounding box so it doesn't clip or float. Optional alignToNormal (rotate to the surface) and snap (grid studs). Use dryRun to get the computed CFrame without moving. Moves a Part (CFrame) or a Model (PivotTo, bbox-center flush). Write tool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "place_on"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | screen X px (screen-ray mode) | |
| y | No | screen Y px | |
| nx | No | normalized X 0..1 | |
| ny | No | normalized Y 0..1 | |
| path | Yes | the instance to place (BasePart or Model) | |
| snap | No | snap final X,Z to this grid (studs) | |
| place | No | Target place (PlaceId or project name). Defaults to the bound/sole connected place. | |
| range | No | ray length (default 5000) | |
| dryRun | No | compute + return the CFrame without moving anything | |
| ground | No | drop straight down from the object's current X,Z onto whatever's below | |
| ignore | No | extra instances the ray should ignore | |
| onTarget | No | place on the TOP surface of this instance | |
| extraOffset | No | extra gap above the surface (studs, default 0) | |
| alignToNormal | No | rotate the object to sit flush on a sloped surface (default false) |