pmndrs/react-three-rapier

어떤 프로젝트인가요?

핵심 기능

• 01react-three-fiber 씬에서 사용할 수 있는 선언형 RigidBody 및 콜라이더 컴포넌트.
• 02메시 경계 상자, 구, 볼록 헐 및 삼각형 메시 지오메트리에서 콜라이더를 자동 생성.
• 03회전, 프리즘형, 스프링 조인트를 포함해 6가지 조인트 유형을 React 훅으로 제공.
• 04인스턴스별 콜라이더와 복합 형상을 지원하는 인스턴스화 강체.
• 05충돌, 센서, 접촉력 이벤트 콜백과 충돌 그룹 필터링.
• 06디버그 시각화, 설정 가능한 타임스텝, 월드 스냅샷 직렬화.

활용 사례

• react-three-fiber 게임이나 인터랙티브 씬에 낙하하는 소품이나 튀어 오르는 공 같은 물리 기반 객체 추가.
• 3D React 애플리케이션에서 조인트를 사용해 래그돌, 체인, 문 또는 바퀴 구현.
• 인스턴스 메시를 사용해 수천 개의 작은 강체 시뮬레이션.
• 센서 콜라이더로 3D 씬의 구역이나 트리거 감지.

빠른 시작

1. 1

   npm에서 패키지를 설치합니다

   npm install @react-three/rapier
2. 2

   Physics와 RigidBody를 가져오고, Suspense 안에서 씬을 Physics로 감쌉니다

사용 전 알아둘 점

• !버전 2에는 @react-three/fiber v9와 React v19가 필요합니다. React v18 사용자는 fiber v8과 함께 v1을 사용해야 합니다.

토픽

자주 묻는 질문

react-three-rapier은(는) 무엇인가요?

Rapier WASM 물리 엔진을 위한 React 바인딩으로, 강체·콜라이더·조인트를 react-three-fiber 씬에 통합합니다. react-three/rapier는 Rapier WASM 물리 엔진을 React 컴포넌트로 감싸, react-three-fiber 씬에서 메시와 함께 물리 객체를 선언할 수 있게 합니다. Physics 컴포넌트가 시뮬레이션을 생성하고, RigidBody 컴포넌트가 메시를 시뮬레이션에 연결하며, 콜라이더 컴포넌트는 직접 지정하거나 메시 지오메트리에서 자동 생성한 형태를 정의합니다.

react-three-rapier은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

react-three-rapier은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

react-three-rapier은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. react-three-rapier의 마지막 커밋은 2026년 10월 12일입니다.

react-three-rapier은(는) 어디에 사용할 수 있나요?

react-three-fiber 게임이나 인터랙티브 씬에 낙하하는 소품이나 튀어 오르는 공 같은 물리 기반 객체 추가. 3D React 애플리케이션에서 조인트를 사용해 래그돌, 체인, 문 또는 바퀴 구현. 인스턴스 메시를 사용해 수천 개의 작은 강체 시뮬레이션. 센서 콜라이더로 3D 씬의 구역이나 트리거 감지.

react-three-rapier는 어떻게 설치하나요?

npm에서 패키지를 설치합니다: npm install @react-three/rapier Physics와 RigidBody를 가져오고, Suspense 안에서 씬을 Physics로 감쌉니다

react-three-rapier은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pmndrs/react-three-rapier