![](\"misc/hero.svg\")
![\"@react-three/rapier\"](\"https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/hero.svg\")
\n \n
\nš£ @react-three/rapier v2 has been released, which adds support for @react-three/fiber v9 and react v19. If you are using react v18, you will need to use @react-three/rapier v1 and @react-three/fiber v8.\n
\n\n\n\n ![](\"https://img.shields.io/npm/v/@react-three/rapier?style=for-the-badge&colorA=0099DA&colorB=ffffff\")
![](\"https://img.shields.io/discord/740090768164651008?style=for-the-badge&colorA=0099DA&colorB=ffffff&label=discord&logo=discord&logoColor=ffffff\")
\nFor contributions, please read the šŖ§ Contribution Guide.\n
\nFor available APIs, see š§© API Docs\n
![](\"https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/example-auto-colliders.jpg\")
\n![](\"https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/example-compound-shapes.jpg\")
\n\n## Instanced Meshes\n\nInstanced meshes can also be used and have automatic colliders generated from their mesh.\n\nBy wrapping exactly one `Three.InstancedMesh` in `![](\"https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/example-sensors.jpg\")
\n\n## Configuring Time Step Size\n\nBy default, `![](\"https://raw.githubusercontent.com/pmndrs/react-three-rapier/HEAD/packages/react-three-rapier/misc/example-joints.jpg\")
\n\n## Advanced hooks usage\n\nAdvanced users might need granular access to the physics loop and direct access to the `world` instance. This can be done by using the following hooks:\n\n- `useRapier` \n Gives you access to the `world`, direct access to `rapier`, and more. \n š§© See [useRapier docs](https://pmndrs.github.io/react-three-rapier/interfaces/RapierContext.html) for more information.\n- `useBeforePhysicsStep` \n Allows you to run code before the physics simulation is stepped. \n š§© See [useBeforePhysicsStep docs](https://pmndrs.github.io/react-three-rapier/functions/useBeforePhysicsStep.html) for more information.\n- `useAfterPhysicsStep`\n Allows you to run code after the physics simulation is stepped. \n š§© See [useAfterPhysicsStep docs](https://pmndrs.github.io/react-three-rapier/functions/useAfterPhysicsStep.html) for more information.\n\n### Physics Hooks (Collision Filtering)\n\nYou can implement advanced collision behaviors like one-way platforms by using physics hooks. These hooks allow you to filter collision and intersection pairs during the physics step.\n\n`r3/rapier` provides two hooks for collision filtering:\n- `useFilterContactPair` - Filter collision pairs and control solver behavior\n- `useFilterIntersectionPair` - Filter intersection pairs for sensors\n\n#### Filter Contact Pairs\n\n`useFilterContactPair` allows you to control how collisions are processed. The callback should return:\n- `SolverFlags.COMPUTE_IMPULSE` (1) - Process the collision normally\n- `SolverFlags.EMPTY` (0) - Ignore the collision\n- `null` - Let other hooks decide, or use default behavior\n\n#### Filter Intersection Pairs \n\n`useFilterIntersectionPair` controls which sensor intersections are detected. The callback should return:\n- `true` - Allow the intersection to be detected\n- `false` - Block the intersection\n\nIf multiple hooks are registered:\n- For contact pairs, the **first hook that returns non-null wins**\n- For intersection pairs, the **first hook that returns false blocks** the intersection\n\n**Important:** To avoid Rust aliasing errors, you **cannot** access rigid body properties (like `translation()` or `linvel()`) directly during the physics step. Instead, cache the needed state before the step using `useBeforePhysicsStep`.\n\nš§© See [useFilterContactPair docs](https://pmndrs.github.io/react-three-rapier/functions/useFilterContactPair.html) and [useFilterIntersectionPair docs](https://pmndrs.github.io/react-three-rapier/functions/useFilterIntersectionPair.html) for more information.\n\n```tsx\nimport { \n useRapier, \n useBeforePhysicsStep,\n useFilterContactPair \n} from \"@react-three/rapier\";\n\nconst OneWayPlatform = () => {\n const platformRef = useRef