AI Assistant Actions
The AI Assistant in the Studio code editor does more than answer questions. When a change is needed, it proposes an action: a world-settings patch or a replacement for the code in the editor. You review the action in the chat and apply it with one click. Nothing is applied until you confirm it.
The AI Assistant works on the script you have open and on the world settings. To let an AI agent place models, write several scripts, take screenshots and build a complete world, see WebMCP — In-Browser AI Tools.
Getting access
The AI Assistant runs on your Captic AI allowance:
- Free accounts get 15 Captic AI interactions a month, shared with every other Captic AI feature. The panel shows how many are left.
- Paid plans include a monthly Captic AI credit. The panel shows how much of it you have used.
- Your own key: when the allowance runs out, or if you prefer, enter your own OpenAI API
key under Settings. You can also point it at any OpenAI-compatible server (for example a
local one at
http://localhost:11434/v1) and choose its API format: Responses or Chat Completions. Your key is stored only in your browser's local storage.
Available actions
Update world attributes
Proposes a JSON patch to the world's environment configuration (roomsattr): sky, lighting,
environment map, spawn point, ground, physics and similar settings.
- You describe what you want, for example "Change the sky colour".
- The assistant reads the current settings (with Environment Settings selected as context) and works out a patch.
- The chat shows Pending Action: Update World Attributes with the patch.
- When you click Confirm & Apply Patch, Captic applies the patch, syncs it to everyone in the world, and saves it.
Replace editor code
Proposes a complete new version of the script in the editor, with a summary of what changed.
- You ask for a change, for example "Add a physics impulse when the button is clicked".
- The chat shows Pending Action: Replace Editor Code with the new code and a summary.
- Confirm & Replace Code puts it into the editor and saves it. Revert restores the previous code.
For smaller edits, every code block in an answer also has Copy, Insert (at the cursor) and Replace All buttons.
Modes
| Mode | What it does | Best for |
|---|---|---|
| Fast Mode | One short model call with no reasoning, for the lowest latency. | Simple questions and small edits |
| Agent Mode | The assistant drafts a solution, validates the generated code, reviews and improves the result, and checks the final replacement before it shows you the proposal. You can follow each step under Agent activity. Uses more AI calls. | Larger changes and new components |
With Allow AI 360° Auto-Capture turned on, the assistant can take a 360° view from your position when it needs to see the scene. You can also attach a screenshot or a 360° panorama to your next message yourself.
Examples
Select Environment Settings (roomsattr) as context before running these prompts, so the assistant can see your current values. See AI Chat Context.
Changing the time of day
Prompt:
"Make it night. Turn off the procedural sky and switch the environment map to moonless golf."
Proposed patch:
{
"useSky": { "use": false },
"useEnvironment": { "use": true, "textureSrc": "moonless_golf_1k.jpg" }
}
Result: after you confirm, the procedural sky disappears and the night environment map lights the scene.
Adjusting the lighting
Prompt:
"It's too dark in here. Increase the global light intensity to 2.5."
Proposed patch:
{ "lightIntensity": 2.5 }
Moving the spawn point
Prompt:
"Move the spawn point up by 5 units on the Y axis."
Proposed patch (the current spawn Y is 0.71):
{ "spawnPoint": { "x": 25.96, "y": 5.71, "z": -13.61 } }
Result: the next visitor who joins arrives at the new position.