3.37.14-exp

Needle Engine

• Fix: Issue where deactivated SpriteRenderer would not be included in USDZ
• Fix: Minor @serializable warning in SpriteRenderer
• Fix: SpriteRenderer progressive textures
• Change: bump gltf-progressive package which includes a vanilla three.js example and fixes issue where texture settings were not re-applied correctly after having loaded the texture LOD (e.g. filter)

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.13-exp

Needle Engine

• Add: WebXRImageTracking hideWhenTrackingIsLost option to configure if objects should stay visible or hide when tracking is lost
• Add: WebARSessionRoot autoPlace option to allow automatically placing the scene content on the first XR hit
• Fix: WebXR component createQRCode options now respects Needle Menu QR code option
• Fix: Bump gltf-progressive package to support updating LODs when using postprocessing effects
• Fix: AR placement being prevented by other scripts that caused the event being used
• Change: QR code now warns when being used for scanning a localhost address

Unity Integration

• Add: WebXRImageTracking hideWhenTrackingIsLost option to configure if objects should stay visible or hide when tracking is lost
• Add: WebARSessionRoot autoPlace option to allow automatically placing the scene content on the first XR hit

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.12-exp

Needle Engine

• Add: onClear (invoked e.g. when <needle-engine src> changes) and onDestroy hooks (invoked when the needle engine context is disposed)

Unity Integration

• Fix: Compilation on Linux due to wrong compiler directive
• Fix: Disabling Allow Progressive Loading in the ProgressiveLoadingSettings component now prevents progressive textures from being generated
• Change: OrbitControls exposes zoomspeed and zoomToCursor + add some more jsdoc comments
• Change: CodeWatcher now watches .tsx files as well

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.10-exp.1

Needle Engine

• Add: expose clearOverlayMessages method
• Fix: SyncedTransform should not set kinematic if overridePhysics is false
• Fix: CustomShader Screenspace support for shaders exported from Unity 2022
• Change: enable preload on audio sources dynamically created by PlayAudioOnClick
• Change: improve URL name parsing for loading screen for blob URLs

Unity Integration

• Fix: DeployToItch needs to disable gzip temporarely

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.10-exp

Needle Engine

• Add: static ContactShadows.auto
• Add: ContactShadows autoFit option to automatically fit the contact shadows at startup and fitShadows() method for applying autofit manually
• Change: Improve PWA logging and rename Vite pwaOptions to pwa in needlePlugin
• Change: Improve loading screen rendering

Unity Integration

• Change: bump UnityGLTF dependency to 2.12.0

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.9-exp

Needle Engine

• Add: INeedleGLTFExtensionPlugin.onLoaded hook providing access to the loaded glTF when registering custom extensions
• Add: PWA ability to specify updateInterval (number in ms or undefined) for auto-updating apps while running
• Fix: WebXRImageTracking now restores tracked objects to their previous state after exit AR
• Fix: WebXRImageTracking extra check in session enabled features if image tracking is even enabled. Otherwise I did get tons of errors in mobile VR
• Fix: Input system now handles mouse wheel during pointer lock
• Fix: Simplify and improve PWA generation and passing workbox config to vite-pwa
• Fix: AnimatorController with multiple layers: don't select start state in another layer
• Fix: AnimatorController handle empty state to stay in last animated previous pose
• Bump gltf-progressive dependency for fixes regarding transparent materials as well as VRM materials
• Bump gltf-build-pipeline dependency to 1.5 alpha for VRM support

Unity Integration:

Change: improve better skybox shader by using a global texture instead of per-material

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.8-exp.2

Needle Engine

• Fix: Camera should not set skybox from scene again automatically if there's a background skybox already
• Fix: Multi-material LOD meshes
• Change: Only set GLTFLoaders if none others are already set
• Change: vite userconfig expose "allowHotReload" in jsdoc types (third argument in needlePlugins)

Unity Integration

• Fix: Prevent export of top-level GltfObject components in disabled hierarchy

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.8-exp

Needle Engine

• Add: @needle-tools/gltf-progressive dependency that handles loading progressive meshes and textures.

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.7-pre

Needle Engine

• Fix: USDZ animation loops didnt work in some cases
• Fix: Properly apply and revert arScale on USDZ export
• Fix: Correctly apply WebXR arSceneScale on USDZ export even when no USDZExporter is present
• Fix: Hand models not being displayed on VisionPro – invalid data passed into registerExtensions leading to exception
• Fix: time.timescale set to 0 now fully pauses physics simulation
• Fix: @syncField now properly applies room state once on connection
• Fix: Timeline reset previously active animation actions then being disabled (e.g. when switching to another active timeline)

Unity Integration

• Change: Improve warnings when not connected to the internet

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples

3.37.6-pre

Needle Engine

• Fix: USDZExporter bug where geometry was getting duplicated on export when the same mesh was used multiple times
• Fix: USDZExporter duplicate export of scene start triggers
• Change: Improve USDZExporter animation export validation and improve handling of empty TransformData slots
• Change: Improve USDZ animation export allowing RegisteredAnimationInfo to also register a null clip for targeting the rest pose (e.g. empty state)
• Change: Improve USDZ time formatting
• Change: Invoke engine lifecycle hooks in the order in which they were registered (e.g. onStart(ctx => ...))

Unity Integration

• Add: DeployToFTP Server asset now has a port option that can be configured if necessary
• Add: DeployToNetlify does now render a info label while uploading
• Change: log error if trying to perform a distribution build without having a web project setup

---

Links

Download for Unity • Download for Blender • Documentation • API • Live Samples