Search for instances in the game
search-instancesSearch Roblox instances using selector syntax to find objects by class, name, tag, property, or attributes from a chosen root.
Instructions
Search Roblox instances with QueryDescendants selector syntax. Use for class, name, tag, property, and attribute queries against a chosen root.
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": {
"selector": "<selector>"
},
"name": "search-instances"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| selector | Yes | Selector string to filter instances. Supports classes (Part), tags (.Tagged), names (#HumanoidRootPart), properties ([CanCollide = false]), attributes ([$QuestId] or [$Health = 100]), child/descendant combinators (> and >>), OR selectors (,), :not(), and :has(); chain selectors for AND logic, e.g. Part.Tagged[Anchored = false]. | |
| root | No | The root instance to search from (e.g., 'game.Workspace', 'game.ReplicatedStorage'). Defaults to 'game' if not specified. | game |
| limit | No | Maximum number of results to return (default: 50, to avoid overwhelming output) |