스크립트 윈도우
MCP 없이도 스크립트를 붙여넣어 씬을 만들 수 있는 에디터 윈도우 사용법입니다.
스크립트 윈도우는 작성한 DSL 스크립트를 붙여넣어 씬에 반영하는 에디터 창입니다. MCP 패키지를 설치하지 않아도 사용할 수 있습니다.
Window > UModeler X > AI Shape Script (Window) 로 엽니다.
사용 순서
-
Copy Prompt 를 누릅니다. 문법 안내문 전체가 클립보드에 복사됩니다.
-
ChatGPT · Claude 등에 붙여넣고, 만들고 싶은 것을 설명합니다. (예: "2인용 벤치를 만들어 줘")
-
AI 의 답변(스크립트)을 복사한 뒤 윈도우의 Paste 를 누르거나 텍스트 영역에 직접 붙여넣습니다.
-
Validate 로 오류만 먼저 확인합니다. (씬은 바뀌지 않습니다)
-
Run 을 누르면 현재 열린 씬에 오브젝트가 생성됩니다.
버튼
| 버튼 | 동작 |
|---|---|
| Copy Prompt | AI 에게 줄 문법 안내문을 클립보드에 복사합니다. |
| 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. | 컴파일 중입니다. 끝난 뒤 다시 실행하세요. |
