Rigid Body·Collision 속성 · OasisW 매뉴얼

COLLISION과 RIGIDBODY 컴포넌트의 칸을 정리합니다. 칸 이름과 처음 값은 2026-10-29 oasisw.ai 에디터(판 표시 OasisW 7e2aa65)에서 읽은 것입니다. 붙이는 절차는 충돌 판정 붙이기, 구조는 물리가 동작하는 방식에 있습니다.

COLLISION

칸	처음 값	뜻
Type	`Box`	범위의 모양. `Box`, `Sphere`, `Capsule`, `Cylinder`, `Cone`, `Mesh`, `Compound`
Half Extents	`0.5, 0.5, 0.5`	Box의 가로·세로·깊이의 절반(미터). 엔티티 Scale을 따라가지 않습니다
Position Offset	`0, 0, 0`	엔티티 중심에서 범위를 옮기는 거리
Rotation Offset	`0, 0, 0`	범위를 돌리는 각도

Type별 칸

2026-10-29에 Type을 하나씩 바꿔 나오는 칸을 확인했습니다. Position Offset·Rotation Offset은 모든 Type에 있습니다.

Type	칸(처음 값)
`Box`	Half Extents(`0.5, 0.5, 0.5`)
`Sphere`	Radius(`0.5`). 엔티티 Scale을 따라가지 않습니다(2026-10-30 실측)
`Capsule`, `Cylinder`, `Cone`	Radius(`0.5`), Height(`2`), Axis(`Y`; `X`·`Y`·`Z`)
`Mesh`	Convex Hull(꺼짐), Model Asset, Render Asset. 모델의 모양 그대로 충돌합니다
`Compound`	Offset 칸만. 자식 엔티티들의 Collision을 합친 모양으로 씁니다. 2026-10-30 실측에서 부모에 `Compound`와 Rigid Body(`Dynamic`), 자식 두 개에 Collision(`Box`)만 붙이자(자식에는 Rigid Body 없음), 두 자식 상자가 함께 바닥에 닿고 한 몸으로 움직였습니다(1회)

Type을 바꿨다가 Box로 돌아오면 전에 넣은 Half Extents가 그대로 남아 있었습니다.

Plane에 맞추는 예

새 씬의 Plane은 Scale 8, 1, 8입니다. Collision을 붙이면 범위는 1×1로 가운데에만 생깁니다. 실측에서는 Half Extents 4, 0.5, 4, Position Offset 0, -0.5, 0으로 바닥 전체를 덮었습니다(충돌 판정 붙이기 4단계).

RIGIDBODY

칸	처음 값	뜻	나오는 Type
Type	`Static`	`Static`, `Dynamic`, `Kinematic`	모두
Mass	`1`	무게(킬로그램)	Dynamic
Linear Damping	`0`	움직임이 줄어드는 정도(공기 저항)	Dynamic
Angular Damping	`0`	회전이 줄어드는 정도	Dynamic
Linear Factor	`1, 1, 1`	축마다 움직일 수 있는 정도. `0`이면 그 축으로 움직이지 않습니다	Dynamic
Angular Factor	`1, 1, 1`	축마다 돌 수 있는 정도. 넘어지지 않게 하려면 `0, 1, 0`처럼 둡니다	Dynamic
Gravity Scale	`1`	이 엔티티가 받는 중력 배율	Dynamic
Friction	`0.5`	미끄러짐을 막는 정도	모두
Restitution	`0.5`	튕기는 정도. `0`이면 튕기지 않습니다	모두
Rolling Friction	`0`	구를 때의 마찰	모두

Static과 Kinematic을 고르면 Friction, Restitution, Rolling Friction만 나옵니다(2026-10-29 확인). 두 타입은 중력과 힘을 받지 않으므로 무게·감쇠 칸이 없습니다.

상자가 바닥에 닿은 뒤 한 번 튀는 것은 Restitution 0.5 때문입니다. 실측에서 상자를 높이 4에서 떨어뜨리면 collisionstart가 튈 때마다 다시 와서 2~3번 들어왔습니다(충돌 이벤트 받기).