unity-smart

Use smart_scene_query with componentName, propertyName, an operator like > or ==, and a comparison value. For example, querying Light components where intensity is greater than 2 returns all matching objects, up to the configurable result limit.

Use smart_reference_bind with the target GameObject name, component name, field name, and a sourceTag or sourceName filter. It finds matching objects and fills the List or Array field, with an appendMode option to add rather than replace entries.

Yes, smart_scene_layout arranges selected objects into Linear, Grid, Circle, or Arc layouts. You control spacing, axis, grid columns, arc angle, and whether objects rotate to face the layout center.

No, the query parameter is an unsupported shorthand that returns a guidance error if used alone. You must specify componentName and propertyName explicitly, with optional operator, value, and limit parameters.

smart_replace_objects is flagged NeverInSemi because it deletes original objects during replacement. It is blocked in Approval and Auto modes and only runs under Bypass mode or when explicitly allowlisted.

Use gameobject_find or scene_find_objects for simple name-based object searches. Reserve smart_scene_query for complex SQL-like filtering on component property values and smart_scene_query_spatial for region-based searches.