insert_toolbox_asset

Inserts a curated Toolbox asset into the game by its toolbox_id.

What it does

insert_toolbox_asset takes a toolbox_id from a prior search_toolbox result and recreates the asset's full instance tree — every part, script, and property — under a chosen parent in your game. The default parent is Workspace. An optional name override renames the top-level inserted instance.

Because the asset's hierarchy is recreated rather than referenced, you own the result outright and can edit any part of it with the usual tools. Revix typically follows an insert with list_descendants on the new path to understand exactly what landed, before applying any tweaks.

Parameters

Name	Type	Required	Description
`toolbox_id`	string	yes	Toolbox asset ID (from `search_toolbox` results).
`parent`	string	no	DataModel path to insert into. Default: `Workspace`.
`name`	string	no	Optional name override for the top-level inserted instance.

When Revix uses it

After search_toolbox returned a suitable match
Building a scene that needs several curated props placed and then customized
Dropping in a UI kit that the user will customize afterward

Example

text

insert_toolbox_asset(
  toolbox_id="6543abcd...",
  parent="Workspace/Forest",
  name="PineTree_01"
)
=> Inserted PineTree_01 with 12 instances under Workspace/Forest

Limits

If the asset has no stored instance data, the call errors and Revix will either pick a different asset or build manually.

Troubleshooting

If the asset cannot be found, it may have been removed from the curated library — re-run search_toolbox to get a fresh ID. See toolbox for more on the curated library.