Patch Changes

• 9d29fc0: removed unused variable

Minor Changes

• 1a0f305: removed properties "manifold" and "flipped" from contact force event

Patch Changes

• 291af9b: Exporting rapier event types for easier method typing

Minor Changes

• 73b533d: Added contact force events and streamlined event management

Patch Changes

• 7d46de2: sensors need events too!

Patch Changes

• 45d018d: OrthographicCamera component now accepts all frustum props

Minor Changes

• c272617: Hooks added to add Joints, Collider and AutoColliders now accepts density, mass or massProperties, documentation for joints hooks added, "Basic Vehicle Controller" Recipe added.

Patch Changes

• cd6dac6: cleaned up dead code in RigidBody component

Patch Changes

• 6d81f56: force disposing resources on Canvas unmounting

Minor Changes

• 36cb173: Advanced automatic disposal: a resource is not disposed when it's still present somewhere in the scene graph

Patch Changes

• 62d2c5c: fixed <RigidBody> initial transforms

Minor Changes

• 834f333: Added a new property "userData" which is useful to debug, add custom properties and filter objects
• a066d3b: Added automatic disposal of three.js objects. See documentation for more info.

Patch Changes

• 458c49b: proper prop types on <Object3DInstance>

Minor Changes

• 834f333: Added a new property "userData" which is useful to debug, add custom properties and filter objects
• 7e36568: Added component to easily create a disposal strategy

Patch Changes

• 1c4d78f: component checks for visibility of ancestors.

Patch Changes

• f7abfad: Line2 now accepts an empty points array as well as points length changes

Patch Changes

• 7a3fa6b: # NEW PACKAGE: @threlte/rapier

  This package provides easy to use components and hooks to use the rapier physics engine in threlte.

  It comes with several components to get you started: <World>, <RigidBody>, <Collider>, <AutoColliders>, <CollisionGroups> and <Debug>.

  It also features several handy hooks: <useRapier>, <useCollisionGroups> and <useRigidBody>.

Patch Changes

• cd07968: Validate click events to make sure the last pointerdown event hit the same instance as the click
  event did. This heuristic more closely resembles how the DOM works, and prevents accidental clicks
  while e.g. using OrbitControls or otherwise dragging on the canvas.

Patch Changes

• 287e8eb: Fixed broken interactivity on MeshInstance at element 0 (@Klowes)

Minor Changes

• e310ff5: Added export of trait components, see docs

Major Changes

• 52e021c: # Breaking Change

  The threlte repository has been moved to its own GitHub Organization: https://github.com/threlte/threlte.
  threlte consists now of two npm packages: @threlte/core and @threlte/extras, managed in a mono repository:

  @threlte/core consists of components, hooks and other utilites that follow three.js principles, nomenclature and inheritance as closely as useful and possible. Therefore components that have been part of the package threlte have been moved to the new home of all kinds of useful abstractons: @threlte/extras.

  @threlte/extras consists of useful abstractions and helpers that you may find yourself use all the time. These components do not need to follow three.js principles as strict as exports from @threlte/core, but they do where it makes sense.

  The breaking changes in detail:

  • Moved <GLTF> component as well as useGltf hook to @threlte/extras.
  • Moved <Text> component to @threlte/extras.

  How to update

  Replace imports from threlte and threlte/extras:

  1. npm rm threlte
  2. npm i -D @threlte/core @threlte/extras
  3. Replace import {…} from 'threlte' with import {…} from '@threlte/core'
  4. Replace import {…} from 'threlte/extras' with import {…} from '@threlte/extras'

  Specifically replace imports of <GLTF>, useGltf or <Text>:

  3. Replace import { GLTF, useGltf, Text } from 'threlte' with import { GLTF, useGltf, Text } from '@threlte/extras'

  Other changes

  • The documentation is now hosted on Vercel and as such we are hoping for a Vercel Sponsorship for OSS. There have also been some style fixes and overhauls.

Major Changes

• 52e021c: # Breaking Change

  The threlte repository has been moved to its own GitHub Organization: https://github.com/threlte/threlte.
  threlte consists now of two npm packages: @threlte/core and @threlte/extras, managed in a mono repository:

  @threlte/core consists of components, hooks and other utilites that follow three.js principles, nomenclature and inheritance as closely as useful and possible. Therefore components that have been part of the package threlte have been moved to the new home of all kinds of useful abstractons: @threlte/extras.

  @threlte/extras consists of useful abstractions and helpers that you may find yourself use all the time. These components do not need to follow three.js principles as strict as exports from @threlte/core, but they do where it makes sense.

  The breaking changes in detail:

  • Moved <GLTF> component as well as useGltf hook to @threlte/extras.
  • Moved <Text> component to @threlte/extras.

  How to update

  Replace imports from threlte and threlte/extras:

  1. npm rm threlte
  2. npm i -D @threlte/core @threlte/extras
  3. Replace import {…} from 'threlte' with import {…} from '@threlte/core'
  4. Replace import {…} from 'threlte/extras' with import {…} from '@threlte/extras'

  Specifically replace imports of <GLTF>, useGltf or <Text>:

  3. Replace import { GLTF, useGltf, Text } from 'threlte' with import { GLTF, useGltf, Text } from '@threlte/extras'

  Other changes

  • The documentation is now hosted on Vercel and as such we are hoping for a Vercel Sponsorship for OSS. There have also been some style fixes and overhauls.

Bugfixes

• (hopefully) fixed <HTML> component not working in production