Add an object LIVE to the user's open R3 editor
r3_editor_createThe same tool as r3_factory_run (this is its older name): add an object — a cube, sphere, light, physics body … — kept at once in the project's live copy: every R3 tab with the project open shows it now, no editor needed and nothing to save. r3_factory_list lists the factories and their params.
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": {
"projectId": "<projectId>",
"factory": "<factory>"
},
"name": "r3_editor_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | The name of what you make, e.g. "Leg front left" (r3_factory_run's name). | |
| params | No | Factory options, e.g. {"color": 16711680, "position": {"y": 2}}. Color is a packed RGB integer. Rotations are in RADIANS, not degrees: a quarter turn is Math.PI/2 ≈ 1.5708 (the R3 Inspector shows rotations in degrees: 90°). | |
| factory | Yes | Factory name, e.g. "Cube", "Sphere", "PhysicsCube". See r3_factory_list. | |
| projectId | Yes | The project (r3_project_list). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seq | No | ||
| live | Yes | ||
| roles | Yes | ||
| saved | Yes | ||
| answer | Yes | This answer in words: what was done, what R3 measured, decided or refused, and what to do next. The same text as the result's text block. Read it: the fields beside it are the data, this is the guidance. | |
| editor | Yes | ||
| created | Yes | ||
| factory | Yes | ||
| projectId | Yes |