react-three-rapier

Minor Changes

• a155277: feat: bump @dimforge/rapier3d-compat from 0.12.0 to 0.13.1

  • Added World prop lengthUnit
  • Renamed World props allowedLinearError and predictionDistance to normalizedAllowedLinearError and normalizedPredictionDistance, matching upstream changes
  • Added softCcdPrediction RigidBody prop
  • Added contactSkin collider prop

Patch Changes

• 1dc78d0: feat: add activeCollisionTypes prop to RigidBody and Collider components

Patch Changes

• Updated dependencies [bad7da7]
  • @react-three/[email protected]

Patch Changes

• bad7da7: fix: move away from use-asset

Patch Changes

• Updated dependencies [1517acb]
  • @react-three/[email protected]

Minor Changes

• 1517acb: feat: update @dimforge/rapier3d-compat to 0.12.0 (@0xtito, @isaac-mason)

  • Change Physics component props to match the new rapier version's integration parameter changes.
    • There aren't direct alternatives for all old parameters. See the Physics component docs for more information on the new parameters: https://pmndrs.github.io/react-three-rapier/interfaces/PhysicsProps.html
  • Add additionalSolverIterations prop to RigidBodyOptions.
    • See: https://pmndrs.github.io/react-three-rapier/interfaces/RigidBodyOptions.html#additionalSolverIterations
  • Add useSpringJoint
  • Add useRopeJoint

Minor Changes

• 1517acb: feat: update @dimforge/rapier3d-compat to 0.12.0 (@0xtito, @isaac-mason)

  • Change Physics component props to match the new rapier version's integration parameter changes.
    • There aren't direct alternatives for all old parameters. See the Physics component docs for more information on the new parameters: https://pmndrs.github.io/react-three-rapier/interfaces/PhysicsProps.html
  • Add additionalSolverIterations prop to RigidBodyOptions.
    • See: https://pmndrs.github.io/react-three-rapier/interfaces/RigidBodyOptions.html#additionalSolverIterations
  • Add useSpringJoint
  • Add useRopeJoint

Patch Changes

• Updated dependencies [1517acb]
  • @react-three/[email protected]

Patch Changes

• a5a08a0: Update docs for setWorld to include example

Patch Changes

• a71ede9: Update changeset settings

Minor Changes

• a71ede9: Adds basic snapshot capabilities by adding setWorld

Patch Changes

• Updated dependencies [c9e897a]
  • @react-three/[email protected]

Patch Changes

• c9e897a: Throw useful error when usePhysics used outside <Physics /> (@CodyJasonBennett)

Patch Changes

• Updated dependencies [c50783a]
  • @react-three/[email protected]

Patch Changes

• c50783a: Fix types for PrismaticJointParams (@wiledal)

Minor Changes

• 95a232b: Update deps

Patch Changes

• Updated dependencies [95a232b]
  • @react-three/[email protected]

Minor Changes

• 95a232b: Update deps

Patch Changes

• Updated dependencies [787462d]
  • @react-three/[email protected]

Patch Changes

• 787462d: Fix world settings not updating when being set (@wiledal)

Patch Changes

• Updated dependencies [93c7e8c]
• Updated dependencies [c4d2446]
• Updated dependencies [6c764cc]
• Updated dependencies [3057f3c]
• Updated dependencies [c4d2446]
• Updated dependencies [af27f83]
  • @react-three/[email protected]

Major Changes

• 6c764cc: Remove WorldApi, replace with singleton instance proxy (@wiledal)

  BREAKING CHANGE: The WorldApi has been removed. Instead, you can now get a proxied singleton instance of the world from @react-three/rapier. This is a breaking change, but it should be easy to migrate to.

  Before:

  import { useRapier } from "@react-three/rapier";
  
  const Component = () => {
    const { world } = useRapier();
  
    useEffect(() => {
      // Access to the WorldApi (limited)
      world.raw().bodies.forEach(() => {
        // Do something
      });
  
      // Access the raw Rapier World instance
      const rawWorldInstance = world.raw();
      rawWorldInstance.raw().setGravity(new Vector3(0, -9.81, 0));
    }, []);
  };
  

  Now:

  import { useRapier } from "@react-three/rapier";
  
  const Component = () => {
    const { world } = useRapier();
  
    useEffect(() => {
      // Access the Rapier World instance directly
      world.bodies.forEach(() => {
        // Do something
      });
      world.setGravity(new Vector3(0, -9.81, 0));
    }, []);
  };
  

  Note: it is best to avoid accessing properties and methods on the world outside of useEffect in order for the world to be properly synchronized with the React component lifecycle.

  // bad
  const Component = () => {
    const {world} = useRapier()
  
    world.setGravity(...)
  
    return null
  }
  
  // good
  const Component = () => {
    const {world} = useRapier()
  
    useEffect(() => {
      world.setGravity(...)
    }, [])
  
    return null
  }
  

Minor Changes

• 93c7e8c: Add missing RoundCylinderCollider and RoundConeCollider (@wiledal)
• c4d2446: Deprecate Vector3Array for Vector3Tuple (@wiledal)
• af27f83: Add integrationProperties as mutable props on Physics (@wiledal)

Patch Changes

• 3057f3c: Fix initiation to only happen in mount effects, never render, for increased stability (@wiledal)
• c4d2446: Internal refactor regarding instances (@wiledal)