pmndrs/react-three-rapier

Что это?

Ключевые возможности

• 01Декларативные компоненты RigidBody и коллайдеров для сцен react-three-fiber.
• 02Автоматическое создание коллайдеров по границам меша, сферам, выпуклой оболочке или геометрии trimesh.
• 03Шесть типов соединений в виде хуков React, включая вращательные, поступательные и пружинные.
• 04Инстанцированные твёрдые тела с отдельными коллайдерами для каждого экземпляра и составными формами.
• 05Обработчики событий столкновений, сенсоров и контактных сил, а также фильтрация по группам столкновений.
• 06Визуализация отладки, настраиваемый временной шаг и сериализация снимка состояния мира.

Сценарии использования

• Добавление в игру или интерактивную сцену на react-three-fiber физических объектов — например, падающих предметов или прыгающих мячей.
• Создание рэгдоллов, цепей, дверей или колёс с соединениями в 3D-приложении на React.
• Симуляция тысяч небольших твёрдых тел с помощью инстанцированных мешей.
• Обнаружение зон или триггеров в 3D-сцене с помощью коллайдеров-сенсоров.

Быстрый старт

1. 1

   Установите пакет из npm

   npm install @react-three/rapier
2. 2

   Импортируйте Physics и RigidBody и оберните сцену в Physics внутри Suspense

Что важно знать

• !Для версии 2 требуются @react-three/fiber v9 и React v19; пользователям React v18 необходимо использовать версию 1 с fiber v8.

Темы

Частые вопросы

Что такое react-three-rapier?

React-обёртка для физического движка Rapier WASM: добавляет твёрдые тела, коллайдеры и соединения в сцены react-three-fiber. react-three/rapier предоставляет компоненты React для физического движка Rapier WASM, позволяя объявлять физические объекты рядом с мешами в сцене react-three-fiber. Компонент Physics создаёт симуляцию, компоненты RigidBody подключают к ней меши, а компоненты коллайдеров задают формы вручную или автоматически строят их по геометрии меша.

react-three-rapier можно использовать бесплатно? Какая у него лицензия?

react-three-rapier распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

react-three-rapier всё ещё поддерживается?

Активно поддерживается. Последний коммит в react-three-rapier — 12 окт. 2026 г..

Для чего можно использовать react-three-rapier?

Добавление в игру или интерактивную сцену на react-three-fiber физических объектов — например, падающих предметов или прыгающих мячей. Создание рэгдоллов, цепей, дверей или колёс с соединениями в 3D-приложении на React. Симуляция тысяч небольших твёрдых тел с помощью инстанцированных мешей. Обнаружение зон или триггеров в 3D-сцене с помощью коллайдеров-сенсоров.

Как установить react-three-rapier?

Установите пакет из npm: npm install @react-three/rapier Импортируйте Physics и RigidBody и оберните сцену в Physics внутри Suspense

Где скачать react-three-rapier?

Исходный код и инструкции по установке — на GitHub: https://github.com/pmndrs/react-three-rapier