UModeler X MCP출시 — AI 에이전트로 모델링하세요
UModeler X

스크립트 윈도우

MCP 없이도 스크립트를 붙여넣어 씬을 만들 수 있는 에디터 윈도우 사용법입니다.

스크립트 윈도우는 작성한 DSL 스크립트를 붙여넣어 씬에 반영하는 에디터 창입니다. MCP 패키지를 설치하지 않아도 사용할 수 있습니다.

Window > UModeler X > AI Shape Script (Window) 로 엽니다.

사용 순서

  1. Copy Prompt 를 누릅니다. 문법 안내문 전체가 클립보드에 복사됩니다.

  2. ChatGPT · Claude 등에 붙여넣고, 만들고 싶은 것을 설명합니다. (예: "2인용 벤치를 만들어 줘")

  3. AI 의 답변(스크립트)을 복사한 뒤 윈도우의 Paste 를 누르거나 텍스트 영역에 직접 붙여넣습니다.

  4. Validate 로 오류만 먼저 확인합니다. (씬은 바뀌지 않습니다)

  5. Run 을 누르면 현재 열린 씬에 오브젝트가 생성됩니다.

버튼

버튼동작
Copy PromptAI 에게 줄 문법 안내문을 클립보드에 복사합니다.
Paste클립보드 내용을 텍스트 영역에 붙여넣습니다.
Clear텍스트 영역을 비웁니다.
Validate씬을 바꾸지 않고 스크립트만 검사합니다.
Run현재 열린 씬에 스크립트를 실행합니다.

Copy Prompt 안내문에 들어 있는 것

Copy Prompt 가 만들어 주는 안내문에는 다음 내용이 담겨 있습니다.

  • 출력 규칙 — 스크립트만 답하고 코드 펜스 · 설명을 붙이지 말라는 지시
  • 씬 규약 — 단위는 미터, 각도는 도, Y가 위 · +X가 오른쪽 · +Z가 앞
  • 피벗 규약 — 대부분의 쉐이프는 바닥면 중심이 피벗이므로 높이 h 의 쉐이프는 y ~ y+h 를 차지하고, 그 위에 쌓을 파트는 @0,h,0 에 둡니다. Torus 처럼 고리 형태는 피벗이 중심입니다.
  • 전체 문법표 — MCP 툴 설명과 동일한 문법 정의
  • 예시 스크립트 — 벤치 조립 예시

결과 확인

실행하면 윈도우 하단에 요약과 상세 목록이 표시됩니다.

  • 생성 / 수정 / 삭제된 오브젝트 — "이름#id" 형식
  • 추가된 모디파이어 수
  • 실패한 노드 — 줄 번호와 이유
  • 경고 — 이름 중복, 파라메트릭 쉐이프가 아닌 대상에 파라미터를 지정한 경우 등

목록이 너무 길어지지 않도록 항목별로 최대 30개까지 표시합니다.

자주 겪는 오류

메시지원인
Indentation must be in 2-space units.들여쓰기가 2칸 단위가 아니거나 탭을 사용했습니다.
Indentation depth increased by more than one level at once.한 번에 두 단계 이상 들여썼습니다.
Unknown kind '...'존재하지 않는 쉐이프 종류입니다. 메시지의 허용 목록을 확인하세요.
Unknown key '...'존재하지 않는 파라미터 이름입니다.
Unknown modifier '...'존재하지 않는 모디파이어입니다.
Target not found: '...'참조 · 삭제 대상이 씬에 없습니다.
Editor is compiling. Retry after compilation completes.컴파일 중입니다. 끝난 뒤 다시 실행하세요.
스크립트 윈도우 | UModeler X Manual