threlte logo
@threlte/rapier

useRigidBody

This hook provides access to the RAPIER.RigidBody from a parent <RigidBody> component.

Use this hook to e.g. add custom colliders to a RAPIER.RigidBody defined by a parent <RigidBody> component.

<script>
  import { useRapier, useRigidBody } from '@threlte/rapier'

  const { world } = useRapier()

  const rigidBody = useRigidBody()

  $effect(() => {
    const collider = world.createCollider(colliderDesc, rigidBody.current)

    return () => {
      world.removeCollider(collider, true)
    }
  })
</script>

Types

const rigidBody = useRigidBody() // { current: RAPIER.RigidBody | undefined }