isTrigger property for SphereCollider and BoxColliderDownload Blender Addon • Download Samples • Documentation • Live Samples
Download Blender Addon 
Download Samples
Documentation 
Live Samples
MaterialPropertyBlock multi-material change from opaque to transparent not applied correctlyactiveInHierarchy evaluation order (NE-6986)NeedleXRSession — prevent spurious onLeaveXR calls for scripts that never entered XRNeedleXRSession — inactive scripts no longer incorrectly detected as leaving XRversion-3 Download Unity Plugin Install from NPM
Changelog on Github 
Needle Engine API
Get started Samples
AudioSource spatial blend support via blend nodesAudioSource rolloff factor for spatial audioAnimation — { exclusive: false } now correctly stops already-running animations when play() is called with the same clipNeedleXRSession — prevent spurious onLeaveXR calls for scripts that never entered XRNeedleXRSession — inactive scripts no longer incorrectly detected as leaving XRNeedleXRSession.isTrackingImages now includes "emulated" state — reticle no longer hides when tracking state is not perfectactiveInHierarchy evaluation order (NE-6986)version-3 tag Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
Download Blender Addon Download Samples
Documentation Live Samples
Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
DragControls EventList supportOrbitControls lookBounds lerpCursorFollow no longer hits objects in self; fixed snapToSurface raycast Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
AudioClip type with standalone playback control — use with @serializable(AudioClip) for direct audio clip referencesAudioSource spatial blend support via dual-path audio graph for smooth 2D/3D crossfadeDragControls EventList supportAudioSource spatial rolloff factor and play() reliabilityAnimation play() with { exclusive: false } not stopping already-running clipsonLeaveXR calls for scripts that never entered XROrbitControls lookBounds lerp and distance-relative gizmo sizesCursorFollow self-intersection and snapToSurface raycast directionmakeFilesLocal and alias plugins now respect vite.config basethree-mesh-bvh worker failing to load in local dev serverVideoPlayer URL serializer tree-shaken out in code-only projectsReflectionProbe not cleaning up overrides when removedvite.config base setting Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
Download Blender Addon Download Samples
Documentation Live Samples
Download Blender Addon Download Samples
Documentation Live Samples
base)base from vite.config) Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
autoCleanup on Behaviour — register disposables or cleanup functions tied to the component lifecycle. Automatically cleaned up on disable or destroy depending on when registered:onEnable() {
this.autoCleanup(on(window, "resize", () => { ... }));
this.autoCleanup(this.context.connection.beginListen("my-event", () => { ... }));
}
TimelineBuilder API for building timeline assets from code:const timeline = TimelineBuilder.create("MyTimeline")
.animationTrack("Walk", animator).clip(walkClip, { duration: 2 })
.activationTrack("FX", vfxObject).activate({ start: 1, duration: 0.5 })
.build();
director.playableAsset = timeline;
PlayableDirector: expose tracks and activationTracks getters, support runtime playableAsset assignment with automatic graph rebuildPhysicsCollider: expose density property, add @validate decorator for automatic property updates at runtimeAudioTrack volume getter/setterNetworking: beginListen now returns an unsubscribe function (backwards compatible — stopListen still works):const unsub = this.context.connection.beginListen("my-event", (data) => { ... });
unsub(); // or use this.autoCleanup(unsub)
instantiate()AvatarLoader, AvatarBlink_Simple, AvatarEyeLook_Rotation, Avatar_Brain_LookAt, Avatar_MouthShapes, Avatar_MustacheShake components@validate decorator wrapping __internalAwake multiple times when components were re-activatedSignalReceiver not resolving EventList object referencesinstantiate() not including cloned Object3D GUIDs in the guids mapLight component throwing on unsupported light types (now logs error without breaking deserialization)dispose() not clearing internal state (freed world could cause crashes) Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
targetBound property and property groups for OrbitControls Download Blender Addon Download Samples
Documentation Live Samples
Added
Context.events — typed event bus for decoupled component communication. Known events get autocomplete; custom events can be typed at the call site:context.events.on("scene-content-changed", e => console.log(e.object));
context.events.emit<{ pts: number }>("scored", { pts: 10 });
ContactShadows auto-refit — when autoFit is enabled, shadows automatically refit when scene content changes (e.g. SceneSwitcher load, DropListener asset loading)Input.addEventListener now returns an unsubscribe function (works with autoCleanup):this.autoCleanup(this.context.input.addEventListener("pointerdown", (evt) => { ... }));
AnimationBuilder — low-level API for defining animation tracks with typed keyframes and tween shorthands. Used by AnimatorControllerBuilder and TimelineBuilder for inline .track() callsTimelineBuilder typed track builder interfaces per track type (AnimationTrackBuilder, AudioTrackBuilder, etc.) with inline .track() support for keyframe animationAnimatorControllerBuilder: inline .track() for defining animation directly on states, support for TrackDescriptor arrays as clip sources, simplified exitTime (replaces separate hasExitTime flag)includeTriggers option — opt-in to hitting trigger/sensor colliders (skipped by default)Changed
AnimationTrackHandler → TimelineAnimationTrack, AudioTrackHandler → TimelineAudioTrack, ActivationTrackHandler → TimelineActivationTrack, ControlTrackHandler → TimelineControlTrack, MarkerTrackHandler → TimelineMarkerTrack, TrackHandler → TimelineTrackHandlerOrbitControls.fitCamera deprecated overload removed from type declarations (runtime still accepts Object3D for backwards compat — use fitCamera({ objects: [...] }) instead)Fixed
OrbitControls: programmatic camera transitions (e.g. fitCamera) no longer interrupted continuously during an ongoing drag — only at interaction startfitCamera with centerCamera: "y" producing incorrect camera elevation when camera was above the scene centerAnimator: switching runtimeAnimatorController now properly disposes the previous controllerAnimatorController.dispose() guard against missing mixerCursorFollow.snapToSurface incorrect property description removed Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
Added
WebXRImageTracking.imageTracked event — invoked every frame an image is tracked, with typed access to the tracked object instance:imageTracking.imageTracked.addEventListener(evt => {
console.log(evt.object, evt.image);
});
?stats URL parameter now also logs renderer info (DPR, window DPR, antialias, MSAA samples, drawing buffer resolution)WebXRImageTracking component now exposes an imageTracked UnityEvent Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
AudioSource now accepts .opus clip URLs — in preparation for upcoming automatic .wav → .opus compression for much smaller, faster-loading audio by default?stats URL parameter now also logs renderer info (DPR, antialias, MSAA samples, drawing buffer resolution)@needle-tools/gltf-build-pipeline to 2.15.12 — adds material-only GLB processing Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples
Highlights:
DragControls upgrade — new constraint system with scale limits, refined regions, and a dedicated AR drag modeFASTHDR) compressionAdded
DragControls received a substantial round of improvements with a new constraint system, including a keepScale option, a two-touch scale constraint with min/max limits, refined hit regions, and a dedicated screen-space AR drag modeSkybox: new background-rotation and environment-rotation HTML attributes, plus background-image-loaded and environment-image-loaded events to react to skybox load completionInput: input cancellation support (e.g. when a pointer is disconnected mid-interaction)loadPMREM: auto-detects image format for extensionless URLsAudioSource: .opus clip URLs are now supportedGroundProjectionEnv.applyOnAwake now defaults to true, matching Unity and Blender behaviourChanged
OrbitControls: lockLookAtTarget now preserves the pointer target when double-clicking to focusPostProcessing: pixelation granularity adapts dynamically to device pixel ratioDragControls: rotation is now limited to two-touch and XR controller input for more predictable single-touch draggingFixed
DragControls: improved reliability across snap points, screen-space AR drag mode, double-click handling, XZPlane side-view and Y-axis behaviour, multi-input rotation, and touch handover (NE-4418, NE-5413, NE-5887, NE-5891)Camera: improved fallback camera and CameraUtils lifecycle handling, and fitCamera stability when meshes are parented to the target cameraContext.clear() now resets mainCamera and fallbackCamera so they always point at live cameras after a scene wipeSkybox: more efficient attribute handling — load cycles are deduplicated, background-intensity is honoured, and magic-name skyboxes resolve correctly when attributes are set at mount timeVideoPlayer.isPlaying now reports streamed sources and file playback independently and correctlyDropListener: loadFromFile now always resolvesVoIP: better mic stream handling on iOS, accurate setMuted for incoming streams, clamped volume, shared AudioContext, and coalesced concurrent connect() calls@needle-tools/gltf-build-pipeline 3.0 — a major version bump that adds WAV audio compression and HDRi → PMREM (FASTHDR) compression to the build pipelineneedle-cloud CLI version 2 with security hardeningSceneSwitcher with dependencies) Download Unity Plugin Install from NPM
Changelog on Github Needle Engine API
Get started Samples