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

Box (박스)

가로·세로·높이와 축별 분할 수를 가진 6면 박스 쉐이프입니다.

Box 는 가로·세로·높이를 가진 6면 박스입니다. 새로 만든 파라메트릭 쉐이프의 기본 종류이며, 블록아웃에서 가장 많이 쓰입니다.


형태

여섯 개의 사각 면으로 닫힌 박스입니다. Width 는 로컬 X, Depth 는 로컬 Z, Height 는 로컬 Y 방향이며, 피벗은 바닥면 중심입니다. 따라서 높이 h 인 박스는 y=0 부터 y=h 까지를 차지하고, 그 위에 다른 파트를 얹으려면 @0,h,0 에 두면 됩니다.

축별 분할 수를 올리면 각 면이 격자로 나뉩니다. Bend·Twist 같은 모디파이어는 분할된 면이 있어야 부드럽게 휘므로, 변형을 예정한 박스는 분할을 미리 올려 둡니다.


파라미터

라벨스크립트 키기본값범위설명
Widthw10.01 ~ 10000로컬 X 방향 폭 (m)
Depthd10.01 ~ 10000로컬 Z 방향 깊이 (m)
Heighth1-10000 ~ 10000로컬 Y 방향 높이 (m)
Width Segswidthsegs11 ~ 128X 방향 분할 수
Depth Segsdepthsegs11 ~ 128Z 방향 분할 수
Height Segsheightsegs11 ~ 128Y 방향 분할 수

Height 에 음수를 넣으면 박스가 피벗 아래로 자랍니다. 0 은 최소 두께(0.01)로 보정됩니다.


만드는 방법

  1. 빈 공간에서 마우스를 눌러 드래그합니다. 드래그한 사각형이 바닥면(Width × Depth)이 됩니다.

  2. 클릭해 바닥을 확정하고 마우스를 위로 올려 Height 를 정합니다.

  3. 다시 클릭하면 완성됩니다.


씬뷰 편집

여섯 면에 각각 화살표 핸들이 붙습니다. X 축 핸들은 Width, Z 축 핸들은 Depth, Y 축 핸들은 Height 를 조정합니다. 기본 드래그는 반대면을 공간에 고정하고 피벗이 따라 이동하며, Shift 드래그는 중심을 기준으로 양쪽을 동시에 늘립니다.


활용 팁

분할 수는 필요할 때만 올리세요. 세 축을 모두 128 로 두면 한 오브젝트에 약 9.8만 개의 면이 생깁니다.

벽·바닥처럼 얇고 넓은 판은 Height 를 얇게 두는 대신 Collider Mode 를 켜서 충돌 전용으로 쓸 수도 있습니다.


스크립트

스크립트에서는 box 로 지정합니다.

box "Crate" w=1 h=1 d=1 @0,0,0
box "Wall" w=4 h=3 d=0.2 widthsegs=4 heightsegs=3 @0,0,2

관련 문서 — 쉐이프 종류 목록 · 생성과 편집 모드 · 씬 스크립트 문법

Box (박스) | UModeler X Manual