# Tool reference

> Every optional tool RoGenie can use, grouped as in Tool access, with what each one does and what RoGenie does instead when it is switched off.

These are RoGenie's 62 optional tools in 10 groups, exactly as they appear in [Tool access](https://rogenie.ai/docs/tool-access), where you can switch any of them off for a session. Where a description says *When off*, that is what RoGenie does instead.

Besides these, RoGenie always has its core abilities: reading your place and its scripts, searching instances and script text, editing scripts with targeted diffs, creating and changing instances, properties and attributes, and running Luau in Studio. Those cannot be switched off, and with Luau RoGenie can still do the work of a tool you switched off (terrain or lighting, for example) the long way. Use [Plan mode](https://rogenie.ai/docs/plan-mode) to keep RoGenie from changing anything.

## AI Generation

> **Note**
> These tools need the [RoGenie Bridge](https://rogenie.ai/docs/bridge) running on a Windows PC with Studio open.

| Tool | What it does |
|---|---|
| **AI Model Generation** | Generate 3D models from primitive parts with AI. When off: build models from primitives / Toolbox. |
| **AI Mesh Generation** | Generate a real textured mesh from a prompt. When off: build from primitives / Toolbox. |
| **AI Material Generation** | Generate a PBR MaterialVariant from a prompt and apply it to parts. |
| **AI Procedural Model** | AI-build objects from primitive parts. |
| **Image Upload to Roblox** | Upload images to the Roblox Asset Server for custom textures/decals. |

## Toolbox & Assets

| Tool | What it does |
|---|---|
| **Toolbox Search** | Search the Roblox Toolbox / Creator Store for models. |
| **Toolbox Browse** | Browse Toolbox categories. |
| **Asset Probe** | Inspect Toolbox asset candidates before inserting. |
| **Audio Search** | Search the Roblox audio library for SFX / music. |
| **Audio Probe** | Check whether audio IDs can load. |
| **Asset Library** | Query / import from the pre-configured asset library. |
| **Icon Library** | Browse and search the curated royalty-free icon packs. When off: no icon browsing (RoGenie must not hand-draw icons). |

## Verification

| Tool | What it does |
|---|---|
| **Playtest** | Run StudioTestService playtests for runtime / physics proof. |
| **Screenshots** | Capture viewport screenshots for visual proof. |
| **Validate** | Cheap static edit-mode validation of scripts / targets. |
| **Geometry Scan** | Scan for hidden parts, z-fighting, duplicates, intersections. |
| **Floor Plan** | Text/SVG top-down plan of one storey: furniture in walls, blocked doors, clear zones. |
| **Build Introspection** | Synthesize a BuildSpec from existing geometry (rooms, openings, stairs, furniture) and write it to the kit spec module. |
| **UI Layout Scan** | Check GUIs for elements cut off by the screen, overlapping siblings, and non-scaling sizes. |
| **Orientation Probe** | Inspect foreign meshes/models before rotating them. |
| **Runtime Eval** | Run Lua inside the LIVE running game to read/poke runtime state (needs a run session). |
| **Profiler** | Live FPS / frame-time / memory-by-tag via the Stats service. |
| **Play as Player** | Run agent-authored behaviour in a real Play session (live player + client + input) and get a report. |
| **Scene Analysis** | Read-only project audit: instance/script stats, triangle & memory composition, dead scripts, module dependencies. |
| **Compare Instances** | Deep structural diff of two instances/subtrees. |
| **Snapshots & Diff** | Capture a property-state snapshot of a subtree and diff against it later to prove exactly what changed. |
| **Reference Quarantine** | Disable scripts under a reference folder (reversibly) so imported games stop polluting play tests. |

## Editing & History

| Tool | What it does |
|---|---|
| **Undo / Redo** | Undo or redo recent Studio changes via ChangeHistoryService. When off: mistakes must be corrected with a fresh edit. |
| **Find & Replace in Scripts** | Find-and-replace a string across many scripts at once (dry run by default). When off: edit scripts individually. |
| **Smart Rename** | Rename an instance and refactor references to the old name across scripts. When off: rename via property set. |
| **Reparent** | Move an instance to a new parent. When off: reparent with a Luau script. |
| **Smart Duplicate** | Clone instances with positional/rotational/scale offsets and property variation. When off: duplicate with a Luau script. |

## Build & Assets

| Tool | What it does |
|---|---|
| **Insert Asset by ID** | Insert a Toolbox/Creator-Store asset by explicit asset ID. When off: insert via a Luau script / build from primitives. |
| **Insert Asset by Search** | Resolve a search query and insert the TOP result in one call (opt-in, one asset). When off: search, then insert by id. |
| **Insert Avatar** | Insert a player's avatar rig. When off: insert a blank rig or build one. |
| **Insert Rig** | Drop a blank animatable R15/R6 dummy. When off: build a rig with a Luau script. |
| **Constraints & Joints** | Build hinges, motors, servos, welds and vehicle joints with correct Attachments. When off: hand-write Attachment CFrames. |
| **Inverse Kinematics** | Solve joint rotations so a hand/foot reaches a world point. When off: pose limbs by hand. |
| **Create Animation** | Author a KeyframeSequence from poses (and optionally publish it). When off: animate with scripted tweens. |
| **Edit Animation** | Retime/mirror/re-prioritise/loop an animation that already exists. When off: re-author it from scratch. |
| **Publish Assets to Roblox** | Upload ANY asset type as a real Roblox asset. When off: RoGenie never publishes anything for you. |
| **Bake to ServerStorage** | Freeze generated geometry into one stored snapshot. When off: keep re-running the generator. |
| **Declarative UI Builder** | Build a GUI from a tree in one call with per-prop errors. When off: assemble GUIs with a Luau script. |

## Interaction

| Tool | What it does |
|---|---|
| **Ask the User** | Let RoGenie pause mid-task to ask you a question. When off: it never interrupts and decides for itself. |
| **Project & User Notes** | Let RoGenie save lasting notes: this place's conventions and decisions (ServerStorage.RoGenie.ProjectNotes) and how you like to work. When off: it never writes notes; notes already saved still load. |

## Research

| Tool | What it does |
|---|---|
| **Roblox Skills** | Curated Roblox engineering knowledge (security, data, networking, UI, growth, publishing). |
| **Roblox Docs Search** | Search official Roblox documentation. |
| **Class Info** | Look up Roblox class/member API shape. |
| **Search My Other Chats** | Let RoGenie search and quote your other chats when you refer to earlier work. When off: it only sees this chat. |

## Parallel & Analysis

| Tool | What it does |
|---|---|
| **Sub-Agents** | Spawn parallel background sub-agents for independent work. |
| **Stop Sub-Agents** | Stop one or all running sub-agents this run spawned. |
| **Resume Sub-Agents** | Re-run sub-agents paused when their model route went down. |
| **Wait for Sub-Agents** | Block until chosen sub-agents finish (some, all, or none), then read their results. |
| **LLM Queries** | Batched background LLM queries. |
| **Script Analyzer** | Background zero-context script bug analysis. |

## Advanced Build

| Tool | What it does |
|---|---|
| **Native Model Builder** | Build a Model from primitive parts with RoGenie's own geometry code (no bridge/AI needed). When off: hand-build with a Luau script. |
| **CSG / Solid Modeling** | Boolean union/negate/intersect operations on parts. |
| **Terrain** | Sculpt smooth Terrain (fill/clear/read). When off: build with parts or a Luau script. |
| **Lighting** | Read/set Lighting or apply mood presets. When off: set lighting via a Luau script. |
| **Material Variants** | Create/list/override custom PBR MaterialVariants from texture asset IDs. When off: manage via a Luau script. |
| **Checkpoints** | Save/restore named binary-fidelity restore points of a subtree. When off: rely on undo. |

## Blender

> **Note**
> These tools need the [RoGenie Bridge](https://rogenie.ai/docs/bridge) running on a Windows PC with Studio open.

| Tool | What it does |
|---|---|
| **Blender Control** | Model, sculpt, rig, animate and render in your own Blender through the Bridge, then send models, rigs, animations and rendered icons into Studio. When off: no Blender access. |