UModeler X MCPis live — model with an AI agent
UModeler X

Script Window

Build scenes without MCP by pasting a DSL script into an editor window.

The Script Window takes a DSL script and applies it to the scene. It works without any MCP package installed.

Open it from Window > UModeler X > AI Shape Script (Window).


Workflow

  1. Press Copy Prompt. The full syntax guide is copied to the clipboard.

  2. Paste it into ChatGPT, Claude or similar, and describe what you want. (For example: "Build a two-seat bench.")

  3. Copy the AI's reply and press Paste in the window, or paste it into the text area directly.

  4. Press Validate to see errors first. (The scene is not changed.)

  5. Press Run to build the objects in the currently open scene.


Buttons

ButtonAction
Copy PromptCopy the syntax guide for the AI to the clipboard.
PastePaste the clipboard contents into the text area.
ClearEmpty the text area.
ValidateCheck the script without changing the scene.
RunRun the script in the currently open scene.

What Copy Prompt includes

The guide produced by Copy Prompt carries:

  • Output rules — reply with the script only, no code fences and no explanation
  • Scene conventions — meters and degrees, Y is up, +X is right, +Z is forward
  • Pivot convention — most shapes have their pivot at the center of the bottom face, so a shape of height h occupies y to y+h and the next part stacked on top goes to @0,h,0. Ring-like kinds such as Torus are centered on the pivot instead.
  • The full syntax table — the same syntax definition the MCP tool carries
  • An example script — a bench assembly

Reading the result

After a run, a summary and a detail list appear at the bottom of the window.

  • Created / updated / deleted objects — in "Name#id" form
  • Number of modifiers added
  • Failed nodes — with line numbers and reasons
  • Warnings — duplicate names, shape parameters given to a non-parametric target, and so on

Each list is capped at 30 items so the panel does not grow unbounded.


Common errors

MessageCause
Indentation must be in 2-space units.Indentation is not a multiple of two spaces, or tabs were used.
Indentation depth increased by more than one level at once.The line indented more than one level deeper.
Unknown kind '...'No such shape type. Check the allowed list in the message.
Unknown key '...'No such parameter name.
Unknown modifier '...'No such modifier.
Target not found: '...'The reference or delete target is not in the scene.
Editor is compiling. Retry after compilation completes.Compilation is in progress. Run again when it finishes.
Script Window | UModeler X Manual