scatter_surface_assets
Distributes linked duplicate props across a target surface mesh, aligning them to normals while applying random Z rotation, scale variation, and overlap avoidance for terrain dressing.
Instructions
Distributes linked duplicates of source props across a target surface mesh with surface normal alignment, random Z rotation, scale variation, and overlap avoidance.
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": {
"surface_name": "<surface_name>",
"asset_names": "<asset_names>"
},
"name": "scatter_surface_assets"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Random seed for distribution. | |
| count | No | Number of asset instances to scatter. | |
| task_id | No | ||
| approved | No | ||
| max_scale | No | Maximum instance scale multiplier. | |
| min_scale | No | Minimum instance scale multiplier. | |
| request_id | No | ||
| asset_names | Yes | List of source asset object names to distribute. | |
| name_prefix | No | Naming prefix for created instances. | ScatteredAsset |
| min_distance | No | Minimum distance between scattered instances to prevent overlap. | |
| surface_name | Yes | Target terrain/surface object name to scatter onto. | |
| avoid_overlap | No | Enforce minimum distance checking. | |
| approval_token | No | ||
| align_to_normal | No | Align instance Up vector to surface normal. | |
| collection_name | No | Target collection for scattered instances. | ScatteredAssets |
| random_rotation_z | No | Apply random rotation around surface normal / Z axis. |