panospel/AR-Menu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
AR-Menu/Library/PackageCache/com.needle.engine-exporter@8c046140a1d9/Changelog.md
pelpanagiotis 114c3aa69c Added Files with LFS
2025-11-30 08:35:03 +02:00

6503 lines
348 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Changelog
All notable changes to this package will be documented in this file.
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
## [4.4.3] - 2025-04-29
### Needle Engine
- Add: Support for `getKeyDown`, `getKeyPressed` and `getKeyUp` to pass in key name to check the state of keyboard input, e.g. `context.getKeyDown(<key>)`
- Add: License validation for webpack (nextjs) via access token or teamid. The `needleNext` plugin does now handle the license for passed in team or access tokens.
For example the `next.config.js` can be modified like so `... }, { modules: { webpack }, license: {team: "needle"} })` to pass in the name of a team (or a Needle Cloud access token).
- Change: License checks will now read the `NEEDLE_CLOUD_TOKEN` environment variable if no access token is provided.
- Fix: SyncedTransform `fastmode` lerp
- Fix: Vite license server timeout
- Fix: Vite `manualChunks` should not be declared if `rollupOutput.inlineDynamicImports` is set to true
- Fix: OrbitControls regression when calling `setCameraAndLookTarget` with a Camera object (or transform) where the forward direction (+Z) did not match the camera's look/render direction (-Z)
### Unity Integration
- Improve Needle Cloud Asset error handling and loading messages
## [4.4.0] - 2025-04-17
### Needle Engine
**Added**
- Add: The needle-engine web-component `contactshadows` attribute now allows you to specify a factor for controlling the darkness/lightness. E.g. `<needle-engine contactshadows="1">` will make the shadows appear darker vs. `<needle-engine contactshadows=".2">` will make the contact shadow appear lighter.
- Add: The needle-engine web-component does now support transparency for `background-color`. For example: `rgba(255, 255, 100, .5)` or `#ffdddd99` or `transparent` are valid values: `<needle-engine background-color="rgba(255, 255, 100, .5)" />`
- Add: `ObjectUtils.createPrimitive()` now supports scale as array
e.g. `ObjectUtils.createPrimitive("Cube", { scale: [1, .25, 1] } );`
- Add: Input `getGamepad(<index>)` function to query a connected gamepad. Example: `this.context.input.getGamepad()`
- Add: `lookAtScreenPoint()` function which allows 3D object to look at points in 2D screen coordinates (e.g. your mouse position).
**Example Component that makes the object look at the mouse**
```ts
import { Behaviour, lookAtScreenPoint } from "@needle-tools/engine";
export class LookAtMouse extends Behaviour {
update() {
lookAtScreenPoint(this.gameObject, this.context.input.mousePosition, this.context.mainCamera);
}
}
```
- Add: Default environment lighting. If you don't configure any environment-image needle engine will now create a default scene to light your objects. Previously the scene was just black when the loaded model didn't contain any lighting information.
- Add: SyncedTransform does now also sync scale changes
- Add: SyncedTransform `freeOwnership()` method
- Add: ReflectionProbe bounding box intersection check to automatically apply reflections to object's in a specific area (handled by the Renderer component)
- Add: `devicePixelRatio` option on Needle Context. This option controls the window.devicePixelRatio set on the renderer by Needle Engine (default `auto`). It can be set to `manual` to disable this behaviour or a custom number which will then be set on the renderer or composer.
**Fixed**
- Fix: Implicit camera did not automatically set to skybox when using `background-image`. E.g. `<needle-engine background-image="<url>">
- Fix: Tonemapping falsely set tonemappingEsposure to undefined causing a black screen
- Fix: `background-color` attribute was not always applied. E.g. `<needle-engine background-color="#ff3333">`
- Fix: `screenshot()` checks if XR is presenting
- Fix: Issue where MeshBVH worker import breaks for projects where the needle-engine vite plugins are not added to the plugins list
- Fix: SceneSwitcher regression with `Object3D` objects in scenes array
- Fix: SceneSwitcher preload was not using three.js FileLoader to re-use three's caching system
- Fix: GroundProjection regression where background blurriness was hardcoded
- Fix: RenderTexture regression where deserialization was not properly handled anymore
- Fix: OrbitControls regression where forward direction in `setCameraAndLookTarget` was inverted
- Fix: Physics bug where negative box collider scales were not correctly handled in all cases causing Rapier to break
- Fix: UI instantiate bug where three-mesh-ui `clone` method was not working and UI that was already in the scene could not be duplicated because of that.
- Fix: Vite license plugin not waiting for the CLI process to start
- Fix: Vite improve license checks in CI environments (e.g. when running via a Github Action).
- Fix: Vite plugins for running in CI environment
- Fix: Vite `manualChunks` are not defined when `preserveModules` is set to true
**Changed**
- Change: License check aborts now faster instead of retrying when connection is actively refused
- Change: OrbitControls `autoTarget` does now automatically update the look at target after panning and not when rotating the camera (previously the target would be updated after any input but this resultet in undesireable behaviour when rotating around objects)
- Change: When no background-color is defined by either the loaded scene or by a `background-color` attribute then the default scene background color respects the user's accessibility setting for `prefer-dark` or `prefer-light`. This means that the background color will be set to a default light or dark value.
- Change: Scene background color or image set on `<needle-engine>` are not overridden anymore by the camera component.
- Change: Hide Needle logo automatically when using Needle Engine with a license
### Unity Integration
- Add: Draco, KTX, and Meshopt as dependencies so that compressed Needle Cloud assets work out of the box
- Add: Support for NPM package containing Unity package and improve npmdef functionality
- Fix: Better SocketException handling
- Fix: Improve log rendering
- Fix: Improve retrieval of external process commandline data on OSX
- Fix: EditorSync support for UIElement Vector2, Vector3, Vector4 and Color
- Update: gltf-build-pipeline dependency
- Update UnityGLTF dependency to `2.16.0-pre.3`
## [4.4.0-beta.2] - 2025-04-14
### Needle Engine
- Fix: Vite license plugin not waiting for the CLI process to start
### Unity Integration
- Bump UnityGLTF dependency to 2.16.0-pre.3
- Fix: Better SocketException handling
- Fix: Improve log rendering
- Fix: Improve retrieval of external process commandline data on OSX
## [4.4.0-beta.1] - 2025-04-14
### Needle Engine
- Add: `<needle-engine background-color="#ffdddd55">` does now support transparency. For example: `rgba(255, 255, 100, .5)` or `#ffdddd99` or `transparent` are valid values.
- Add: SyncedTransform `freeOwnership()` method
- Add: ReflectionProbe does now check boundingbox intersection
- Add: `devicePixelRatio` option on Needle Context. This option controls the window.devicePixelRatio set on the renderer by Needle Engine (default `auto`). It can be set to `manual` to disable this behaviour or a custom number which will then be set on the renderer or composer.
- Change: Scene background color or image set on `<needle-engine>` are not overridden anymore by the camera component.
- Change: Hide Needle logo automatically when using Needle Engine with a license
- Fix: Improve license checks in CI environments (e.g. when running via a Github Action).
- Fix: Vite plugins for running in CI environment
- Fix: Vite `manualChunks` are not defined when `preserveModules` is set to true
- Fix: `screenshot()` checks if XR is presenting
- Fix: Issue where MeshBVH worker import breaks for projects where the needle-engine vite plugins are not added to the plugins list
### Unity Integration
- Add: draco, ktx, and meshopt as dependencies so that compressed Needle Cloud assets work out of the box
## [4.4.0-beta] - 2025-03-28
### Needle Engine
- Add: `ObjectUtils.createPrimitive()` now supports scale as array
e.g. `ObjectUtils.createPrimitive("Cube", { scale: [1, .25, 1] } );`
- Add: Input `getGamepad(<index>)` function to query a connected gamepad. Example: `this.context.input.getGamepad()`
- Add: `lookAtScreenPoint()` function which allows 3D object to look at points in 2D screen coordinates (e.g. your mouse position).
**Example Component that makes the object look at the mouse**
```ts
import { Behaviour, lookAtScreenPoint } from "@needle-tools/engine";
export class LookAtMouse extends Behaviour {
update() {
lookAtScreenPoint(this.gameObject, this.context.input.mousePosition, this.context.mainCamera);
}
}
```
- Add: SyncedTransform does now also sync scale changes
- Add: Default environment lighting. If you don't configure any environment-image needle engine will now create a default scene to light your objects. Previously the scene was just black when the loaded model didn't contain any lighting information.
- Add: The `contactshadows` attribute now allows you to specify a factor for controlling the darkness/lightness. E.g. `<needle-engine contactshadows="1">` will make the shadows appear darker vs. `<needle-engine contactshadows=".2">` will make the contact shadow appear lighter.
- Fix: Implicit camera did not automatically set to skybox when using `background-image`. E.g. `<needle-engine background-image="<url>">
- Fix: Tonemapping falsely set tonemappingEsposure to undefined causing a black screen
- Fix: `background-color` attribute was not always applied. E.g. `<needle-engine background-color="#ff3333">`
- Change: License check aborts now faster instead of retrying when connection is actively refused
- Change: OrbitControls `autoTarget` does now automatically update the look at target after panning and not when rotating the camera (previously the target would be updated after any input but this resultet in undesireable behaviour when rotating around objects)
- Change: When no background-color is defined by either the loaded scene or by a `background-color` attribute then the default scene background color respects the user's accessibility setting for `prefer-dark` or `prefer-light`. This means that the background color will be set to a default light or dark value.
### Unity Integration
- Add: Support for NPM package containing Unity package and improve npmdef functionality
- Fix: EditorSync support for UIElement Vector2, Vector3, Vector4 and Color
- Update: gltf build pipeline dependency
## [4.3.2] - 2025-03-20
### Needle Engine
#### Added
- Documentation for `Gizmos` API
- `this.context.time.fps` returning the FPS for the current frame (for a more stable FPS value `smoothedFps` can be used)
#### Removed
- Vite license plugin check does not support Node 16 anymore
#### Changes
- Improve Vite preload link injection into HTML head
- The PostprocessingManager component does now expose a `multisampling` property which is set to `"auto"` by default. By setting `multisampling` to a number it will force postprocessing to the configured samples.
- Downloading of `<needle-engine>` attributes for `skybox-image` and `environment-image` does now start earlier. Previously it would only start loading the HDRi or EXR images after the root glTF file was finished loading. Now it will start downloading earlier which improves the time until the scene is ready to be displayed.
#### Fixed
- Vite dependency-watcher plugin warning
- Vite license check plugin is now using the latest Needle CLI version
- Browser cache busting issue related to loading the root scene where range requests (e.g. when download urls without a file extension). This caused Chrome to remove files from the disc cache causing a re-download
- Three.js core postprocessing effects support
- Loading glTF files without any components (e.g. when directly downloaded from Sketchfab) was causing Needle Engine to falsely keep a reference to the loaded glTF structure.
- Instancing issue where instancing did sometimes renderer wrong geometry when many objects where removed and added again and multiple different geometries were batched together. This was caused by a bug in the internal bucketing mechanism and has now been removed since it's not necessary anymore.
### Unity Integration
#### Removed
- NeedleEngineModules component and warning
#### Fixed
- Console error in BuildWindow
- Unity error when adding a new component caused by recent editor sync change
- Handle NPM cache error when generating font assets
- Update dialogue should not open automatically when using a stable package version and a new beta version is available
- Unity EditorSync should work with GenericInspector instances in Unity versions that use VisualElements / UI Toolkit now
- Context menu exporting a GLB file and selecting the `compress` option did not apply progressive optimization and not produce texture or mesh LODs.
## [4.3.2-beta.5] - 2025-03-20
### Needle Engine
- Change: Improve Vite preload link injection into HTML head
- Fix: Vite dependency-watcher plugin warning
### Unity Integration
- Fix: Console error in BuildWindow
- Remove: NeedleEngineModules component and warning
## [4.3.2-beta.4] - 2025-03-19
### Needle Engine
- Fix: Start loading earlier for `skybox-image` and `environment-image` when configured in `<needle-engine>` web component. Previously it would only start loading the HDRi or EXR images after the root glTF file was finished loading. Now it will start downloading earlier which improves the time until the scene is ready to be displayed.
- Fix: Update vite license check using the latest CLI version
- Fix: Issue related to loading the root scene where range requests (e.g. when download urls without a file extension) caused Chrome to remove previously full downloads to be removed from disc cache
- Remove: Vite license check does not support Node 16 anymore
## [4.3.2-beta.3] - 2025-03-18
### Needle Engine
- Fix: Support for three.js core postprocessing effects
## [4.3.2-beta.2] - 2025-03-18
### Needle Engine
- Add: Documentation for `Gizmos` API
### Unity Integration
- Fix: Unity error when adding a new component caused by recent editor sync change
- Fix: Handle NPM cache error when generating font assets
## [4.3.2-beta.1] - 2025-03-17
### Needle Engine
- Fix: Bug when loading glTF files without any components where a reference to the loaded glTF structre was kept in memory causing the memory to not be freed
### Unity Integration
- Fix: Update dialogue should not open automatically when using a stable package version and a new beta version is available
- Fix: Unity EditorSync should work with GenericInspector instances in Unity versions that use VisualElements / UI Toolkit now
## [4.3.2-beta] - 2025-03-14
### Needle Engine
- Add: `this.context.time.fps` returning the FPS for the current frame (for a more stable FPS value `smoothedFps` can be used)
- Change: The PostprocessingManager component does now expose a `multisampling` property which is set to `"auto"` by default. By setting `multisampling` to a number it will force postprocessing to the configured samples.
- Fix: Issue where instancing with multiple different geometries being batched together did sometimes be cause wrong rendering when many objects where removed and added again. This was caused by a bug in the internal bucketing mechanism which is not necessary anymore with the new BatchedMesh version.
### Unity Integration
- Fix: Context menu exporting a GLB file and selecting the `compress` option did not apply progressive optimization and not produce texture or mesh LODs.
## [4.3.1] - 2025-03-14
### Needle Engine
- Add: Expose lifecylcle hooks in `Needle` global scope for usage in commonjs or without a bundler. For example this allows to subscribe to the update event with `Needle.onUpdate(ctx => console.log(ctx.time.time))`.
- Fix: OrbitControls micro-movement after a pointer event was already used. For example previously when using DragControls and starting to drag an object the camera would still move slightly before stopping during drag. This is not the case anymore now and the camera does not move anymore during interaction with other objects.
- Fix: Canvas UI render settings not being applied in one rare case causing a worldspace image not being set to double sided rendering.
### Unity Integration
- Change: Needle Engine dependency semver changed to ensure NPM doesnt automatically update minor versions when installing a web project (e.g. updating 4.2.x to 4.3.x). Previously this could cause a web project using `@needle-tools/engine@4.2.5` to be updated to `@needle-tools/engine@4.3.0`. This makes updating versions more predictable and deliberate using Unity.
NOTE: It's possible to prevent Unity from changing web project versions completely by using the npm package alias syntax in your web project. For example: `"@needle-tools/engine": "npm:@needle-tools/engine@4.0.0"` will lock the package version to 4.0.0. When using this syntax it's up to you to manage the installed package version.
## [4.3.0] - 2025-03-12
- Bump version to 4.3.0
## [4.3.0-alpha.6] - 2025-03-06
### Needle Engine
- Add: more jsdoc comments to `Graphics.textureToCanvas` and `Mathf` methods
- Change: AudioSource tries to get AudioListener from it's own object first before it checks camera and scene
- Change: Postprocessing effects in shared volume (when exported from Unity) are now added to the Volume gameObject during initialization
- Fix: SpriteRenderer issue where runtime instantiate and setting Sprite would in some cases not update the texture on all instances
- Fix: Issue in `Graphics.copyTexture` where the blit material was not yet created
- Fix: improve Rigidbody physics poststep / smoothed velocity
## [4.3.0-alpha.3] - 2025-03-06
### Needle Engine
- Add: WebARSessionRoot `arScale` can now be changed while in AR to modify or reset the scale.
- Change: AudioSource now creates it's own AudioListener instead of using one from the camera.
### Unity Integration
- Bump Needle Build Pipeline dependency
## [4.3.0-alpha.2] - 2025-03-04
### Unity Integration
- Fix compilation error on Mac
- Bump Spline dependency to 2.x
- Bump Needle Build Pipeline dependency
## [4.3.0-alpha.1] - 2025-03-03
### Needle Engine
- Add: More API documentation for various core components
### Unity Integration
- Improve export time
- Bump EditorSync dependency to fix support for Needle Engine 4
## [4.3.0-alpha] - 2025-02-28
### Needle Engine
- Add: SceneSwitcher `sceneLoadingStart` and `sceneLoadingProgress` events
- Add: AssetReference `urlName` property
- Fix: SceneSwitcher preloading if configured to not load scene at startup
- Fix: UI issue where text components were not correctly handled by the EventSystem for the `hasActiveUI` property
### Unity Integration
- Add: Experimental support for importing C# components and assets from node_modules packages
- Fix: Sub-Scene export on save or at Enter Playmode
## [4.2.5] - 2025-02-27
### Needle Engine
- Fix: keep FBX vertex color assignment when postprocessing materials
- Fix: ContactShadow flicker when point materials are in the scene
- Fix: OrbitControls keep `autoTarget` enabled in `fitCamera`
- Fix: Static `BoxCollider.add` now correctly calculates bounding box
- Fix: InputField `onValueChanged` event is now invoked after the new value has been assigned
- Change: `getBoundingBox` now also takes a single object as well as an array of objects
- Change: DropListener now exposes `DropListenerOnDropArguments` type
## [4.2.4] - 2025-02-21
### Needle Engine
- Add: OrbitControls set to `autoTarget` now automatically updates rotation target in onPointerUp
- Fix: USDZ add safeguard against potential issue in bone sorting
- Fix: USDZ remove extra check for bone type that might prevent bone structure ordering
- Fix: Static method for `BoxCollider.add` not correctly calculating object bounds when object is rotated
- Fix: Ignore fullscreen plane for WebXR auto center
- Fix: Issue in FBXLoader where loading FBX files with out-of-bounds material assignments lead to incorrect geometry groups and subsequent errors
- Change: Improve input typings for `isKeyDown`, `isKeyUp` and `isKeyPressed`
## [4.2.3] - 2025-02-20
### Needle Engine
- Add: InputField setter for `text`
- Fix: OrbitControls setCameraAndLookTarget
- Fix: Issue where updating KTX transcoder was not being correctly applied for offline usage
## [4.2.2] - 2025-02-18
### Needle Engine
- Fix: WebXRImageTracking iOS size calculation due to change by Apple
- Fix: USDZ AudioSource not generating code for `playOnAwake` anymore
- Fix: Lightmap and environment ligthing not working correctly anymore due to change in three v163
- Change: EventSystem simplification - it is now always created once in scene root, this removes the requirement of ObjectRaycasters in the scene which simplifies the usage of component input event methods like `onPointerClick` (which previously required users to ensure there are ObjectRaycasters in the parent hierarchy)
## [4.2.1] - 2025-02-17
### Unity Integration
- Fix: Nullreference error in new compression settings component
## [4.2.0] - 2025-02-17
### Needle Engine
- Change: remove MXInk fallback codepath for pre-release OS versions
- Change: don't request "hand-tracking" on VisionOS devices unless explicit custom hand models are requested
- Fix: occluder generation in Plane/Mesh tracking should not be enforced when we have a data template
### Unity Integration
- Add: New automatic Texture compression settings for `Product` and `3D World` usecases. Available via the Compression & LOD settings component.
- Change: Move texture and mesh compression settings into "Compression & LOD Settings" component (formerly ProgressiveTextureSettings) to support compression settings in Unity 6000.
## [4.1.1] - 2025-02-14
### Needle Engine
- Fix: ParticleSystem regression where particles using a transparent PBR shader are not being rendered as transparent
### Unity Integration
- Update Needle glTF Build Pipeline
- Update Needle helper package dependency with improvements to repository cloning
- Internal: Query installed npm version using async call
## [4.1.0] - 2025-02-13
### Needle Engine
- Fix: Issue in WebXR component where disabling `usePlacementReticle` would not apply other settings to already existing WebARSessionRoot components in the scene
### Unity Integration
- Fix: Console warnings in Unity 6000.x when opening the BuildWindow
## [4.1.0-beta.8] - 2025-02-12
### Needle Engine
- Fix: Handle `<needle-menu>` web component being present anywhere in the document already
- Fix: Allow nextjs based projects to be deployed to Needle Cloud
- Change: `instantiate()` can now take an AssetReference as an argument as well
- Change: Improve `context.input.addEventListener` function typing
## [4.1.0-beta.7] - 2025-02-05
### Unity Integration
- Fix: further checks for npx cache issue, tested with slow internet connections on WIN and OSX
## [4.1.0-beta.6] - 2025-02-05
### Needle Engine
- Fix: issue with `parseSync` for loading a glTF file is a file path
### Unity Integration
- Fix: handle npx issue where incomplete installations prevent the license server from running
- Update samples dependency
## [4.1.0-beta.5] - 2025-02-04
### Needle Engine
- Fix: Physics issue with mesh colliders where colliders were sometimes created with the wrong size depending on the users network speed. This was due to the change of lazily loading the physics engine in Needle Engine 4.
- Fix: Add workaround for a regression in the particle system where PBR materials would sometimes render with a wrong texture. [Issue](https://github.com/Alchemist0823/three.quarks/issues/101)
- Fix: ParticleSystem gradients set to `Random Color`
- Fix: import WebGLNodes to ensure nodes actually run
- Change: Physics engine `addMeshCollider` scale argument is now optional and treated as scale applied to the object's world scale when creating the collider.
## [4.1.0-beta.4] - 2025-02-03
### Needle Engine
- Add: OrbitControls support for orthographic camera
- Fix: Orthographic camera aspect ratio
## [4.1.0-beta.3] - 2025-01-30
### Needle Engine
- Fix issue where networked values with the `@syncField` decorator would not be updated correctly on instances spawned at runtime (e.g. via PlayerSync).
## [4.1.0-beta.2] - 2025-01-29
### Needle Engine
- Fix: VideoPlayer screenspace mode colorspace
- Fix: XRRig `setAsActiveRig()` now ensures the given rig has the highest priority. Previously it was possibly immediately overidden again if another XRRig with a higher priority was active in the scene.
- Change: SpatialTrigger EventList events are now invoked without additional parameters. They did previously take a reference to the SpatialTriggerReceiver and active SpatialTrigger. If this information is important the SpatialTriggerReceiver can be saved when subscribing to the event and the trigger can be accessed using the `triggerReceiver.currentIntersected` array.
- Change: TransformGizmo now exposes the underlying three.js TransformGizmo via a new `control` property.
- Change: GroundProjection now uses the `scene.background` instead of `scene.environment`
## [4.1.0-beta.1] - 2025-01-29
### Needle Engine
- Fix: ParticleSystem custom behaviours
- Fix: OrbitControls not keeping the initial look direction if `autoTarget` was off
- Fix: Invalid Rigidbody warning caused by async physics engine loading change
- Fix: SharpeningEffect
- Update gltf-progressive including a fix for loading texture LOD 0 (the highest resolution)
- Update three.quarks dependency to 0.15.6
### Unity Integration
- Fix: `Component` menu item paths for Deploy components
- Fix: Validation window NPM update
- Update helper package dependency for Node 22 support
## [4.1.0-beta] - 2024-01-24
- Promote to beta
## [4.1.0-alpha.14] - 2024-01-24
### Needle Engine
- Fix: glsl shader error at linear to sRGB conversion
## [4.1.0-alpha.13] - 2024-01-23
### Needle Engine
- Update three.js dependency to fix issue in WebXRManager
## [4.1.0-alpha.12] - 2025-01-21
### Needle Engine
- Change: Much improved initial loading speed making Needle Engine websites load up to 1000 ms faster.
Improved Needle Engine website lighthouse scores for all Vite based projects.
Improved bundle chunking and loading for better lighthouse scores.
Core bundles and entrypoint glTF files are not loaded as soon as the web document is ready.
- Change: Needle Engine does now lazily import dependencies for `rapier` and `postprocessing` to reduce download and startup size.
This means that projects that don't use any collider or rigidbody components will not load the physics and postprocessing modules. Modules can be loaded at any time once they're need by e.g. components in the scene.
### Unity Integration
- Fix: Needle Cloud deployment list not being showing the last deployments
- Fix: Sandbox scene template had falsely scaled Rock model
## [4.1.0-alpha.11] - 2025-01-17
### Needle Engine
- Remove: legacy Flycontrols component
- Fix: MeshCollider contact normal direction
### Unity Integration
- Fix: Unity 6000 component links
## [4.1.0-alpha.10] - 2025-01-17
### Needle Engine
- Fix: Instanced meshes bug where sometimes an vertex count increase due to mesh compression was not handled correctly
### Unity Integration
- Change: Allow to install samples for Unity 6000
## [4.1.0-alpha.9] - 2025-01-15
### Needle Engine
- Fix: Better AgX and Neutral tonemapping
### Unity Integration
- Fix: On windows handle missing `Roaming/npm` folder
- Update Needle Engine samples min dependency requirement to support three.js r169
## [4.1.0-alpha.7] - 2025-01-14
### Needle Engine
- Update three.js to r169
- Update dependencies: three-mesh-bvh to 0.8.3, three-quarks to 0.15.5, postprocessing to 6.36.6, n8ao to 1.9.3
- Fix: AR screenshot bug where the second screenshot would not look correct
## [4.1.0-alpha.6] - 2025-01-13
### Unity Integration
- Update build pipeline to latest alpha
## [4.1.0-alpha.5] - 2025-01-13
### Needle Engine
- Fix: Issue where MeshCollider with InterleavedBufferAttributes were not created correctly
- Fix: multi-object mesh collider handling for Groups and add warning for remaining case that are not supported
- Fix: transparency trimming for screenshot should happen before screenshot is returned
- Change: Reduced mesh LOD vertex reduction to improve quality of lowest LOD
- Update build pipeline to latest 2.7 alpha
- Update rapier dependency to 0.14.0
### Unity Integration
- Allow Node 22 LTS
## [4.1.0-alpha.4] - 2025-01-10
### Needle Engine
- Add: SceneSwitcher methods for `unload()` and `reload()` the currently loaded scene
### Unity Integration
- Add: FileReference types now have an option to be assigned from an asset in the scene, URL string or filepath string
- Change: Generated font assets are now cached
- Change: Attempt to auto recover corrupted npx cache
## [4.1.0-alpha.1] - 2025-01-09
### Needle Engine
- Add: Support for loading KTX2 textures as `environment-image` and `background-image` (e.g. `<needle-engine background-image="my-skybox.ktx2">`)
- Fix: Issue where raycasting was not using acceleration structures and instead falling back to slow raycasting. This release greatly improves raycasting performance
## [4.1.0-alpha] - 2025-01-08
### Needle Engine
- Add: Screenshot support for AR:
To use you need to request the `camera-access` XR feature when starting a new XR session.
For that you can *either* simply add the *WebARCameraBackground* component to your scene
or add the feature in the `NeedleXRSession.onSessionRequestStart` event hook.
### Unity Integration
- Add: Get AI Help for converting C# to typescript
We added a small UI label above C# components that do not yet have a matching Needle Engine component. Clicking this label will ask the AI for how the component can be translated to typescript.
- Add: "Explain with AI" component context menu in `Needle Engine/Explain with AI`
## [4.0.4-alpha] - 2025-01-02
### Needle Engine
- Fix: Detecting OBJ files starting with `mtllib` or content-type header `model/obj`
- Fix: Issue where `screenshot()` method with custom camera and postprocessing didn't work
- Update gltf-progressive package to load higher texture LODs by default
### Unity Integration
- Add: NeedleCloudAsset component password field
## [4.0.3-alpha] - 2024-12-20
### Needle Engine
- Add: OBJLoader now automatically loads mtl files
- Add: OBJLoader materials are now fixed like FBX materials
### Unity Integration
- Add: NeedleCloudAsset component. Initial version to load [Needle Cloud](https://cloud.needle.tools) into the Unity Editor and Needle Engine runtime. To use just add the NeedleCloudAsset component to a GameObject in Unity.
- Fix: EDU license handling
## [4.0.2-alpha] - 2024-12-12
### Needle Engine
- Add: Support for custom scripts on WebXR custom hands
- Fix: OrbitControls should not listen to window.body for key events
### Unity Integration
- Add: Basic WebXR hand models and assign as default models in the XRControllerModel script
## [4.0.1-alpha] - 2024-12-11
### Needle Engine
- Fix: Objects spawned with `syncedInstantiate` should automatically be removed when disconnecting from the networking room
- Fix: Issue where objects rendered with instancing enabled were not visible in screenshots
### Unity Integration
- Change: Update Editor UI styles
## [4.0.0-alpha] - 2024-12-09
### Needle Engine
- Add: Builds can now be compressed on Needle Cloud instead of locally. Set the `NEEDLE_CLOUD_TOKEN` environment variable to your Cloud access token to enable this. This allows running compression in CI build pipelines, for example in a Github Action. Needle Cloud access tokens can be obtained on https://cloud.needle.tools/team.
- Add: `DropListener` now optionally supports networking when `allowNetworking` is on. Dropped files will be network-synced if the file size does not exceed a certain size (50 MB for projects on paid plans; 5 MB for projects free plans).
- Fix: Previously, when changing a `@syncField` property, only the last changed property was synchronized to the server. This is now fixed. Note that this is a **breaking change**: previously networked server state with the `@syncField` attribute in Needle Engine 3.x projects will not be loaded in Needle Engine 4.0.
- Change: `EventList` now takes a generic type code hints when using `myEventList.addEventListener(...)` e.g. `new EventList<string>()`
- Change: The default networking server is now located at `networking.needle.tools`
- Change: The `DropListener` API has changed
- Change: OrbitControls `useKeys` is now false by default since the underlying three.js OrbitControls incorrectly capture ALL keyboard events on the page.
- Change: Loading speed improvements and improved Lighthouse score
- Change: md5 hashing results are now S3-compatible
### Unity Integration
- Add: Projects can now be deployed to Needle Cloud directly from Unity. Needle Cloud supports build versioning, tagging, sharing and more. Learn more at https://cloud.needle.tools.
- Change: License authentication is now much easier and uses Needle Cloud authentication
## [3.51.1] - 2024-12-09
### Needle Engine
- Fix: DragControls snap to surface setting should use world normal
- Fix: Needle Menu missing focus-visible for overflow menu button
- Fix: Needle Menu :focus-visible on menu elements barely being visible
- Fix: edge case where we still showed the QR code when only the WebXR component is on and we're on mobile
- Fix: detect URL content format using "Content-Type" header as well
- Fix: double quotes in USDZ displayName need to be escaped
- Fix: don't fetch when we already know fetch won't work due to cross-origin isolation
- Change: for QuickLook, use "View in AR" instead of "Download for AR" even for cases where we're not sure if the device actually supports QuickLook – rel="ar" is not reliable
- Change: disable Needle logo being clickable during loading because users click it accidentally and then they're lost
- Docs: add @group Component to components since TypeDoc doesn't do inheritance as expected
## [3.51.0] - 2024-11-27
### Needle Engine
- Add: API docs for networking methods
- Add: USDZ export automatically creates "hold" animations now to prevent animation snapping
- Add: USDZ export now supports ShadowCatcher component and materials
- Add: USDZ export now contains more meta-info about exported animations
- Add: Log warnings on USDZ export for overlapping animation roots so hierarchy can be manually adjusted
- Add: Use ?debugusdzbehaviours to log more information and Behaviour Graphs during USDZ export. A graph in mermaid format will be logged into the console, which can be pasted into https://massive-mermaid.glitch.me or other viewers.
- Fix: USDZ animation rounding error edge cases for long-running animations (>20.000 frames)
- Fix: USDZ export only adds physics extension now if required to work around QuickLook issue (FB15925487) for animated objects with physics components
- Fix: USDZ exporter adds rest poses properly again
- Fix: Developer console is now more robust against network errors, e.g. offline PWA usage
- Fix: Canvas parent element size now matches the canvas size
### Unity Integration
- Add: Unity 6 compatibility
- Add: add some missing Deploy To component icons
- Remove: WebGL1 custom shader export
## [3.50.0-beta] - 2024-10-28
### Needle Engine
- Add: PWA plugin now works with gzip compression
- Add: Asynchronous overload for `screenshot2` method that returns a `Promise<Blob>`
- Add: USDZExporter supports `animator.minMaxOffsetNormalized` and `animation.minMaxOffsetNormalized` for QuickLook now
- Add: USDZExporter vertex color export. Use unlit white materials with only vertex colors to export as `displayColor` without a material. This is supported on iOS 18+ and visionOS 2+.
- Fix: automatically instanced/batched meshes are not exported twice in USDZ anymore.
- Change: "Open in QuickLook" is now "View in AR" to be more consistent
- Change: Deprecate device utilities outside the `DeviceUtilities` namespace, use the methods directly from the namespace instead (e.g. `DeviceUtilities.isSafari()`)
- Change: Remove legacy `Object3D.transform` wrapper that returns itself
### Unity Integration
- Change: Bump UnityGLTF dependency to 2.14.1
## [3.49.0-beta] - 2024-10-21
### Needle Engine
- Add: More jsdoc code API documentation
- Add: `OrbitControls` can now lerp to a target field of view
- Add: Timeline animation tracks now can have 0..1 weights
- Add: `getBoundingBox` can now optionally respect a layer mask for determining which objects to include
- Fix: Regression with animations not playing on instantiated objects
- Fix: `DeleteBox` uses `getBoundingBox` now instead of a custom implementation
- Fix: `Duplicatable` now correctly checks for its target object already being deleted
- Fix: vite plugins use vite 5.x API (and are still compatible with 4.x)
- Fix: MX Ink support for QuestOS v71+
- Fix: Some logs where incorrectly not behind debug flags
- Fix: Don't export cameras in USDZ when requesting QuickLook-compatible assets
- Fix: Exclude childs of `ContactShadows` and `GroundProjectedEnv` from USDZ export
- Fix: Custom hand models should not automatically become occluders in Passthrough XR
- Fix: Avoid potential exception in `GameObject.getAllComponents(...)`
- Fix: Prevent exception in `DragControls` when dragged object or controller disappear mid-drag
- Fix: Improve `EventList` usage from pure JS
- Fix: Regression in `OrbitControls.autoFit` that resulted in a wrong fit in some cases
- Fix: Improve order of batch validation for automatic instancing when some meshes have different attributes
- Change: Needle Menu styles are more consistent now
- Change: Change casing on `isiPad()`, deprecate `isIPad()`
### Unity Integration
- Change: Bump UnityGLTF dependency to 2.14.0
## [3.48.3] - 2024-09-30
### Needle Engine
- Add: `NeedleXRSession.start("ar")` support which will start `immersive-ar` on supported devices or export an interactive USDZ on iOS devices
- Add: nextjs alias plugin
- Fix: Voip on iOS with connected bluetooth device should select the bluetooth device
## [3.48.2] - 2024-09-24
### Unity Integration
- Fix: Unity WebGL build error
## [3.48.1] - 2024-09-24
### Needle Engine
- Add: `<needle-engine>` attributes for `background-color`, `background-blurriness` and `background-image`
- Fix: Loading of OBJ files exported from ZBrush
- Fix: Loading of FBX files with empty vertex color attributes
- Fix: Unregister mixer in Animation component
- Fix: Needle Menu CSS improvements when using custom html elements inside the menu
- Fix: Needle Menu top positioning now takes CSS safe area into account
- Fix: Balloon message styles adjusted
- Fix: ContactShadows auto fit calculation
- Change: Exit AR button style aligned with Needle Menu
### Unity Integration
- Change: Enable `AutoReference` in Needle Engine Common AssemblyDefinition for easier access to types like FileReference
## [3.48.0] - 2024-09-19
### Needle Engine
- Add: Logitech MX Ink controller support
- Add: Quest menu button now shows Needle Menu in immersive-ar and immersive-vr
- Fix: Improved USDZ code generation regarding transformations/matrices
- Fix: USDZ multi-channel attribute export
- Fix: Minor jsdoc comment error
- Fix: Postprocessing Volume `removeEffect` does now also remove effects from assigned `sharedProfile`
- Internal: Warn if Rigidbody physics object could not be created due to a missing collider
### Unity Integration
- Change: Update scene templates
- Internal: menu item order fix
## [3.47.10] - 2024-09-11
### Unity Integration
- Change how helper tool commands are invoked and some minor fixes
## [3.47.8] - 2024-09-10
### Needle Engine
- Fix: LookAt orientation fixed when both `copyRotation` and `keepUp` are active
- If you have both options enabled and rely on the previous behaviour, toggle `invertForward` to get the same result as before.
- Fix: USDZExporter correctly applying `arScale` again
- Fix: Issue with Needle Menu buttons preventing AR or VR to start in certain cases/devices
- Fix: BatchedMesh/Instancing error after adding/removing many instances and growing the batched mesh buffers where internal state was not properly reset causing an error
- Change: Make Needle Menu text not selectable
- Change:`NeedleXRSession.start("immersive-ar")` now exports to USDZ when called on iOS (experimental)
- Change: Needle Menu foldout is now closed when entering XR
- Change: Remove `Quit XR` button for screen based AR experiences (in favor of the X icon at the top right corner)
- Change: Needle Menu foldout button has now an larger click area to avoid accidental clicks on the Needle logo
- Change: LookAt `copyTargetRotation` is now disabled automatically during VR/passthrough AR session
**Additional changes for Needle Engine 3.47.7**
- Fix: Support loading FBX files in ASCII format
- Fix: Support loading OBJ files starting with `# Alias OBJ`
- Change: Needle Menu buttons height adjusted for mobile
### Unity Integration
- Change: OrbitControls range sliders for `minAzimuthAngle` and `maxAzimuthAngle`
- Change: Click `Open Workspace` button on npmdef asset will now open the vscode workspace directly (instead of the main web project workspace)
- Change: Minor USDZExporter branding wording fix
## [3.47.6] - 2024-09-02
### Needle Engine
- Fix: USDZ animation interpolation. We're now using timesamples for `translation`, `orientation` and `scale` separately. This fixes an issue with animation optimization (optimization removing redundant keyframes) to just 2 keyframes where matrix timesamples would produce unexpected interpolations
- Change: inline mesh bvh worker
### Unity Integration
- Minor console log fix
## [3.47.6-pre] - 2024-09-02
### Needle Engine
- Add: `Mathf.random()` can now also accept an array to randomly select an element
- Add: AudioSource `pitch` property
- Add: SpriteRenderer `addSprite` method
- Add: SpriteRenderer `texture` setter to change the texture of the currently rendered sprite
- Fix: SpriteRenderer `sprite` setter
- Fix: OrbitControls double click to focus should not focus if the click was already used (e.g. by a button)
- Fix: XR `screenshot()` support
- Fix: DragControls now work with physical objects again e.g. Rigidbodies that react to gravity
### Unity Integration
- Add: SkyboxGradient shader `Softness` property to adjust the softness of the color transition
- Add: Few more Gradient Skybox Materials
- Fix: Custom Cubemap export validation
- Fix: Npmdef component generation should allow abstract classes
## [3.47.5-pre.1] - 2024-08-28
### Needle Engine
- Add: `screenshot` option to output a texture
- Fix: `screenshot` method when using a camera with a RenderTexture assigned
- Fix: `ObjectUtils.createPrimitive` option linting
- Change: Addressables `instantiate` method now returns Object3D type
## [3.47.5-pre] - 2024-08-27
### Needle Engine
- Fix: Shader warmup when loading glTF file containing *only* materials (no scenes)
- Fix: OrbitControls `autoTarget` option causing `setLookTargetPosition` to be overriden during the first frame
- Fix: Compressed RenderTexture not being updated on objects in the scene
- Fix: Physics mesh BVH generation on worker caused raycasts during processing to not work until the BVH was ready
#### Additional changes for Needle Engine 3.47.4-beta
- Add: Support loading of glTF files in `<needle-engine src="...">` that don't contain any objects/scenes but just materials. These glTF files will be rendered with a shaderball
- Fix: three.js changing environment texture while in XR
- Fix: three.js OrbitControls zoom damping
- Fix: GroundProjectedEnv error when setting `height` as part of init properties as part of `addComponent(..., { height: 4 })`
- Fix: OrbitControls `minZoom` and `maxZoom` should be applied during update
- Fix: Regression in ParticleSystem trail rendering where `mode` was not set correctly
- Change: Camera `backgroundBlurriness` and `backgroundIntensity` should be undefined by default
- Change: OrbitControls `fitCamera` can now also take a single object as a first parameter
## [3.47.4-pre] - 2024-08-17
### Needle Engine
- Add: OrbitControls `fitCamera` method overload which can directly take an options parameter. E.g. it can be invoked with `fitCamera({ immediate: false })`
- Fix: Lifecycle hooks like `onStart` and `onInitialized` are now properly called again for new subscribers
- Fix: Regression in raycasting with multi-material objects
- Fix: `<needle-engine>` canvas highlighting with touch on iOS
- Fix: Issue where automatic camera change stopped working
- Fix: `screenshot` should update the camera aspect ratio before rendering
- Fix: Physics raycasts do now run basic geometry validation
- Change: The WebGL context is now automatically restored when lost
### Unity Integration
- Fix: OSX commands using `npx`
- Fix: Needle Engine classes declared like `export default class` are now automatically picked-up as well
- Internal: OSX bugreports now include the Editor.log files
## [3.47.3-pre] - 2024-08-13
### Needle Engine
- Add: Improved ParticleSystem MinMaxCurve and MinMaxGradient types with utility methods (`constant`, `betweenTwoColors` / `setConstant`, `setMinMaxConstant`, `setCurve`)
- Add: preliminary support for MX Ink pens
- Add: NeedleXRController `pinchPosition` getter for hand tracking
- Add: SceneSwitcher add `sceneLoaded` Eventlist
- Add: DragControls static `CurrentlySelected` getter to access all currently active DragControls components
- Fix: Gizmo label offset
- Fix: XRControllerFollow on VisionOS with hand tracking
- Fix: Vision OS depth buffer workaround (FB14720123)
- Fix: emulate grip space for hands that don't have grip space
- Fix: `screenshot2` should use passed in camera
- Fix: nextjs plugin fix for error caused by mesh bvh worker integration
- Fix: `input.mouseDoubleClick` getter
- Fix: EventList invocation with custom arguments (e.g. `myEvent.invoke("test")`)
## [3.47.2-pre] - 2024-08-08
### Needle Engine
- Add: Type definitions for Object3D Needle Engine extension methods like `addComponent` or `worldPosition`
- Add: ObjectUtils `createText`
- Add: static `BoxCollider.add` method
- Add: Experimental util method `PlayerSync.setupFrom` to easily setup networked player representations
- Add: ContactShadows `minSize` property
- Fix: ShadowCatcher should set `receiveShadow` to true
- Fix: Animation `play` should restart the animation if it's at the end
- Fix: ContactShadows should ignore Line materials
- Fix: SyncedRoom component is easier to setup from code
- Fix: Properly resolve EventList calls when using `instantiate` to the new instances
- Fix: WebXR simulator hand gesture calculation
- Fix: WebXR desktop preview with postprocessing enabled
- Fix: WebXR input `click` detection
- Change: Physics collider center x should not be flipped. Instead the exporters need to ensure the correct space
### Unity Integration
- Add: Basic Everywhere Actions Unity Runtime implementation:
- ChangeMaterialOnClick
- ChangeTransformOnClick
- HideOnStart
- PlayAnimationOnClick
- PlayAudioOnClick
- SetActiveOnClick
- Add: Improved support for importing glTF files with asset references:
- Import of AudioSource component with referenced AudioClip file
- Import of VideoPlayer component with referenced VideoClip file
## [3.47.1-pre] - 2024-08-05
### Needle Engine
- Add: Voip microphone button option to allow users to mute and unmute themselves
- Add: More jsdoc documentation
- Add: NeedleXRController `emitPointerDown`, `emitPointerUp` and `emitPointerMove` properties to control if the controller should emit pointer events to the Needle Engine Input System
- Add: NeedleXRController `pointerMoveDistanceThreshold` and `pointerMoveAngleThreshold` for changing when controller `pointermove` events are emitted. These values can be set to 0 to emit events every frame or larger values to reduce the number of events emitted.
- Add: Support to disable SpatialGrabRaycaster by setting the static property `SpatialGrabRaycaster.allow = false`
- Fix: Improved audio and voicechat streams when using the Voip component to more reliably play audio and connect to all users in the room
- Fix: Prevent browsers translation of HTML icons
- Fix: Issue with Application audio playback permissions check
- Fix: SpriteRenderer setting `renderOrder` must be rounded to an integer
- Fix: Vite issue where mesh bvh worker was not found in local dev server
- Fix: Mesh BVH should not raycast on meshes that don't have a position attribute
- Change: EventSystem now respects used events. This means if you subscribe to `pointerdown/pointermove/pointerup` with the queue set to a negative value and call `event.use()` or `event.preventDefault()` the EventSystem will ignore the event.
### Unity Integration
- Add: Voip `createMenuButton` option
- Add: AudioSource expose `PlayInBackground` option
## [3.47.0-pre] - 2024-07-31
### Needle Engine
- Add: accelerated raycasting using three-mesh-bvh. All calls to `physics.raycast()` now use a spatial grid solution under the hood to improve raycasting performance. (This can be disabled in the raycasting options by setting `useAcceleratedRaycast: false`)
- Add: `physics.engine.raycast` methods now have an option to ignore the `ignoreRaycastLayer` on the Object3D (the three.js layer 2 is used to exclude objects from raycasting. This means setting `layers.set(2)` is equivalent to "Do not raycast on this object")
- Minor UI performance improvements
## [3.46.1-pre.2] - 2024-07-30
### Needle Engine
- Add: SpriteRenderer `toneMapped` option
- Fix: minor iOS color fix in Needle Menu CSS
- Fix: Voip should stop audio sending and receiving when user disconnects from a networked room
- Fix: WebXR avatar head being offset when user is not centered in rig space
- Change: SyncedRoom auto-generated room name is now numbers only by default
### Unity Integration
- Expose: SpriteRenderer `toneMapped` option
## [3.46.1-pre.1] - 2024-07-29
### Needle Engine
- Fix: WebXR teleport and rotation now takes user position in rig space into account. This means when teleporting the user is now placed at the expected ray target point and when rotating the user is rotated around himself as expected (and the position stays the same)
- Fix: Animation component `fadeDuration` didn't fade out previously playing animations but instead stop immediately
### Unity Integration
- Fix: Update dialogue
## [3.46.1-beta.1] - 2024-07-29
### Needle Engine
- WebXR performance improvements
- Add: Needle Menu foldout submenu for smaller screen sizes. The compact Needle Menu does now have a submenu which can be opened by clicking the 3 dots button at the right side. This improves the menu layout for smaller screen sizes.
- Fix: ContactShadows performance improvements
- Fix: Gizmo label performance improvements
## [3.46.1-pre] - 2024-07-26
### Needle Engine
- Add: `isMacOS` utility method
- Improve WebXR controller and hand raycasting and line rendering. Hide rays while the primary pointer i active.
- Improve DragControls performance
- Fix: Animation `play` should resume paused animations instead of restarting
- Fix: PWA plugin now automatically disables gzip compression. Improved error message if there's missing configuration
- Fix: SyncedRoom `joinRoom` button not creating a new room if the room url parameter was present but empty
- Change: Better error message for circular imports causing scripts to not work
- Change: On OSX and MacOS use power-preference `default` for improved performance ([webkit issue](https://bugs.webkit.org/show_bug.cgi?id=276959))
## [3.46.0-pre.1] - 2024-07-25
### Needle Engine
- Add: WebXR teleport using right hand pinch
- Add: WebXR `Quit XR` button
- Add: SceneSwitcher `useSceneBackground` option to apply background skybox from loaded scene (if it has any)
- Add: SceneSwitcher option to add Needle menu buttons
- Add: `Gizmos.DrawCircle`
- Fix: issue where `depth-sensing` would cause camera near and far planes to have invalid values causing the scene to not render properly anymore when exiting AR
- Fix: DropListener should not prevent propagation. Otherwise e.g. RemoteSkybox and DropListener would not work together
- Fix: DropListener `placeOnHit` should not raycast on just dropped object
- Fix: issue where onPointerEnter is only invoked once if onPointerExit isnt declared
- Fix: WebXRController hits rendering on UI elements
- Fix: WebXRController rays are always visible when enabled but with a low opacity if no object was hit
- Change: WebXR `autoPlace` does now only place on flat surfaces with a small time threshold
- Change: DragControls `SnapToSurface` now uses `DynamicViewAngle` if no object was hit
- Change: Needle Menu active and focus button CSS
### Unity Integration
- Update SceneSwitcher component
## [3.46.0-pre] - 2024-07-23
### Needle Engine
- Add: MeshTracking (WebXRPlaneTracking) is by default now generating occluder meshes for detected planes and meshes
- Add: AudioSource properties for `time`, `time01` (normalized time), `duration`
- Add: Animation properties for `time` and method for `pause()`
- Add: WebXRPlaneTracking `occluder` property to automatically generate occluder meshes for detected meshes
- Add: GroundProjection can now blend with the AR environment using the `blending` property
- Fix: Animation `playOnAwake` regression
- Fix: ContactShadows ignoring GroundProjectedEnv sphere, gizmos and depth only objects (e.g. occluder spheres from mesh tracking)
- Fix: Ensure Sprites when exporting to USDZ
- Fix: DragControls `Snap To Surface` when starting to drag
- Change: WebXR controller hits now only use object bounds
- Change: Hide GroundProjection in immersive-ar
- Change: Minimal increase of close distance for SpatialGrab in WebXR
- Change: Settings on WebARSessionRoot are now all moved to the WebXR component
- WebXR performance improvements for immersive-ar sessions as well as controller and hand tracking
- Update three.js dependency to 0.162.6
### Unity Integration
- WebARSessionRoot settings have been moved to the WebXR component
## [3.45.2-pre] - 2024-07-18
### Needle Engine
- Add: Support for immersive-ar `unbounded` session for unlimited passthrough experiences (enabled by default).
This is currently an experimental feature in the Quest browser. To enable it go to `chrome://flags` and check `WebXR experiments`, then restart the Browser. The next time you start an immersive-ar session on quest the WebXR experience will run without guardian boundaries.
- Add: NEPointerEvent `isSpatial` getter to easily determine if an input event was generated by a spatial device
- Add: Object `static:true` does now disable `matrixAutoUpdate`
- Add: vite plugin that ensures that the npm folder exists
- Fix: Raycast handle null or empty objects in targets array
- Fix: Animation component `play()` issue where previous animations were not always stopped/faded out
- Fix: SceneSwitcher regression causing scenes to not be unloaded
- Fix: Issue where completely empty scene without explicit XR rig caused invalid placement/rendering in VR
- Change: pointer events are now captured and continue to work when they hover over other HTML elements (if started in the 3D scene)
- Change: Disable touch-action on `<needle-engine>` element
### Unity Integration
- Add more characters to default character sheet
## [3.45.1-pre] - 2024-07-16
### Needle Engine
- Add: GroundProjection blurriness set from `scene.backgroundBlurriness`
- Add: Camera `backgroundRotation` property
- Add: GroundProjection environment rotation using `scene.backgroundRotation`
- Add: GroundProjection `autoFit` option
- Fix: OrbitControls re-applying autoFit again when enabled/disabled
- Fix: `getBoundingBox` should ignore gizmos
- Fix: XRControllerModel `createHandModels` not working when `createControllerModels` was disabled
- Fix: `getTempVector` and `getTempQuaternion` set to 0,0,0 by default to return consistent values when called without parameters
- Change: WebXR avatar does now hide local hand models when XRControllerModel models or hands are enabled
- Update gltf-progressive to version 1.2.5
### Unity Integration
- Add: GroundProjectedEnv autoFit option to automatically move the projected surface right below the content
## [3.45.0-pre] - 2024-07-11
### Needle Engine
- Add: XRControllerFollow does now reset the object to the original pose after XR
- Fix: XRControllerFollow does now take original object scale into account
- Fix: OrbitControls autoFit now takes GroundProjection scale into account for the camera far plane
- Change: ContactShadows do now apply scale and transform to a child object so it does not modify the transform anymore of the object it was added to
- Change: GroundProjectionEnv default height to 3
- change: Increase GroundProjectionEnv resolution to 128 for smoother edges
- Change: ChangeMaterialOnClick does now change mouse cursor on hover
### Unity Integration
- Update GroundProjectedEnv component
## [3.44.6] - 2024-07-10
### Needle Engine
- Add: The default XR rig is now automatically placed to view the scene if no explicit XRRig component is found in the scene
- Add: XRControllerMovement does now allow teleportation on the current rig ground plane (if no object is hit when trying to teleport)
- Fix: XRController ray rendering should respect rig scale if the ray doesnt hit any object in the scene
- Fix: rare issue in input calculating world position from screenspace input
- Change: Voip component `autoConnect` default changed to true
## [3.44.5] - 2024-07-10
### Needle Engine
- Add: `window[Needle].NeedleXRSession`
- Change: WebARSessionRoot reticle without depth test for better use with depth sensing
- Change: VR default movement speed increased slightly from 1 to 1.5
- Change: VR default hit visualization adjusted to improve raycasting.
- Update gltf-progressive for improved updated with animated skinned meshes
### Unity Integration
- Fix: Issue where gzip setting was falsely commenting out code and not detecting that we're using a vite plugin
## [3.44.4] - 2024-07-09
### Needle Engine
- Add: TonemappingEffect `exposure` setting to control tonemapping exposure
- Fix: Animator transition for negative timescale
- Fix: SceneSwitcher can now activate and deactivate objects in the scene
- Fix: `XRControllerFollow` takes rig scale into account
- Change: WebXR controllers do not raycast the scene for hit visualization anymore by default. To use add `XRControllerMovement` and enable `showHits`
### Unity Integration
- Fix: Default vite template CSS to not show scrollbar
## [3.44.2] - 2024-07-04
### Needle Engine
- Add: `instantiate` can now be invoked to clone objects without components
- Add: TonemappingEffect `exposure` setting to control tonemapping exposure
- Fix: OrbitControls `autoTarget` and `autoFit` at the start of a scene
- Fix: KTX2Loader being created both by needle engine and gltf-progressive resulting in a warning
- Change: DragControls `SnapToSurface` is more snappy
- Change: DragControls `SnapToSurface` drag start behaviour improved
### Unity Integration
- Add: TonemappingEffect `exposure` setting to control tonemapping exposure
## [3.44.0] - 2024-07-04
### Needle Engine
- Add: `syncInstantiate(object, { deleteOnDisconnect:boolean })` and `IModel { deleteOnDisconnect:boolean }` option to delete a networked instance in the networking storage when a user disconnects. This requires the networking server to use `@needle-tools/networking@2.x` (instead of `@needle-tools/needle-tiny-networking-ws`)
- Add: Expose `AnimationUtils`
- Fix: Improve `PlayerSync` networking, use `deleteOnDisconnect`
- Fix: Update draco decoader to 1.5.7
- Fix: SharpeningEffect effect order
- Fix: SharpeningEffect alpha handling
- Fix: WebXR MeshTracking plane and mesh normals
- Fix: ChangeMaterialOnClick resolving of assigned material in certain cases
- Fix: Duplicatable + DragControls not properly networking on first duplication in cases where multiple DragControls components are nested
- Fix: Dont apply reflection probes to unlit materials
- Fix: FBX loading can now handle multimaterial objects
- Fix: WebXR networked Avatar head position
- Fix: Needle Menu layout update is now enforced immediately when options change
- Fix: Initialize Postprocessing effects parameter when created from code
- Fix: Sharpening effect causing color overflow
- Fix: `screenshot()` breaking transparent rendering
## [3.44.0-pre] - 2024-07-01
### Needle Engine
- Add: `environment-image` magic names now use a lower-resolution version of the HDR/EXR image if the texture is just used for lighting
- Add: Postprocessing Sharpening effect
- Add: PostprocessingManager `addEffect` and `removeEffect` API
- Add: `<needle-menu>` slot support
- Add: `<needle-button>` with support for `ar`, `vr` and `quicklook`. For example: `<needle-button ar>` creates a Needle VR button
- Add: support to use file extension for determining which loader to use to save initial header fetch
- Add: Tuned AGX tonemapping
- Fix: Toggle Volume component `enable` should add and remove the effects
- Fix: Remove leftover log in `<needle-button>`
- Fix: Error in spatial menu caused by slots
- Fix: Export of WebXRButtonFactory type
- Fix: Patched neutral tonemapping [issue](https://github.com/google/model-viewer/issues/4825)
### Unity Integration
- Add: Standalone postprocessing components for TonemappingEffect, BloomEffect and SharpeningEffect
- Change: ImageReference type now can reference Cubemap texture
- Change: Collaborative Sandbox scene template DragControl components are now set to SnapToSurface
## [3.41.2-pre] - 2024-06-25
### Needle Engine
- Add: DropListener can now take `dropArea` object to define a section of the scene that would accept the dropped file.
- Add: DropListener support to fit a mesh into a defined volume (e.g. 1x1x1)
- Add: SyncedRoom option to create a share button for the view only room URL
- Fix: DragControls `SnapToSurface` option when dragged object is not a mesh / the mesh is in the child hierarchy
### Unity Integration
- Change: Update DropListener component
## [3.41.1-exp] - 2024-06-24
### Needle Engine
- Add: `<needle-engine>` web component attributes `environment-image` and `skybox-image` can now be set to presets values: "studio", "blurred-skybox", "quicklook" or "quicklook-ar"
- Add: `<needle-engine tone-mapping>` attribute. Possible values are `none`, `linear`, `neutral` or `agx`.
- Fix: ContactShadows should capture objects on all layers
- Fix: Issue in LOD gizmo debug rendering
- Change: Use smaller icons font
- Change: Camera fitting near and far planes are now tighter to reduce z-fighting in some cases
### Unity Integration
- Fix: Exporting multiple animations assigned to Animation component
## [3.41.0-exp] - 2024-06-19
### Needle Engine
- Add: AnimationRegistry, accessible via `this.context.animations`
- Add: static AnimationUtils class
- Add: `TestSceneUtils.createComparisonScene` for quickly spinning up test scenes
- Add: Menu `appendChild` can now create a button from a structured json object
- Add: New `exportAsGLTF` function
- Add: `<needle-engine contactshadows>` attribute
- Add: Lifecycle hooks like `onStart` or `onUpdate` can now be configured to only run once using the options argument. For example: `onBeforeRender(ctx => { ... }, { once: true })`
- Fix: Postprocessing where Tonemapping was not being applied in some cases
- Fix: `screenshot` method does now support Reflection Probe lighting
- Fix: Lightmapped objects with MultiMaterial objects spamming warnings
- Change: Improve Postprocessing Bloom
- Change: Improve FBX loading
- Change: ContactShadows `autoFit` increases shadow area by factor 1 (previously 0.5)
- Change: Bump three to 0.162.4 adding GLTFExporter plugin hooks and animation retargeting using `userData { name }`
- Change: Bump postprocessing to ^6.35.5
- Change: Bump gltf-progressive dependency
## [3.40.0-exp.1] - 2024-06-12
### Needle Engine
- Add: Experimental support to load `.fbx` files via `<needle-engine src>`
- Fix: issue where `<needle-engine autoplay>` would not play animations
- Change: "IsMobile" check because window.orientation is deprecated
- Change: USDZ move direct/indirect interaction logic to tapTrigger and add options (by default, both are allowed)
- Change: Production build command changed - vite plugin now runs when `vite build` is invoked with `--production` - e.g. `vite build -- --production`. The legacy npm build script is automatically updated when the plugin runs for the first time.
### Needle Engine
- Bump Needle Engine version
## [3.40.0-exp] - 2024-06-03
**IMPORTANT NOTICE**
Needle Engine does now require NPM 10 to be installed.
Simply run `npm update -g npm` in your commandline/terminal or use the Needle Engine project validation window.
NPM 10 is required due to an update in the compression pipeline which brings faster and more stable compression of glTF/GLB files as well as texture and mesh LODs.
Our automatic LOD generation improves performance and loading times of application of all sizes significantly. This allows to use higher texture resolutions and meshes with higher poly counts in projects while Needle Engine takes care of loading the appropriate LOD keeping loading times fast and your website responsive.
### Needle Engine
- Update gltf-progressive dependency for smarter LOD texture loading
- Add: `WebARSessionRoot.onPlaced` event hook
- Fix: InputField click should open keyboard on Android and iOS
- Fix: ContactShadow and ShadowCatcher meshes should not be raycastable
- Fix: Mesh particle LODs not being loaded
- Fix: UI Image/Raw Image texture LODs not being updated
- Change: OrbitControls `fitCamera` use options object, add "centerCamera" option
### Unity Integration
- Update build-pipeline dependency for automatic texture LOD generation
- Improve project validation requiring NPM 10
## [3.39.0-exp.2] - 2024-06-03
### Needle Engine
- Fix: vite build pipeline plugin
### Unity Integration
- Fix: run npm install with include optional sharp for build pipeline
## [3.39.0-exp] - 2024-06-03
### Needle Engine
- Fix: Issue where OrbitControls setTarget not working as expected sometimes due to first frame matrices not being updated yet
- Fix: Gizmos sometimes rendering for 2 frames instead of just 1
- Change: WebXRImageTracking now applies some smoothing based on jitter amount
- Change: Bump gltf-build-pipeline package to 2.1
### Unity Integration
- Fix: Issue where context menu export would not clear internal cache that prevented re-exporting the same file multiple times
- Fix: Export context menu handle case where directories can not be deleted because they're locked by a CLI tool
- Change: Dont write progressive texture max size if no specific settings are found because we then want it to be handled by the build pipeline package (depends on the usecase etc)
## [3.38.0-exp.1] - 2024-05-29
### Needle Engine
- Fix: needle menu CSS blur in safari
- Fix: USDZ - move Animation component animations into correct sequence depending on whether it should loop or not
- Fix: QuickLook button being created by WebXR despite `usdzExporter.allowCreateQuicklookButton` explicitly being off
- Fix: Issue in vite plugin for Node 16 where fetch wasn't supported yet
- Fix: AudioListener should remove itself when disabled
### Unity Integration
- Minor WebXR component tooltip improvements
## [3.38.0-exp] - 2024-05-29
### Needle Engine
- Add: OrbitControls `clickBackgroundToFitScene` property that can be used to allow autofitting when users click on the background. By default it is set to 2 clicks
- Add: Vite plugin option to open browser with network ip address when the server starts by setting `needlePlugins(command, config, { openBrowser: true })` in vite.config.js
- Fix: USDZ image tracking orientation corrects for node world matrix now, resulting in proper placement relative to the image
- Fix: WebARSessionRoot matrix and invertForward were not correctly applied for USDZ export
- Change: WebXR Image Tracking orientation was rotated by 180°. Now it's consistent between iOS USDZ and Android WebXR. If you're using image tracking, you might have to rotate your content 180° to adjust to the new orientation.
### Unity Integration
- Add: OrbitControls `clickBackgroundToFitScene` property that can be used to allow autofitting when users click on the background. By default it is set to 2 clicks
## [3.37.16-exp] - 2024-05-28
### Needle Engine
- Add: `Gizmos.DrawWireMesh`
- Fix: use lowpoly raycast mesh again when available
- Fix: USDZ - issue where image tracking orientation was inconsistent between Android and iOS
- Change: USDZ - better logs when unsupported animation tracks are used during export (e.g. .activeSelf or material animations).
- Change: USDZ - show balloon warning when exporting unsupported track types
### Unity Integration
- Add: ImageTracking now renders gizmo texture on tracked object
## [3.37.15-exp] - 2024-05-27
### Needle Engine
- Add: ScreenCapture `deviceFilter` and `deviceName` properties that simplify camera selection
- Fix: Avatar hands being visible in screenbased AR
- Fix: USDZ workaround for Apple bug FB13808839 - skeletal mesh rest poses must be decomposable in RealityKit
- Fix: Issue where Lightmap LOD textures did not load
- Fix: Issue where Custom Shader LOD textures did not load
- Change: `Powered by Needle` tag can be hidden with indie license
### Unity Integration
- Add: ScreenCapture `deviceName` field and dropdown for simplified camera selection
- Change: `Powered by Needle` tag can be hidden with indie license using the Needle Menu component
## [3.37.14-exp] - 2024-05-24
### 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)
## [3.37.13-exp] - 2024-05-23
### 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
## [3.37.12-exp] - 2024-05-17
### 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
## [3.37.11-exp] - 2024-05-15
### Needle Engine
- Add: OrbitControls `zoomSpeed` and `zoomToCursor` properties
- Add: `screenshot2` method that takes an options object for easier configuration and transparent screenshots support.
- Add: `context.menu.setVisible` method for hiding the Needle Menu from code
- Add: USDZ API now supports playing back audio from custom behavior scripts. Usage from inside `createBehaviours`:
```ts
const audioClip = ext.addAudioClip(clipUrl);
const behavior = new BehaviorModel("playAudio",
TriggerBuilder.tapTrigger(this.gameObject),
ActionBuilder.playAudioAction(playbackTarget, audioClip, "play", volume, auralMode),
);
```
- Add: USDZ API now supports registering animations from custom behavior scripts (experimental)
better lighting response
- Add: animator state speed support in USDZ
- Fix: USDZ export had multiple identical textures for the same cloned image
- Fix: USDZ sprites had wrong lighting because of QuickLook bug with non-specified normals, now emitting (0,0,1) and not (0,0,0) as fallback normals
- Fix: HideOnStart should not hide objects in USDZ that were manually enabled in the scene before
- Fix: issue with texture tiling being 0 in any direction leading to invalid USDZ files
- Fix: Contact Shadows now have consistent blur independent of scene scale
- Fix: Regression with audio not playing at start of USDZ scene
- Fix: Contact Shadows now properly correct for different scene aspect ratios
- Fix: SceneSwitcher `scenes` array not immediately when creating from code
- Fix: `onStart` hook not being called for all `<needle-engine>` elements
- Fix: Script registration to correct context when loading multiple `<needle-engine>` components on one page
- Fix: Renderer allow changing the ReflectionProbe anchor at runtime
- Fix: Reflection probes with lightmaps causing memory leak
- Fix: Contact Shadows now have consistent blur
- Fix: Contact Shadows auto fit box is now correctly setup to include the whole scene
- Fix: Balloon Messages overflowing for very long words
- Fix: Issue with OrbitControls `zoomToCursor` enabled in cases where the loaded glTF didn't contain any camera
- Change: USDZ now exports disabled objects as well, sets their visibility to false (for regular USD) and hides them on start (for QuickLook)
- Change: `clearOverlayMessages` has been renamed to `clearBalloonMessages`
- Change: Allow hiding the needle menu for local development
## [3.37.10-exp.1] - 2024-05-07
### 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
## [3.37.10-exp] - 2024-05-06
### 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
## [3.37.9-exp] - 2024-05-03
### 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
## [3.37.8-exp.1] - 2024-05-02
### 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
## [3.37.8-exp] - 2024-04-30
### Needle Engine
- Add: `@needle-tools/gltf-progressive` dependency that handles loading progressive meshes and textures.
## [3.37.7-pre.1] - 2024-04-29
### Needle Engine
- Fix: USDZ regression in writing timeSamples > 1000
## [3.37.7-pre] - 2024-04-29
### 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
## [3.37.6-pre] - 2024-04-26
### 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
## [3.37.6-exp] - 2024-04-24
### Needle Engine
- Add: More API documentation
- Add: VideoPlayer can now play `m3u` livestream links
- Fix: WebARBackground now checks if camera-access is granted
- Change: Progressively loaded assets now postfix urls with the content hash of the assets if available to make sure the correct version is loaded and not a old version from cache
- Change: VideoPlayer setting `url` now immediately updates the videoplayback
## [3.37.5-exp] - 2024-04-22
### Needle Engine
- Add: SceneSwitcher support for adding the `ISceneEventListener` on the sceneSwitcher gameObject
- Fix: OrbitControls should not update on user input when the camera is not currently active
- Change: OrbitControls middle click/double click does not change camera position anymore and just set the look target
## [3.37.4-exp] - 2024-04-22
### Needle Engine
- Fix: Collider filtermask bug where it did previously override membership settings in certain cases
- Change: Menu now removes the buttons for very small sizes
- Change: `this.context.physics.engine.raycast` and `raycastWithNormal` api changed to take an options parameter instead of single values. It now also exposes rapier's `queryFilterFlags`, `filterGroups` and the `filterPredicate` options. It can now be called with e.g. `this.context.physics.engine.raycast(origin, direction, { maxDistance: 2 })`
### Unity Integration
- Change: Move all Needle Engine components in `Needle Engine/` addComponent menu and improve searchability
## [3.37.3-exp] - 2024-04-19
### Needle Engine
- Fix: Regression in progressive mesh for multi material objects / multiple primitives per mesh
- Change: Improve LOD level selection based on available mesh density per level
Level of detail switching now finds a good match for screen and mesh density that results in more consistent on-screen triangle density. This change also improves LOD switching for low-poly meshes considerably.
- Change: ScreenCapture now respects if user is in `viewonly` networked room
### Unity Integration
- Add: New "Better Cubemap" shader that allows to blur the skybox in the editor and change intensity.
You can upgrade from skybox materials that currently use `Skybox/Cubemap`.
Upgrade options are in the material inspector and on the `Camery Skybox Data` component in a scene.
- Add: Improved image-based lighting workflow on 2023.x+ when using the new "Better Cubemap" shader
## [3.37.2-exp] - 2024-04-17
### Needle Engine
- Fix: Regression in USDZ export causing behaviours to stop working
### Unity Integration
- Change: WebXR component now exposes methods to start and stop a XRSession (`enterVR`, `enterAR`, `exitXR`)
- Change: WebXR component AR transform touch controls are now enabled by default
## [3.37.1-exp] - 2024-04-16
### Needle Engine
- Fix: Eventlist now handles EventListeners being added or removed during `EventList.invoke`
- Fix: Progressive LOD textures issue where compressed textures would not be loaded in some cases when using tiling
- Change: USDZExporter created by the WebXR component now enables `autoExportAnimation` and `autoExportAudioSources` by default
### Unity Integration
- Change: Improve multi scene workflow with additional loaded scenes that are also referenced. Multiple ExportInfo components are also better handled by using the first ExportInfo component in the currently active scene
## [3.37.0-exp] - 2024-04-15
### Needle Engine
- Add: USDZ physics export for VisionOS
- Add: Sprite `mesh` and `material` properties to simplify creating a new sprite object
- Fix: Loading files that don't have a `.glb` or `.gltf` extension but the correct mime type
- Fix: PostProcessing error when using tonemapping from vanilla threejs
- Change: Bump rapier dependency to ^0.12.0
### Unity Integration
- Fix: DeployToGlitch now using `needle.config.json` for build folder (support for e.g. Sveltekit deployment to glitch)
- Fix: DeployToGlitch horizontal button layout
## [3.36.6] - 2024-04-12
### ⭐ Highlights
This release comes with numerous new features on our path to providing the best foundations for the spatial web.
We have rewritten our underlying WebXR support with ease of use and flexibility in mind,
added a new cross-platform Menu component for quickly adding custom functionality to apps, and introduced a novel automatic mesh simplification and level of detail system.
Needle Engine now supports VisionOS, with improvements to hand tracking, transient pointers, and support
for both Fully Immersive apps using WebXR, and Immersive Volume experiences based on Everywhere Actions and USD.
We're also introducing the next step on our road to ubiquitous 3D content with automatic mesh simplification and sophisticated level of detail selection at runtime.
Apps now are smaller, load faster, and run smoother – heavy models and large worlds benefit the most.
#### **New WebXR Foundations and API**
We've rewritten our WebXR API to be more intuitive, easier to use, and better integrated with the rest of the engine. XR controllers, hands, and eye tracking now flow seamlessly through our Event System, so that events like `onPointerClick` just work – no matter the input source.
We've also made sure controllers are fully accessible for advanced use cases, with low-level access to the underlying WebXR API.
Our new spatial preloader allows scenes to enter XR sessions more quickly, unlocking immersive navigation using `sessiongranted` (supported on Quest 2/3) for larger scenes.
Drag Controls now have support for multiple hands/controllers/touches and have modes for different interaction types.
This new release also brings support for `mesh tracking`, `depth sensing`, `offer session`, a spatial debugging console, and more.
Existing scenes will upgrade to the new WebXR API automatically.
#### **Needle Menu**
The new `Needle Menu` component allows for easy creation of custom menus in your apps. It brings together a number of often-used features like fullscreen, audio and networking settings, and sharing options under one unified user interface.
Sharing experiences with others is now even easier through automatic QR code generation and Direct-to-Quest links.
AR, VR and QuickLook buttons are integrated into the menu as well – and Needle Menu is supported in WebXR too.
#### **Next Level Optimzation**
Needle Engine supported automatic compression and progressive loading for textures for a while, and now we're introducing automatic LOD generation, progressive loading, and runtime switching.
Detail levels are chosen based on screen density, which means that in complex scenes only load mesh levels that are actually needed are ever downloaded.
Additionally, automatic compression of meshes and textures paired with our compression cache is now fast enough to be enabled by default while working on projects, not just for production builds.
#### **Better API documentation**
Besides readable source and documentation, we now have a dedicated API docs page that contains documentation for all previous and future versions: https://engine.needle.tools/api.
#### **VisionOS support**
VisionOS is now a fully supported platform for Needle Engine.
We support both Immersive Volume experiences and Fully Immersive (VR) experiences.
Immersive Volumes are enabled by our Everywhere Actions and on-the-fly USD generation, and can even be shared via SharePlay to other users. Take a look at our collection of interactive USD samples at https://engine.needle.tools/projects/ar-showcase.
While we had VisionOS support since day 1 due to building on open standards like WebXR, we improved the experience with better hand tracking, transient pointers for eye tracking, and performance improvements.
A great example is https://engine.needle.tools/samples/bow-&-arrow/ – make sure to enable the WebXR flag in your Safari settings on VisionOS.
#### **Smarter FTP deployments**
When using our built-in FTP deployment, we now keep track of previously uploaded files.
This makes repeat deployments much faster since it allows us to upload only those files that have changed.
#### **Numerous Fixes and Improvements**
This release ships with hundreds of bug fixes and improvements in the runtime, build pipeline, and integrations.
Thanks to all of our customers who send us feedback and reported bugs – we appreciate each and every report, keep them coming!
Among the improvements are preload support for video and audio, better gizmo rendering and handling for lines, texts, meshes, and many new debug flags for an in-depth look at the engine's inner workings. We also ship experimental support for single-line PWA setup – more on that in a future release.
### Needle Engine
- Add: Needle Menu can now create QR button
- Change: Needle menu fullscreen button now switches the `needle-engine` element into fullscreen
- Change: LODs are now switched at a slightly larger distance
## [3.36.6-pre] - 2024-04-10
### Needle Engine
- Add: Expose `setAutoFitEnabled` method to remove objects from being included in camera fitting
- Change: Improve WebAR wall and ceiling placement
### Unity Integration
- Fix: Issue where the menu item `Needle Engine/Build Production` creating a development build (if the Build Window `Development Build` checkbox was ticked)
## [3.36.5-pre] - 2024-04-09
### Needle Engine
- Add: lifecycle hooks like `onUpdate(()=>{})` now return method to unsubscribe. For example you can now write it like this `const unsubscribe = onUpdate(()=>{ console.log("One Frame"); unsubscribe(); })`
- Add: `onAfterRender` hook
- Add: RemoteSkybox can now handle locally dropped files
- Add: `ObjectUtils.createSprite` method
- Fix: `<needle-engine camera-controls="0">` does now not create OrbitControls anymore if the assigned glTF file doesn't contain a camera
- Fix: RemoteSkybox doesn't prevent drop events anymore if the dropped file can not be handled
### Unity Integration
- Fix: Unity 2023 platform selection for embedded assets (Textures, Meshes)
## [3.36.4-pre] - 2024-04-05
### Needle Engine
- Add: More API documentation
- Add: `SceneSwitcher.addScene`
- Add: SceneSwitcher `scene-opened` event. Subscribe with `sceneSwitcher.addEventListener('scene-opened', args => {})`
- Fix: `OrbitControls.fitCamera` handle case where user passes in array with undefined entries
- Fix: Needle Menu not visible in AR overlay
- Fix: Contact Shadows should not render transparent objects
- Fix: API docs warnings (internal)
## [3.36.3-pre] - 2024-04-04
### Needle Engine
- Add: More API documentation for progressive loading, USDZExporter, getComponent methods etc
- Add: Needle Menu CSS for disabled buttons
- Add: Expose `onXRSessionStart` and `onXRSessionEnd` hooks
- Add: `isAndroidDevice` utility method
- Fix: Bounds calculation of SkinnedMeshRenderer with multi-material (multiple three skinned meshes in children)
- Fix: ContactShadows rendering for AR
- Fix: WebAR touch transform does now ignore touches that start in top 10% of screen on android (e.g. when user is opening the menu by swiping down)
- Change: Needle Menu button height is clamped
- Change: Improve OrbitControls `fitCamera`
- Change: Needle asap now displays custom logo if assigned to `needle-engine` web component (requires PRO license)
### Unity Integration
- Add: `OrbitControls.fitCamera` method exposed
## [3.36.2-pre] - 2024-04-03
### Needle Engine
- Add and improve API documentation
- Add: `onXRSessionEnd` method hook
- Fix: Regression introduced by 3.36.0 causing stencil rendering to not work anymore
- Change: Move QR button method into `ButtonsFactory`
### Unity Integration
- Fix: minor issue where register type codegen would generate types for @example jsdoc comments
## [3.36.0-pre] - 2024-04-02
### Needle Engine
- Add: support for Auto LOD generation and runtime switching based on mesh density
- Add: support for progressive mesh loading which can reduce the initial download size significantly
- Add: BatchedMesh support for instancing
- Add: `Renderer.setInstanced(myMesh, true)` call to enable instancing for any Mesh
- Change: raycasting will now use lowpoly LOD which can reduce intersection checks significantly for high-poly assets
### Unity Integration
- Add: support for Auto LOD generation.
- generating LODs can be disabled for a complete project using the `ProgressiveLoadingSettings` component or in the mesh import settings
## [3.35.1-pre] - 2024-03-29
### Needle Engine
- Add: Animator api for `getCurrentStateInfo()` and `currentAction` getter which returns the currently playing three action.
- Internal: use `compileAsync` for prewarming newly loaded objects
### Unity Integration
- Fix exception caused by pnpm folder check
## [3.35.0-pre] - 2024-03-25
### Unity Integration
- Fix: sub asset inspector should not create the data object asset when platform import-options are selected
- fix: AssetSettingsInspector should handle submeshes in PackageCache - the data object asset is then created in `Assets/Needle/ImportSettings`
## [3.35.0-exp] - 2024-03-22
### Needle Engine
- Add: Support for `transient-pointer` input sources for VisionOS
- Add: add metadata and intersections to `NEPointerEvent` type. Intersections are filled in from EventSystem. This information can be access via `this.input.addEventListener` or the input event callbacks
- Change: `ObjectUtils.createPrimitive` now has types strings e.g. `ObjectUtils.createPrimitive("Cube")`
- Change: ChangeMaterialOnClick doesnt require a Renderer component anymore
## [3.34.4-exp.1] - 2024-03-21
### Unity Integration
- Fix: Explictly use `@needle-tools/gltf-build-pipeline` v1.3.1 until 1.4 is out
- Change: Update UnityGLTF to 2.10.2-rc fixing exception when animating a missing material
- Internal: clarify EditorSync warning and minor warning fix
## [3.34.4-exp] - 2024-03-20
### Needle Engine
- Fix: OrbitControls autoFit frame delay causing a wrong perspective for one frame
- Fix: Multiple WebXR components causing menu item icons to appear multiple times
### Unity Integration
- Fix: Generate lightmaps on export if the scene is using baked lighting but no lightmaps exist yet
- Fix: Improve SamplesWindow tags and search filtering to restore state after recompile
- Change: Clarify some logs regarding local server and export from an scene without ExportInfo
## [3.34.3-exp.1] - 2024-03-19
### Needle Engine
- Add: debug on-screen console (`?console`) now has a tab to inspect the scene
- Fix: TransformGizmo component preventing OrbitControls input
### Unity Integration
- Fix: workaround for welcome window exception
## [3.34.3-exp] - 2024-03-18
### Needle Engine
- Add: `context.maxRenderResolution` clamping the max renderer size
- Add: `PointerEventData` now expose raw three.js Intersection object (e.g. in onPointerDown)
- Add: `addComponent` can now take an optional init parameter which can be used to set default values during creation of the component instance, modify options or assign fields. The init parameter is fully typed and only shows available options
- Fix: Issue where async import of Needle Engine breaks registering custom gltf extensions registered from local packages. Needle Engine now waits for all dependent packages to be ready
- Change: Bloom effect defaults to normal Bloom effect for performance reasons (previously it was using SelectiveBloom by default). To change this back set `Bloom.useSelectiveBloom = true` in global scope
- Change: Volume component now exposed `effects` array which is a list of the currently active postprocessing effects
- Change: NEPointerEvents now create a threejs Ray when accessing the `ray` property and no ray was created before
- Change: Allow audio playback when keyboard input is detected
- Change: Gizmos now ignore fog
- Change: Improve `getComponent` api types. For example previously `addComponent` did return the generic `IComponent` interface instead of the concrete type (e.g. `Animator`)
- Change: Deprecate `addNewComponent` because it is redundant. You can just use `addComponent`
### Unity Integration
- Internal: update materials to 2021.3 serialization format
## [3.34.2-exp.2] - 2024-03-13
### Needle Engine
- Fix: vite build pipeline plugin should wait for output directory up to 10 seconds
- Fix: input event button index for mouse on pointer move
- Fix: basic styles for links inside needle menu
### Unity Integration
- Fix: EditorSync settings serialization causing error on export
- Internal: project generator should not change local paths in web project
## [3.34.2-exp] - 2024-03-13
### Needle Engine
- Fix: issue where asap plugin path would be falsely resolved causing a vite build error
- Fix: serializable warning in WebARCameraBackground and Animation components
- Change: set Needle Menu zindex to 1000
### Unity Integration
- Change: Remove legacy support for Versions lower than Unity 2021.3
- Change: TransformControls component can now be disabled
- Change: Opening workspace now updates Needle Engine folder display name
- Change: Update vite workspace template removing wrong compile-hero setting
## [3.34.1-exp.1] - 2024-03-12
### Needle Engine
- Fix: Input regression when querying mouse button states (e.g. `getPointerClicked(1)` for the middle mouse button)
### Unity Integration
- Add: Expose OrbitControls `autoTarget` option
## [3.34.1-exp] - 2024-03-12
### Needle Engine
- Add: OrbitControls exposing min/maxPolarAngle and min/maxAzimuthAngle
- Fix: Input should subscribe to pointer events (`pointerdown`, `pointermove`...) instead of touch and mouse. For fixing iOS and AR issues where pointerIds are stuck and we have wrong state
- Fix: Button hover state when dragging with right mouse button
- Fix: Vite build plugin error when needle gltf build pipeline package doesnt exist
### Unity Integration
- Add: OrbitControls exposing min/maxPolarAngle and min/maxAzimuthAngle
- Fix: ensure local dependencies are added to the workspace when opening it
- Fix: catch some exceptions during tests when scene has no ExportInfo
- Fix: Hidden tools project check if installation is really finished
## [3.34.0-exp.3] - 2024-03-11
### Needle Engine
- Fix: TypeScript warnings in XR components
- Fix: Add correct @type for `Button.animationTriggers`
- Fix: Incorrect serialization warnings for fields marked with `@serializable()`
### Unity Integration
- Fix: Compilation error on 2020.3.x
- Change: Open typescript files in main workspace if they're a dependency
- Change: Always add NpmDef dependencies to workspace
## [3.34.0-exp.2] - 2024-03-07
### Needle Engine
- Fix: Partially revert alias plugin changes to fix issues with md5 package
- Fix: Check if asap exists before referencing it
### Unity Integration
- Fix: Remove URP light/camera components when samples are opened on BiRP and components are missing
## [3.34.0-exp] - 2024-03-06
### Needle Engine
- Add: Vite plugin for showing indicator that needle engine bundle is still loading (Needle ASAP)
- Add: Vite plugin for build info now includes file hash so we can skip uploading unchanged files
- Add: `this.context.input.addEventListener` now exposes options for `once` (remove event listener after the first invocation) and `signal` (remove event listener when signal is aborted)
- Add: `this.context.time` now has `deltaTimeUnscaled`
- Fix: Issue where Needle Menu size would sometimes switch between compact and stretched view
- Fix: Improve icon rendering while icon font is still being loaded
- Fix: Ensure NeedleXRSession does only subscribe once to `session granted`
- Fix: Vite alias plugin now explictly resolved three exports for addons and nodes
- Fix: wrong colorspace in scene lighting texture
- Fix: Show Needle Menu in AR dom overlay
- Fix: LOD layers are now properly set (e.g. it's now possibly to disable raycasting via layer 2)
- Fix: Issue where timescale would affect XR movement
- Change: Bump three.js version to 0.162
- Change: Bump postprocessing to 6.35.1
### Unity Integration
- Add: DeployToFTP now skips uploading unchanged files based on data stored in `needle.buildinfo.json` (this is automatically generated via a vite plugin during building)
- Fix: Issues in Unity 2022 due to Unity regression in inspector height calculation
- Change: Bump UnityGLTF to version to 2.10.0-rc.2 (latest)
- Change: Update CollabSandbox Scene Template
- Change: Remove Needle Engine Trial limitations (previously affecting AnimatorController and Timeline export)
## [3.33.0-pre] - 2024-03-02
### Needle Engine
- Add: Needle Menu can now create `Mute` and `Fullscreen` buttons.
- Add: Needle Menu buttons now have icons (configuration options will be added in a future version)
- Add: Needle Menu `postMessage` support to inject buttons to open an URL
- Add: SyncedRoom now creates a `Join Room` button to the menu (or `Leave Room` button)
- Add: WebXR support for the Needle Menu
- Add: Pre-XR room when user enters via `sessiongranted` when the main content is still loading
- Add: OneEuroFilter `reset` method
- Fix: Resume AudioContext when interrupted (happens e.g. on VisionOS when entering VR)
- Fix: GroundProjection should not be visible when in pass-through AR
- Fix: XRController ray and hit rendering now correctly respects rig scale
- Fix: Button with state transition colors now correctly work with alpha values
- Fix: Issue where the Needle Menu was visible without any button or content
- Change: Spatial console becomes visible when an error happens on local server while in XR
### Unity Integration
- Fix: Generate the correct template when user selects a template in the ExportInfo and then click the Unity Play button
- Change: Improve the custom shader inspector for when the shader is a subasset or in an immutable package
## [3.32.28-pre] - 2024-02-28
### Needle Engine
- Fix: AR placement for Chrome 122
### Unity Integration
- EditorSync inspector now shows uninstall button while server is running
## [3.32.27-exp] - 2024-02-26
### Needle Engine
- Fix: Quicklook export caused by typo in USDZ mime-type
- Fix: Workaround iOS/visionOS bug: always include the tap trigger for audio even if nothing to tap on
- Change: Input `addEventListener` can now take options as a third argument
## [3.32.26-exp] - 2024-02-23
### Needle Engine
- Add: Needle Menu. This first version will contain the WebXR options for now. Future versions will allow for more configuration
- Fix: webpack based project code optimization. This will improve e.g. nextjs production builds
- Fix: Raycasting offset in AR for touches near the screen border
- Fix: Spatial console text z fighting
- Fix: PostProcessing Exposure not working anymore with tonemapping
- Change: `NeedleWebXRHtmlElement` has been renamed to `WebXRButtonFactory`
- Change: bump postprocessing package to `6.34.3`
- Change: Improve PostProcessing when tonemapping is enabled
### Unity Integration
- Change: Automatically enable progressive textures when overriding TextureImporter settings for Needle Engine platform
## [3.32.25-exp] - 2024-02-22
### Needle Engine
- Fix: WebXR switching between controllers and hands
- Fix: WebXR `onControllerAdded` being called twice at the start of a session
- Fix: WebXR buttons container should not capture pointer events
- Fix: Improve spatial console (visible in XR with `?console` in the URL)
- Fix: Allow audio playback once a XRSession starts
- Fix: USDZ fill in missing transform data when multile animation clips on the same object have different detected animation roots
- Fix: generated USDZ mime type
- Change: new cleaner loading screen
### Unity Integration
- Change: ExportInfo.AutoCompress now also generates progressive textures for local dev
## [3.32.24-exp] - 2024-02-21
### Needle Engine
- Add: Spatial debug console, add `?console` url parameter to get a debug console in XR floating before the camera view
- Add: OpenURL component support for opening email addresses (without `mailto:` prefix, just enter your email address in the url field)
- Add: Progress api for performance logging (use via `Progress.start`, `Progress.report` and `Progress.end`)
- Fix: error when using RenderTextures
- Fix: USDZ text material missing
- Fix: USDZ prevent unclear animation export error
- Fix: USDZ improve endTimeCode calculation
- Fix: USDZ improve audio export, implicit register audio sources with scene start triggers
- Change: USDZ unpremultiplied texture readback on chrome
- Change: Expose DragControls.DragMode enum
### Unity Integration
- Change: bump helper package dependency
## [3.32.23-exp] - 2024-02-19
### Needle Engine
- Add: `FileReference` support to reference, export and load almost any file:
```ts
@serializable(FileReference)
myFile?: FileReference;
```
- Add: initial support for [building PWAs with needle engine](https://engine.needle.tools/docs/html.html#creating-a-pwa) and `vite-plugin-pwa`
- Fix: false check in VideoPlayer `videoElement` getter
### Unity Integration
- Fix: WebXR component false warning for missing Avatar component
- Change: improve WebXR component DX (for example when the WebARSessionRoot component is present in the scene the WebXR component will render the correct `userScale` value)
## [3.32.22-exp] - 2024-02-16
### Needle Engine
- Add: Needle build-pipeline plugin to run compression as part of the vite build process
- Fix: Loading of progressive textures in Canvas UI
- Fix: Loading of progressive textures in Spritesheet renderer
- Change: SpritesheetRenderer does now directly apply rounded sprite index (instead of relying on the value to be an integer)
### Unity Integration
- Change: Vite projects are now running `build:dev` for production builds as well since the compression is handled by the new needle build-pipeline vite plugin
- Change: Update UnityGLTF dependency from 2.8.1-exp to 2.9.1-rc
- Change: Click on `Install` in ExportInfo now runs install in all locally installed packages (e.g. all references npmdef packages)
## [3.32.21-exp] - 2024-02-16
### Needle Engine
- Add: USD `displayName` support for nodes and materials
- Fix: input double click data on iOS
- Fix: USDZ material indenting
- Fix: check if `linearVelocity` exists on XRPose to prevent typecheck error in CI environment
- Change: export USDZ materials, geometry and textures with proper names related to their original names
- Change: improve USDZ opacity and opacityThreshold conversion, add minimal alphaHash support since QuickLook seems to allow that now
### Unity Integration
- Fix: ensure supported three.js is installed in needle engine web projects
- Change: WebXR component now shows infos about assigned avatar and shows a `Fix` button
## [3.32.20-exp] - 2024-02-10
### Needle Engine
- Fix: WebXR buttons should catch exception when accesing `navigator.xr` which can happen in iframe without spatial-tracking permissions
- Fix: Issue where `getPointerDelta(pointerId)` did not return data when using multitouch except for the first touchpoint
- Fix: Issue where `backgroundBlurriness` and `backgroundIntensity` would not be reset to the default when enabling a camera that didnt have explicit settings (NE-4243)
- Change: `getComponentsInChildren` and `getComponentsInParents` now clear the optionally provided buffer arrays by default
## [3.32.19-exp] - 2024-02-09
### Needle Engine
- Fix: CanvasGroup causing performance to drop over time
- Change: Expose `createNewRenderer()` on context
## [3.32.18-exp] - 2024-02-09
### Needle Engine
- Add: vite plugin for collecting build information
- Fix: USDZExporter not respecting button option so `Open in Quicklook` button was always created
- Fix: vite plugin for copying files didnt respect needle.config.json build directory
- Fix: AnimatorController exception happening in deepClone (NE-4227)
- Fix: minor false warning log for deserializing postprocessing effects
- Fix: vite dependency watcher plugin should handle version containing alias like `npm@three@160`
- Fix: NeedleXRSession feature support should catch exception that might happen when running inside iframe with insufficient permissions
- Change: ARSessionRoot align placed scene to camera during placement preview and actual placement so they match up
- Change: bump postprocessing package to 6.33.4 for three 160 support
- Change: vite plugin dependency watcher should now reload website when the server has changed due to changed package.json dependency
### Unity Integration
- Fix: DeployToFTP component respecting needle.config.json
- Change: ExportInfo `Open Workspace` button now opens Readme in project directory by default (if it exists)
## [3.32.17-exp] - 2024-02-08
### Needle Engine
- Fix: visionOS input handling and hands rendering
- Fix: Error during USDZ text export
- Fix: vite plugin error for cases where config object was missing
- Fix: Rare issue where re-entering AR causes error due to missing reticle
- Change: component `onDestroy` is now called before Object3D and resouces are disposed/destroyed
- Change: WebARSessionRoot z-forward looks now towards user/camera
### Unity Integration
- Fix: DeployToFTP URL encoding when opening url
- Fix: Fog not exporting for scenes without GltfObject component
- Fix: Issue in ComponentGenerator component when no ExportInfo is in scene
- Change: BugReporter description can now be cancelled
- Change: Try fix issue where npm tools package fails to install
- Change: Try improving license check for cases where the internet connection is lost
## [3.32.16-exp] - 2024-02-07
### Needle Engine
- Add: NeedleXRController `isHand` property
- Add: WebARSessionRoot `customReticle` to allow how the AR session placement looks
- Add: NeedleXRController `getHandJointPose(jointName)` API
- Add: Static `NeedleXRSession.onXRSessionStart` and `onXRSessionEnd`
- Fix: Custom Avatar was despawning when not in multi-user session (added `dontDestroy` flag to PlayerState)
- Fix: USDZExporter without WebXR component in scene does now again create quicklook button
- Fix: Bug in Avatar where assigning head or hands objects would cause errors
- Fix: Hide XR buttons during running session
- Fix: Bump threejs version to fix OrbitControls not handling `pointerup` if it doesnt happen over the passed in target element
- Change: NeedleXRController does now not emit `pointermove` event every frame but only when above a set position/rotation threshold
- Change: time.smoothedFPS is now smoothed over 60 frames
- Change: loaded GLB name in loading overlay is now less technical
- Change: static `NeedleXRSession.onXRStart` is now `onXRSessionStart`
## [3.32.15-exp] - 2024-02-06
### Needle Engine
- Fix: Hands rendering on visionOS
- Fix: NeedleXRController now supports pinch gesture and emits pinch event for devices that don't properly implement the WebXR API and don't invoke the `selectstart` events (e.g. visionOS)
- Fix: USDZExporter should not use `doubleSided` for skeletal meshes
- Fix: safeguard against null reference error in DragControls.alignManipulator
- Fix: Gizmo labels being raycastable
- Fix: Gizmo cache stopped working due to wrong `isDestroyed` check
- Fix: Error caused by Canvas UI when starting XR session
- Fix: `onPointerEnter` and `onPointerExit` is not called for all controllers
## [3.32.14-exp] - 2024-02-04
### Needle Engine
- Add: Renderer `sharedMeshes` property to easily access all mesh objects that belong to the renderer
- Fix: WebXRController ray rendering frame delay
- Fix: Avoid WebXRHand model sometimes not being properly cleaned up
- Fix: minor console.log fixes
### Unity Integration
- Fix: compiler error on windows
## [3.32.13-exp] - 2024-02-03
### Needle Engine
- Add: AudioSource `preload` property
- Fix: BoxCollider now automatically detects changes on `scale` property and updates underlying physics engine collider size
- Fix: error in mobile VR touch (without physical controllers)
- Change: Calls to `instantiate` now don't accept a null or missing object to instantiate anymore
- Change: Rigidbody component now updates underlying physics properties immediately when dirty before invoking `applyForce()` or `applyImpulse()`
### Unity Integration
- Add: AudioSource `preload` property
- Change: Samples Window now shows installed version
- Change: Warn if installed samples are out-dated or not supported with the current Needle Engine version
## [3.32.12-exp] - 2024-02-01
### Needle Engine
- Fix: ParticleSystem modifying assigned material instance in some cases
- Fix: PostProcessing DepthOfField effect api change in `postprocessing` package
- Fix: nextjs production builds with needle-engine
- Fix: `input.addEventListener` for key events stopped working
- Fix: issue in physics async draincollision callback sometimes failing when objects were already destroyed
- Fix: WebXR controller and hand models should not be destroyed with the XRRig
- Change: WebXR on non-secure connections now shows warning and button for WebAR and WebVR are disabled
### Unity Integration
- Add: Support for Build Window `preview` build button for nextjs projects
- Add: nextjs template to templates dropdown
- Fix: issue where tools project generation ran multiple times
## [3.32.11-exp] - 2024-01-30
### Needle Engine
- Add: various more documentation comments
- Add: NeedleXRController now exposes gripspace [`linearVelocity`](https://developer.mozilla.org/en-US/docs/Web/API/XRPose/linearVelocity)
- Fix: input event causing error due to missing pointerId
- Fix: DragControls not checking if an event was already used
- Fix: EventSystem calling input event methods on disabled components
- Change: Calculate worldspace data only once per frame in NeedleXRController
### Unity Integration
- Add: expose collider [membership and filter group](https://rapier.rs/docs/user_guides/javascript/colliders#collision-groups-and-solver-groups) options
- Fix: prevent rare error caused by empty/missing entries in UnityGLTF plugins
## [3.32.10-exp] - 2024-01-30
### Needle Engine
- Add: XRControllerFollow option to follow gripspace or rayspace
- Fix: ParticleSystem trail not rendering if assigned material culling was set to front
- Fix: ParticleSystem incorrect InheritVelocity when creating a new instance
- Fix: NeedleXRController index in NeedleXRSession.controllers array now matches the `NeedleXRController.index` (the index of the inputdevice)
- Change: `?stats` url parameter now also shows FPS in WebXR session
- Change: `this.context.xr` now contains the whole type information
## [3.32.9-exp] - 2024-01-29
### Needle Engine
- Add: various more documentation comments
- Add: pointer events now expose `pressure` property
- Fix: `pointerCapture` now works with all buttons
- Fix: raycast call did not skip hidden objects
- Fix: XRController hit rendering does now skip SkinnedMeshes for performance reasons
- Change: touchup did emit `onPointerExit` every time, it now only happens if the touch hits another object (or none)
- Change: `pointerId` now is a unique id generated from device-index + button-index, input events now also expose a `deviceId` property
- Change: EventSystem optimization for skipping raycast for e.g. `pointermove` event on objects that don't have a component that implements the `onPointerMove` method
## [3.32.8-exp] - 2024-01-29
### Needle Engine
- Fix: AudioSource error when creating three's PositionalAudio object where GameObject was missing
- Fix: Collider center offset being falsely applied resulting in wrong object placement
- Fix: Physics debug visualization should be updated in post physics step fixing a visual frame delay
- Fix: WebXR AR/VR buttons are now always created
## [3.32.7-exp] - 2024-01-28
### Needle Engine
- Add: first version of `setPointerCapture` and `releasePointerCapture` that acts similarly to [HTML pointer capture](https://developer.mozilla.org/en-US/docs/Web/API/Element/setPointerCapture) and can be used to receive onPointerMove events when the pointer has left the object until it is either released or `onPointerUp` happens (this currently only works with the primary button)
- Fix: Remove console.log in `instantiate` call
- Change: used pointer events will still be propagated to all components
- Change: reduce default Gizmos.Label size
### Unity Integration
- Fix EditorSync, bump dependency
- Change: EditorSync editor now shows warning if `Auto Compress` for local development is enabled. With compression the required extensions that are only used for development are stripped and therefore `Auto Compress` needs to be enabled while using Editor Sync.
## [3.32.6-exp] - 2024-01-27
### Needle Engine
- Fix: `AssetRefernence.instantiate` does now clone instantiate options before awaiting asset loading
- Fix: `onPointerMove` event was not being called in XR
- Fix: Timeline paused but evaluated should still start audio playback e.g. when controller through scroll
### Unity Integration
- Fix: avoid call to `SessionState.GetBool` on other threads when generating the tools project
## [3.32.5-exp] - 2024-01-26
### Needle Engine
- Fix: issue where `onEnterXR` callback was possibly not being invoked on all scripts if a script was removed or deleted during onEnterXR (and the underlying array was modified) causing e.g. the CollaborativeSandbox AR placement to not work
- Fix: minor issue where controller ray visualization would not respect rig scale
## [3.32.4-exp] - 2024-01-26
### Needle Engine
- Add: NeedleXRSession `fadeTransition()` that can be used to cover teleportation. It returns a promise that is resolved when fade to black has completed
- Fix: error in next template caused by wrong internal imports
- Fix: WebXR should not show quicklook button when `useQuicklookExport` is disabled
- Change: debug mobile console now also captures errors at load time, mobile console shows automatically on quest browser (for local development)
## [3.32.3-exp] - 2024-01-26
### Needle Engine
- Add: `origin` field to NEPointerEvent which references the object that raised the event (e.g. the XRController)
- Add: `delayForFrames(numOfFrames)` util method returning a promise that will resolve after the given amount of frames (equivalent to `delay` which will take a time in milliseconds)
- Fix: prevent access to geometry of a destroyed mesh in physics call
- Fix: AR passthrough placement with controllers
- Fix: issue where AR could not be started twice
- Change: AR placement fallback to camera placement if controller hit-test is not available (e.g. when using Quest simulator)
## [3.32.2-exp] - 2024-01-26
### Needle Engine
- Add: expose options to disable XRController rays, hit points and teleport on the XRControllerMovement component
- Add: NeedleXRController `emitEvents` to disable input events for controllers
- Fix: Cases where XRController button `isDown` and `isUp` wasn't updated for `primary` and `squeeze` buttons.
- Change: WebXRButton container zIndex is now 5000
### Unity Integration
- Fix: DefaultAvatar hands model
- Change: XRControllerMovement minimal turn angle is no 0 to disable rotation
- Change: ComponentGenerator.debug will now include more information regarding node.js not being found
- Change: ComponentGeneratorRunner will now use session state for determining if node is installed
- Change: Bump EditorSync package dependency to `2.0.2-beta`
## [3.32.1-exp] - 2024-01-25
### Needle Engine
- Add: NeedleXRController `getButton()` now returns an enhanced GamepadButton object which contains bools for `isUp` and `isDown`
- Add: Access to NeedleXRSession via `this.context.xr`
- Fix: XR lifecycle issue where script became inactive during onEnterXR
- Fix: XR Avatar component for synchronization should not log an error when not connected to networking backend
- Fix: XR renderOnTop option for worldspace UI
- Fix: XR screenspace UI should not render for now
- Fix: change event argument for `space` (input in 3D space) is now of type `IGameObject` to expose `worldPosition` etc
- Fix: `offerSession` should request AR mode when only `showAR` button is enabled in WebXR component
- Change: calls to `instantiate(prefab, {})` can now be invoked with anonymous options object as second parameter, for example `instantiate(prefab, { parent: myParent })`
- Change: the SyncTransform component does now automatically throttle `fast` mode (reducing the frequency of updates) when running on the glitch backend and when having set more than 10 components to `fast`
## [3.32.0-exp] - 2024-01-24
### Needle Engine
- Add: new **Needle WebXR** system
- Core component event methods give much easier access to the XR system (e.g. `onEnterXR` or `onXRControllerAdded`)
- Easy access to XRSystem data like `gripWorldSpace` or controller buttons using the `NeedleXRController` class
- Default functionality like movement, teleport and rendering of controllers or hands is now encapsulated in separate components that can easily be enabled or disabled or overriden.
- All XR input events now go through the event system and can be received on components using the input event methods (like `onPointerDown`)
- Support for `offerSession` for QuestBrowser
- Support for new `depth-sensing` in Quest pass-through mode
- Add: much improved `DragControls` offering different modes for screen and XR interaction, snapping or XR distance grab
- Change: **Update three.js to 0.160**
- Change: pointer events don't need the `IPointerEventHandler` interface anymore - they're now already available on the core `Behaviour` class via e.g. `onPointerDown`
- Change: for networked avatars add a `PlayerState` and a `Avatar` component to your avatar prefab
### Unity Integration
- Add: `UnityEngine.TextAsset` references will now be copied to the output directory
- Change: update Needle Engine to the new XR system
## [3.31.0] - 2024-01-23
### Needle Engine
- Fix: `isDesktop()` util method should return false on iPad
### Unity Integration
- Bump Editor-Sync dependency fixing issue with changed engine API
- Change: update button now warns when updating to a pre-release version
## [3.30.0] - 2024-01-18
### Needle Engine
- Add: VideoPlayer `preload` method to start loading the video file without having to start playback
- Add: VideoPlayer support for m3u8 video stream format (set the mode to URL and assign the video streaming url)
- Add: SceneSwitcher `autoLoadFirstScene` option
- Add: `this.context.connection` now has a getter for current websocket url
- Add: USDZExporter option to set max texture size
- Fix: SceneSwitcher should not load it's own scene again causing recursive loading
- Fix: Gizmo lines being culled sometimes
- Fix: Gizmo parented to another object should not be returned to cache if it got destroyed while being rendered (e.g. Gizmo.Label)
- Fix: prevent destroyed component from being added to an object again
- Change: Physics.raycast does now ignore lines by default (you can pass in a custom line threshold >= 0 to override that)
### Unity Integration
- Fix: Add guarding against trying to reference the root web project scene from a referenced sub-scene
- Fix: Exception when calling FindObjectOfType from different thread
- Change: Custom Shader setting is now at the top of a material
- Change: Update UnityGLTF to [2.8.1-exp](https://github.com/prefrontalcortex/UnityGLTF/blob/dev/CHANGELOG.md#281-exp---2024-01-18)
## [3.29.0] - 2024-01-08
### Needle Engine
- Add: `isDesktop` util method
- Add: physics engine now has `debugRenderRaycasts` boolean or `debugraycasts` url parameter to visualize raycasts
- Fix: issue where Gizmos would be rendered for more than one frame or the expected time
- Fix: issue in physics engine `sphereOverlap` where dynamic rigidbodies would not be captured
- Change: more stable guid generator on initial scene load
- Change: Collider `membership` and `filter` can now be undefined for default collision groups (all enabled)
- Change: `Collider.filter` is now set to undefined to include all groups in the filter (allow collision with all groups)
- Change: vite meta plugin to write secure url
### Unity Integration
- Fix: DeployToGithubPages now correctly opens github pages url for `.git` urls
- Bump UnityGLTF to 2.7.1-exp
## [3.28.8] - 2024-01-04
### Needle Engine
- Fix: pre-bundled version should contain Needle Engine version
- Change: generate component guids based on original guid for initial scene load per component for more stable guids across local and deployed versions and where the order of components in the scene will not affect the guid for components anymore
### Unity Integration
- Change: improve editor typescript link rendering, labels are displayed with higher contrast and the package where a typescript file is located is now always displayed
## [3.28.7] - 2024-01-02
### Needle Engine
- Add: SceneSwitcher `progress` event, `currentLoadingProgress` and `currentlyLoadingScene` properties exposing loading progress. Passing `sceneSwitcher` instance as first argument to `sceneOpened` callback
- Fix: Creating the renderer should not modify the static `Context.DefaultWebGLRendererParameters`, this caused multipage sites to not find the correct canvas anymore (e.g. causing sveltekit sample to not work anymore when changing back and forth between pages)
### Unity Integration
- Add: `Custom Template` option when creating a new web project allowing to just paste in a github url to pull the project from
- Fix: Preview Build should not open localhost url `/true`
- Fix: Build Window Deployment buttons
## [3.28.7-beta.1] - 2023-12-30
### Needle Engine
- Fix: Revert AnimatorController condition evaluation change
## [3.28.7-beta] - 2023-12-30
### Needle Engine
- Fix: Issue in AnimatorController evaluation of bool condition where the threshold wasnt taken into account (e.g. only making a transition if a bool parameter was set to false)
## [3.28.6-beta] - 2023-12-30
### Needle Engine
- Add: EventList serialization can now have multiple arguments allowing support for e.g. `setBool` on Animator component being called from a Button directly
- Add: Animator `toggleBool` method
- Fix: Issue where destroying an object in `onCollisionEnter` it would not be removed from the physics event queue and result in `onCollisionStay` being called with an already destroyed component
- Fix: Rigidbody matrix changed watcher should ignore events during physics to threejs synchronization
- Fix: Set gizmos renderOrder to be always rendered last to avoid cases where gizmos are hidden due to custom renderOrder on scene objects
### Unity Integration
- Fix: Issue where codegen would produce invalid type registration code when the typescript class would not contain any space after the name
- Improve DeployToFTP logging an error when the tools package could not be found
## [3.28.5-beta] - 2023-12-22
### Needle Engine
- Fix: WebXRController falsely triggering click in EventSystem
### Unity Integration
- Fix: Timeline window opened during export for evaluation should now be automatically closed again
## [3.28.3-beta] - 2023-12-21
### Needle Engine
- Fix: Issue in pointer events not triggering onPointerEnter and Exit in VR
- Remove: warning log in USDZ export about double sided materials not being supported
### Unity Integration
- Fix: Issue where incomplete types information was generated for the component compiler
- Fix: Issue regarding generics in typescript types not being parsed correctly by Unity
## [3.28.2-beta] - 2023-12-20
### Needle Engine
- Add: Support double sided material export for USDZ
- Fix: `PlayAudioOnClick` when explicit clip is given, use loop from attached audio source
- Change: Improve Everywhere Action `SetActiveOnClick`
### Unity Integration
- Change: On OSX local server now also starts in external terminal window
## [3.28.1-beta] - 2023-12-18
### Needle Engine
- Add: `context.recreate` to destroy the whole scene and reload everything (including all script instances)
- Fix: issue where EventSystem pointer events would not be received anymore if the event component was on e.g. an empty object in the parent hierarchy
## [3.28.0-beta] - 2023-12-14
### Needle Engine
- Fix: USDZ: `emissiveIntensity` was not applied and `emissiveColor` wasn't used for scale/bias properly
- Fix: USDZ: compressed textures with alpha channel were not being read back correctly
- Change: USDZ: bake `effectiveOpacity` into the opacity texture if needed, since QuickLook/usdview don't support `.a` scale values
- Change: Bump UnityGLTF version to 2.6.0-exp to support GPU Instancing on imported glTF materials
### Unity Integration
- Add: enable GPU instancing support for custom shaders
- Fix: prevent NullRef in `TextureImportSettings`
## [3.27.5-beta] - 2023-12-12
### Needle Engine
- Fix: Offscreencanvas support for iOS 16.x
- Fix: `PlayAudioOnClick` now respects playOnAwake if an explicit audio source is assigned
- Change: `EventSystem` should only check objects if they're meshes
## [3.27.4-beta] - 2023-12-11
### Needle Engine
- Fix: instancing now updating bounds in Needle Engine before render callback if necessary
- Change: expose `onPauseChanged` on components
- Change: handle case where a added coroutine function is not a coroutine (Generator)
### Unity Integration
- Change: clean install only stops certain node processes
## [3.27.3-beta] - 2023-12-09
### Needle Engine
- Add: `InstancingUtil.getRenderer` to get the three InstancedMesh for any Object3D (if it's using instancing)
- Add: instancing does now automatically update culling bounds if it's dirty. This can be disabled via `InstancingUtil.setAutoUpdateBounds(obj, false)`
- Add: Rigidbody method documentation
- Add: `ParticleSystem.addBehaviour` method and expose underlying particle system. We now also export the particle types
- Fix: Issue where `this.physics.raycastFromRay` was modifying the default raycast options
- Fix: Issue where sprites would be falsely interpreted as builtin sprite causing the image to be not displayed correctly
- Change: `this.physics.raycast()` can now be called with anonymous options (instead of having to use a `RaycastOptions` class), for example `this.physics.raycast({ray:myRay})`
### Unity Integration
- Fix: npmdef component generation with abstract classes
## [3.27.2-beta] - 2023-12-08
### Needle Engine
- Fix: don't set font on `<needle-engine>` host styles to prevent leaking into child elements
- Fix: `AssetReference.loadAsync` being called multiple times should always return the `asset` result
- Change: register OrbitControls events on the canvas and not the needle engine element to allow child HTML objects to capture input
### Unity Integration
- Fix: error when saving scene without a Needle Engine component
- Fix: resolve symlinks when opening vscode workspace on windows for VSCode to correctly suggest imports when editing code that is installed by local file path
- Fix: reduced FileWatcher count for OSX where this caused issues in mono
- FIx: minor editor UI layouting issues in ExportInfo and BuildWindow on OSX
- Change: re-generate component compiler types more frequently
## [3.27.1-beta] - 2023-12-06
### Needle Engine
- Add `addCustomExtensionPlugin` API to register custom glTF importer and exporter extensions
- Fix: issue where instanced and animated object was rendered for one frame with a wrong matrix
- Change: expose `imageToCanvas` method from USDZExporter
- Change: GltfExporter component does not cache exporter anymore and expose all exporter options
### Unity Integration
- Fix: Welcome Window `ShowWindowAtStartup`
- Change: validation of lightmap encoding is now only displayed when lightmaps are being used
- Internal: Npmdef peerDependencies are now automatically set to local package for development
## [3.27.0-beta] - 2023-12-04
### ⭐ Highlights
#### **Skinned Mesh support for USDZ export**
Our runtime USDZ export now supports skinned meshes and animations. This allows you to export animated characters to USDZ for AR on iOS/visionOS devices. Additionally, we're now handling animator state transitions much smarter on export, leading to improved consistency between browser runtime and QuickLook.
### Needle Engine
- Add: USDZ: skinned mesh export, including animations
- Add: USDZ: ability to specify if we're exporting for QuickLook or not
- Add: USDZ: animation export respects basic root motion (translation and rotation)
- Add: USDZ: `USDZExporter` API supports exporting binary buffer similar to `GLTFExport` API
- Fix: USDZ: correct `defaultPrim` encapsulation so that it also contains materials
- Fix: USDZ: render texture readback failure when exporting
- Fix: `ISceneEventListener` only being found when first component
- Fix: error in vite plugin facebook instant games if no config would exist
- Fix: Gizmo label padding and border radius were not properly applied when re-using label
- Change: USDZ: animation export now automatically includes Animator states
- Change: USDZ: `PlayAnimationOnClick` now automatically uses Animator state logic to determine looping and continuation of animation (what happens after the specified animation has finished playing)
- Change: USDZ: current animator states are exported as `PlayAnimation` on scene start
### Unity Integration
- Change: USDZ `PlayAnimationOnClick` loop state and next state are now implict
## [3.26.2-pre] - 2023-11-28
### Needle Engine
- Add physics NaN safeguards to avoid invalid rapier data propagating through three objects
## [3.26.1-pre] - 2023-11-27
### Unity Integration
- Add warning label to experimental components
### Needle Engine
- Add: information about mouse button, hit point, hit normal, hit distance to `PointerEventData`
- Fix: EventSystem regression where UI events stopped working
## [3.26.0-pre] - 2023-11-27
### Unity Integration
- Add: option to ExportInfo to automatically compress local exports (enabled by default)
- Change: Improve first time installation
- Change: Clean install now also deletes tools package
- Change: Update scene templates
### Needle Engine
- Fix: LOD update frame delay
- Change: EventSystem optimization to avoid raycasting objects without event receiver components
## [3.25.5] - 2023-11-24
### Unity Integration
- Add `DeployToFacebookInstantGames` component
- Add `Open Build Window` button to ExportInfo and Needle Engine Settings
- Change: Show warning if Needle Engine TextueSettings MaxSize can not be applied because the texture is already imported at a lower resolution
### Needle Engine
- Add: vite plugin for facebook deployment
- Fix: Physics collider center being not applied correctly with rotated parent
## [3.25.4] - 2023-11-23
### Unity Integration
- Add: Button to open Build Window settings with Needle Engine target selected to ExportInfo component
- Fix: ComponentCompiler should not generate types in UnityEditor namespace
- Bump Needle Engine version
### Needle Engine
- Add: `onInitialized(ctx => {...})` and `onBeforeRender` event functions
- Add: `Camera.cullingLayer` property
- Fix: Physics collider center being modified causing rapier runtime error
## [3.25.3] - 2023-11-23
### Unity Integration
- Bump Needle Engine version
### Needle Engine
- Add: `onStart((ctx)=>{})` and `onUpdate((ctx)=>{})` functions API
- Fix: AudioSource not starting autoplay anymore after registered user interaction (which is necessary to playback audio in the browser)
- Fix: `TransformGizmo` component not working as expected anymore since it also defines `worldPosition`
- Change: Improve performance for colliders without rigidbody to not create an implicity rapier rigidbody anymore
## [3.25.2] - 2023-11-20
### Needle Engine
- Add: `worldForward`, `worldRight` and `worldUp` to Object3D and GameObject types
- Add: `getTempVector` utility method that has a circular array of vector3 instances for re-use
- Fix: ImageTracking hysteresis for images to stay visible during bad tracking for up to a second after tracking has been lost
## [3.25.1] - 2023-11-15
### Unity Integration
- Change: Minor project validation window and menu item changes
- Bump Needle Engine dependency
### Needle Engine
- Add: getters and setters on Object3D and GameObject types for `worldPosition`, `worldRotation`, `worldQuaternion` and `worldScale`
- Fix: ImageTracking now has hysteresis for how long to keep a tracked object visible before disabling it (if tracking is lost just for a few frames)
- Fix: Catch and log exception in rapier during collider creation
- Change: WebXRImageTracking objects that are already present in the scene are now hidden when entering WebXR/AR
## [3.25.0] - 2023-11-15
### Unity Integration
- Add: ObjectRaycaster expose option to ignore skinned mesh renderers
- Add: project setup validation window and improve first installation UX
- Change: Improve OrbitControls inspector and expose methods to pass in camera position or look target from Unity events
### Needle Engine
- Add: `Mathf.easinOutCubic` utility method
- Add: ObjectRaycaster expose option to ignore skinned mesh renderers
- Fix: detecing website interaction to allow playing audio before any component or audio component has been loaded
- Fix: Physics capsule height creation
- Fix: WebXRImageTracking not hiding tracked objects after tracking has been lost
- Change: Improved ContactShadows component
- Change: Improve OrbitControls for smoother lerping. Add methods to set camera position and look at target by passing in an Object3D reference.
- Change: PlayAudioOnClick does now create an AudioSource implictly if non is assigned
- Change: EventSystem does ignore SkinnedMeshRenderers by default now
- Change: WebXR reticle is now hidden when image tracking starts
## [3.24.0] - 2023-11-15
### Unity Integration
- Fix: issue where font naming didn't match casing of file on disc causing fonts not being found at runtime
- Change: add additional logs to license `Refresh` button
### Needle Engine
- Fix: Everywhere Action material otherVariants was not cleared between behaviour generation
- Fix: Everywhere Action Change Material loosing track of the target material
- Fix: issue where SpatialTrigger calling AudioSource.play doesnt work because of wrong argument
- Fix: text linebreak in USDZ
- Fix: material bindings API for Preliminary_Text and don't apply material when no geometry is found
- Fix: material assignments for USDZ text and fix color space
- Fix: Capsulecollider height
- Fix: Core networking issue where throwing callbacks would silently be ignored and causing not all callbacks being called
- Fix: PlayerSync `owner-changed` being raised twice
- Fix: PlayerSync unsubscribe from UserLeftRoom event once the player is leaving/has left
- Fix: Catch exception in creating `new type()` during deserialization of animationclip if the clip is just a string and could not be resolved because it's missing, falsely serialized or annotated
- Change: OnClick Everywhere Actions now ensure they have a raycaster component assigned or in parent hierarchy
- Change: Everywhere Action PlayAnimationOnClick remove target field
## [3.24.0] - 2023-11-13
### Unity Integration
- Add: Timeline AudioTrack now exports volume per track
- Add: `RigidbodyData` component to expose `autoMass` toggle to Unity
- Add: ContactShadows component
- Fix: Timeline infinite animationclip should serialize pre- and post extrapolation
- Change: Bump UnityGLTF version to 2.5.2-exp to support camera backgroundColor animation
### Needle Engine
- Add: ContactShadows component
- Add: `Gizmos.DrawLabel`
- Fix: issue with AnimatorController behaviour when using loop and cycle offset
- Fix: error when loading component with missing AnimatorController field
- Fix: use correct colorspace for UI components
- Fix: loading of remote GLB and `skybox-image` url where default camera should set clearflags to skybox
- Fix: Various colorspace issues fixed
- Change: USDZ export `imageToCanvas` now uses OffscreenCanvas for improved performance
- Change: Update pmndrs postprocessing package to 6.33.3 to fix SSAO not working on mobile android
- Change: `ObjectUtils.createPrimitive` so all primitives use the same settings
## [3.23.1] - 2023-11-09
### Unity Integration
- Fix: regression where AnimatorController could not be used on multiple objects anymore introduced in last version
- Change: menu item `Setup Scene` now creates scene without extra `GltfObject` component since this actually not needed anymore
### Needle Engine
- Add: `Gizmos.DrawLabel` method
- Add: `LookAtObject` utils method with options to keep upwards direction and copying target rotation to stay screen aligned
- Fix: WebXRPlaneTracking dispose old mesh data properly, heuristically determine if a shape should be convex or not
- Fix: AudioSource `play` not working anymore if called without parameters
- Internal: rapier meshcolliders now use convexHull instead of convexMesh, the latter already expects the input data to be convex
## [3.23.0] - 2023-11-08
### Unity Integration
- Add: AnimatorController cycle offset and speed export settings per state
- Change: AnimatorController can now be referenced from custom scripts and properly exported
- Change: Bump UnityGLTF version to fix issues related to animation export and exporting glTF files via context menu that reference EXR textures (which were previously exported using a wrong encoding causing errors at runtime)
- Remove: csharp to typescript package dependency
### Needle Engine
- Add: support for changing animatorcontroller at runtime
- Add: AnimatorController support for cycle offset and speed being used from parameter (or fixed serialized value)
- Add: `OrbtiControls.allowInterrupt` property that can be set to false to prevent animation to a target point or autoRotate being interrupted by user input like clicking or dragging
- Add: Physics collision now includes tangent vector for contact points
- Add: Physics exposes API for getting the object velocity per collider (`context.physics.engine.getLinearVelocity`)
- Add: Physics Material can now be updated at runtime. Call `updatePhysicsMaterial` on the collider with the changed physics material
- Fix: scaled capsule collider being created with wrong size
- Fix: timeline audiotracks not respecting speed property on PlayableDirector (effectively being cut-off instead of being played back at another speed/playbackRate)
- Fix: Prevent using XRAnchor on Quest in AR mode (pass-through)
- Fix: Timeline evaluate is now done in lateUpdate which gives animated objects time to apply the changed data (e.g. OrbitControls where the target object may be animated)
- Fix: Timeline Audio tracks do not require AudioListener in scene anymore
## [3.22.6] - 2023-11-06
### Unity Integration
- Fix: Linked Npmdef issue where the local npm package wasnt removed correctly from the web project
- Fix: compilation warnings and errors on 2020.x
### Needle Engine
- Change: work on approximated transmission export in USDZ
## [3.22.5] - 2023-11-03
### Unity Integration
- Fix: drag linked npmdef into ExportInfo dependencies array
- Fix: skybox resolution editing in component
## [3.22.4] - 2023-11-03
### Unity Integration
- Fix: npmdef string comparison not working in some cases in Unity 2022.3
- Fix: Opening npmdef directory when the directory didnt contain a vscode workspace file
- Change: Show licence type in Needle Engine headers
### Needle Engine
- Add: Option to WebXRControllers to disable default controls (`enableDefaultControls`) and raycasting (`enableRaycasts`)
- Fix: AnimatorController transition with exitTime and trigger didnt work since trigger was reset before transition could be made
- Fix: USDZExporter isssue where compressed textures always ended up as JPG after decompression since format check was only checking for RGBAFormat, now also checks for compressed formats
- Change: catch and display unhandled exceptions during creation of engine, make sure bubble messages are on top of loading overlay
- Change: USDZExporter should re-use renderer
## [3.22.3] - 2023-11-02
### Unity Integration
- Fix: issue where externally linked npmdef could not be added to ExportInfo dependencies in some cases
- Fix: issue where creating a linked npmdef did cause AssetDatabase warnings
- Change: show warning in ExportInfo footer if toktx wasnt found
### Needle Engine
- Add: Coroutine can now yield on promise and wait for the promise to be resolved
- Fix: CharacterController not being grounded on mesh collider
- Fix: ShadowCatcher set to additive mode didnt work anymore
## [3.22.2] - 2023-11-01
### Unity Integration
- Change: Linked npmdef creation improved UX
### Needle Engine
- Add: Optional `RectTransform.minWidth` and `RectTransform.maxWidth`
- Fix: GameObject instantiate should clone color objects (to not share instance)
- Fix: Call to `parseSync` with full url argument now correctly passes base url to three GLTFLoader for resolving external resources
- Change: PhysicsMaterial properties are now all optional (e.g. so we can set only friction)
- Change: `Rigidbody.setForce` to take a vec3
- Change: `AudioSource.onDisable` should pause not stop
- Change: `Mathf.random(<min>?, <max>?)` now takes optional min and max parameters
## [3.22.1] - 2023-10-30
### Unity Integration
- Bump Needle Engine version
### Needle Engine
- Fix: `Screencapture.autoconnect` when already connected to networking server or connection is in progress / window selection is currently open
- Change: when `isManagedExternally` is enabled then framerate is user controlled and not automatically clamped
- Change: add more documentation to networking methods
## [3.22.0] - 2023-10-26
### Unity Integration
- Change: Attempting to export unsaved scene stops export now
### Needle Engine
- Fix: SyncedCamera deserialization warning
- Change: Collider property updates now trigger rigidbody mass recalculation immediately (if set to auto-mass)
- Change: Rigidbody methods now take Vec3 object as well as arguments like `{x:0, y:1, z:0}`
- Change: Improve Screencapture
- Change: Screencapture now also allows `Microphone` as input device
- Change: Updated VOIP script and removed old VOIP implementation - it now uses the same underlying codebase as screencapture
- Change: Update imports to use `type` where appropriate
## [3.21.5] - 2023-10-25
### Unity Integration
- Change: Allow using Node 20 LTS (currently showing a warning)
### Needle Engine
- Fix: remove leftover console.log
- Fix: Hovered button should reset pointer state when destroyed
- Fix: WebXR Rig parenting in VR when switching scenes
- Fix: Timeline activation track not properly evaluating when timeline is paused and manually evaluated from user code
- Fix: Sphere Collider radius not being set correctly
## [3.21.3] - 2023-10-23
### Unity Integration
- Bump Needle Engine version
### Needle Engine
- Fix: Issue where Chrome touch emulation caused "onPointerClick" being called twice per click
- Fix: EventList instances are now not shared anymore between components created via `instantiate`
- Fix: Regression where SphereCollider radius was not being applied
## [3.21.2] - 2023-10-23
### Unity Integration
- Fix: npmdef references should properly update itself when the npmdef path or name of the package have changed
### Needle Engine
- Change: Expose EventList subscriber count
- Change: `PointerEventArgs.use()` should not stop propagation
## [3.21.1-pre] - 2023-10-20
### Unity Integration
- Bump UnityGLTF dependency to 2.5.0
- Bump helper package to get meshopt compression fix for animation (requires Needle Build Pipeline 1.3.1)
- Fix: False export where GltfObject was *not* in the root scene hierarchy *but* somewhere on a child object
- Fix: Double click on SampleInfo should not attempt to open immutable scene asset (which is not allowed) but instead handle the regular `Open Sample Scene` event to correctly open the sample
### Needle Engine
- Add: Multitouch support on `input` events, our EventSystem implementation now handles multitouch cases and is using the browser events directly and immediately (before events via `window` where deferred and hanlded during the engine update loop)
## [3.21.0-pre] - 2023-10-19
### Unity Integration
- Add: WebXRSessionRoot preview feature option to enable touch controls for drag, scale, rotate in AR
- Bump Needle Engine version
### Needle Engine
- Add: support for translate, rotate and scale of AR scene on android devices (needs `WebXRSessionRoot.arTouchTransform` set to true right now)
- Add: `SphereCollider.radius` and `BoxCollider.size` updates at runtime are now automatically propagated to the physics engine updating the physics shapes. Additionally the object scale for SphereCollider objects is watched and automatically applied on change
- Fix: removal of all colliders on an object now also fully cleansup the implictly created RigidBody
- Change: `Context.isManagedExternally` can now be set at runtime as a first step towards allowing complete external control over the Needle Engine lifecycle loop in cases where Needle Engine scenes or components are mixed with an external three.js scene (and projects that require more explicit control)
## [3.20.3] - 2023-10-18
### Unity Integration
- Add: UI to settings to refresh license
- Change: Improve displayed information when nodejs is not found or installed
- Bump Needle Engine version
### Needle Engine
- Add: Expose Rapier dominance group option on Rigidbody
- Fix: Ignore root motion when animator weight is <= 0 due to Timeline playing
- Fix: Rapier race condition caused by dynamic loading
- Change: Allow setting Rigidbody mass explictly now by either setting `autoMass` to false or by setting the `mass` property
## [3.20.2] - 2023-10-17
### Unity Integration
- Fix: path for tools package not being found in some cases
- Fix: 2020 compiler errors
- Change: Make it more obvious in cases where samples can not installed and why
- Change: Remove 2020 from recommended Editor versions in samples window
### Needle Engine
- Fix: renderer access nullreference exceptions caused by deferred initialization
- Fix: disabling postprocessing now restores renderer clear state (which got disabled by the postprocessing package)
- Fix: disable generating WebXRPlane tangents
## [3.20.1] - 2023-10-16
### Unity Integration
- Fix: license check sometimes not working correctly
- Change: Improve error message when trying to export unsaved scene
### Needle Engine
- Change: `addComponent` can now take component instance or type
## [3.20.0] - 2023-10-13
### Unity Integration
- Add options for mesh tracking to `WebXRPlaneTracking` component
### Needle Engine
- Fix: issue where physics colliders where not yet fully initialized in `start` event
- Fix: Pointer delta while cursor is locked
- Change: Expose `context.phyiscs.engine.world` and `context.physics.engine.getComponent` method to directly work with rapier physics engine and to easily get access to Needle Engine components from rapier colliders
- Change: Expose `Context.DefaultWebGLRendererParameters` that can be modified in static context before renderer is created
## [3.19.9] - 2023-10-11
### Unity Integration
- Bump Needle Engine version
### Needle Engine
- Change: `AnimatorController.createFromClips` now sets the state hash to index of clip
- Fix: AnimatorController root motion direction when runtime instantiating and using the same clip on multiple objects
- Fix: AnimatorController root motion forward direction when rotating object from script as well
## [3.19.8] - 2023-10-10
### Unity Integration
- Add: Animation component export for clips array
- Bump Needle Engine version
### Needle Engine
- Add: `AnimatorController.createFromClips` utility method taking in a animationclips array to create a simple controller from. By default it creates transitions to the next clip
- Fix: occasional issue where the scrollbar would cause flickering due to hiding/showing when the website was zoomed
- Fix: screenshot utility method respecting page zoom
- Fix: vite dependency watcher plugin running installation if dependency in package.json would change
- Fix: Animator root motion working with multiple states, clips and transitions
## [3.19.7] - 2023-10-04
### Unity Integration
- Add: OrbitControls `enableRotate` property
- Change: LODGroup export in correct format and fix issue with last LOD not being used in cases without a "Cull" state
### Needle Engine
- Add: OrbitControls `enableRotate` property
- Fix: LODGroup not using last LOD in cases where the last LOD is never culled
- Fix: PostProcessing EffectStack correctly ordered when using N8 Ambient Occlusion (together with Bloom for example)
- Fix: Postprocessing N8 should not modify gamma if it's not the last effect in the stack
- Fix: AudioSource does now create an AudioListener on the main camera if none is found in the scene
- Change: VideoPlayer does fallback to clip if src is empty or null
- Change: OrbitControls now expose `enableRotate` property
- Fix: web component font import
## [3.19.4] - 2023-09-29
### Unity Integration
- Bump Needle Engine version
### Needle Engine
- Fix: Remove leftover OrbitControls log
- Change: Timeline TrackModel `markers` and `clips` fields are now optional
- Change: VideoPlayer is set to use url as default video source (if nothing is defined)
## [3.19.3] - 2023-09-28
### Unity Integration
- Bump UnityGLTF dependency to `2-4-2-exp` which fixes export for root level objects marked as `EditorOnly`
### Needle Engine
- Fix: regression in OrbitControls without lookat target assigned
- Fix: progressive textures loading with custom reflection probe
- Fix: WebAR touch event screenspace position using `this.context.input`
## [3.19.2] - 2023-09-27
### Unity Integration
- Add: OrbitControls `autoFit` property
- Fix: Error when creating a FTPServerAsset in Unity 2022.3
### Needle Engine
- Add: OrbitControls `autoFit` property
- Add: API to access underlying Rapier physics body using `context.physics.engine.getBody(IComponent | IRigidbody)`
## [3.19.1] - 2023-09-27
### Unity Integration
- Add: ParticleSystem now supports HorizontalBillboard and VerticalBillboard
- Fix: exception in ComponentGenerator when clicking `regenerate components` in npmdef without ever having opened a Needle Project
### Needle Engine
- Add: ParticleSystem now supports HorizontalBillboard and VerticalBillboard
- Fix: [WebXR chromium bug](https://bugs.chromium.org/p/chromium/issues/detail?id=1475680) where the tracking transform matrix rotates roughly by 90° - we now add an WebXR Anchor to keep the scene at the placed location in the real world
- Fix: SceneSwitcher does now call event on first `ISceneEventListener` found on root level of a loaded scene (e.g. if a Unity scene is loaded that contains multiple children and does not have just one root object)
- Fix: Text UI clipping with multiple active screenspace canvases in scene
- Fix: Screenspace canvas events should not be blocked anymore by objects in 3D scene
- Fix: FirstPersonController rotation not being correctly / falsely resetted and flipped in some cases
## [3.19.0] - 2023-09-26
### Unity Integration
- Add: commandline argument to accept EULA via `--accept-needle-eula`
- Change: disable ExportInfo UI while cloning a remote project template
- Change: move react three fiber project template into remote repository
### Needle Engine
- Fix: collider scale wrongly affecting physics objects
- Fix: collider debug lines should not be raycastable
- Fix: mesh-collider behaving unexpectedly
- Fix: animator root motion causing error due to uninitialized Quaternion object
## [3.19.0-pre] - 2023-09-25
### Unity Integration
- Add: Project templates cloneable from github (added Sveltekit, Svelte and React templates)
- Fix: Improve installation of npmdef dependencies to be able to just click Play when opening or switching a sample
- Fix: saving of remote url in FTP server asset
- Fix: ShadowCatcher `Create` button creating plane with wrong rotation in some cases
- Change: clarify EULA window text
- Internal: Fix SampleInfo asset not being editable in inspector
## [3.18.0] - 2023-09-21
### Unity Integration
- Add: SceneSwitcher has now a field for `LoadingScene` which can be used to display a scene / 3D content while loading other scenes
- Fix: Improve license check
- Fix: Rare MissingReference error caused by EditorSync component while adding/removing components inside a prefab
- Change: Improve feedback when clicking the red Typescript component link (for scripts used in the scene but not installed in the web project)
- Change: Improse feedback for Needle Engine Pro Trial limits
### Needle Engine
- Add: SceneSwitcher has now a field for `loadingScene` which can be used to display a scene while loading other scenes
- Add: `ISceneEventListener` which is called by the SceneSwitcher when a scene has been loaded or a scene is being unloaded. It can be used to handle showing and hiding content gracefully. It has to be added to the root of the scene that is being loaded (e.g. the root of the scene or prefab assigned to the `loadingScene` field or the root of a scene assigned to the `scenes` array)
- Add: `hide-loading-overlay` attribute to `<needle-engine>` webcomponent (use like `<needle-engine hide-loading-overlay>`). Custom loading requires a PRO license. See [all attributes in the documentation](https://engine.needle.tools/docs/reference/needle-engine-attributes.html).
- Fix: Loading overlay should not link to needle website anymore when using a custom logo
- Fix: Add safeguard to user assigned events on `<needle-engine>` for cases where methods are not defined in the global scope
- Change: Update loading message displayed in overlay while waiting for `ContextCreated` promise (e.g. in cases where a large environment skybox is being loaded)
## [3.17.1] - 2023-09-20
### Unity Integration
- Fix: DeployToFTP deployment producing wrong meta image url
## [3.17.0] - 2023-09-20
### Unity Integration
- Add: ExportInfo `remoteUrl` field which allows to pull or download projects from a remote repository instead being created from a local template
- Fix: ExportInfo shows an error if the directory paths contains invalid characters
### Needle Engine
- Fix: handle exception when loading GLB/glTF files with invalid lightmapping extension
## [3.16.5] - 2023-09-18
### Unity Integration
- Bump Needle Engine version
### Needle engine
- Add: help balloon message if user tries to open a local file without using a webserver
- Add: helpful console.log if user tries to add a component that is not a Needle Engine component
- Change: Ignore shadow catcher and GroundProjectedEnvironment sphere when running OrbitControls.fit
## [3.16.3] - 2023-09-15
### Unity Integration
- Add: `EditorModificationHandler.HandleChange` event to allow modification (or ignoring) of editor modifications, ignore UnityEvent changes by default
- Change: EditorSync ping should not run on main thread and block the editor
### Needle Engine
- Add: logo now respects prefer-reduced-motion, reduce and is immediately added instead of after 1s
- Fix: use default background color if GLB without camera and skybox is loaded
- Fix: ensure custom KTX2 loader is correctly initialized
- Fix: revert RectTransform change that broke hotspot rendering
- Change: adjust default backgroundBlurriness to match Blender defaults
## [3.16.2] - 2023-09-15
### Unity Integration
- Fix: License Check for exporting AnimatorController animation
### Needle Engine
- Add: mesh collider handling for invalid mesh data (non-indexed geometry)
## [3.16.2-pre] - 2023-09-13
### Needle Engine
- Add: `camera.environmentIntensity` property
- Change: default background blurriness for fallback camera to match blender default
## [3.16.1-pre] - 2023-09-13
### Needle Engine
- Change: if loaded glTF doesnt contain a camera we now also create the default OrbitControls (e.g. glTF exported from a Blender scene without a camera)
## [3.16.0-pre] - 2023-09-13
### Needle Engine
- Add: `NEEDLE_lightmaps` entries `pointer` property can now also be a path to a local texture on disc instead of a texture pointer. This allows Blender EXR and HDR maps to be used at runtime until Blender export supports hdr and exr images to be stored inside the GLB
## [3.15.0-pre] - 2023-09-13
### Unity Integration
- Fix: glTF `OnAfterImport` exception if imported glTF produced a missing GameObject
### Needle Engine
- Fix: remove leftover console.log
- Fix: `DeviceFlag` component not detecting devices correctly for iOS safari
- Fix: loading glTF without any nodes
- Fix: `SceneSwitcher` bug where a scene would be added twice when switching in fast succession
- Fix: `Animation.isPlaying` bool was always returning false
- Fix: Handle typescript 5 decorator change to prevent VSCode error message (or cases where `experimentalDecorators` is off in tsconfig). See [179](https://github.com/needle-tools/needle-engine-support/issues/179)
- Fix: Improve internal lifecycle checks and component method calls
- Change: Improse ContextRegistry/NeedleEngine `ContextEvent` enum documentation
- Change: `<needle-engine skybox-image=` and `environment-image=` attributes are now awaited (loading overlay is still being displayed until loading the images have finished or failed loading)
## [3.14.0-pre] - 2023-09-11
### Unity Integration
- Add: custom shader material inspectors now have UI with export options and information
- Remove: react template, please use https://github.com/needle-engine/react-sample instead
- Update: react-three-fiber template
- Bump UnityGLTF dependency to 2.4.1-exp containing an fix for KHR_animation_2 export and added compressed texture import
### Needle Engine
- Add: exposing `Needle.glTF.loadFromURL` in global scope to support loading of any glTF or GLB file with needle extensions and components when using the prebundled needle engine library (via CDN)
- Add: `context.update` method for cases where needle engine is now owning renderer/scene/camera and the update loop is managed externally
- Fix: animating custom shader property named `_Color`
- Fix: issue with wrong CSS setting in Needle Engine breaking touch scroll
- Change: `?stats` now logs renderer statistics every few seconds
- Change: simplify creating a new Needle Context that is controlled externally (not owning camera/renderer)
## [3.13.0-pre] - 2023-09-08
### Unity Integration
- Add: `ActionsBrowser.BeforeOpen` event to allow modification to local server url or to customize the browser being opened / handle browser opening yourself
- Bump UnityGLTF dependency to 2.4.0-exp containing various color export fixes
- Fix: EditorSync issue when dragging transform position.x
- Fix: ArgumentOutOfRange exception in UnityEvent when no method name is assigned (or missing)
- Fix: Various cases where colors where exported in wrong colorspace affecting UI, materials and particles
### Needle Engine
- Add: ParticleSystem now also uses material color
- Add: `IEditorModificationListener.onAfterEditorModification` callback (requires `@needle-tools/editor-sync@2.0.1-beta`)
- Bump: Three.Quarks dependency to 0.10.6
- Update draco decoder include files
## [3.12.2-pre] - 2023-09-04
### Unity Integration
- Fix: Unity Progress display description on Windows interpreting `\n` as a newline which caused description to be cut off
### Needle Engine
- Add: option to override peerjs host and id (options) via `setPeerOptions`
- Fix: potential nullreference error in AudioListener
- Fix: Networking component cases where invalid localhost input with "/" causes url to contain "//" sometimes -> we can skip one "/" in this case and make it just work for users
- Fix: package.json `overrides` syntax for quarks three.js version
- Change: Screensharing bool to disable click to start networking + add deviceFilter to share(opts:ScreenCaptureOptions)
## [3.12.1-pre.1] - 2023-09-04
### Unity Integration
- Change: Update npmdef package version dependencies
- Fix: Handle `Win32 operation completed successfully` exception
## [3.12.1-pre] - 2023-09-04
### Unity Integration
- Fix: editor web request failing on OSX
### Needle Engine
- Fix: next.js/webpack useRapier setting
- Change: typestore is now globally registered
## [3.12.0-pre.4] - 2023-08-29
### Unity Integration
- Change: Update cloning a project from github
## [3.12.0-pre.3] - 2023-08-28
### Unity Integration
- Change: Update git clone
- Fix: exporting all colors in linear colorspace now
## [3.12.0-pre.2] - 2023-08-28
### Unity Integration
- Fix: UnityEvent arguments not being used anymore
### Needle Engine
- Fix: vite hot reload plugin to dynamically import needle engine to support usage in server-side rendering context
## [3.12.0-pre] - 2023-08-28
### Unity Integration
- Add: commonly used skyboxes
- Change: Drop support for Unity 2020
- Change: bump UnityGltf from 2.2.0-exp to [2.3.1-exp](https://github.com/prefrontalcortex/UnityGLTF/blob/dev/CHANGELOG.md)
- Fix compiler error caused by HideInCallstacks in Unity 22.1.23
- Fix: issue where needle.config `assetDirectory` path wasn't respected (e.g. for sveltekit)
### Needle Engine
- Add: Timeline api for modifying final timeline position and rotation values (implement `ITimelineAnimationCallbacks` and call `director.registerAnimationCallback(this)`)
- Change: Update three quarks particlesystem library to latest
- Fix: issue where onPointerExit was being called when cursor stops moving
- Fix: USDZ normal scale Z was incorrect
- Fix: Timeline Signal events using different casing than UnityEvent events
- Fix: issue where `isLocalNetwork` was falsely determined
## [3.11.6] - 2023-08-15
- Remove beta
## [3.11.6-beta] - 2023-08-14
### Unity Integration
- Add: Tag filters to samples window
- Fix: HideInCallstacks compiler error
### Needle Engine
- Fix: find exported animation by PropertyBinding
- Fix: USDZExporter was not exporting animation from Animation component but only from Animator
- Fix: potential issues with Animation component `clip.tracks` being null/undefined on USDZ export
- Fix: `loadstart` event not being called
- Fix: getComponent should always either the component or null (never undefined)
- Fix: dynamic import of websocket-ts package
- Fix: progressive texture loading wasn't properly awaited on USDZ export
- Fix: apply XR flags when exporting to QuickLook
- Fix: USDZ alpha clipping for materials without textures
- Fix: USDZ same material used in different ChangeMaterialOnClick resulted in duplicate behaviour names
- Change: set default WebARSessionRoot to "1" instead of "5"
## [3.11.5-beta] - 2023-08-10
### Unity Integration
- Fix: Shader export uniform parsing and error log
- Fix: Opening Typescript files in Visual Studio or Rider (Unity Default Code Editor) [issue 175](https://github.com/needle-tools/needle-engine-support/issues/175)
- Fix: issue with logging into file in certain cases on windows
- Fix: incorrect warning when wanting to clone from a repository that ends with `/` (via ExportInfo project path)
- Fix: extra styles in template and absolute positioning of shadowroot div
- Change: sanitize live url in DeployToFTP
- Change: add `.DS_Store` to gitignore
- Internal: add tracing scenario to WebHelper, explicit 1s timeout waiting for npm package response
- Internal: Bugreporter improvements
### Needle Engine
- Fix: components keep their gameObject references until `destroy` call of object's is completed when destroying an hierarchy. Previously child components might already be destroyed resulting in `myChildComponent.gameObject` being null when called in `onDestroy` from a parent component
- Fix: regression where timeline was not updating animations anymore if Animator had an empty AnimatorController assigned (without any states)
- Fix: `SceneSwitcher.switchScene` can now handle cases where it's called with a string url instead of an AssetReference
- Fix: issue where `onPointerMove` event was being called continuously on mobile after touch had already ended
- Fix: issue where GLTFLoader extensions where missing name field resulting in extensions not being properly registered (causing stencils to not work sometimes)
- Change: EventSystem raycast is now only performed when pointer has changed (moved, pressed, down, up) which should improve performance on mobile devices when raycasting on skinned meshes
- Change: peer and websocket-ts import asynchronously
- Remove: legacy include files
## [3.11.4-beta] - 2023-08-04
### Unity Integration
- Bump UnityGLTF fixing issue with blend shape animation not being exported if animation also contained humanoid animations
### Needle Engine
- Fix: USDZExporter exception caused by programmatically calling `exportAsync` without quicklook button
- Fix: Timeline `evaluate` while being paused
- Bump three to fix issue with blend shape animation not being applied to Group objects (KHR_animation_pointer)
## [3.11.3-beta] - 2023-08-03
### Unity Integration
- Add: new option to export glb from context menu without progressive texture processing
- Change: Improve feedback when installing samples
- Fix: finding toktx default installation on MacOS
### Needle Engine
- Change: improve styling of `<needle-engine>` DOM overlay element to allow positioning of child elements
- Fix: USDZExporter normal bias when normalScale is used
- Fix: Nullreference in SceneSwitcher when creating the component from code and calling `select` with a new scene url
- Fix: Quicklook button creation
- Fix: Particlesystem layermask not being respected
## [3.11.2-beta] - 2023-07-31
### Unity Integration
- Fix: CustomReflection texture should not be renamed
- Fix: CustomReflection texture should be at least 64 pixel when exporting
- Change: Bump UnityGLTF dependency, fixing texture transform export for metallicRoughness
- Change: improve "Setup Scene" default names
### Needle Engine
- Fix: `ChangeMaterialOnClick` with multi material objects
- Fix: progressive textures regression
## [3.11.1-beta] - 2023-07-31
### Unity Integration
- Minor editor UI changes
### Needle Engine
- Add: `saveImage` utility method and make `screenshot` parameter optional
- Add: `loading-style="auto"`
- Fix: skybox image caching
- Fix: finding animation tracks for unnamed nodes when using the `autoplay` attribute
- Change: improved `<needle-engine>` default sizes
- Change: smoother src changes on `<needle-engine>` by only showing loading overlay when loading of files takes longer than a second
- Change: bump three version to 154.2 fixing KHR_animation_pointer not working with SkinnedMesh
## [3.11.0-beta] - 2023-07-29
### Unity Integration
- Fix: hide FTP password in console logs
- Fix: incorrect check in Samples Window for installing samples in 2022 LTS and later 2023 LTS
- Change: show installed versions in ExportInfo even if web project is not yet installed
### Needle Engine
- Add: Support for blending between Timeline and Animator animation by fading out animation clips allowing to blend idle and animator timeline animations
- Fix: WebXR buttons style to stay inside `<needle-engine>` web component
- Fix: `OrbitControls.fitCamera` now sets rotation target to the center of the bounding box
- Fix: Timeline animation regression causing Animator not being enabled again after timeline has finished playing
- Fix: Timeline should re-enable animator when ended reached end with wrap-mode set to None
- Change: add `.js` extensions to all imports
- Change: allow overriding loading style in local develoopment
- Change: expose flatbuffer scheme helper methods
## [3.10.7-beta] - 2023-07-28
### Unity Integration
- Fix: Shader uniform export
- Fix: edge case when using URLs in ExportInfo directory
- Fix: console log prints in certain cases containing control characters
- Fix: Toktx detection not working properly on OSX
- Change: Warn if debug mode is enabled
### Needle Engine
- Fix: Camera using RenderTarget (RenderTexture) now applies clear flags before rendering (to render with solid color or another skybox for example)
- Fix: RenderTexture not working in production build due to texture being compressed
- Fix: RenderTexture warning `Feedback loop formed between Framebuffer and active Texture`
- Fix: Handle Subparticlesystem not being properly serialized avoiding runtime error
- Internal: add resource usage tracking of textures and materials
## [3.10.6-beta] - 2023-07-27
### Unity Integration
- Bump Engine version
### Web Engine
- Fix: Timeline ActivationTrack behaves like `leave as is` when timeline is disabled (not changing the activate state anymore)
- Fix: Timeline Signal Track with duration of 0 and signal at time 0 does now trigger
- Fix: Timeline disabling or pausing does now activate animator again
- Fix: CustomShader Time node for BiRP
- Fix: ParticleSystem simulation mode local now correctly applies parent scale
- Change: Show warning for wrong usage of `@serializable` with `Object3D` where a `AssetReference` is expected
- Change: ParticleSystem shows warning when using unsupported scale mode (we only support local right now)
## [3.10.5-beta] - 2023-07-25
### Unity Integration
- Add: DeployToFTP does not support SFTP
- Add: `overscroll-behaviour` CSS to templates
- Add: `type: module` to templates
- Fix: issue where ftp deployment didnt work on OSX
- Fix: export of referenced scenes or prefabs with timeline where timeline graph was exported in the wrong state
### Web Engine
- Fix: warning at runtime when methods called by `EventList`/`UnityEvent` are in the wrong format
- Fix: OrbitControls issue where double clicking/focus on screenspace UI would cause the camera to be moved far away
- Fix: `OrbitControls.fitCamera` where three `expandByObject` now requires an additional call to `updateWorldMatrix` [26485](https://github.com/mrdoob/three.js/issues/26485#issuecomment-1649596717)
- Change: replace some old `Texture.encoding` calls with new `Texture.colorSpace`
- Change: improve `PlayerSync` networking and add `onPlayerSpawned` event
- Remove: `RectTransform.offsetMin` and `offsetMax` because it's not implemented at the moment
## [3.10.4-beta] - 2023-07-24
### Unity Integration
- Fix: rare InvalidOperationException when codewatcher list is cleared while foreach runs
### Web Engine
- Fix: activating UI elements in VR not applying transform
## [3.10.3-beta] - 2023-07-21
### Unity Integration
- Internal: include package and Unity versions in bug report description
### Web Engine
- Fix: AnimatorController error caused by missing animationclip
- Fix: next.js webpack versions plugin
- Fix: Occasional `failed to load glb` error caused by not properly registering `KHR_animation_pointer` extension
- Fix: UI issue where Text in worldspace canvas would be visible at wrong position for a frame
- Fix: UI issue where Text would not properly update when switching between text with and without richtext
- Fix: UI issue where Image would not automatically update when setting texture from script
- Fix: issue where RenderTexture would not be cleared before rendering
- Change: make `addEventListener` attribute on `<needle-engine>` optional
## [3.10.2-beta] - 2023-07-19
### Unity Integration
- Change: Samples window clicking `Install Samples` now displays feedback that samples are being installed
### Web Engine
- Fix: iOS double touch / input
- Change: minor WebXRController refactor moving functionality into separate methods to be patchable
## [3.10.1-beta] - 2023-07-18
### Unity Integration
- Fix: workaround for TextureImporter.spritesheet being obsolete without proper replacement
- Change: update LTS version warning; no warning on 2022 LTS (and 2023 LTS) but warn on 2020 LTS since that's out of support.
### Web Engine
- Fix: prebundled package
- Fix: runtime license check
- Fix: Input being ignored after first touch
- Fix: SpatialTrigger, reverting previous change where we removed the trigger arguments
## [3.10.0-beta] - 2023-07-17
### Unity Integration
- Fix: shadow catcher BiRP support
- Change: add link to [feedback form](https://fwd.needle.tools/needle-engine/feedback) to License window
### Web Engine
- Fix: Text clipping in VR
- Fix: AR overlay `quit-ar` button not being properly detected
- Fix: Timeline animation track post-extrapolate set to `Hold`
- Fix: iOS touch event always producing double click due to not properly ignoring mouse-up event
- Change: DragControls to automatically add ObjectRaycaster if none is found in parent hierarchy
- Change: DragControls now expose options to hide gizmo and to disable view-dependant behaviour
## [3.10.0-exp] - 2023-07-15
### Exporter
- Add: support to download project via git repository
- Fix: issue with opening project directory for certain relative paths
### Engine
- Change: WebXR component now automatically adds a WebARSessionRoot on entering AR when no session root was found in the scene
- Change: `@syncField` can now sync objects by re-assigning the object to the same field (e.g. `this.mySyncedObject = this.mySyncedObject` to trigger syncing)
- Change: log error when `@syncField` is being used in unsupported types (currently we only support syncField being used inside Components directly)
- Change: improve message when circular scene loading is detected and link to documentation page
## [3.9.1-exp] - 2023-07-14
### Exporter
- Fix: compiler errors in Unity 2023.1
- Fix: bug in npmdef registry causing packages to not be properly registered on first editor startup
- Fix: OSX editor stall due to FileWatcher
- Change: Add badge to scene templates
- Change: Don't make insecure calls (localhost running on `http`) when `PlayerSettings.insecureHttpOption` is turned off starting from Unity 2022
- Change: component compiler should ignore .d.ts files
- Change: component compiler can now work without web project (only requires ExportInfo in the scene)
- Internal: cleanup Collab Sandbox scene template, remove unused material
### Engine
- Add: SceneSwitcher now uses scene name by default. Can be turned off in component
- Fix: ParticleSystem lifetime not respecting simulation speed
- Fix: ParticleSystem prewarm with simulation speed and improved calculation of how many frames to simulate
- Fix: Exit AR and Exit VR now restores previous field of view
- Change: close AR button adjusted for better visibility on bright backgrounds
- Change: bump @types/three to 154
## [3.9.0-exp] - 2023-07-12
### Exporter
- Bump Engine version
### Engine
- Add: `<needle-engine>` web component slot support, AR DOM overlay can now be added by simple adding HTML elements inside the `<needle-engine></needle-engine>` web component. Fixing [165](https://github.com/needle-tools/needle-engine-support/issues/164)
- Add: Basic USDZ exporting of UI shadow hierarchies as mesh hierarchies for UI in Quicklook AR support
- Fix: WebXR Rig not being rotated as expected when setting up in Unity [129](https://github.com/needle-tools/needle-engine-support/issues/129)
- Fix: WebXR VR button click, hover is still not working
- Fix: Issue with Lightmaps breaking when switching back and forth between multiple lightmapped scenes
- Change: Button click should not invoke with middle or right mouse
## [3.8.0-exp] - 2023-07-11
### Exporter
- Bump Engine version to use three.js 154 (latest)
### Engine
- Update three.js to 154 (latest)
- Bump postprocessing dependency
- Add: `this.context.xrCamera` property
- Fix: screenspace canvas should not run in VR
- Fix: OrbitControls should not update while in AR and touching the screen
- Change: allow using vanilla three.js by dynamically importing KHR_animation pointer api
## [3.7.7-pre] - 2023-07-11
### Exporter
- Bump Engine
### Engine
- Fix: LookAt copyTarget + keepUpDirection
- Fix: DragControls not working on first touch on mobile / clone input event
- Fix: Renderer assigning renderOrder in URP on SkinnedMesh with multi-material
## [3.7.6-pre] - 2023-07-10
### Exporter
- Fix: react and r3f templates
- Fix: warnings on OSX
- Fix: invalid cast exception due to change with prefab export
- Change: use UnityWebRequest.EscapeURL for BugReporter description
- Change: show reason for why Bugreporter dialogue popup shows again
## [3.7.5-pre.3] - 2023-07-08
### Exporter
- Fix: compiler error in Unity 2021.3.28 (latest)
## [3.7.5-pre.2] - 2023-07-07
### Exporter
- Fix: Unity 2020.3 compiler error
## [3.7.5-pre.1] - 2023-07-07
### Exporter
- Fix: minor 2021+ compiler warning
- Change: Allow longer bug report descriptions
## [3.7.5-pre] - 2023-07-07
### Exporter
- Add: support for bugreporter descriptions
- Change: Fonts handle semibold variant
- Change: make sure PlayerSync can be enabled/disabled in the editor
- Internal: specifically log when reading file is not allowed
### Engine
- Fix: USDZExporter should not show Needle banner when branding information is empty (pro only)
- Fix: USDZExporter sessionroot scale should be applied to object to be exported when the root is in the parent
- Fix: DropListener localhost without explicit backend url + dropping file caused exceptions
- Fix: instanceof error that tsc complained about
- Change: Fonts handle semibold variant
- Internal: DropListener re-use addFiles method, remove old code
- Internal: Bump tools package dependency
## [3.7.5-exp] - 2023-07-06
### Exporter
- Fix: catch access lock exception when trying to read npm log
- Change: component in prefab referencing root prefab should not export as glb path
### Engine
- Add: SignalEvents support for arguments
- Fix: SpatialTrigger Unity events removing extra (unexpected) event arguments
- Fix: safeguard `AudioSource.play` to not fail when `clip` argument is not a string
- Change: change Timeline signal event trigger time to use last frame deltatime with padding to estimate if the event should fire
## [3.7.4-exp] - 2023-07-05
### Exporter
- Fix: Sprite colorspace export taking sRGB textures into account
### Engine
- Change: targetFps, use timestamp that we get from the animation callback event because it is more reliable on Firefox
## [3.7.3-exp] - 2023-06-26
### Exporter
- Bump engine version
### Engine
- Add: physics gravity to `IPhysicsEngine` interface to be available via `this.context.physics.engine.gravity`
- Fix: USDZ text alignment
## [3.7.2-exp] - 2023-06-23
### Exporter
- Add: `Preview Build` button to PlayerBuildWindow
- Fix: PlayerBuildWindow for Unity 2022.3.3
### Engine
- Fix: Nullref in SpectatorCamera.onDestroy when camera wasnt active
## [3.7.1-exp] - 2023-06-22
### Exporter
- Fix: Font export with styles that are unknown to the Unity FontStyle enum (e.g. `-Medium`)
### Engine
- Add: ChangeMaterialOnClick `fadeDuration` option (Quicklook only)
- Change: USDZ export now enforces progressive textures to be loaded before export
- Change: USDZ export callbacks for `beforeCreateDocument` and `afterCreateDocument` can now run async
- Fix: USDZExporter quicklook button
- Fix: USDZExporter Quicklook button not being removed when exporter gets removed or disabled
- Fix: USDZ ChangeMaterialOnClick clear cache before exporting, this caused USDZ export to fail on third export in USDZ sample scene
- Fix: Engine loading bar not being updated
- Fix: USDZ text linebreaks
- Fix: UI font name style check. Unknown font styles are now not touched anymore (e.g. font name ending with `-Medium`)
## [3.7.0-exp] - 2023-06-21
### Exporter
- Bump Engine version
### Engine
- Change: Move HTML elements into <needle-engine> shadow dom
## [3.6.13] - 2023-06-21
### Exporter
- Fix: use assemblylock to handle regenerating all components in npmdef
- Bump Engine version
### Engine
- Add: static Context.DefaultTargetFrameRate
- Add: option to prevent USDZExporter from creating the button
- Fix: `@prefix` handling promise resolving to false
## [3.6.11] - 2023-06-19
### Exporter
- Bump UnityGLTF version adding support for importing draco compressed meshes and KTX2 compressed textures
### Engine
- Add: UI InputField API for clear, select and deselect from code
- Change: LODGroup serialization
- Fix: mobile debug console should be above loading overlay if error happens during loading
- Fix: LODGroup not being able to resolve renderer reference
- Fix: Particles direction being wrong in some causes with scaled parent and scaled particle system
- Fix: Particles subsystem emitter position being wrong when main particle system was scaled
- Fix: Bundled library failing to load due to undeclared variable
- Fix: UI InputField hide html element
- Fix: Joining empty room name is not allowed anymore
- Fix: Clamp Room name length to 1024 chars
## [3.6.10] - 2023-06-14
### Exporter
- Bump engine version
### Engine
- Fix: Text with richText not updating properly
- Internal: Change font style parsing
## [3.6.9] - 2023-06-12
### Exporter
- Bump Engine version
### Engine
- Fix: Particles SizeOverLifetime module for mesh particles
## [3.6.8] - 2023-06-12
### Exporter
- Fix: LookAt component exception when being used in prefab
## [3.6.6] - 2023-06-12
### Exporter
- Bump Engine version
### Engine
- Internal updates
## [3.6.5] - 2023-06-09
### Exporter
- Bump Engine version
### Engine
- Add: NestedGltf `loaded` event being raised when the glb has been loaded
- Add: AnimationCurve cubic interpolation support
- Change: set targetFramerate to 60 by default (in `context.targetFrameRate`)
- Fix: USDZ metalness/roughness potentially being undefined when exporting Unlit materials
- Fix: Handle exception when loading components due to bug when using meshopt compression and material count changes
- Fix: ColorAdjustments setting tonemapping exposure to 0 when exposure parameter override is off [824]
## [3.6.4] - 2023-06-02
### Exporter
- Bump engine version
### Engine
- Add: `ObjectUtils.createPrimitive` for cube and sphere
- Change: expose `ObjectUtils`
- Fix: BoxGizmo component
- Fix: vite copy plugin when needle.config.json "assets" directory starts with "/"
## [3.6.3] - 2023-06-01
### Engine
- Change: OrbitControls apply settings in update
- Fix: Rapier stripping not being respected
## [3.6.2] - 2023-06-01
### Exporter
- Change: Try fix curl 60 error when server is already running on http
### Engine
- Fix: wrong UI z-offset in some cases
- Fix: Particle velocity over lifetime not using world rotation
- Fix: Particle burst being played twice
- Fix: Particle `playOnAwake` option not being respected
## [3.6.2-pre] - 2023-05-31
### Exporter
- Bump Engine Version
### Engine
- Add: `setAllowOverlayMessages` to explictly disable overlay messages without url parameter
- Add: allow larger textures for USDZ generation
- Fix: nested gltf with disposing of resources leading to broken files
## [3.6.1-pre] - 2023-05-29
### Exporter
- Change: enable ProgressiveTexture compression by default. Use the `ProgressiveTextureSettings` component to explictly disable it
### Engine
- Fix: removing `<needle-engine>` from DOM does now dispose the context properly and unsubscribes from browser events. Add `keep-alive` attribute to disable disposing
## [3.6.0-pre] - 2023-05-29
### Exporter
- Add: `ScreenSpaceAmbientOcclusionN8` component
- Bump Engine version
### Engine
- Add callbacks for ContextClearing
- Add: [n8AO postprocessing effect](https://github.com/N8python/n8ao) (Screenspace Ambient Occlusion) support
- Add: option to disable automatic poster generation (use `noPoster` in options in vite.config)
- Fix: `<needle-engine>` without any src should setup an empty scene
- Change: `OrbitControls.fit` now handles empty scene and ignores GridHelper
- Change: TimelineAudio disconnect audio in onDestroy
- Change: Ensure PostProcessing VolumeParameters are initialized
- Change: Improve memory allocs and disposing of resources
- Change: Update three.js fixing GLTFLoader memory leak
## [3.6.0-exp] - 2023-05-27
### Exporter
- Fix: Exception when npmdef package had no `devDependencies` key
- Bump Engine version
### Engine
- Add: Changing `src` attribute now does scene cleanup and loads new files
- Add: `skybox-image` and `environment-image` attributes, allow changing both at runtime
- Fix: error display overlapping in cases where somehow engine is imported twice
- Fix: logo overlay should only show when loading is done, change error during render loop message
- Fix: OrbitControls camera fitting now done once before rendering when loaded glb does not contain any camera
- Fix: Vite client plugin imports
- Change: Context now handle errors during initializing or when starting render loop
- Change: ContextRegistry exported as NeedleEngine and export hasIndieLicense function
- Change: Remove need to manually define global engine variables in cases without bundler or Needle plugins
## [3.5.13-pre] - 2023-05-26
### Exporter
- Change: ExportInfo editor performance improvements: check if npm is installed only once per session, run project validation on thread, dont collect template files in onEnable
- Fix: Prevent spawning more than one "npm installed" check task
### Engine
- Change: OrbitControls camera fitting improved
## [3.5.12-pre] - 2023-05-24
### Exporter
- Add: `IAdditionalFontCharacters` interface to allow components to add additional characters for font atlas generation
- Change: schedule Font export task to be awaited at end of export
- Change: GltfValueResolver should export Object3D node reference instead of Transform if referencing GameObject in UI hierarchy
### Engine
- Add: option to toggle collider visibility from script via `this.context.physics.engine.debugRenderColliders`
- Change: engine.physics raycast doesnt need any parameters now anymore
- Change: OrbitControls default target should be related to distance to center (if nothing is hit by raycast)
- Fix: EventList object and component argument deserialization
## [3.5.11-pre.1] - 2023-05-22
### Exporter
- Fix: missing texture for importer overrides inspector header
## [3.5.11-pre] - 2023-05-22
### Exporter
- Bump Engine Version
### Engine
- Add: `@registerType` decorator that can be added to classes for registration in TypeStore. Currently only useful for cases outside of Unity or Blender for Hot Reload support
- Fix: `Component.name` should return Object3D name
- Fix: GameObject static methods generic
- Fix: Logo animation causing browser scrollbar to appear
## [3.5.10-pre] - 2023-05-22
### Exporter
- Add: SpriteRenderer now exposes shadow casting and transparency options via SpriteRendererData component
### Engine
- Add: SpriteRenderer now exposes shadow casting and transparency options
- Fix: vite plugin issue caused by missing src/generated/meta
- Fix: nullref in debug_overlay, typo in physics comment
- Fix: disabling collider with rigidbody component did cause an error in rapier
- Fix: HTMLElement css, cleanup loading element, move logo into html element
- Fix: GameObject.addComponent now takes Object3D type too
- Fix: loading overlay not hiding when <needle-engine> src changes
- Change: OrbitControls now sets target to 10 meter by default if nothing is assigned or hit in the scene (previously it was set to 1 meter)
- Change: fit camera to scene after loading when no camera is present in file
## [3.5.9-pre.2] - 2023-05-20
### Exporter
- Fix: Component links should use default app
### Engine
- Add: WebXRPlaneTracking should initiate room setup on Quest when no tracked planes are found
## [3.5.9-pre.1] - 2023-05-19
### Exporter
- Fix: DeployToGlitch
- Internal: move compression components into Needle AddComponent sub-menu
### Engine
- Fix: SceneSwitcher should ignore swipe events when `useSwipe` is disabled
## [3.5.9-pre] - 2023-05-19
### Exporter
- Change: when using a custom reflection texture use the texture size
- Fix: issue where npmdef to react-three-fiber package was being removed when generating the project
### Engine
- Add: Support for progressive texture loading for custom shaders
- Fix: react-three-fiber template
## [3.5.9-exp.2] - 2023-05-18
### Exporter
- Bump Needle Engine package
### Engine
- Add: needle-engine attributes documentation
- Change: assign main camera during gltf component deserialization when no camera is currently assigned
## [3.5.9-exp] - 2023-05-18
### Exporter
- Change: allow opening component links with default editor too (when VSCode is unticked in Needle settings)
- Change: clear .next/cache directory on full export
### Engine
- Add: add nextjs plugin to handle transpiling and defines
- Change: expose USD types to make custom behaviours, add proximityToCameraTrigger
- Fix: loading element position to absolute to avoid jumps when added to e.g. nextjs template
- Fix: texcoords werren't quicklook compatible in ThreeUSDZExporter
- Fix: `LookAt` component with invertForward option was flipped vertically in QuickLook
## [3.5.8-exp] - 2023-05-16
### Exporter
- Add option to settings to open web projects and files with default code editor (e.g. Rider)
- Add NeedleConfig `baseUrl` for codegen e.g. when the served file path is not the local path (e.g. `./public/assets` but server url is `./assets`)
- Change: improve check for http and https, remove usage of UnityWebRequest because is logs ssl error that we can not prevent when pinging local server urls
- Change: dont append toktx path as argument anymore when running build command, it is automatically discovered by build pipeline
- Fix: NullReferenceException in ProjectGenerator
### Engine
- Add NeedleConfig `baseUrl` for codegen
- Change: AudioSource should pause in background on mobile
- Fix: logo svg import for nextjs
- Fix: particle system playOnAwake
## [3.5.7-exp] - 2023-05-15
### Exporter
- Add: Initial support for text in USDZ
- Fix: EditorSync, prevent error caused by serialization of UnityObject
- Fix: Components can now reference RectTransforms
- Change: expose `SyncedRoom.tryJoinRoom` method
- Change: add some more information to networking components
- Bump UnityGLTF fixing issues with material animation export
### Engine
- Add: Initial support for text in USDZ
- Change: add generic to `networking.send` for validation of model
- Change: SyncedRoom, expose tryJoinRoom method + remove error thrown when roomName.length <= 0, join room in onEnable
- Fix: setting position on UI object (RectTransform) works again
- Fix addressable instantiate options called with `{ position: .... }` and without a parent, it should then still take the scene as the default parent
- Fix: WebXR `arEnabled` option
- Fix: Worldspace canvas always being rendered on top
- Fix: CanvasGroup alpha not being applied to text
## [3.5.6-exp] - 2023-05-12
### Exporter
- Add component tags for easier searching of Everywhere Actions (USDZ/QuickLook support)
### Engine
- Add: `addComponent` method to this.gameObject
- Add: "light" version on bundle processing
- Add: bundled library now comes with `light` variant to be installed from cdn (e.g. [`needle-engine.light.min.js`](https://unpkg.com/@needle-tools/engine@3.5.6-alpha/dist/needle-engine.light.min.js))
- Remove: some spurious logs
- Fix: defines for vanilla JS usage
- Fix: CanvasGroup not overriding alpha
## [3.5.5-exp] - 2023-05-11
### Exporter
- Change license display: holt ALT to show clear text + trim whitespace
- Bump engine version
### Engine
- Add: getWorldDirection
- Add: needle.config.json `build.copy = []` to copy files on build from arbitrary locations into the dist folder for example:
```md
"build": {
"copy": [
"cards" <-- can be relative or absolute folder or file. In this case the folder is named "cards" in the web project directory
]
}
```
- Add ip and location utils
- Change: add buffers for getWorldQuaternion, getWorldScale util methods
- Change: animatorcontroller should only log "no-action" warning when in debug mode
- Fix: apply and check license
## [3.5.4-exp] - 2023-05-11
### Exporter
- Change: introduce FileReference and derive ImageReference from it, add FileReferenceTypeAttribute. It can be used to copy any file type from Unity to the desired output directory without modification or going through the exporter to, for example, reference `usdz` files.
### Engine
- Fix: wrong serialization check if a property is writeable
- Fix: mark UI dirty when text changes
- Change: allow UI graphic texture to be set to null to remove any texture/image
- Change: rename USDZExporter `overlay` to `branding`
## [3.5.3-exp.1] - 2023-05-10
### Engine
- Fix: wrong check in serialization causing particles to break (introduced in 3.5.3-exp)
## [3.5.3-exp] - 2023-05-10
### Exporter
- Change: hold ALT to show Netlify access key
### Engine
- Add: `IPointerMoveHandler` interface providing `onPointerMove` event while hovered
- Add: USDZ AudioSource support and PlayAudioOnClick
- Change: balloon messages can now loop
- Change: pointer event methods are now lowercase
- Change: allow `moveComponent` to be called with component instance that was not added to a gameObject before (e.g. created in global scope and not using the `addComponent` methods)
- Fix: input pointer position delta when browser console is open
- Fix: GameObject.destroy nullcheck
- Fix: typescript error because of import.meta.env acccess
- Fix: issue where added scenelighting component by extension caused animation binding to break
- Fix: UI layout adding objects dynamically by setting anchorMinMax
- Fix: Prevent exception during de-serialization when implictly assigning value to setter property
- Fix: screenspace canvas being rendered twice when using explicit additional canvas data component
- Fix: EventSystem cached state of hovered canvasgroup not being reset causing no element to receive any input anymore after having hovered a non-interactable canvasgroup once
- Fix: empty array being returned in `GameObject.getComponents` call when the passed in object was null or undefined
## [3.5.2-exp] - 2023-05-09
### Exporter
- Add: SceneSwitcher preload feature
- Change: USDZBehaviours can now be enabled on USDZExporter component
### Engine
- Add: SceneSwitcher preload feature
- Change: interactive behaviours for QuickLook are on by default now
- Fix: SetActiveOnClick toggle for QuickLook
- Fix: USDZ texture transform export works in more cases
## [3.5.1-exp] - 2023-05-09
### Exporter
- Change: Allow overriding the default GltfValueResolver
### Engine
- Fix: reflection probes not working anymore
- Fix: false RectTransform return breaking some cases with reparenting
- Fix: RectTransform mark dirty when anchors change (due to animation for example)
## [3.5.0-exp] - 2023-05-08
### ⭐ Highlights
#### **Tree-shake Rapier / Physics engine**
With this version the physics engine can be marked to be removed in bundles reducing the overall `needle-engine` size by 600 KB (when using gzip) or 2 MB (without gzip). See the [documentation](https://fwd.needle.tools/needle-engine/docs/compression) for more information
#### **Choose between draco and meshopt mesh compression**
Add support to compress exported glTFs either with draco or meshopt compression. See the [documentation](https://fwd.needle.tools/needle-engine/docs/compression) for more information
#### **Various USDZ export fixes**
This release fixes various issues with USDZ export like exporting occlusion maps, texture input scale not being used and normal maps color space
### Exporter
- Add: vite plugin to watch package.json dependency changes to restart the server (can be disabled by adding `{noDependencyWatcher:true}` as a third parameter to the needle plugin)
- Add: `MeshCompression` component to be able to select compression per prefab/scene/gltfobject
- Add: `NeedleEngineModules` component to be able to remove rapier from bundle reducing overall engine size by 2MB (or 600KB with gzipping)
- Fix: nullref when adding new `DeployToFTP` component
- Fix: colorspace and texture flip issues in USDZ export in production builds (compressed texture readback)
### Engine
- Change: allow tree-shaking rapier physics
- Fix various USDZ export issues:
- fix UV2 for occlusion maps (paves the way for lightmaps), had to be texCoord2f[] instead of float2[]
- fix missing MaterialBindingAPI schema
- fix normal scale for non-ARQL systems (ARQL doesn't support it though, but needed for other viewers)
- fix input:scale for textures not being used if it's (1,1,1,1)
- fix normal maps not being in raw colorSpace
## [3.4.0-exp.1] - 2023-05-05
### Exporter
- Fix: inspector injections stopped working
## [3.4.0-exp] - 2023-05-05
### ⭐ Highlights
#### **QuickLook Behaviours (experimental)**
This version adds support for interactive USDZ files for iOS devices. A number of built-in components work out of the box, with more to come! Try the USDZExporter sample to see for yourself. The high-level components will likely change over the next releases, but now is a great time to experiment and provide feedback.
#### **AR Image Tracking**
AR Image Tracking is now available! Place content on trackable, configurable markers. On Android, it requires Chrome and currently the flag `chrome://flags#webxr-incubations` needs to be enabled. On iOS, Image Tracking works without additional settings.
#### **UI Improvements**
This version adds initial support for Vertical- and Horizontal LayoutGroups for Unity's UI Canvas System.
### Exporter
- Add: high-level USDBehaviours components: ChangeMaterialOnClick, PlayAnimationOnClick, SetActiveOnClick, HideOnStart
- Add: DeployToFTP: add option to disallow toplevel deployment
- Add: SamplesWindow filtering by tags and sorting by priority
- Change: various editor performance improvements
- Change: add @types/three when generating new NpmDefs
- Bump UnityGLTF dependency including fixes for NaNs in Unity's tangents and sorting of AnimationClip channels
### Engine
- Add: low-level USD Actions/Triggers API for building complex interactions for iOS devices
- Add: high-level USDBehaviours components: ChangeMaterialOnClick, PlayAnimationOnClick, SetActiveOnClick, HideOnStart
- Add: LookAt component now supports iOS AR
- Add: more settings for LookAt
- Add: support for Horizontal- and VerticalLayoutGroup (UI)
- Fix: `setWorldScale` was setting incorrect scale in some cases
- Fix: WebXR Image Tracking now works with WebARSessionRoot / rig movements
- Fix: vite reload only when files inside "assets" change and only if its a known file type
- Fix: UI scale set to 0 not being applied correctly
## [3.3.0-exp] - 2023-05-02
### ⭐ Highlights
#### **Screenspace UI and improved RectTransform support**
This versions updates to latest three-mesh-ui 7.x and adds support to correctly apply RectTransform anchoring and pivot settings as well as the ability to create screenspace UI (both modes for screenspace overlay and screenspace camera are supported)
### Exporter
- Add: deploy to github pages component
- Add: Linked npm package support
- Fix: recursively installing locally referenced packages
- Fix: check if scene is saved before trying to export when not using any GltfObject
- Fix Unity warning when exporting canvas in scene without GltfObject
- Change: SceneSwitcher now allows assigning both prefabs and scenes
### Engine
- Add: AssetReference can now handle scene reference
- Add: UI update with support for screenspace UI, anchoring, pivots, image outline effect, image pixelPerUnit multiplier
- Add: basic LookAt component
- Add: basic UI outline support + handle builtin Knob image
- Add: WebXRImageTracking ability to directly add a tracked object to an image marker
- Fix: OrbitControls should only update when being the active camera
- Fix: UI input ignored browser "mouseDown" for each "touchUp" event
- Fix: OrbitControls requiring additional tab after having clicked on UI
- Fix: OrbitControls only being deactivated when down event starts on UI element
- Fix: loading bar text not being decoded (displayed e.g. `%20` for a space)
- Fix: TransformGizmo not working anymore
## [3.2.15-exp] - 2023-04-28
### Exporter
- Add: USDZExporter exposes download usdz file name
### Engine
- Add: SceneSwitcher.select(AssetReference) support to be invoked from a UnityEvent with an object reference (must be an asset)
- USDZExporter: change exported usdz name, remove needle name for license holders
## [3.2.14-exp] - 2023-04-28
### Exporter
- Add: OpenURL component
- Fix: USDZ export breaking if the object name is just a number
- Fix: allow to specify local three version in package
### Engine
- Add: OpenURL component
- Change: Implictly add Raycaster to scene if it is not found.
- Fix: USDZ export breaking if the object name is just a number
## [3.2.13-exp.1] - 2023-04-27
### Exporter
- Fix: Vite template missing `base: "./"` for FTP subfolder deployment
- Fix: Vite template missing `server.proxy` option for HTTP2
- Change: DeployToFTP can now run `Build & Deploy` even if the project was never built before
## [3.2.13-exp] - 2023-04-27
### Exporter
- Add: USDZExporter editor shows warning if no objects are assigned and exposes quicklook overlay texts
- Add: USDZExporter callToActionButton can now invoke url to open
- Change: EditorSync improved feedback during installation
- Change: Remove Copy files run from editor, run copy files on via vite plugin
- Change: remove console log in pro license
- Fix: Fix vite html transform plugin
- Fix: EditorSync false check if Materials were enabled, otherwise it would not inject
- Fix: minor SemVer warning
### Engine
- Add: USDZExporter editor shows warning if no objects are assigned and exposes quicklook overlay texts
- Add: USDZExporter callToActionButton can now invoke url to open
- Add: SceneSwitcher can now use history without updating the url parameter
- Fix: Fix vite html transform plugin
## [3.2.12-exp] - 2023-04-26
### Exporter
- Change: ProcessHelper should fail if working directory doesnt exist
- Change: ProcessHelper starts command windows minimized
- Change: BugReporter can now run without web project
- Fix: BugReporter should run by using Needle managed tools package
- Fix: When mesh compression `override` was enabled the `useSimplifier` would not be used
### Engine
- Fix: issue where removing an object from the scene would disable all its components
## [3.2.11-exp] - 2023-04-25
### Exporter
- Bump Needle Engine version
- Bump Tools package version
### Engine
- Fix: lighting settings being implictly switched (enabled/disabled) when using SyncCamera / any loaded prefab at runtime
## [3.2.10-exp] - 2023-04-25
### Exporter
- Remove: creation of legacy `scripts.js` file
- Change: improve first time installation logs
- Change: Clean install now recursively runs for locally referenced packages
- Change: EditorSync now can allow camera sync only / only inject materials if enabled and only inject other properties if `components` sync is enabled
- Change: EditorSync should disable scene camera sync when a scene is closed to not lock camera view in browser
- Change: EditorSync: schedule reconnect exponentially slower over time if it fails
### Engine
- Fix: Remove log in `Animator.SetTrigger`
- Fix: GroundEnv radius property setting wrong value internally
- Fix: Apply license to unnamed local vite chunk files
## [3.2.9-exp] - 2023-04-23
### Exporter
- Change: ExportInfo big install button should run clean install silently if the project does not exist at all
- Change: Cleanup vite template config
### Engine
- Fix: VideoPlayer not restarting when enable/disable being toggled
- Fix: Builtin serializer for URLs `@serializable(URL)` should ignore empty strings
- Change: set `enabled` to true before calling `onEnable`
- Change: VideoPlayer now deferrs loading of the video until the video should play
- Change: ScreenSharing component now changes cursor pointer on hover to indicate that is can be clicked
## [3.2.8-exp] - 2023-04-23
### Exporter
- Add: DeployToNetlify component
- Change: SceneView now shows server start information
- Change: Improve npm installation logs in Unity and run installations in sequency rather than in parallel
- Change: automatically update workspace title making it easier to work with multiple VSCode editors open
- Change: wait a bit longer before opening browser URL (mainly for safari not refreshing when the vite server takes a bit longer to fully start)
- Change: remove npmdef dependencies in temporary projects (in Library/) when they have not been added explitly in the Unity scene (this is useful when switching many sample projects where one web project is shared for many Unity scenes that might use different local packages - when switching many scenes more and more dependencies would been added to the project altough only few were actually used by the current example scene)
- Fix: font export where font name is "Arial" but font file name is "arial"
- Fix: npmdef dependency path update (remove unnecessary log, only write dependencies if they've actually changed)
- Fix: Catch some timeline export bugs when animation window is open but has no clip
### Engine
- Add: this.context.getPointerUsed(index) and setPointerUsed(index)
- Change: physics now by default receives collisions/triggers between two colliders that are set to trigger
## [3.2.7-exp] - 2023-04-22
### Exporter
- Change: reduce warnings when font style could not be found
- Change: improve switching of scenes in samples repository where packages are added to shared project
### Engine
- Change: ambient light does now look closer to Unity ambient light
- Fix: guard calls to component event methods when the component or object has been destroyed
## [3.2.6-exp] - 2023-04-21
### Exporter
- Fix_ editor sync for enums
- Change: Delete package.lock.json when installing
### Engine
- Add: SceneSwitcher has now option to automatically set scene environment lighting
- Fix: Issue caused by NeedleEngineHTMLElement import from SceneSwitcher
- Change: Allow component to be disabled in awake (e.g. calling `this.enabled = false` in awake callback)
- Change: Export more types e.g. AnimatorStateMachineBehaviour
- Change: VolumeParameter.value should return rawValue (unprocessed)
- Change: rename "rendererData" to "sceneLighting"
- Change: scene lighting must now be enabled explictly when additional scene are being loaded, use `this.context.sceneLighting.enable(...)` with the AssetReference or sourceId of the scene you want to enable
## [3.2.5-exp] - 2023-04-20
### Exporter
- Add: Occluder mode to ShadowCatcher component
- Add: WebXRPlaneTracking
### Engine
- Add: WebXRPlaneTracking
- Add: `<needle-engine loading-style="light">` for a brighter loading screen
- Fix: InputField.onEndEdit should send string
- Change: move webxr into subfolder
- Change: export more types
## [3.2.4-exp] - 2023-04-20
### Exporter
- Add: auto updater for scripts importing types using `engine/src` paths (to skip auto update add `// @noupdate` in the beginning of your file)
- Internal: NpmDef devDependency is now set to current local engine if the current project does use a locally installed engine package
### Engine
- Change: export more types (e.g. `syncField`)
- Fix: PlayerSync
- Fix: Environment lighting
- Fix: license check
## [3.2.3-exp] - 2023-04-20
### Exporter
- Change: bump UnityGLTF dependency to `2.0.0-exp.2`
### Engine
- Fix: VideoPlayer AudioOutput.None should mute video
- Fix: SpriteRenderer applies layer from current object (e.g. for IgnoreRaycast)
## [3.2.2-exp] - 2023-04-19
### Exporter
- Change: Bump engine version
### Engine
- Fix: issue where the environment lighting would be falsely disabled
- Change: minor improvements to initial state of the SceneSwitcher
## [3.2.1-exp] - 2023-04-19
### Exporter
- Remove: New shaders will not be changed anymore
- Change: DriveHelper now runs in background to prevent long stalls on windows call
- Fix: timeline signal asset export
### Engine
- Change: SceneSwitcher clamp option
- Change: timeline signals without bound receiver are now invoked globally on all active SignalReceivers with the specific signal asset
- Change: internal check preventing errors during initialization for projects where the package is falsely added multiple times to the project by importing from internal types directly instead of `from "@needle-tools/engine"`
## [3.2.0-exp] - 2023-04-19
### Exporter
- Add gzip option to DeployToFTP and always enable gzip compression for DeployToGlitch
- Fix minor Unity warnings
- Change: Allow exporting root scene without GltfObject
### Engine
- Add: built-in SceneSwitcher component
- Change: VideoPlayer.playInBackground is set to true by default
- Change: Screensharing should continue playback of receiving video when the sending tab becomes inactive
- Change: log additional information when button events can not be resolved
- Change: AudioSource.playInBackground set to true by default to allow audio playback when tab is not active
- Change: syncField can now take function argument
- Change: Renderer.sharedMaterials can now be iterated using `for(const mat of myRenderer.sharedMaterials)`
- Fix: lightmap not being resolved anymore
- Fix: environment lighting / reflection not switching with scenes
- Fix: progressive texture did not check if the texture was disposed when switching to an unloaded scene resulting in textures being black/missing
- Fix: timeline does enable animator again when pausing/stopping allowing to switch to e.g. idle animations controlled by an AnimatorController
- Fix: changing material on renderer with lightmapping will now re-assign the lightmap to the new material
## [3.1.0-exp.3] - 2023-04-18
### Exporter
- Fix: font export not working when tools helper package was not yet initialized
- Fix: NestedGltf exporting wrong file path
## [3.1.0-exp.2] - 2023-04-18
### Exporter
- Fix: UI font path export
### Engine
- Fix: UI font style resolving
## [3.1.0-exp.1] - 2023-04-18
### Engine
- Fix: RemoteSkybox not being able to load locally reference dimage
- Fix: ParticleSystem sphere scale not being applied anymore
- Fix: WebXRImageTracking url not being resolved
## [3.1.0-exp] - 2023-04-18
### Upgrade Guide
With version 3.x the Needle Engine Unity integration will install Needle Engine from npm instead of installing a separate Unity package and installing it by filepath. This change is an important step to alig the Unity integration with Blender and all future integrations.
After upgrading please make sure to apply the following changes:
- Open your web project package.json and check that the dependency for `three` does not contain an old `file:` path to a previous installation. It may be necessary to change the value from `"file:/path/"` to `""` (empty string) so that the Unity integration can fill in the correct version. You may also remove the explicit dependency to `three` completely if you are not using e.g. react-three-fiber.
- Open the `vite.config.js` and make sure to remove the custom `alias` configuration for `@needle-tools/engine` and `three`
- If you have been using the Unity `ImageReference` class to export images to external files you should change your runtime code to use the new typescript `ImageReference` class as well (using `@serializable(ImageReference)`)
- The `build:dev` script not contain an extra `tsc` compile call
### ⭐ Highlights
#### **Needle Engine is now installed from NPM**
Needle Engine in Unity is now also installed from NPM. This is an important step to align Unity, Blender and all future integrations. It will also make it easier to publish projects on platforms like Netlify without having to modify the web project. Please see the changelog for the Upgrade Guide.
#### **WebXR ImageTracking**
Add the `WebXRImageTracking` component to your scene and assign images to be tracked. Currently requires the `webxr-incubations` chrome flag to be enabled.
#### **Screensharing**
Reliability when making new connections or joining a room with an active screensharing session has been improved.
### Exporter
- Add: automatically update npm dependencies for certain packages (e.g. `@needle-tools/engine`) when a normal Semversion is being used
- Add: initial experimental component import support allowing to import glTF files from Blender into Unity with their components intact (similarly glTF files that have been exported in other Unity projects can now be imported including their components)
↪ **NOTE**: this feature is experimental and not yet production ready. It needs further testing and import does not yet work for all types (known issues where import does not yet work include ParticleSystems and AnimatorControllers where states have missing animation clips)
- Change: bump UnityGLTF dependency to `2.0.0-exp` for import plugin API
- Change: build pipeline tools are now run from an internal package, this removes the need to have a web project setup to export and compress glTF files (e.g. during CI or when using the context menu item on an model or prefab asset)
- Change: remove dependency to extra Unity package and local engine installation.
- Change: paths to external files are not relative to the exported glb (previously they did contain the full path relative to the project root) - this allowed modifications to `needle.config.json` assetsDirectory to work when the folder structure for the deployed version is different to the development structure. NOTE: if you've been exporting external images using `ImageReference` you can now use the new `ImageReference` runtime type to easily resolve them
- Change: Compressed glTF export is now possible without web project
- Change: Full Export now does not restart the server but deletes both Needle Engine as well as vite caches
- Fix: Projects using `needle.config.json` to modify the assets directory are now being built correctly
### Engine
- Add: `ImageReference` type, use to export textures to external files and load them as `img`, `texture` or to get the binary data for e.g. image tracking
- Add: api for `WebXRImageTracking`, this does currently require the ``webxr-incubations`` flag to be enabled
- Add: TiltShift postprocessing effect
- Add: AnimatorController support for negative speed
- Add: `this.context.xrFrame` to get access to the current XRFrame from every lifecycle event method
- Add: `<needle-engine>` loading visuals can now be customized by commercial license holders
- Change: ParticleSystem now has a reset method to allow for clearing state, stop has options for calling stop on Sub-Emitters and to clear already emitted particles
- Change: license check is now baked
- Change: Rename "EngineElement" to NeedleEngineHTMLElement
- Change: disable "Enable Keys" on OrbitControls by default as it conflicts with so many things
- Fix: ParticleSystem circle shape
- Fix: balloon messages are now truncated to 300 characters
- Fix: Screensharing connection setup and start of video playback
- Fix: Screensharing muting now local audio
- Fix: AudioSource does not play again when it did finish and the user switches tabs
- Fix: ParticleSystem prewarm
- Fix: ParticleSystem minMax size, it's currently not supported and should thus not affect rendering
## [2.67.16] - 2023-04-13
### Exporter
- Change: Improved handling of error during export if referenced scenes have the same name causing an IOException. Regular export now still continues and an error with some more information is being logged.
- Fix: Exception in attribute drawer
- Fix: Nullreference exception from EditorSync when trying to re-assign a missing script
### Engine
- Change: postprocessing DOF exposes resolution scale and takes device pixel density into account. By default the resolution is slightly lowered on mobile devices
## [2.67.16-pre.1] - 2023-04-12
### Exporter
- Fix: key exception in ExportInfo version check
## [2.67.16-pre] - 2023-04-12
### Exporter
- Change: dont change font name casing
### Engine
- Add: static ``AudioTrackHandler.dispose`` for disposing loaded audio data in timeline
- Fix: issue where only the first audio clip would be played in a timeline with multiple audio clips of the same file
- Change: Text should not change font name casing
- Change: Timeline does now wait for audio and first interaction by default (if any audio track is being used, this can be disabled by setting `waitForAudio` to false on the PlayableDirector component)
## [2.67.15-pre] - 2023-04-12
### Exporter
- Change: Automatically use PBRGraph or UnlitGraph for known shaders when creating a new material
- Change: adding nullchecks to DriveHelper, it seems a drive or drive name can also be null
- Change: show "MODULE NOT FOUND" as error in Unity
### Engine
- Fix: Issue where ControlTrack was not being able to resolve bound timeline
- Fix: issue with font generation where font file name contained a dot
## [2.67.14-pre] - 2023-04-12
### Exporter
- Add: symlink support check (FAT32 and exFAT)
### Engine
- Change: WebXR camera now copies culling mask from main camera
- Fix: WebXRController raycast on all layers
- Fix: WebXR all layers should be visible
- Fix: set pointer position properly on mouse down to prevent jumps in delta
- Fix: respect IgnoreRaycast in physics raycasts
- Fix: issue with CircularBuffer where sometimes the same item was returned twice
- Fix: boxcolliders with scale 0 (such as adding a BoxCollider to a plane) resulted in flipped normals being returned from raycasts
- Fix: parenthesis error in CharacterController
- Fix: issue with mouse vector position being re-used causing delta position being falsely modified
## [2.67.13-pre] - 2023-04-11
### Exporter
- Add: disc formatting check for FAT32
### Engine
- Fix: Animation component settings
- Fix: instanced renderer matrix auto update
- Change: enable shadow casting in instanced rendering when any mesh has castShadow enabled
- Change: export ui pointer events
## [2.67.12-pre] - 2023-04-09
### Exporter
- Add: Support exporting immutable scenes (e.g. when referencing a scene in an immutable package)
- Add: SSAO color and luminance influence options
- Fix: handle invalid formatting of vscode workspace json
- Change: Clicking on missing script (uninstalled npmdef / rendered in red font) now pings npmdef (you can double click to still open the script)
- Change: try to find toktx in default install directory on windows and not show warning/error when user has it installed (but not in parth)
- Change: Rename `CustomPostprocessingEffect` to `PostprocessingEffect` to make codegen work (e.g. when creating a custom PostProcessingEffect)
### Engine
- Add: SSAO color and luminance influence options
- Change: postprocessing now exposes effect order
## [2.67.11-pre] - 2023-04-08
### Exporter
- Add: support for exporting skybox and fog settings for referenced scenes
- Fix: ExportInfo getting stuck without install button
- Fix: ProcessHelper remove invalid control characters that might come in from external process breaking logs / showing incomplete information
- Change: Delete broken Unity package install directory (e.g. when hidden Needle Engine directory exists but is empty)
- Change: Show info in "Install Project" Button tooltip what is missing / why it's not installed
- Change: update react template
### Engine
- Add: some checks for WebGPURenderer
## [2.67.10-pre] - 2023-04-06
### Exporter
- Add: tags to samples window
- Change: hold ALT to restart local server (when server is running)
- Change: EditorSync: install ^1.0.0-pre by default
### Engine
- Add vite copy files build plugin
- Fix: PostProcessing not applying effects when enabled for the second time as well as removing earlier hack
- Change: update user-select/touch-action in project templates style.css to prevent accidental iOS selection of canvas
- Change: disable text selection on Needle logo
- Bump three version, see changes below
### Three
- change USDZExporter: pass writer into onAfterHierarchy callback, move onAfterHierarchy callback after scene hierarchy write
- fix USDZExporter: fix exception when trying to process render targets
- fix WebXRManager: Correctly update the user camera when it has a parent with a non-identity transform.
## [2.67.9-pre] - 2023-04-03
### Exporter
- Add: Bug Report upload functionality
- Fix: spritesheet export and display for non-similar sprite shapes
- Change: Improve feedback when nodejs is not installed
- Change: run install in local package.json dependencies
- Change: optimized Spritesheet data export resulting in smaller files
### Engine
- Change: SpriteRenderer material to transparent
- Bump: tools package dependency
## [2.67.8-pre.1] - 2023-03-31
### Exporter
- Bump engine version
- Bump UnityGLTF dependency
### Engine
- Fix: exception when using BoxColliders caused by error in initial activeInHierarchy state assignment
## [2.67.8-pre] - 2023-03-31
### Exporter
- Bump engine version
### Engine
- Fix: vite plugins must have a name
- Fix: activeInHierarchy update when key is undefined (e.g. in r3f context)
- Change: cleanup r3f component
## [2.67.7-pre] - 2023-03-30
### Exporter
- Internal: samples can now have tags
### Engine
- Add: time smoothed delta time
- Add this.context.targetFrameRate
- Fix: enum / type conversion errors
- Fix: CanvasGroup overriding text `raycastTarget` state in event handling causing problems with button events
- Fix: Text z-fighting from invisible ThreeMeshUI frame object
- Change: Canvas `renderOnTop` moved into separate render call to avoid ordering issues and postprocessing affecting overlay UI
- Internal: Move context from engine_setup to engine_context
## [2.67.6-pre] - 2023-03-30
### Exporter
- Fix: reset blurred skybox color
### Engine
- Fix: Postprocessing enforce effect order
- Change: gizmos should not render depth
## [2.67.5-pre] - 2023-03-30
### Exporter
- Fix: issue where context menu export didnt export all known components
- Fix: dont import npmdef types multiple times
### Engine
- Fix: issue where postprocessing did not check composer type (e.g. when using threejs composer instead of pmndrs package)
- Change: Postprocessing now uses stencil layers
## [2.67.4-pre] - 2023-03-28
### Exporter
- Bump engine version
### Engine
- Change: Postprocessing effects value mapping / settings improved (Bloom & ColorAdjustments)
## [2.67.3-pre] - 2023-03-28
### Exporter
- Bump engine version
### Engine
- Fix: issue where progressive textures would not be applied correctly anymore
- Fix: Timeline audio loading on firefox
- Fix: issue where progressive textures with reflection probes wouldn't be applied correctly anymore
## [2.67.2-pre] - 2023-03-28
### Exporter
- Fix: registry component codegen should not generate extra c# types for npmdefs that exist locally
- Change: bump UnityGLTF dependency
### Engine
- Change: calculations for rect transform animation offsets
- Change: Warn if engine element src contains a url without .glb or .gltf
## [2.67.1-pre] - 2023-03-28
### Exporter
- Change: disable soft restart button while installing EditorSync
- Remove: physics debug log when raycasting
### Engine
- Fix: PostProcessing failing to be re-applied after exit XR
## [2.67.0-pre] - 2023-03-27
### ⭐ Highlights
#### **Editor Live Sync 🔴**
Immediately see changes made in the Unity Editor in your three.js scene. Add the Needle Editor Sync component to your scene to get started.
#### **More PostProcessing effects**
Adding Bloom, Depth of Field, ColorAdjustments, Chromatic Aberration, Screenspace Ambient Occlusion, Vignette, AntiAliasing powered by pmndrs' postprocessing package.
#### **WebAR Camera Background**
Taking scene screenshots in AR now also includes the camera image. This paves the way for adding custom camera and AR effects in future versions!
### Exporter
- Add: **EditorSync** component and package to send changes in the editor to the three.js scene. In this first version it can be used to modify material properties, change certain component values at runtime, enable or disable objects as well as to render from the Unity scene camera. To use just add the EditorSync component to scene and click the Install button.
- Add: **More postprocessing effects**: Bloom, ChromaticAberration, ColorAdjustments, DepthOfField, Pixelation, Screenspace Ambient Occlusion, Tonemapping, Vignette. Custom effects can easily be implemented by deriving from the `PostProcessingEffect` base class
- Add: Support to adjust postprocessing effects from the Unity Editor when EditorSync is being used
- Add: **WebARCameraBackground** that can be used to apply effects to the camera image (or capture the image when taking scene screenshots while in AR) using the WebXR Raw Camera access API
- Add: NpmDef `Publish to npm` button
- Add: **Integration of using NpmDefs published to npm**, generating C# components from packages with Needle Engine components installed via npm. This allows to publish packages with Needle Engine typescript components and when installed in a Unity project the corresponding C# components will be generated and discovered on export.
- Change: DeployToFTP should not log error in check if a directory already exists
- Change: Show info in scene view when using SmartExport and scene would not be exported because nothing has changed
- Fix: Remove legacy `camera` field on `SyncCamera` component
- Fix: Typo in allowed camera fields causing `ARBackgroundAlpha` to not be exported
- Fix: wrong warning for NpmDef being missing when name was containing a `.`
- Fix: Issue in welcome window where certain URLs were opened twice
- Fix: Issue where assembly reload lock would not be unlocked again
- Other: Internal cleanup and deletion of a lot of legacy code that was originally used to build three.js scenes from javascript codegen
- Other: Improved menu items order and wording
### Engine
- Add: `this.gameObject.destroy` as a shorthand for `GameObject.destroy(this.gameObject)`
- Add: support for camera `targetTexture` to render into a RenderTexture (when assigned to e.g. the main camera in Unity)
- Add: utility methods to toplevel engine export (for example `getParam`, `delay`, `isMobileDevice`, `isQuest`)
- Add: first version of usage tracking of materials, textures and meshes. This is off by default and can be enabled using the `?trackusage` url parameter. When enabled `findUsers` can be used to find users of an object.
- Add: pmnders postprocessing package
- Change: improved PlayerState component and added event for PlayerState events for owner change (to properly listen to first assignment)
- Change: `AssetReference.unload` now calls dispose to free all resources
- Change: `WebXR` component now has static field for modifying optionalFeatures
- Change: `Physics.RaycastOptions` now have a `setLayer` method to simplify setting the correct layer mask (similar to Unity's layers to enable e.g. just layer 4 for raycasting)
- Change: `RemoteSkybox` now requests to re-apply clear flags on main camera when disabling to restore previous state.
- Fix: issue where component instances were created using wrong method causing arrow functions to be bound to the wrong instance
- Fix: `@syncField` now properly handles destroy of an component
- Fix: react-three-fiber template
- Fix: ParticleSystem prewarm safeguard and additional checks where emission is set to 0
- Fix: Timeline only playing first audio clip
- Fix: Issue where scene with multiple root glbs cross-referencing each other were not being resolved correctly in all cases
- Fix: Progressive textures not being loaded when using tiling
- Fix: Text UI anchoring
## [2.66.1-pre] - 2023-03-16
### Exporter
- Add: additional option to Lightmap format dialogue to set the right format when exporting using unsupported lightmapping quality setting
- Fix: AutoInstall nullref if installing a package in a scene that has no Needle Engine project
- Fix: BRP `shadowBias` conversion
- Fix: unassigned methods in Unity Events ("No Function") were throwing an exception on export
- Fix: change detection (Smart Export) for referenced assets was not checking for changes in some cases
- Change: component header link now has file extension
- Change: Bump UnityGLTF dependency
- Change: allow specifying double jump force separately in CharacterController
### Exporter
- Add: `sphereOverlapPhysics` function for more accurate sphere overlap detection using rapier
- Fix: Gizmos should be excluded from being hit by raycasts
- Fix: Gizmo sphere radius was twice the desired size
- Fix: Physics now prevent negative collider scale
- Fix: renderer instancing auto update when using multi material objects
- Change: Show warning that stencil and instancing doesnt work together at the moment
## [2.66.0-pre.1] - 2023-03-14
### Exporter
- Fix: issue where scene assets wouldnt be exported properly anymore
- Fix: issue with very first web project installation in a new unity project
## [2.66.0-pre] - 2023-03-14
### Exporter
- Fix: AssetReferenceResolver should not export references on a asset root as separate glbs
- Fix: skip serialization for `transform` property on components
- Fix: Updater should trim leading whitespace when testing if line is import and needs to be updated
- Fix: npmdef button "Add to project" / "Remove from project" not updating workspace
- Fix: deprecated import in basic_component template
- Fix: NestedGltf should not dont traverse into EditorOnly objects
- Change: Export cache: check if the parent context is null (in case of e.g. export from prefab)
- Change: Prevent exporter from re-exporting glb with the same name multiple times per run. Instead print a warning. This can be caused by e.g. using nested gltfs or GltfObject components where the GameObject has the same name as another previously exported GltfObject
- Change: Full Export does now also kill local server, add "force" to search for node processes running current web project
- Change: Updater can now run for immutable package when in hidden directory
- Remove legacy transform.guid code that slowed down export in scenes with many objects
### Engine
- Add: particle system prewarm support
- Add: `poseMatrix` argument in WebARSessionRoot.placedSession event
- Add: MeshCollider minimal support for submeshes (they can be added but currently not removed from the physics world)
- Fix: debug_overlay error when rejection reason is null
- Fix typo beginListenBinrary → beginListenBinary
- Fix: particle system staying visible after disabling gameObject
- Fix particle system not finding subemitter in certain cases
- Fix: particles with subemitters and trails and disabled "die with particle" should emit subemitter when the particle dies (and not when the trail dies)
- Fix: Loading overlay now hides when loading is done and the first frame has finished rendering
- Change: rename networking `stopListening` to `stopListen` for consistency
- Change: addressables allow up to 10k instantiations per frame before aborting
- Change: set material shadowSide to match side
- Change: generate poster image with 1080x1080 px and add `og:image:width` and `og:image:height` meta tags
## [2.65.2-pre] - 2023-03-11
### Exporter
- Fix: custom shader export of uv2 etc
- Fix additional data button should now show up on model importer
- Change: dont run Updater automatically if `allowProjectFixes` is disabled (in Needle settings)
- Change: dont run Updater for script files in PackageCache
- Change: custom shader export now caches previously exported shaders (per export) when having a scene with multiple materials using the same custom shader
- Change: log warning when exporting with gzip disabled (it is disabled by default, please check your Build Settings)
### Engine
- Change: custom shaders should not log warning for unsupported ``OrthoParams`` shader property
- Change: Animator methods starting with uppercase are marked as deprecated because UnityEvent methods are now exported starting with lowercase letter, added lowercase methods
## [2.65.1-pre] - 2023-03-10
### Exporter
- Change: Updater now locks assemblies during auto-update to avoid components from recompiling and aborting export or server start
### Engine
- Fix: ParticleSystem using `min/max` size in the renderer module is now minimally handled
- Fix: ParticleSystem emission when using local space with scaled parents
- Fix: ParticleSystem not finding SubEmitter systems
- Fix: ParticleSystem simulation speed not being applied to gravity and initial speed
- Fix: RemoteSkybox not resolving relative url correctly (when assigning a cubemap in the editor)
## [2.65.0-pre.1] - 2023-03-10
### Exporter
- Fix: issue where `<needle-engine>` element was not yet in the DOM when queried by exporter codegen which caused the paths to not be assigned and the engine to not load
### Engine
- Fix: issue where `<needle-engine>` element was not yet in the DOM when queried by exporter codegen which caused the paths to not be assigned and the engine to not load
## [2.65.0-pre] - 2023-03-09
### Exporter
- Add: Updater to fix wrong import paths due to change in engine package structure (`@needle-tools/engine/src/...`)
- Change: codegen for loading the exported glbs in main scene is now simplified, removing previous and legacy code completely. It now just collects all exported files in an array and sets that as the `src` attribute on the `<needle-engine>` web component.
- Change: project settings should not show warning for Engine package not being installed when the current scene is not a web project
- Change: engine package should only be automatically installed on update when the current scene is a web project
- Change: type imports now generate without an extension to fix distributed `lib` imports
- Fix: error where unresolved package.json variable did cause IllegalChar exception
- Fix: improved npmdef error handling caused by the hidden package being missing which might happen if a user copies the npmdef to another Unity project but does not copy the hidden package folder (ending with ~). Such cases are now also properly displayed in the ExportInfo component
- Fix: BugReporter should not print error message about toktx not being installed when collecting project information
### Engine
- Add: runtime checks for recursive loading to prevent it from breaking
- Change: internal duplicate active state on `Object3D` has been removed, instead `visible` is used. This was previously a workaround for the `Renderer` setting the visible state when being enabled or disabled but this has been changed in a previous version and it now only sets a flag in the object's Layers instead (which allows for a single object in the hierarchy to not being rendered by setting `Renderer.enabled = false` while objects in the child hierarchy stay visible)
- Change: `<needle-engine>` src attribute can now also take an array of glbs to load. This simplifies codegen done by exporters and also prevents errors due to bundler optimizations as well as being easier to understand. Runtime changes of the `src` attribute (especially when using arrays of files) have not been tested for this release. Networking for `src` changes has been removed in this release.
- Change: move engine into src subfolder. All paths to explicit script files are now `@needle-tools/engine/src/...`
- Change: poster screenshot will be taken after 200ms now
- Change: canvas default set to false for castShadow and receiveShadow
- Change: Remote skybox should not set `scene.background` when in XR with pass through device (e.g. when using Quest Pro AR or AR on mobile)
- Fix: issue where ColorAdjustments Volume effect was applied with `active` set to false
- Fix: `Light` not being enabled again after disabling the component once
## [2.64.0-pre] - 2023-03-07
### Exporter
- Add: dependency to `csharp to typescript` package.
> This allows to quickly create typescript skeleton or stub components from existing csharp code
> Created components try to import used types if known, create fields with `@serializable` decorations and methods (the method body needs to be implemented manually)
> Use the context menu item on csharp script assets or on components in the scene
- Add: When your package.json contains a script named `install` the exporter will invoke this script instead of directly running `npm install`. This allows running projects that e.g. require `yarn install`
- Add: Export audio volume for timeline clip (Timeline audio track settings are not yet supported)
- Fix: Clean install when using project paths starting with `Packages/` or `Assets/`
- Fix: Issue where the `enabled` property of some component types was not exported anymore (e.g. colliders)
- Fix: Issue with license import when using vite 2 caused by BOM
### Engine
- Add: `PlayableDirector` now correctly applies timescale
- Add: `PlayableDirector.speed` property allowing to play the timeline at different speeds or even reverse (reversed audio playback is not supported at the moment)
- Add: `Physics.enabled` property for disabling physics updates. This also prevents any collider shapes to be created
- Add: `this.gameObject.transform` property to ease getting started for devs coming from Unity. This property is merely a forward to `this.gameObject` and shouldnt really be used. The property description contains information and a [link to the docs](https://fwd.needle.tools/needle-engine/docs/transform) with further information.
- Fix: instanced materials using progressive loading are now correctly updated
- Fix: Timeline animation tracks now disable the `Animator`. This fixes cases where two animations were played at the same time. When the PlayableDirector is paused or stopped the animator state is reset
- Fix: License styles leaking into website
- Fix: Timeline audio not stopping correctly at end of timeline when set to hold
- Change: improve instancing updates, instanced objects now auto update detect matrix changes. This includes improvements of instancing when used with `Animation` components
- Change: set particle system layers to `IgnoreRaycast` to not receive wrong click events on batched particle meshes
- Change: Timeline audio is now loaded on evaluation. Only clips in a range of 1 second to the current time are loading. To manually trigger preload of audio you can invoke `loadAudio` with a time range on audio tracks of a timeline
## [2.63.3-pre] - 2023-03-03
### Exporter
- Change: ExportInfo should install should not show too much information when ALT is pressed
- Change: project generator should not replace version for needle engine in package.json paths
- Fix: project generator should insert package path if the dependency is an empty string
### Engine
- Fix: engine published to npm was missing vite plugins
## [2.63.2-pre] - 2023-03-03
### Exporter
- Add: ExportInfo context menu `Internal/Move Project` to move a web project
- Change: allow web projects in Assets/ and Packages/ directories (when they're in a hidden folder like `Assets/MyProject~` or `Packages/com.my.package/MyProject~`)
- Change: ignore build.log
- Change: bump UnityGLTF dependency
- Fix npmdef open button, rename "path" to "name" because that's what it is
- Fix: deploy to ftp when server name starts with ftp.
### Engine
- Fix: license styling in some cases
- Fix: duplicatable + draggable issue causing drag to not release the object (due to wrong event handling)
- Fix duplicatable + deletion not working properly
- Fix: timeline breaking when time is set to NaN
## [2.63.1-pre] - 2023-03-02
### Engine
- Add: components now have `up` and `right` vectors (access via ``this.up`` from a component)
- Fix: import of license and logo for npm package
## [2.63.0-pre] - 2023-03-01
### Exporter
- Add: licensing information
### Engine
- Add: licensing information
- Add: logo to loading display
- Change: VideoPlayer now exposes VideoMaterial
- Change: Screencapture now only accepts clicks with pointerId 0 (left mouse button, first touch) to toggle screen capture
- Change: expose physics gravity setting `this.context.physics.gravity`
## [2.62.2-pre] - 2023-02-27
### Engine
- Add: support for `camera-controls` attribute on `<needle-engine>` element. When added it will automatically add an `OrbitControls` component on start if the active main camera has no controller (you can assign custom controllers by calling `setCameraController` with the camera that is being controlled)
- Fix: rare error in extension_util
- Fix: timeline preExtrapolation setting
- Fix: disabling Light component should turn off light
- Fix: animating camera fov, near or far plane
- Fix: threejs layer patch for Renderer visibility is now always applied
- Fix: UI runtime instantiate of canvas from templates in scene
- Fix: UI text did not update shadow-component-owner on font loading
- Fix: UI EventSystem raising click event multiple times in some cases
- Fix: UI Text raycast now respects object layer (NoRaycast)
- Fix: UI duplicate pointerUp event
- Fix: UI highlighting getting stuck in wrong state sometimes
## [2.62.1-pre] - 2023-02-23
### Exporter
- Add: FontAdditionalCharacters component to allow to specifiy additional fonts to be included in a font atlas
- Fix: missing animationclip in director caused export exception
- Fix: ComponentGenerator not watching subdirectories in `src/scripts`
- Fix vite plugin not using config codegen directory
- Fix vite plugin assuming <needle-engine> web component in index.html and producing error if not found
- Change: bump UnityGLTF to 1.22.4-pre
### Engine
- Fix: pause wasn't evaluating and thus not pausing audio tracks
- Fix: debug overlay styles were not properly scoped and affected objects inside needle-engine tag
- Fix: Addressables wrong recursive instantiation error
- Fix: UI not showing fully when setting active at runtime
- Change: timeline tracks are now created immediately but their audio clips are deferred until audio is allowed
## [2.62.0-pre] - 2023-02-13
### Exporter
- Add: Meshopt decoder support for engine-loaded glTF files
- Add: better logs when running in headless mode and operations fail due to non-installed packages
- Fix: nullrefs when saving in scenes that don't have ExportInfo components
- Fix: explicit texture compression "None" resulted in wrong compression applied in some cases
- Change: Update UnityGLTF dependency including fixes for specular extension roundtrips, importer improvements
## [2.61.0-pre] - 2023-01-30
### Exporter
- Add: batch export now allows `-scene` arg to point to a prefab or asset and adds `-outputPath` argument to define the path and name of the exported glb(s)
- Fix: rare vite plugin poster error when include directory does not exist
- Fix poster incorrectly being generated when building
- Fix: Dialog that shows up when lightmap encoding settings are wrong now shows up less often
- Fix: serialized npmdefs with wrong paths are not automatically repaired or cleaned up from serialized data
- Change: Bug reporter now assumes .bin next to .gltf is a dependency until .bin is properly registered as a dependency in Unity
- Change: bump gltf-pipeline package fixing a rare bug where toktx could not be found
### Engine
- Add: canvas applyRenderSettings
- Add: progressive support for particle system textures
## [2.60.4-pre] - 2023-01-27
### Exporter
- Change: dont reload page while build preview is in progress (when running ExportInfo/Compress/PreviewBuild)
- Fix: bump build pipeline package to fix issue where texture compression settings were taken from wrong texture
- Fix: vite reload plugin sometimes preventing reload
### Engine
- Fix UI prefab instantiate throwing error at runtime
- Change: show warning when unsupported canvas type is selected
- Change: show warning when trying to use webxr features in non-secure context
## [2.60.3-pre] - 2023-01-26
### Exporter
- Fix register type error when component class with the same name exists multiple times in the same web-project in different files [issue 49](https://github.com/needle-tools/needle-engine-support/issues/49)
- Fix: NeedleAssetSettingsProvider and simplify setting texture settings on import like so:
```csharp
if (NeedleAssetSettingsProvider.TryGetTextureSettings(assetPath, out var settings))
{
settings.Override = true;
settings.CompressionMode = TextureCompressionMode.UASTC;
NeedleAssetSettingsProvider.TrySetTextureSettings(assetPath, settings);
}
```
### Engine
- Fix: camera fov for blender export allowing fieldOfView property to be undefined, where the fov should be handled by the blender exporter completely.
## [2.60.2-pre.1] - 2023-01-26
### Exporter
- Fix: remove accidental codice namespace using in 2022
## [2.60.2-pre] - 2023-01-26
### Exporter
- Add: Api to access texture compression settings (use `NeedleAssetSettingsProvider`)
- Add pre-build script to run tsc
- Fix: cubemap export fallbacks to LDR format if trying to export cubemap on unsupported build target (e.g. Android)
- Fix: project paths replacement when path has spaces
- Fix: remove global tsc call before building
### Engine
- Fix: particle textures being flipped horizontally
## [2.60.1-pre.1] - 2023-01-25
### Exporter
- Fix: Smart export file size check if file doesnt exist
## [2.60.1-pre] - 2023-01-25
### Exporter
- Change: Make cubemaps use correct convolution mode, downgrade error to warning
- Change: Cubemap warning should not show for skybox
- Change: Smart export check if file exported was < 1 kb in which case we always want to re-export
- Change: vite server plugin now communicates scheduled page reload to client
- Change: bump gltf extensions package dependency
- Fix: vite reload on changed codegen files (it should not reload there)
### Engine
- Change: export Mathf in `@needle.tools/engine`
## [2.60.0-pre] - 2023-01-25
### Exporter
- Add: check allowed cubemap convolution types and log error if that doesn't match
- Change: Remove `backgroundBlurriness` setting on RemoteSkybox (should be controlled on the camera)
- Fix: ExportInfo now doesnt display packages as `local` on OSX anymore
- Fix: GltfReference nullref when exporting via context menu, always ignore smart export for context menu exports
- Fix NEEDLE_gltf_dependencies extension causing gltfs to be invalid
- Fix: Platform compiler errors
### Engine
- Add: Particles support for horizontal and vertical billboards
- Add: Timeline now supports reversed clip (for blender timeline)
- Change: bump gltf pipeline package dependency adding support for global `NEEDLE_TOKTX` environment variable
- Change: timeline clip pos and rot are now optional (for blender timeline)
- Fix: when first loading a gltf pass guidsmap to components (for blender timeline)
- Fix: scrubbing TimelineTrack scrubs audio sources as well now
- Fix: stencils for multimaterial objects
## [2.59.3-pre] - 2023-01-21
### Exporter
- Add: particles basic support for on birth and ondeath subemitter behaviour
- Change: run typescript check before building for distribution
- Fix: saving referenced prefab with auto-export causing export to happen recursively
- Fix: improve vite reloading, generate needle.lock when exporting from referenced scene or prefab to prevent reloading while still exporting
- Fix: vite reloading scripts for usage with vuejs
### Engine
- Add: particles basic support for on birth and ondeath subemitter behaviour
## [2.59.2-pre.1] - 2023-01-20
### Engine
- Fix: issue where click on overlay html element did also trigger events in the underlying engine scene
## [2.59.2-pre] - 2023-01-20
### Exporter
- Add: save in Prefab Mode does now attempt to re-export currently viewed prefab (similarly to how referenced scenes will re-export if they are referenced in a currently running web project)
- Change: EXR textures are now exported zipped (UnityGLTF)
- Change: OrbitControls now use damping (threejs)
- Change: default mipmap bias is now -0.5 (threejs)
- Change: DeployToFTP inspector now shows info if password is missing in server config asset
- Change: Bump dependencies
- Fix: export of human animation without transform when discovered from animatorcontroller should not cause errors
- Fix: handle cubemap export error on creating texture when Unity is on unsupported platform
- Fix: context click export for nested element in hierarchy
- Fix: bump gltf-transform-extensions package fixing a failure when using previously cached texture data but not setting the texture mime-type which caused errors at runtime and the texture to not load
- Fix: timeline now skips exporting clips with missing audio assets in AudioTrack
- Fix: subasset importer throwing nullref when selecting subassets from multiple assets and modifying their import settings
- Fix: Unity build being blocked by BuildPlayerHandler
- Fix: Unity build errors
### Engine
- Add: SpectatorCam.useKeys to allow users to disable spectator cam keyboard input usage (`f` to send follow request to connected users and `esc` to stop following)
- Change: expose SyncedRoom.RoomPrefix
## [2.59.1-pre] - 2023-01-18
### Exporter
- Fix: export error where object was being exported twice in the same event as transform and as gameObject due to self-referencing
## [2.59.0-pre] - 2023-01-18
### Exporter
- Add: Smart Export option, which will not re-export referenced prefabs or scenes if they didnt change since the last export (enable via ProjectSettings/Needle) improving export speeds significantly in certain cases. This option is off by default
- Add: lock file to prevent vite from reloading while export is still in process
- Add: warning when older nodejs version fails because of unknown ``--no-experimental-fetch`` argument
- Change: Some methods of DeployToFTP can now be overriden to customize uploading
- Change: TextureCompressionSettings can now be overriden to customize compression settings
- Change: Minor optimization of exported json, removing some unused data to reduce output size slightly for large or deeply nested projects
- Fix: Issue where vite reload plugin did sometimes not trigger a reload after files have changed
- Fix: Issue where prefab containing GltfObject did not create a nested gltf to be lazily loaded
- Fix: Issue where nested gltf would cause IOException when it had the same name as an glb in the parent hierarchy
- Fix: TextureSizeHandler not being used when not added to GltfObject. It can now be added to any object in the scene to globally clamp the size of exported textures.
- Fix: Export of default font in 2022 (LegacyRuntime)
- Fix: AnimatorOverrideController is now properly ignored (currently not supported) instead of being serialized in a wrong/unexpected format which did cause errors at runtime
- Fix: Issue where DeployOnly did cause already compressed assets in output directory being replaced by uncompressed assets
- Fix: Texture compression set to ``Auto`` did not be properly export
- Fix: issue where default compression wasnt applied anymore when no specific compression settings where selected / setup anywhere
- Fix: Context menu export with compression from Project window now runs full compression pipeline (applying progressive transformation as well as compression)
- Remove: Experimental SmartExport option on GltfObject
### Engine
- Add: AssetReference.unload does now dispose materials and mesh geometry
- Add: ``setParamWithoutReload`` now accepts null as paramValue which will remove the query parameter from the url
- Change: timeline does now skip export for muted tracks
- Change: OrbitControls can now use a custom html target when added via script and before enable/awake is being called (e.g. ``const orbit = GameObject.addNewComponent(this.gameObject, OrbitControls, false); orbit.targetElement = myElement``)
- Change: Input start events are now being ignored if a html element is ontop of the canvas
- Fix: use custom element registry to avoid error with `needle-engine element has already been defined`
- Fix: timeline not stopping audio on stop
- Fix: input click event being invoked twice in certain cases
- Fix: ParticleSystem start color from gradient
- Fix: ParticleSystem not properly cleaning up / removing particles in the scene in onDestroy
- Fix: ParticleSystem velocity now respects scale (when mode is set to worldscale)
## [2.58.4-pre] - 2023-01-14
### Exporter
- Update template vite config to improve reloading (you can update the vite config in existing projects via ExportInfo Context Menu > Update vite config)
### Engine
- Update gltf-extensions package dependency
## [2.58.3-pre] - 2023-01-13
### Exporter
- Change: Update UnityGLTF dependency including fixes for gltf texture imports
- Fix: run install on referenced npmdefs for distribution builds when packages have changed
- Fix: catch WebRequest invalid operation exception
## [2.58.2-pre.1] - 2023-01-13
### Exporter
- Fix: compiler error on osx and linux
## [2.58.2-pre] - 2023-01-12
### Exporter
- Add: start support for targeting existing web projects
- Add: support for animating color tracks when only alpha channel is exported
- Change: use vite for internal compiling of distributable npm package of needle-engine
- Change: remove scene asset context menu override
- Change: bump UnityGLTF dependency
- Change: run compression commands when building web project from Unity
- Fix: OSX component compiler commands not being executed when containing spaces
- Fix: Linux using sh for terminal commands instead of zsh
- Fix: Blendshape normals export
- Fix: error in vite plugin generating poster image
- Fix: Embedded assets for 2022 could not select Needle Engine compression settings
- Fix: Texture MaxSize setting not being passed to UnityGLTF
- Fix: Occasional error when exporting fog caused by component not being in runtime assembly
- Fix: Component compiler should update watcher when project directory changes
- Fix: Export of color alpha animation
- Fix: Light shadow bias settings export for URP when light didnt have UniversalAdditionalLightData component
### Engine
- Change: use draco and ktx loader from gstatic server by default
- Change: reduce circular dependencies
- Fix: Reflectionprobe selecting wrong probe when multiple probes had the exact same position
## [2.58.1-pre] - 2023-01-09
### Exporter
- Fix: light default shadow bias values
- Fix: template vite config
- Fix: timeline exported from prefab was sometimes not exported correctly (due to Playable graphs) - this is now fixed by rebuilding the graph once before export
### Engine
- Add: Prewarm rendering of newly loaded objects to remove lag/jitter when they become visible for the first time
- Change: renderer now warns when sharedMaterials have missing entries. It then tries to remap those values when accessing them by index (e.g. when another component has a material index serialized and relies on that index to be pointing to the correct object)
## [2.58.0-pre] - 2023-01-09
### Exporter
- Add hot reload setting (requires vite.config to be updated which can be done from ExportInfo context menu)
- Add fog export
### Engine
- Add: EventSystem input events (e.g. IPointerClick) are now invoked for all buttons (e.g. right click)
- Add: Hot reload for components
## [2.57.0-pre] - 2023-01-07
### Exporter
- Add: meta info export for vite template
- Add: HtmlMeta component to allow modification of html title and meta title/description from Unity
- Add: Support for poster image generation
- Change: Use custom vite plugin for gzip setting
### Engine
- Remove: Meshline dependency
- Fix: Testrunner Rigidbody import error
## [2.56.2-pre] - 2023-01-06
### Exporter
- Fix: BuildPlatform option for Unity 2021 and newer
- Fix: npm install command for npm 9
- Fix: Light shadowBias settings for Builtin RP
- Change: Include npm logs and version info in bug report logs
### Engine
- Change: Component.addEventListener argument can now derive from Event
## [2.56.1-pre] - 2023-01-05
### Exporter
- Add: initial batch mode / headless export support, can be invoked using `path/to/Unity.exe -batchmode -projectPath "path/to/project" -executeMethod Needle.Engine.ActionsBatch.Execute -buildProduction -scene "Assets/path/to/scene.unity"`, use `-debug` to show Unity console window during process
- Fix: sample window now locks assembly reload while downloading until after installation has finished, show progress report for user feedback
- Fix: sample window not respecting user cancel
### Engine
- Fix: UI setting Image.sprite property did apply vertical flip every time the sprite was set
## [2.56.0-pre] - 2023-01-04
### Exporter
- Add: mesh compression support
- Add: compression settings for textures and meshes in embedded assets (e.g. an imported fbx or glb now has options to setup compression for production builds)
- Change: Bump UnityGLTF dependency adding caching of exported image data to speed up exports for texture heavy scenes
### Engine
- Add: file-dropped event to DropListener
- Add: UI image and raw image components now support updating texture/sprite at runtime
- Change: Bump needle gltf-transform extensions package adding mesh compression and caching for texture compression leading to significant speedups for subsequent production builds (only changed textures are re-processed)
- Fix: light normal bias defaults
## [2.55.2-pre] - 2023-01-02
### Exporter
- Change: log warning if node is not installed or can not be found before trying to invoke component compiler
- Fix: handle `node` commands similarly to how `npm` commands work
### Engine
- Add: Rigidbody.gravityScale property
- Add: Gizmos.DrawArrow method
- Add: Rigidbody.getAngularVelocity method
- Fix: Mesh collider center of mass
## [2.55.1-pre] - 2022-12-30
### Exporter
- Add: Command Tester window
- Fix: error on OSX when nvm directory does not exist
### Engine
- Add: Warning when serialized component field name is starting with uppercase letter
- Change: bump component compiler dependency
- Fix: Particle rotation over lifetime
- Fix: Particles should not emit when emission module is disabled
- Fix: LODGroup breaking rendering when used with multi-material objects or added on mesh to be culled directly
## [2.55.0-pre] - 2022-12-21
### Exporter
- Add: PhysicsMaterial support
- Fix Spline export
- Fix: Renderer not exporting enabled bool
- Fix: Dev <> Production build flip in DeployToGlitch component
### Engine
- Add: PhysicsMaterial support
- Add: ``Time.timesScale`` factor
- Change: VideoPlayer exposes underlying HTML video element
- Change: EffectComposer check if ``setPixelRatio`` method exists before calling
- Change: WebARSessionRoot and Rig rotation
- Fix: WebXRController raycast line not being visible in Quest AR
- Fix: Renderer that is disabled initially now hides object
- Fix: Some ParticleSystem worldspace settings when calling emit directly
## [2.54.3-pre] - 2022-12-19
### Exporter
- Change: OSX now automatically trys to detect npm install directory when installed using nvm
## [2.54.2-pre] - 2022-12-19
### Exporter
- Change: Improve SamplesWindow adding search field and better styling
- Change: Rename ``UseProgressiveTextures`` to ``ProgressiveTextureSettings``
- Change: Progressive texture loading can now be disabled completely using ProgressiveTextureSettings component
- Change: Only generate progressive loading textures when building for distribution / making a build for deployment
- Change: Remove internal ``ObjectNames.NicifyVariableNames`` which caused unexpected output for variable names starting with `_`
- Change: Remove unused NavMesh components
- Fix: Help menu item order
- Fix: Sample window styling for single column
- Fix: Initial project generation does now run installation once before replacing template variables which previously caused errors because the paths did not yet exist.
### Engine
- Change: debug parameter can now take ``=0`` for disabling them (e.g. ``freecam=0``)
- Fix: InputField opens keyboard on iOS
## [2.54.1-pre] - 2022-12-15
### Engine
- Fix: issue with progressive loading, loading files multiple times if a texture was used in multiple materials/material slots. This was causing problems and sometimes crashes on mobile devices
- Fix: balloon messages using cached containers didnt update the message sometimes and displaying an old message instead
## [2.54.0-pre.1] - 2022-12-14
### Engine
- Fix: bump gltf extensions package fixing issue with progressive texture loading when multiple textures had the same name
## [2.54.0-pre] - 2022-12-14
### Exporter
- Add: custom texture compression and progressive loading settings for Needle Engine platform to texture importer
- Add: support for webp texture compression
- Add: tsc menu item to manually compile typescript from Unity
- Add: support for spritesheet animationclips
- Add: menu item to open bug reports location
- Change: sort component exports by name
- Change: update UnityGLTF version
- Fix: issue with wrong threejs path being written to package.json causing button "Run Needle Project Setup" to appear on ExportInfo
### Engine
- Add: start and end events for progressive loading
- Add: USDZExporter events for button creation and after export
- Change: apply WebARSessionRoot scale to exported object, e.g. if scene is scaled down on Android it should receive the same scale when exporting for Quicklook
- Fix: process reflection probe update in update event to avoid visible flickr after component enabled state has changed
## [2.53.3-pre.1] - 2022-12-12
### Engine
- Fix: implement ButtonColors
## [2.53.3-pre] - 2022-12-12
### Exporter:
- Fix: InvalidCastException when trying to export AnimatorOverrideController
### Engine
- Add: GroundProjection appyOnAwake to make it possible to just use it when the environment changes via remote skybox and not apply it to the default skybox
- Change: more strict tsconfig
- Change: allow overriding loading element
- Fix: apply shape module rotation to direction
- Fix: ParticleSystem world position not being set when shape module was disabled
## [2.53.2-pre] - 2022-12-09
### Exporter
- Change: order generated types alphabetically
- Fix: engine export codegen should only run in local dev environment
## [2.53.1-pre] - 2022-12-08
### Exporter
- Fix OSX bugs regarding nvm and additional search paths not being used correctly
## [2.53.0-pre] - 2022-12-08
### Exporter
- Add: progressive build step is now separated from Unity Exporter and runs in the background to transform exported gltfs to be progressively loaded. That requires a ``UseProgressiveTextures`` component in the scene. Textures can be excluded from being processed by adding a ``noprogressive`` AssetLabel
- Add: USDZExpoter component which will display ``Open in Quicklook`` option when running on iOS Safari instead of WebXR not supported message.
- Add: Automatically update @types/three in referenced project dependencies to match types declared in core engine
- Change: Only open dist directory after building when not deploying to either FTP or Glitch
- Change: Display toktx message about non-power-of-two textures as warning in Unity
- Change: DeployToFTP inspector now behaves just like DeployToGlitch (using ALT to toggle build type)
### Engine
- Add: InstantiateIdProvider constructor can now take string too for initializing seed
- Add: USDZExpoter component enabling ``Open in Quicklook`` option by default when running on iOS Safari
- Fix: Light intensity
- Fix: Add workaround texture image encoding issue: https://github.com/needle-tools/needle-engine-support/issues/109
- Fix: OrbitControls.enableKeys
- Fix: Remove warning message about missing ``serializable`` when the reference is really missing
- Fix: ``context.domX`` and ``domY`` using wrong values when in AR mode
## [2.52.0-pre] - 2022-12-05
### Exporter
- Add initial support for Spritesheet export (spritesheet animationclip export will be added in one of the next releases)
- Add: RemoteSkybox environmentBlurriness setting
- Add: environmentBlurriness and -Intensity setting to CameraAdditionalData component
- Update templates tsConfig adding skipLibCheck to avoid errors when types/three have errors
- Change: Dont open dist folder when deploying to a server like FTP or Glitch
- Change: Start server now checks vite.config for configured port
- Change: adjust materials to UnityGltf/PBRGraph for better cross-pipeline compatibility
### Engine
- Add iOS platform util methods
- Add ``?debugrig`` to render XRRig gizmo
- Add support for Spritesheet Animation
- Add: EventTrigger implementations for onPointerClick, onPointerEnter, onPointerExit, onPointerDown, onPointerUp
- Add: RemoteSkybox environmentBlurriness setting
- Fix: Renderer reflection probe event order issue not applying reflection probes when enabling/disabling object because reflection probes have not been enabled
- Fix: remove log in ParticleSystemModules
## [2.51.0-pre] - 2022-11-30
### Exporter
- Add: basic texture compression control using ``ETC1S`` and ``UASTC`` Asset Labels, they can be added to either textures or exported Asset (for example gltf asset) to enforce chosen method in toktx (production builds)
- Change: Improve BugReporter
- Fix: DefaultAvatar XRFlags
- Fix: Progressive texture export (high-res glb) not using selected texture compression method
### Engine
- Change: remove nebula, dat.gui and symlink package dependencies
- Change: Light does not change renderer shadowtype anymore
- Change: update threejs to 146
- Change: update threejs types
- Change: Screencapture should not start on click when not connected to networked room
- Change: WebXR returns ar supported when using Mozilla WebXR
- Fix DragControls drag interaction not disabling OrbitControls at right time
- Fix physics collider position in certain cases
- Fix Rigidbody not syncing physics position when parent transform changes
- Fix Timeline awake / active and enable
- Fix: OrbitControls calulcating target position with middle mouse click in worldspace instead of localspace causing wrong movement when parent is transformed
- Fix: Raycast in Mozilla WebXR / using window sizes instead of dom element sizes
- Fix input with scrolled window
- Fix: destroy local avatar on end of webxr session (https://github.com/needle-tools/needle-engine-support/issues/117)
- Fix: WebXRAvatar setting correct XRFlags
## [2.50.0-pre] - 2022-11-28
### Exporter
- Add: Skybox export checks to ensure texture is power of two and not bigger than 4k when exported using hdr
- Add: RemoteSkybox component to allow referencing local image texture
- Add: Set UASTC compression to sprite textures to improve production build quality for UI graphics
### Engine
- Add warning to Light when soft shadows change renderer shadow type
- Add: RemoteSkybox can now load jpg and png textures as skybox
- Change: Instantiate does now copy Vector, Quaternion and Euler objects to ensure multiple components dont share the same objects
- Fix: AnimatorController causes threejs error when creating empty animationclip (Blender)
- Fix: AnimatorController error when transition has no conditions array (Blender)
## [2.49.1-pre] - 2022-11-25
### Engine
- Add circular instantiation check to AssetReference
- Allow filtering ``context.input.foreachPointerId()`` by pointer types (e.g. mouse or touch)
- Fix typescript error in particle system module function (happened only when ``strict`` was set to false in tsconfig)
- Fix XRFlag component not being applied on startup
## [2.49.0-pre] - 2022-11-24
### Exporter
- Change: Exporter now shows dialogue when trying to export lightmaps with wrong Lightmap encoding
### Engine
- Add: input iterator methods to loop over currently active input pointer ids
- Change: input refactor to work better with touch
- Fix GraphicRaycaster serialization warning
- Fix deserialization bug when Animation clips array is not serialized (exported from blender)
- Fix: remove leftover log in AnimatorController when cloning
- Fix XR flag not correctly restoring state
- Fix reticle not being rendered when XRRig is inside WebARSessionRoot
- Fix Mozilla XR AR overlay (https://github.com/needle-tools/needle-engine-support/issues/81)
- Fix Mozilla XR removing renderer canvas on exit AR (https://github.com/needle-tools/needle-engine-support/issues/115)
## [2.48.0-pre] - 2022-11-23
### Exporter
- Add menu item to copy project info to clipboard (``Needle Engine/Report Bug/Copy Project Info``)
- Change: Reduce max size of default cubemap to 256 (instead of 2048)
- Change: ExportInfo can open folder without explicit workspace in workspace
- Change: remove keep names options in react vite template
- Change: move default project path from ``Projects/`` to ``Needle/``
- Change: remove .quit-ar styles from templates
- Fix: Export skybox in referenced prefabs using minimal size (64px) unless otherwise defined
### Engine
- Add: debug console for better mobile debugging (shows up on error on mobile in local dev environment or when using the ``?console`` query parameter)
- Add: dom element visibility checks and suspend rendering and update loops (if ``this.context.runInBackground`` is false)
- Add: ``this.context.isPaused`` to manually suspend rendering
- Add: ``IComponent.onPausedChanged`` event method which is called when rendering is paused or resumed
- Change: update copy-from-to dev dependency version to fix build error when path contains ``(``
- Change: ``this.context.input`` does now support pointer lock state (properly reports delta)
- Fix: make sure VRButton has the same logic as in three again (regex instead of try-catch)
- Fix: WebXRViewer DOM Overlay bugs when dom overlay element is inside canvas
- Fix: exitAR not being called in some cases when exiting AR
- Fix: ``this.context.domX`` and ``this.context.domY`` when web component is not fullscreen
## [2.47.2-pre] - 2022-11-17
### Exporter
- Add info to log about where to change colorspace from gamma to linear
### Engine
- Add: Initial react three fiber components
- Change: OrbitControls made lerp stop distance smaller
- Change: expose ``*enumerateActions()`` in AnimatorController
- Fix: Flipped custom reflection texture
- Fix: Volume exposure not being applied when no Tonemapping effect was set
- Fix: Volume tonemapping not respecting override state setting
- Fix: ``AudioSource.loop`` not working
- Fix: Collider center being not not applied correctly
- Fix: MeshCollider scale not being applied from object
## [2.47.1-pre] - 2022-11-16
### Exporter
- Bump Engine version and export particle trail material
### Engine
- Add: Particles subemitter support
- Add: Particles inherit velocity support
- Add: Particles size by speed support
- Add: Particles color by speed support
- Add: Particles trail now fadeout properly when "die with particle" is disabled
- Add: Particles circle shape
- Change: button hover now sets cursor to pointer
- Fix: WebXR controller disabling raycast line for hands
- Fix: WebXR hands path when not assigned in Unity
- Fix: Mesh Particles not rendering because of rotation being wrongly applied
- Fix: Mesh particles size in AR
- Fix: Particles color and size lerp between two curves
## [2.47.0-pre] - 2022-11-14
### Exporter
- Change: AxesHelper component now shows axes like in threejs
- Change: bump UnityGLTF version
### Engine
- Add: RemoteSkybox option to control if its set as background and/or environment
- Add: @serializable decorator, @serializeable will be removed in a future version
- Add: getComponent etc methods to IGameObject interface
- Add: Renderer.enable does now set visible state only without affecting the hierarchy or component active state
- Change: Expose Typestore
- Change: Animation componet does loop by default (use the AdditionalAnimationData component to set the default loop setting)
- Fix: WebXR relative hands path in subfolders
- Fix: Rigidbody did not properly detect object position change if the position change was applied a second time at the exact same target position (it worked setting it once and didnt work in subsequent calls - now it does always detect it)
## [2.46.0-pre] - 2022-11-11
### Exporter
- Change: ``Setup scene`` when creating a new camera it sets near clip plane to smaller value than default
- Change: ExportInfo pick directory button now opens last selected directory if it still exists and is in the same Unity project
### Engine
- Add: Particles limit velocity over time
- Add: Particles rotation by speed
- Add: ParticleSystem play, pause, stop and emit(count) methods
- Add: ``WebXR.showRaycastLine`` exposed so it can be disabled from code
- Fix: issues in applying some forces/values for different scaling and worldspace <> localspace scenarios
- Change: raise input events in core method to also allow receiving WebAR mock touch events
- Change: ``Animation.play()`` does not require argument anymore
## [2.45.0-pre] - 2022-11-10
### Exporter
- Add: gzip option to build menu
- Change default build to not gzipped (can be enabled in Unity's Build Window)
- Change: open output directory after building distribution
- Change: bump UnityGLTF dependency
- Fix: glitch project name must not contain spaces
### Engine
- Add: particles emission over distance
- Add: particles can enable trail (settings are not yet applied tho)
- Add: camera now useses culling mask settings
- Add: particle VelocityOverLife
- Add: particle basic texture sheet animation support
- Change: ensure ``time.deltaTime`` is always > 0 and nevery exactly 0
- Fix: progressbar handle progress event not reporting total file size
- Fix: layer on camera did affect visibility
- Fix: cloning animatorcontrollers in builds did fail because of legacy AnimatorAction name check
- Fix: ``RGBAColor.lerpColors`` did produce wrong alpha value
- Fix: custom shader ``_ZTest`` value is now applied as threejs depthTest function
## [2.44.2-pre] - 2022-11-09
### Exporter
- add: export of particle mesh
- change: bump UnityGLTF dependency
- change cubemap export: make sure the path for flipping Y and not flipping Y applies the same Y rotation
### Engine
- add ``Graphics.copyTexture``
- add ``Renderer.allowProgressiveLoad``
- add ``Gizmos.DrawBox`` and ``DrawBox3``
- add particles burst emission
- add particles color interpolation between two gradients
- fix: reflection probe material caching for when material is being changed at certain times outside of animation loop and cache applied wrong material
- fix: AnimationCurve evaluation when time and keyframe are both exactly 0
- change: reflection probe now requires anchor override
- change: bump threejs dependency
## [2.44.1-pre] - 2022-11-07
### Exporter
- Fix: serialization error for destroyed component
### Engine
- Add: start adding particle systems support again
- Change: update dependency version to needle gltf-transform-extensions package
- Change: light set to soft shadows now changes renderer shadow mode to ``VSMShadowMap`` (can be disabled by setting ``Light.allowChangingShadowMapType`` to false)
- Fix: WebXR creating AR button when called from script in awake
- Fix: ``AnimationCurve.evaluate``
## [2.44.0-pre] - 2022-11-05
### Exporter
- Add: ``Create/Typescript`` can now create script files in ``src/scripts`` if the selected file in the ProjectBrowser is not part of an npmdef - it will create a template typscript file with your entered name and open the workspace
- Change: Update component compiler version fixing codegen for e.g. ``new Vector2(1, .5)`` which previously generated wrong C# code trying to assign doubles instead of floats
### Engine
- Add support for deleting all room state by calling ``context.connection.sendDeleteRemoteStateAll()`` (requires backend to update ``@needle-tools/needle-tiny-networking-ws`` to ``^1.1.0-pre``)
- Add Hinge joint
- Add ``Gizmos.DrawLine``, ``DrawRay`` ``DrawWireSphere`` and ``DrawSphere``
- Add: physics Collision Contacts now contain information about ``impulse`` and ``friction``
- Add ``physics.raycastPhysicsFast`` as a first method to raycast against physics colliders, the returning object contains the point in worldspace and the collider. This is the most simplest and thus fastest way to raycast using Rapier. More complex options will follow in future versions.
- Fix joint matrix calculation
- Fix and improve physics Contacts point calculations
- Fix issue in physics event callbacks where ``onCollisionStay`` and ``onCollisionExit`` would only be called when ``onCollisionEnter`` was defined
## [2.43.0-pre] - 2022-11-04
### Exporter
- Change: Set template body background to black
### Engine
- Add: physics FixedJoint
- Change: CharacterController now rotates with camera
- Change: scaled mesh colliders are now cached
- Change: disable OrbitControls when in XR
- Change: first enabled camera component sets itself as rendering camera if no camera is yet assigned (mainCamera still overrides that)
- Change: package module field now shows to ``src/needle-engine``
- Change: ``Camera.backgroundColor`` assigning Color without alpha sets alpha to 1 now
- Fix: improved missing ``serializable`` detection / warning: now only shows warning for members actually declared in script
- Fix: wrong light intensity in VR when light is child of WebARSessionRoot [issue 103](https://github.com/needle-tools/needle-engine-support/issues/103)
## [2.42.0-pre] - 2022-11-02
### Exporter
- Add: explicit shadow bias settings to ``LightShadowData`` component (can be added via Light component button at the bottom of the component)
- Fix ComponentCompiler / CodeWatcher not starting to watch directory when project is not installed yet
- Fix ``CubemapExporter.ConvertCubemapToEquirectTexture`` now using same codepath as skybox export
- Fix ``ExportInfo.Play`` button does not use same code path as Editor Play button
### Engine
- Add ``context.isInAR`` and ``context.isInVR`` properties
- Add physics capsule collider support
- Add basic character controller implementation (experimental)
- Add ``context.input.getMouseWheelDeltaY()``
- Add: SmoothFollow option to restrict following on certain axes only for position
- Add: ``Rigidbody.teleport`` method to properly reset internal state
- Add: load glbs using build hash (appended as ``?v=123``)
- Change: Collision event args now exposes contacts array
- Fix Exit AR (X) button not showing up
- Fix physics collider center offset
- Fix removing colliders and rigidbodies throwing error (when trying to access properties for already removed bodies)
- Fix bug in AnimatorController causing broken animations when the same clip is used in multiple states (caused by ``mixer.uncacheCip``)
- Fix rigidbody friction allowing for physical bodies being transported on e.g. platforms
- Fix ``onTriggerStay`` being invoked with the correct collider argument
- Fix AnimatorController exit time not being used properly
- Fix AnimatorController not checking all possible transitions if one transition did match conditions but could not be made due to exit time setting
- Fix ``Renderer.sharedMaterials`` not handling SkinnedMeshRenderer
- Fix environment blend mode for mozilla XR browser on iOS
- Fix: Camera now removing self from being set as currently rendering in ``onDisable``
## [2.41.0-pre] - 2022-10-28
### Exporter
- Change: enable Auto Reference in Needle Engine asmdef
### Engine
- Add: rapier physics backend and overall improved physics system like constraint support, fixed physics collider updates and synchronization between rendering and physics world or animation of physical bodies
- Remove: cannon-es
- Add basic mesh collider support
- Add ``@validate`` decorator and ``onValidate`` event method that can be used to automatically get callbacks when marked properties are being written to (for example internally this is used on the Rigidbody to update the physics body when values on the Rigidbody component are being updated)
- Change: assign nested gltf layers
- Change: reworked Rigidbody api
- Fix: allow Draco and KRTX compression on custom hand models
- Fix: applying Unity layers to threejs objects
- Fix: BoxHelper stopped working with SpatialTrigger
- Fix: AR reticle showing up in wrong position with transformed WebARSessionRoot
## [2.40.0-pre] - 2022-10-26
### Exporter
- Add: Warnings when nesting GltfObjects with gltf models that are only copied to the output directory (effectively not re-exported) with prefab overrides
- Add: Animation component can now be configured with random time scale and offset using the additional data component (see "Add AnimationData" button on Animation component)
- Add: nested .gltf assets now copy their dependencies to the output directory
- Change: Refactor deploy to FTP using ScriptableObjects for server settings
- Change: Better compression is only used when explicitly configured by adding a ``TextureCompressionSettings`` component to the GltfObject because it also increases filesize significantly and is not always needed
- Fix: Remove old texture callback that caused textures to be added to a glb twice in some cases
### Engine
- Add: Expose WebXR hand model path
- Add: Animation component can now be configured with random time scale and offset
- Change: allow blocking overlay errors using the ``?noerrors`` query parameter
- Change: don't use Composer for postprocessing in XR (see [issue](https://github.com/needle-tools/needle-engine-support/issues/101))
- Change: physics intersections causing NaN's are now reported prominently and physics bodies are removed from physics world as an interim solution, this provides more information about problematic colliders for debugging
- Fix: bug that caused component events for onEnable and onDisable not being called anymore in some cases
- Fix: cases where loading overlay using old project template wouldnt be removed/hidden anymore
- Fix: WebXR hide large hand grab sphere
- Fix: onPointerUp event not firing using WebXR controllers when grabbing an object for the second time
- Fix: GroundProjection can now be removed again
- Fix: Custom shaders exported using builtin RP can now use _Time property
- Fix: Only create two controllers when in AR on oculus browser
- Fix: BoxHelperComponent can now handle multi-material objects (groups)
## [2.39.3-pre] - 2022-10-24
### Exporter
- Change: Remove GltfObject component from default Avatar prefab
- Fix: DeployToFTP connection error
### Engine
- Add: warning balloon when unknown components are detected and have been most likely forgot to be installed, linking to npmdef docs
- Fix: dont show serialization warning for builtin components where specific fields are not deserialized on purpose (since right now the serializer does not check which fields are actually implemented)
## [2.39.2-pre] - 2022-10-24
### Exporter
- Change: Disable timer logs
### Engine
- Change: AudioSource exposes ``clip`` field
- Change: improve error and messaging overlay
- Change: detect when serialized Object3D and AssetReference are missing ``@serializable`` attribute and show message in overlay
- Change: add WebXR hands path to controllers
- Fix: WebXR controllers now use interactable object when grabbing (instead of hit object previously) which fixes interaction with nested hierarchies in XR and DragControls
## [2.39.1-pre] - 2022-10-23
### Exporter
- Fix: improve generating temporary project with npmdef dependencies
- Fix: avoid attempting to start server twice when project is being generated
## [2.39.0-pre] - 2022-10-23
### Exporter
- Add DeployToFTP component
- Fix automatically installing dependencies to temporary project when the project was already generated from another scene
### Engine
- Change: Renderer ``material`` is now ``sharedMaterial`` to make it more clear for Unity devs that the material is not being cloned when accessed
- Fix: When not specifying any explicit networking backend for glitch deployment it now falls back to the current glitch instance for networking
## [2.38.1-pre] - 2022-10-21
### Exporter
- Add: creating npmdef now automatically creates ``index.ts`` entry point (and adds it to ``main`` in package.json)
- Change: bump UnityGLTF dependency
### Engine
- Add: Screenshare component ``share`` method now takes optional options to configure device and MediaStreamConstraints for starting the stream
- Fix: WebXR should show EnterVR button when enabled in Unity
- Fix: component ``enable`` boolean wasnt correctly initialized when loaded from gltf
- Fix: Object3D prototype extensions weren't correctly applied anymore
- Fix: Interaction bug when using DragControls with OrbitControls with multitouch
## [2.38.0-pre] - 2022-10-20
### Exporter
- Add: toktx compression extension is now automatically used, can be disabled by adding the ``TextureCompressionSettings`` component to the GltfObject and disabling it
- Change: adjust menu items
### Engine
- Add ``Renderer.mesh`` getter property
- Change: ``Renderer.material`` now returns first entry in ``sharedMaterials`` array so it automatically works in cases where a Renderer is actually a multi-material object
- Change: warn when trying to access components using string name instead of type
- Change: update needle gltf-transform-extensions to 0.6.2
- Fix: remove log from UIRaycastUtil
- Fix: move TypeStore import in builtin engine again to not break cases where ``import @needle-engine`` was never used
- Fix: React3Fiber template and AR overlay container access when using react
## [2.37.1-pre] - 2022-10-19
### Exporter
- Change: allow overriding minimum skybox resolution for root scene (minimum is 64)
### Engine
- Change: unify component access methods, first argument is now always the object with the component type as second argument
- Fix physics collision events throwing caused by refactoring in last version
- Fix loading screen css
## [2.37.0-pre] - 2022-10-19
### Exporter
- Add ``ImageReference`` type: textures exported as ``ImageReference`` will be copied to output assets directory and serialized as filepaths instead of being included in glTF
- Change: Reduce default size of progressive textures (in ``UseProgressiveTextures`` component)
- Change: Update UnityGLTF dependency fixing normal export bug and serializing text in extensions now using UTF8
### Engine
- Change: First pass of reducing circular dependencies
- Change: Update @needle-tools/gltf-transform-extensions version
- Change: Update component compiler to 1.9.0. Changed include:
* Private and protected methods will now not be emitted anymore
* ``onEnable/onDisable`` will be emitted as ``OnEnable`` and ``OnDisable`` [issue 93](https://github.com/needle-tools/needle-engine-support/issues/93)
- Change: handle Vector3 prototype extensions
- Fix: issue with UI causing rendering to break when enabling text components during runtime that have not yet been active before
- Fix: OrbitControls LookAtConstraint reference deserialization
- Fix: WebXRController raycasting against UI marked as ``noRaycastTarget`` or in CanvasGroup with disabled ``interactable`` or ``blocksRaycast``
## [2.36.0-pre] - 2022-10-17
### Exporter
- Change: Move Screensharing aspect mode settings into VideoPlayer component (in ``VideoPlayerData``)
### Engine
- Add: start adding support for 2D video overlay mode
- Change: Install threejs from @needle-tools/npm - this removes the requirement to have git installed and should fix a case where pulling the package from github would fail
- Change: Move Screensharing aspect mode settings into VideoPlayer component
- Change: Move ``InstancingUtils`` into ``engine/engine_instancing.ts``
- Change: BoxCollider now checks if ``attachedRigidBody`` is assigned at start
- Change: Collision now exposes internal cannon data via ``__internalCollision`` property
- Fix: EventSystem now properly unsubscribes WebXRController events
## [2.35.5-pre] - 2022-10-17
### Exporter
- Change: rename ``codegen/exports.ts`` to ``codegen/components.ts``
- Change: ScreenCapture component has explicit VideoPlayer component reference to make it clear how it should be used
### Engine
- Add: ScreenCapture has mode for capturing webgl canvas (unfortunately it doesnt seem to work well in Chrome or Firefox yet)
- Change: move threejs prototype extensions into own file and make available to vanilla js builds
- Change: ScreenCapture component has explicit VideoPlayer component reference
- Fix: animating properties on custom shaders
## [2.35.4-pre] - 2022-10-15
### Exporter
- Change: dont automatically run install on referenced npmdefs when performing export
- Fix issue where browser scrollbar would flicker in certain cases when OS resolution was scaled
### Engine
- Add: start implementing trigger callbacks for ``onTriggerEnter``, ``onTriggerExit`` and ``onTriggerStay``
- Change: ``GameObject.setActive`` now updates ``isActiveAndEnabled`` state and executes ``awake`` and ``onEnable`` calls when the object was activated for the first time (e.g. when instantiating from an previously inactive prefab)
- Change: improve collision callback events for components (``onCollisionEnter``, ``onCollisionExit`` and ``onCollisionStay``)
- Change: this.context.input keycode enums are now strings
- Fix: local dev error overlay now also displays errors that happen before web component is completely loaded (e.g. when script has import error)
- Fix: Rigidbody force is now correctly applied when the component was just instantiated (from inactive prefab) and added to the physics world for the first time
- Fix: DragControls component keyboard events ("space" and "d" for modifying height and rotation)
## [2.35.3-pre] - 2022-10-14
### Exporter
- Change: delete another vite cache
- Change: improve Codewatcher for scripts in ``src/scripts``
## [2.35.2-pre] - 2022-10-14
### Exporter
- Change: delete vite caches before starting server
## [2.35.1-pre] - 2022-10-14
### Exporter
- Change: only serialize used Camera fields
- Change: prevent serializing TextGenerator
- Change: prevent exporting Skybox if no skybox material exists
- Change: prevent installing referenced npmdefs while server is running hopefully fixing some issues wiht vite/chrome where type declarations become unknown
- Fix: loading relative font paths when exported via Asset context menu
### Engine
- Change: Rigidbody now tracks position changes to detect when to update/override simulated physics body
- Fix: loading relative font paths when exported via Asset context menu
## [2.35.0-pre] - 2022-10-13
### Exporter
- Change: make default SyncCam prefab slightly bigger
- Change: log error when ExportInfo GameObject is disabled in the hierarchy
### Engine
- Add: inital ScreenCapture component for sharing screens and camera streams across all connected users
- Add: ``onCollisionEnter``, ``onCollisionStay`` and ``onCollisionExit`` event methods to components
## [2.34.0-pre] - 2022-10-12
### Exporter
- Add temporary support for legacy json pointer format
- Add warning to Build Window when production build is selected but installed toktx version does not match recommended version
- Add warning if web project template does not contain package.json
- Add react template
- Add: allow exporting glbs from selected assets via context menu (previously this only worked in scene hierarchy, it now works also in project window)
- Changed: SpectatorCam improvements, copying main camera settings (background, skybox, near/far plane)
- Changed: improved ExportInfo when selecing web project template
- changed: dont export hidden Cinemachine Volume component
- Changed: update UnityGLTF dependency
- Changed: use source identifier everywhere to resolve absolute uri from relative uris as a first step of loading glbs including dependencies from previously unknown directories
- Fix: when exporting selected glbs with compression all dependent glbs (with nested references) will automatically also be compressed after export
- Fix: Cubemap rotation
### Engine
- Add: Quest 2 passthrough support
- Add: UI Graphic components now support ``raycastTarget`` again
- Add: VideoPlayer now supports ``materialTarget`` option which allows for assigning any renderer in the scene that should be used as a video canvas
- Changed: updated three-mesh-ui dependency version
- Changed: updated needle-gltfTransform extensions package, fixing an issue with passthrough of texture json pointers
- Changed: selecting SpectatorCam now requires click (instead of just listening to pointer up event)
- Fix: Avatars using instanced materials should now update transforms correctly again
## [2.33.0-pre] - 2022-10-10
### Exporter
- Fix: error log caused by unused scene template subasset
- Change: allow exporting ParticleSystem settings
- Change: re-word some unclear warnings, adjust welcome window copy
- Change: dont automatically open output folder after building
### Engine
- Add: Context.removeCamera method
- Add: SpectatorCam allows to follow other users across devices by clicking on respective avatar (e.g. clicking SyncedCam avatar or WebXR avatar, ESC or long press to stop spectating)
- Add: ``Input`` events for pointerdown, pointerup, pointermove and keydown, keyup, keypress. Subscribe via ``this.context.input.addEventListener(InputEvents.pointerdown, evt => {...})``
- Change: Default WebXR rig matches Unity forward
- Fix: WebXRController raycast line being rendered as huge line before first world hit
- Fix: SpectatorCam works again
- Fix: ``serializable()`` does now not write undefined values if serialize data is undefined
- Fix: exit VR lighting
## [2.32.0-pre] - 2022-10-07
### Exporter
- Add: toktx warning if toktx version < 4.1 is installed.
- Add: button to download recommended toktx installer to Settings
- Change: Bump UnityGLTF version
- Change: Builder will install automatically if Needle Engine directory is not found
### Engine
- Add: ``resolutionScaleFactor`` to context
- Fix ``IsLocalNetwork`` regex
- Fix custom shaders failing to render caused by json pointer change
- Change: rename Context ``AROverlayElement`` to ``arOverlayElement``
## [2.31.0-pre] - 2022-10-06
### Exporter
- Add first version of TextureCompressionSettings component which will modify toktx compression settings per texture
- Fix skybox export being broken sometimes
- Fix Vite template update version of vite compression plugin to fix import error
- Change: json pointers now have correct format (e.g. ``/textures/0`` instead ``textures/0``)
- Change: Bump needle glTF transform extensions version
### Engine
- Fix: EventList failing to find target when targeting a Object3D without any components
- Fix: text now showing up when disabling and enabling again after the underlying three-mesh-ui components have been created
- Fix: Builtin sprites not rendering correctly in production builds
- Change: Bump needle glTF transform extensions version
- Change: json pointers now have correct format (e.g. ``/textures/0`` instead ``textures/0``)
- Change: Bump UnityGLTF version
## [2.30.1-pre] - 2022-10-05
### Exporter
- Fix animating ``activeSelf`` on GameObject in canvas hierarchy
- Fix ExportInfo directory picker
- Removed unused dependencies in Vite project template
- Removed wrapper div in Vite project template
### Engine
- Fix animating ``activeSelf`` on GameObject in canvas hierarchy
- Fix SpectatorCam component
- Fix WebXRController raycast line being rendered as huge line before first world hit
## [2.30.0-pre] - 2022-10-05
### Exporter
- Add: experimental AlignmentConstraint and OffsetConstraint
- Fix: font-gen script did use require instead of import
- Change: delete vite cache on server start
### Engine
- Add: experimental AlignmentConstraint and OffsetConstraint
- Remove: MeshCollider script since it is not supported yet
- Change: Camera does now use XRSession environment blend mode to determine if background should be transparent or not.
- Change: WebXR exposes ``IsInVR`` and ``IsInAR``
- Fix: RGBAColor copy alpha fix
- Fix: Avatar mouth shapes in networked environment
## [2.29.1-pre] - 2022-10-04
### Exporter
- Add folder path picker to ExportInfo
- Change message on first installation and when a project does not exist yet
- Change prevent projects being generated in Assets and Packages folders
### Engine
- Change: DropListener file drop event does send whole gltf instead of just the scene
## [2.29.0-pre] - 2022-10-04
### Exporter
- Add: Local error overlay shows in AR
- Add: itchio inspector build type can now be toggled by holding ALT
- Fix: URP 12.1 api change
- Change: Vite template is updated to Vite 3
- Change: Bump UnityGLTF dependency
- Change: Move glTF-transform extension handling into own package, using glTF transform 2 now
### Engine
- Add: allow overriding draco and ktx2 decoders on <needle-engine> web component by setting ``dracoDecoderPath``, ``dracoDecoderType``, ``ktx2DecoderPath``
- Add: ``loadstart`` and ``progress`` events to <needle-engine> web component
- Fix rare timeline animation bug where position and rotation of objects would be falsely applied
- Change: update to three v145
- Change: export ``THREE`` to global scope for bundled version
## [2.28.0-pre] - 2022-10-01
### Exporter
- Remove: legacy warning on SyncedCamera script
- Fix: exception during font export or when generating font atlas was aborted
- Change: Export referenced gltf files using relative paths
- Change: Bump runtime engine dependency
### Engine
- Add: make engine code easily accessible from vanilla javascript
- Fix: handle number animation setting component enable where values are interpolated
- Change: Remove internal shadow bias multiplication
- Change: Addressable references are now resolved using relative paths
- Change: Update package json
## [2.27.2-pre] - 2022-09-29
### Exporter
- Bump runtime engine dependency
### Engine
- Add: Light component shadow settings can not be set/updated at runtime
- Fix: enter XR using GroundProjectedEnv component
- Fix: Light shadows missing when LightShadowData component was not added in Unity (was using wrong shadowResolution)
- Change: dont allow raycasting by default on GroundProjectedEnv sphere
## [2.27.1-pre.1] - 2022-09-29
### Exporter
- Fix compiler flag bug on OSX [issue 76](https://github.com/needle-tools/needle-engine-support/issues/76)
## [2.27.1-pre] - 2022-09-29
### Exporter
- Add: Detect outdated threejs version and automatically run ``npm update three``
- Add: shadow resolution to LightShadowData component
- Add: Warning to GroundProjectedEnvironment inspector when camera far plane is smaller than environment radius
### Engine
- Add: Light exposes shadow resolution
## [2.27.0-pre] - 2022-09-28
### Exporter
- Add RemoteSkybox component to use HDRi images from e.g. polyhaven
- Add GroundProjectedEnv component to use threejs skybox projection
### Engine
- Add RemoteSkybox component to use HDRi images from e.g. polyhaven
- Add GroundProjectedEnv component to use threejs skybox projection
- Fix: export ``GameObject`` in ``@needle-tools/engine``
## [2.26.1-pre] - 2022-09-28
### Exporter
- Add LightShadowData component to better control and visualize directional light settings
### Engine
- Add: ``noerrors`` url parameter to hide overlay
- Fix: WebXR avatar rendering may be visually offset due to root transform. Will now reset root transform to identity
## [2.26.0-pre] - 2022-09-28
### Exporter
- Add: tricolor environment light export
- Add: generate exports for all engine components
- Add: export for InputActions (NewInputSystem)
### Engine
- Add: ``@needle-tools/engine`` now exports all components
- Add: environment light from tricolor (used for envlight when set to custom but without custom cubemap assigned)
- Add: show console error on screen for localhost / local dev environment
- Fix: create environment lighting textures from exported colors
- Change: UI InputField expose text
- Change: Bump threejs version to latest (> r144) which also contains USDZExporter PR
## [2.25.2-pre] - 2022-09-26
### Exporter
- Fix collab sandbox scene template, cleanup dependencies
- Fix ShadowCatcher export in Built-in RP
- Fix WebHelper nullreference exception
- Change: remove funding logs, improve log output
- Change: exporting with wrong colorspace is now an error
- Change: Bump UnityGLTF dependency
- Change: add log to Open VSCode workspace
### Engine
- Add: custom shader set ``_ScreenParams``
- Change: DropListener event ``details`` now contains whole gltf file (instead of just scene object)
## [2.25.1-pre] - 2022-09-23
### Exporter
- Bump Engine dependency
### Engine
- Add: AudioSource volume and spatial blending settings can now be set at runtime
- Fix: AudioSource not playing on ``play`` when ``playOnAwake`` is false
## [2.25.0-pre] - 2022-09-23
### Exporter
- Add: automatically include local packages in vscode workspace
- Add: experimental progressive loading of textures
- Fix: Catch ``MissingReferenceException`` in serialization
- Fix: Environment reflection size clamped to 256 for root glb and 64 pixel for referenced glb / asset
- Fix: ShadowCatcher inspector info and handle case without renderer
- Change: ComponentGen types are regenerated when player scriptcount changes
### Engine
- Add: VideoPlayer crossorigin attribute support
- Add: ``debuginstancing`` url parameter flag
- Add: Image handle builtin ``Background`` sprite
- Add: Component now implements EventTargt so you can use ``addEventListener`` etc on every component
- Add: EventList does automatically dispatch event with same name on component. E.g. UnityEvent named ``onClick`` will be dispatched on component as ``on-click``
- Add: experimental progressive loading of textures
- Add: ``WebXR`` exposes ``IsARSupported`` and ``IsVRSupported``
- Fix: remove Ambient Intensity
- Fix: ShadowCatcher material should not write depth
## [2.24.1-pre] - 2022-09-22
### Exporter
- Remove: all scriban templating
- Change: TypeUtils clear cache ond recompile and scene change
- Change: move SyncedCamera into glb in Sandbox template
- Change: Show warning in GltfObject inspector when its disabled in main scene but not marked as editor only since it would still be exported and loaded on startup but most likely not used
- Change: scene template assets use UnityGLTF importer by default
- Change: TypeInfoGenerator for component gen does now prioritize types in ``Needle`` namespace (all codegen types), ``Unity`` types and then everything else (it will also only include types in ``Player`` assemblies)
### Engine
- Fix: SpatialTrigger intersection check when it's not a mesh
- Fix: UnityEvent / EventList argument of ``0`` not being passed to the receiving method
- Fix: Physics rigidbody/collider instantiate calls
- Fix: Physics rigidbody transform changes will now be applied to internal physics body
- Fix: ``needle-engine.getContext`` now listens to loading finished event namely ``loadfinished``
- Change: cleanup some old code in Rigidbody component
## [2.24.0-pre] - 2022-09-21
### Exporter
- Add: new ``DeployToItch`` component that builds the current project and zips it for uploading to itch.io
- Add: FontGeneration does not try to handle selected font style
- Add: Show ``SmartExport`` dirty state in scene hierarchy (it postfixes the name with a *, similar to how scene dirty state is visualized)
- Add: ``Collect Logs`` now also includes all currently known typescript types in cache
- Remove: legacy ``ScriptEmitter`` and ``TransformEmitter``. Code outside of glb files will not be generated anymore
- Change: Renamed ``Deployment`` to ``DeployToGlitch``
- Change: Set typescript cache to dirty on full export
- Change: automatically run ``npm install`` when opening npmdef workspace
- Change: Bump UnityGLTF dependency to ``1.16.0-pre`` (https://github.com/prefrontalcortex/UnityGLTF/commit/aa19dd2a4f2f3f533888deb47920af6a6b4bf80b)
- Fix: ``Setup Scene`` context menu now sets directional light shadow when creating a light
- Fix: "Project Install Fix" did sometimes fail if an orphan but empty folder was still present in node_modules and ``npm install`` didn't install the missing package again
- Fix: Exception where FullExport would fail if no ``caches~`` directory exists
- Fix: CodeWatcher threading exception when many typescript files changed (or are added) at once
- Fix: FontGenerator issue where builtin fonts would be unnecessarily re-generated
- Fix: Regression in custom reflection texture export
### Engine
- Add: initial support for ``InputField`` UI (rendering, input handling on desktop, mobile and AR, change and endedit events)
- Add: ``EventList.invoke`` can now handle an arbitrary number of arguments
- Change: lower double click threshold to 200ms instead of 500ms
- Change: runtime font-style does not change font being used in this version. This will temporarely break rich text support.
- Fix: custom shader regression where multiple objects using the same material were not rendered correctly
- Fix: Text sometimes using invalid path
- Fix: Remove unused imports
## [2.23.0-pre] - 2022-09-20
### Exporter
- Add: support for ignoring types commented out using ``//``. For example ``// export class MyScript ...``
- Add: ``Setup Scene`` context menu creates directional light if scene contains no lights
- Add: support for environment light intensity multiplier
- Change: typescache will only be updated on codegen, project change or dependencies changed
- Change: improve font caching and regenerating atlas for better dynamic font asset support
### Engine
- Add basic support for ``CameraDepth`` and ``OpaqueTexture`` (the opaque texture still contains transparent textures in this first version) being used in custom shaders
## [2.22.1-pre] - 2022-09-17
### Exporter
- Fix missing dependency error when serialized depedency in ExportInfo was installed to package.json without the npmdef being present in the project.
- Fix typo in BoxGizmo field name
### Engine
- Improve Animator root motion blending
- Fix SpatialTrigger error when adding both SpatialTrigger as well as SpatialTrigger receiver components to the same object
- AnimatorController can now handle states with empty motion or missing clips
## [2.22.0-pre] - 2022-09-15
### Exporter
- Add: automatic runtime font atlas generation from Unity font assets
- Change: setup scene menu item does not create grid anymore and setup scene
- Fix: serialization where array of assets that are copied to output directory would fail to export when not all entries of the array were assigned
- Fix: obsolete SRP renderer usage warning in Unity 2021
- Fix: serialize LayerMask as number instead of as ``{ value: <number> }`` object
### Engine
- Add: automatic runtime font atlas generation from Unity font assets
- Remove: shipped font assets in ``include/fonts``
- Fix: Physics pass custom vector into ``getWorldPosition``, internal vector buffer size increased to 100
- Fix: SpatialTrigger and SpatialTrigger receivers didnt work anymore due to LayerMask serialization
## [2.21.1-pre] - 2022-09-14
### Exporter
- Bump Needle Engine version
- Fix: WebXR default avatar hide hands in AR
- Change: UI disable shadow receiving and casting by default, can be configured via Canvas
### Engine
- Change: UI disable shadow receiving and casting by default, can be configured via Canvas
- Fix: ``gameObject.getComponentInParent`` was making false call to ``getComponentsInParent`` and returning an array instead of a single object
- Fix: light intensity in AR
## [2.21.0-pre] - 2022-09-14
### Exporter
- Remove legacy UnityGLTF export warning
- Fix: add dependencies to Unity package modules (this caused issues when installing in e.g. URP project template)
- Change: will stop running local server before installing new package version
- Change: Bump UnityGLTF version to 1.15.0-pre
### Engine
- Add: first draft of Animator root motion support
- Fix: ``Renderer.sharedMaterials`` assignment bug when GameObject was mesh
- Fix: Buttons set to color transition did not apply transition colors
- Fix: UI textures being flipped
- Fix: UI textures were not stretched across panel but instead being clipped if the aspect ratio didnt match perfectly
## [2.20.0-pre] - 2022-09-12
### Exporter
- Add Timeline AnimationTrack ``SceneOffset`` setting export
- Change: improved ProjectReporter (``Help/Needle Engine/Zip Project``)
### Engine
- Add stencil support to ``Renderer``
- Add timeline ``removeTrackOffset`` support
- Fix timeline animation track offset only being applied to root
- Fix timeline clip offsets not being applied when no track for e.g. rotation or translation exists
## [2.19.0-pre] - 2022-09-11
### Exporter
- Add ShadowCatcher enum for toggling between additive and ShadowMask
- Add initial support for exporting URP RenderObject Stencil settings
- Add support for animating ``activeSelf`` and ``enabled``
- Change: improved ProjectReporter (``Help/Needle Engine/Zip Project``)
- Bump: UnityGLTF dependency
### Engine
- Add initial UI anchoring support
- Add initial support for URP RenderObject Stencil via ``NEEDLE_render_objects`` extension
## [2.18.3-pre] - 2022-09-09
### Exporter
- Bump runtime engine dependency
### Engine
- Fix UI transform handling for [issue 42](https://github.com/needle-tools/needle-engine-support/issues/42) and [issue 30](https://github.com/needle-tools/needle-engine-support/issues/30)
- Fix AudioSource not restarting to play at onEnable when ``playOnAwake`` is true (this is the default behaviour in Unity)
## [2.18.2-pre] - 2022-09-09
### Exporter
- Change default skybox size to 256
- Fix hash cache directory not existing in certain cases
### Engine
- Fix RGBAColor not implementing copy which caused alpha to be set to 0 (this caused ``Camera.backgroundColor`` to not work properly)
## [2.18.1-pre.1] - 2022-09-08
### Exporter
- Fix gitignore not found
- Fix hash cache directory not existing in certain cases
## [2.18.0-pre] - 2022-09-08
### Exporter
- Add ``Zip Project`` in ``Help/Needle Engine/Zip Project`` that will collect required project assets and data and bundle it
## [2.17.3-pre] - 2022-09-07
### Exporter
- Add auto fix if .gitignore file is missing
- Add menu item to only build production dist with last exported files (without re-exporting scene)
- Fix dependency change event causing error when project does not exist yet / on creating a new project
- Fix updating asset hash in cache directory when exporting
### Engine
- Add support to set OrbitControls camera position immediately
## [2.17.2-pre] - 2022-09-07
### Exporter
- Bump Engine dependency version
### Engine
- Fix EventList invocation not using deserialized method arguments
## [2.17.1-pre] - 2022-09-07
### Exporter
- Fix DirectoryNotFound errors caused by dependency report and depdendency cache
- Fix writing dependency hash if exported from play buttons (instead of save) and hash file doesnt exist yet
## [2.17.0-pre] - 2022-09-07
### Exporter
- Add export on dependency change and skip exporting unchanged assets
- Add ``EmbedSkybox`` toggle on GltfObject component
- Add simple skybox export size heuristic when no texture size is explictly defined (256 for prefab skybox, 1024 for scene skybox)
- Add debug information log which allows for basic understanding of why files / assets were exported
- Remove old material export code
- Change: clamp skybox size to 8px
- Fix skybox texture settings when override for Needle Engine is disabled, fallback is now to default max size and size
- Fix exceptions in ``Collect Logs`` method
- Fix Glitch ``Deploy`` button to only enable if deployment folder contains any files
### Engine
- Add ``context`` to ``StateMachineBehaviour``
- Fix ``StateMachineBehaviour`` binding (event functions were called with wrong binding)
## [2.16.0-pre.3] - 2022-09-06
### Exporter
- Fix compiler error when no URP is installed in project
### Engine
- Fix deserialization error when data is null or undefined
## [2.16.0-pre.1] - 2022-09-05
### Exporter
- Add EXR extension and export (HDR skybox)
- Add initial tonemapping and exposure support (start exporting Volume profiles)
- Add AR ShadowCatcher
- Add automatic re-export of current scene if referenced asset changes
- Fix potential nullref in BugReporter
- Change: add additional info to test npm installed call
- Change server process name to make it more clear that it's the local development server process
- Change: bumb UnityGLTF dependency
### Engine
- Add initial tonemapping and exposure support
- Add AR shadow catcher
- Fix objects parented to camera appear behind camera
- Fix reticle showing and never disappearing when no WebARSessionRoot is in scene
- Fix WebARSessionRoot when on same gameobject as WebXR component
- Fix deserialization of ``@serializable(Material)`` producing a new default instance in certain cases
- Fix ``OrbitControls`` enable when called from UI button event
- Fix EventList / UnityEvent calls to properties (e.g. ``MyComponent.enable = true`` works now from UnityEvent)
## [2.15.1-pre] - 2022-09-02
### Exporter
- Add skybox export using texture importer settings (for Needle Engine platform) if you use a custom cubemap
- Bump ShaderGraph dependency
- Fix compiler error in Unity 2021
- Change automatically flag component compiler typemap to be regenerated if any generated C# has compiler errors
### Engine
- Change: ``OrbitControls.setTarget`` does now lerp by default. Use method parameter ``immediate`` to change it immediately
- Change: bump component compiler dependency to ``1.8.0``
## [2.14.2-pre] - 2022-09-01
### Exporter
- Bump runtime dependency
- Fix settings window not showing settings when nodejs/npm is not found
### Engine
- Fix EventList serialization for cross-glb references
- Fix AnimatorController transition from state without animation
## [2.14.0-pre] - 2022-09-01
### Exporter
- Add: mark GltfObjects in scene hierarchy (hierarchy elements that will be exported as gltf/glb files)
- Add FAT32 formatting check and warning
- Fix: setup scene
- Fix: try improving ComponentGenerator component to watch script/src changes more reliably
### Engine
- Fix: skybox/camera background on exit AR
- Change: AnimatorController can now contain empty states
- Change: Expose ``Animator.Play`` transition duration
## [2.13.1-pre] - 2022-08-31
### Exporter
- Fix UnityEvent argument serialization
- Fix generic UnityEvent serialization
## [2.13.0-pre] - 2022-08-31
### Exporter
- Add report bug menu items to collect project info and logs
- Remove legacy ResourceProvider code
### Engine
- Improved RectTransform animation support and canvas element positioning
- Fix ``Animator.Play``
- Change: Expose ``AnimatorController.FindState(name)``
## [2.12.1-pre] - 2022-08-29
### Exporter
- Fix UnityEvent referencing GameObject
## [2.12.0-pre] - 2022-08-29
### Exporter
- Add UI to gltf export
- Add better logging for Glitch deployment to existing sites that were not remixed from Needle template and dont expose required deployment api
- Add AnimatorController support for any state transitions
### Engine
- Add UI to gltf export
- Add button animation transition support for triggers ``Normal``, ``Highlighted`` and ``Pressed``
## [2.11.0-pre] - 2022-08-26
### Exporter
- Add Linux support
- Add additional npm search paths for OSX and Linux to the settings menu
- Add ShaderGraph dependency to fix UnityGLTF import errors for projects in 2021.x
- Fix exporting with Animation Preview enabled
### Engine
- Add ``Canvas.renderOnTop`` option
- Fix ``OrbitControls`` changing focus/moving when interacting with the UI
- Fix nullref in AnimatorController with empty state
## [2.10.0-pre] - 2022-08-25
### Exporter
- Add export for ``Renderer.allowOcclusionWhenDynamic``
- Fix issue in persistent asset export where gameObjects would be serialized when referenced from within an asset
### Engine
- Add export for ``Renderer.allowOcclusionWhenDynamic``
- Fix: bug in ``@serializable`` type assignment for inherited classes with multiple members with same name but different serialized types
- Change: ``GameObject.findObjectOfType`` now also accepts an object as a search root
## [2.9.5-pre] - 2022-08-25
### Exporter
- OSX: add homebrew search path for npm
### Engine
- Fix canvas button breaking orbit controls [issue #4](https://github.com/needle-tools/needle-engine-support/issues/4)
## [2.9.4-pre.1] - 2022-08-23
### Exporter
- Fix glitch component for private projects
## [2.9.3-pre] - 2022-08-23
### Exporter
- Fix passing UnityGLTF export settings to exporter
- Fix old docs link
- Fix timeline extension export in certain cases, ensure it runs before component extension export
- Update minimal template
### Engine
- Fix SyncedRoom to not append room parameter multiple times
## [2.9.2-pre] - 2022-08-22
### Exporter
- Fix: Minor illegal path error
- Change: ExportInfoEditor ``Open`` button to open exporter package
- Change: ExportInfoEditor clear versions cache when clicking update button
### Engine
- Add: Timeline AudioTrack nullcheck when audio file is missing
- Fix: AnimatorController error when behaviours are undefined
- Change StateMachineBehaviour methods to be lowercase
## [2.9.1-pre] - 2022-08-22
### Exporter
- Fix build errors and compilation warnings
## [2.9.0-pre] - 2022-08-22
### Exporter
- Add initial StateMachineBehaviour support with "OnStateEnter", "OnStateUpdate" and "OnStateExit"
- Update UnityGLTF dependency
- Fix: prevent scene templates from cloning assets even tho cloning was disabled
- Fix: ifdef for URP
### Engine
- Add initial StateMachineBehaviour support with "OnStateEnter", "OnStateUpdate" and "OnStateExit"
- Fix input raycast position calculation for scrolled content
## [2.8.2-pre] - 2022-08-22
### Exporter
- Fix exporting relative path when building distribution: audio path did produce absolute path because the file was not yet copied
- Fix bundle registry performance bug causing a complete reload / recreation of FileSystemWatchers
- Fix texture pointer remapping in gltf-transform opaque extension
- Change: skip texture-transform for textures starting with "Lightmap" for now until we can configure this properly
### Engine
- Fix texture pointer remapping in gltf-transform opaque extension
- Change: skip texture-transform for textures starting with "Lightmap" for now until we can configure this properly
## [2.8.1-pre] - 2022-08-19
### Exporter
- Fix rare timeline export issue where timeline seems to have cached wrong data and needs to be evaluated once
- Update sharpziplip dependency
## [2.8.0-pre] - 2022-08-18
### Exporter
- Add new template with new beautiful models
- Change start server with ip by default from Play button too
- Fix Glitch deployment inspector swapping warning messages when project does not exist
- Fix certificate error spam when port is blocked by another server
### Engine
- Add scale to instantiation sync messages
- Fix ``BoxHelper``
- Fix AR reticle being not visible when ``XRRig`` is child of ``WebARSessionRoot`` component
- Fix exception in ``DragControls`` when dragged object was deleted while dragging
## [2.7.0-pre] - 2022-08-18
### Exporter
- Change name of ``KHR_webgl_extension`` to ``NEEDLE_webgl_extension``
- Change start server to use IP by default (ALT to open with localhost)
- Fix export cull for ShaderGraph with ``RenderFace`` option (instead of ``TwoSided`` toggle)
### Engine
- Change name of ``KHR_webgl_extension`` to ``NEEDLE_webgl_extension``
- Change: dont write depth for custom shader set to transparent
- Deprecate and disable ``AssetDatabase``
## [2.6.1-pre] - 2022-08-17
### Exporter
- Add codegen buttons to npmdef inspector (regenerate components, regenerate C# typesmap)
- Add DefaultAvatar and SyncedCam default prefab references
- Change: allow cancelling process task when process does not exist anymore
- Change: ExportInfo inspector cleanup and wording
- Fix Timeline Preview on export (disable and enable temporarely)
- Fix constant names
- Fix XR buttons in project templates
- Fix VideoPlayer for iOS
- Fix Editor Only hierarchy icon
- Fix order of menu items and cleanup/remove old items
- Fix timeline clip offset when not offset should be applied
- Fix project templates due to renamed web component
- Fix and improve setup scene menu item
### Engine
- Add ``Mathf.MoveTowards``
- Change: rename ``needle-tiny`` webcomponent to ``needle-engine``
- Fix ordering issue in needle web component when codegen.js is executed too late
## [2.5.0-pre] - 2022-08-16
### Exporter
- Add ShaderGraph double sided support
- Add ShaderGraph transparent support
- Add SyncedCamera prefab support
- Remove legacy shader export code
### Engine
- Add SyncedCamera prefab/AssetReference support
- Add TypeArray support for ``serializable`` to provide multiple possible deserialization types for one field (e.g. ``serializable([Object3D, AssetReference])`` to try to deserialize a type as Object3D first and then as AssetReference)
## [2.4.1-pre] - 2022-08-15
### Exporter
- Add error message when trying to export compressed gltf from selection but engine is not installed.
### Engine
- Add event callbacks for Gltf loading: ``BeforeLoad`` (use to register custom extensions), ``AfterLoaded`` (to receive loaded gltf), ``FinishedSetup`` (called after components have been created)
## [2.4.0-pre] - 2022-08-15
### Exporter
- Add minimal analytics for new projects and installations
- Add log to feedback form
- Fix minor context menu typo
## [2.3.0-pre] - 2022-08-14
### Exporter
- Add warning to Camera component when background type is solid color and alpha is set to 0
- Add ``CameraARData`` component to override AR background alpha
- Change Glitch deployment secret to only show secret in plain text when ALT is pressed and mouse is hovered over password field
- Fix ``ExportInfo`` editor "(local)" postfix for installed version text at the bottom of the inspector
- Fix scene templates build command
- Fix Glitch project name paste to not wrongly show "Project does not exist"
### Engine
- Fix AnimatorController exit state
- Fix AR camera background alpha to be fully transparent by default
## [2.2.1-pre] - 2022-08-12
### Exporter
- Add: Export context menu to scene hierarchy GameObjects
- Fix: Multi column icon rendering in ProjectBrowser
- Fix: Builder now waits for installation finish
- Fix: Copy include command does not log to console anymore
- Fix: Invalid glb filepaths
- Fix: URP light shadow bias exported from RendererAsset (when setup in light)
### Engine
- Fix: light shadow bias
## [2.2.0-pre] - 2022-08-11
### Exporter
- Add: Problem solver "Fix" button
- Change: Use Glitch Api to detect if a project exists and show it in inspector
- Change: Typescript template file
- Change: Disable codegen for immutable packages
- Change: Improved problem solver messages
- Change: Renamed package.json scripts
- Change: Run "copy files" script on build (to e.g. load pre-packed gltf files at runtime when project was never built before)
- Fix: Logged Editor GUI errors on export
- Fix: gltf-transform packing for referenced textures via pointers
- Fix: Don't try to export animations for "EditorOnly" objects in timeline
- Fix: ComponentLink does now npmdef VSCode workspace
### Engine
- Add ``@needle-tools/engine`` to be used as import for "most used" apis and functions
- Change: remove obsolete ``Renderer.materialProperties``
- Fix: ``NEEDLE_persistent_assets`` extension is now valid format (change from array to object)
## [2.1.1-pre] - 2022-08-09
### Exporter
- Add Option to Settings to disable automatic project fixes
- Fix Build Window
## [2.1.0-pre] - 2022-08-08
### Exporter
- Add fixes to automatically update previous projects
## [2.0.0-pre] - 2022-08-08
### Exporter
- Renamed package
- Add: npmdef pre-build callback to run installation if any of the dependencies is not installed
- Add: Glitch Deployment inspector hold ALT to toggle build type (development or production)
### Engine
- Renamed package
## [1.28.0-pre] - 2022-08-08
### Exporter
- Add: Custom Shader vertex color export
- Add: NestedGltf objects and components do now have a stable guid
- Fix: NestedGltf transfrom
### Engine
- Fix: NestedGltf transform
## [1.27.2-pre] - 2022-08-06
### Exporter
- Remove: Scene Inspector experimental scene asset assignment
- Change: update templates
- Change: Component guid generator file ending check to make it work for other file types as well
- Change: add logo to scenes in project hierarchy with Needle Engine setup
### Engine
- Remove: Duplicateable animation time offset hack
- Change: GameObjectData extension properly await assigning values
- Change: NestedGltf instantiate using guid
- Change: ``instantiate`` does now again create guids for three Objects too
## [1.27.1-pre] - 2022-08-05
### Exporter
- Change: always export nested GlbObjects
- Change: update scene templates
- Change: Spectator camera component now requires camera component
### Engine
- Add: NestedGltf ``listenToProgress`` method
- Add: Allow changing Renderer lightmap at runtime
- Fix: Environment lighting when set to flat or gradient (instead of skybox)
- Fix: ``this.gameObject.getComponentInChildren`` - was internally calling wrong method
- Fix: Spectator camera, requires Camera component in glb now
## [1.27.0-pre] - 2022-08-03
### Exporter
- Add: warning if lightmap baking is currently in progress
- Add: support to export multiple selected objects
- Change: Audio clips are being exported relative to glb now (instead of relative to root) to make context menu export work, runtime needs to resolve the path relative to glb
- Fix: Selected object export collect types from ExportInfo
### Engine
- Add: Animator.keepAnimatorStateOnDisable, defaults to false as in Unity so start state is entered on enable again
- Add: warning if different types with the same name are registered
- Add: timeline track ``onMutedChanged`` callback
- Change: PlayableDirector expose audio tracks
- Change: BoxCollider and SphereCollider being added to the physics scene just once
- Change: try catch around physics step
## [1.26.0-pre] - 2022-08-01
### Exporter
- Add: open component compiler menu option to open Npm package site
- Add: feedback form url menu item
- Add: support for nested ``GltfObject``
- Add: support to copy gltf files in your hierarchy to the output directory instead of running export process again (e.g. a ``.glb`` file that is already compressed will just be copied and not be exported again. Adding components or changing values in the inspector won't have any effect in that case)
- Change: Don't export skybox for nested gltfs
- Change: bump component compiler dependency to ``1.7.2``
- Change: Unity progress name changed when running Needle Engine server process
- Remove: legacy export options on ``GltfObject``, components will now always be exported inside gltf extension
- Fix: delete empty folder when creating a new scene from a scene template
- Fix: CodeWatcher error caused by repaint call from background thread
- Fix: Don't serialize in-memory scene paths in settings (when creating scenes from scene templates)
- Fix: Array serialization of e.g. AudioClip[] to produce Array<string> (because audio clips will be copied to the output directory and be serialized as strings which did previously not work in arrays or lists)
- Fix: component link opens workspace again
- Fix: scene save on scene change does not trigger a new export/build anymore
### Engine
- Add: Addressable download progress is now observeable
- Add: Addressable preload support, allows to load raw bytes without actually building any components
- Add: PlayableDirector exposes tracks / clips
- Change: modify default engine loading progress bar to be used from user code
- Change: add option to Instantiate call to keep world position (set ``keepWorldPosition`` in ``InstantiateOptions`` object that you can pass into instantiate)
- Change: light uses shadow bias from Unity
- Fix: instancing requiring worldmatrix update being not properly processed
- Fix: Duplicatable world position being off (using ``keepWorldPosition``)
- Fix: ``Animation`` component, it does allow to use one main clip only now, for more complex setups please use AnimationController or Timeline
- Fix: ``SyncedRoom`` room connection on enter WebXR
- Fix: WebXR avatar loading
## [1.25.0-pre] - 2022-07-27
### Exporter
- Add: Send upload size in header to Glitch to detect if the instance has enough free space
- Add: menu item to export selected object in hierarchy as gltf or glb
- Add: Timeline animation track infinite track export (when a animation track does not use TimelineClips)
- Add: ``AnimatorData`` component to expose and support random animator speed properties and random start clip offsets to easily randomize scenes using animators with the same AnimatorController on multiple GameObjects
- Fix: npmdef import, sometimes npmdefs in a project were not registered/detected properly which led to problems with installing dependencies
- Fix: script import file-gen does not produce invalid javascript if a type is present in multiple packages
- Change: improved error log message when animation export requires ``KHR_animation_pointer``
- Change: server starts using ``localhost`` url by default and can be opened by ip directly by holding ALT (this removes the security warning shown by browsers when opening by ip that does not have a security certificate which is only necessary if you want to open on another device like quest or phone. It can still be opened by ip and is logged in he console if desired)
### Engine
- Change: bump component compiler dependency to ``1.7.1``
- Change: ``context.mainCameraComponent`` is now of type ``Camera``
- Fix: timeline control track
- Fix: timeline animation track post extrapolation
- Fix: custom shader does not fail when scene uses object with transmission (additional render pass)
## [1.24.2-pre] - 2022-07-22
### Exporter
- Add: Deployment component now also shows info in inspector when upload is in process
- Fix: cancel deploy when build fails
- Fix: better process handling on OSX
## [1.24.1-pre] - 2022-07-22
### Exporter
- Change: ``Remix on Glitch`` button does not immediately remix the glitch template and open the remixed site
## [1.24.0-pre] - 2022-07-21
### Exporter
- Add: glitch deploy auto key request and assignment. You now only need to paste the glitch project name when remixed and the deployment key will be requested and stored automatically (once after remix)
- Fix: process output log on OSX
- Fix: process watcher should now use far less CPU
- Change: move internal publish code into separate package
### Engine
- add loading bar and show loading state text
## [1.23.1-pre] - 2022-07-20
- Fix check if toktx is installed
- Fix: disable build buttons in Build Settings Window and Deployment component when build is currently running
- Fix: dont allow running multiple upload processes at once
- engine: add using ambient light settings (Intensity Multiplier) exported from Unity
## [1.23.0-pre] - 2022-07-18
- Update UnityGLTF dependency version
- Fix packing texture references on empty gameobjects
- Fix npmdef problem factory for needle.engine and three packages
- Add help urls to our components
- engine: fix nullref in registering texture
## [1.22.0-pre.2] - 2022-07-18
- Refactor problem validation and fixing providing better feedback messages
- Add: log of component that is not installed to runtime project but used in scene
- Change: Glitch deploy buttons
- Change: Build Settings window with new icons
## [1.21.0-pre] - 2022-07-15
- Add: moving npmdef in project should now automatically resolve path in package.json (if npmdef name didnt change too)
- Add: ``Show in explorer`` to scene asset context menu
- Add: warn when component is used in scene/gltf that is not installed to current runtime project
- engine: remove legacy file
- engine: add basic implementation of ``Context.destroy``
- engine: fix ``<needle-tiny>`` src attribute
- engine: add implictly creating camera with orbit controls when loaded glb doesnt contain any (e.g. via src)
## [1.20.3-pre.1] - 2022-07-13
- Fix exception in ComponentCompiler editor
- Fix type list for codegen including display and unavailable types
## [1.20.2-pre.2] - 2022-07-12
- Add warning to Typescript component link (in inspector) when component on GameObject is not the codegen one (e.g. multiple components with the same name exist in the project)
- Change component compiler to not show ``install`` button when package is not installed to project
- Change recreate codewatchers on editor focus
- engine: fix dont apply lightmaps to unlit materials
- engine: remove log in PlayableDirector
- engine: add support to override (not automatically create) WebXR buttons
## [1.20.1-pre] - 2022-07-11
- Fix TypesGenerator log
- Fix ExportInfo editor when installing
- Fix: ComponentCompiler serialize path relative to project
- Fix Inspector typescript link
- Fix AnimatorController serialization in persistent asset extension
- Fix AnimatorController serialization of transition conditions
- Add more verbose output for reason why project is not being installed, visible when pressing ALT
- Fix process output logs to show more logs
- Update component compiler default version to 1.6.2
- engine: Fix AnimatorController finding clip when cloned via ``AssetReference.instantiate``
- engine: Fix deep clone array type
- engine: Fix PlayableDirectory binding when cloned via ``AssetReference.instantiate``
## [1.20.0-pre] - 2022-07-10
- Add info to ExportInfo component when project is temporary (in Library folder)
- Add ``Open in commandline`` context menu to ExportInfo component
- Add generating types.json for component generator to remove need to specify C# types explicitly via annotations
- Add context menu to ComponentGenerator component version text to open changelog
- Change: hold ALT to perform clean install when clicking install button
- Fix: KHR_animation_pointer now works in production builds
- engine: add VideoPlayer using ``AudioOutputMode.None``
- engine: fix VideoPlayer waiting for input before playing video with audio (unmuted) and being loaded lazily
## [1.19.0-pre] - 2022-07-07
- Add: automatically import npmdef package if npmdef package.json contains (existing) ``main`` file
- Add: Timeline serializer does not automatically create asset model from custom track assets for fields marked with ``[SerializeField]`` attribute
- Change: PlayableDirector allow custom tracks without output binding
- engine: Add ``getComponent`` etc methods to THREE.Object3D prototype so we can use it like in Unity: ``this.gameObject.getComponent...``
- engine: Change ``Duplictable`` serialization
## [1.18.0-pre] - 2022-07-06
- Add temp projects support: projects are temp projects when in Unity Library
- Change prevent creating project in Temp/ directory because Unity deletes content of symdir directories
- Change ExportInfo update button to open Package Manager by default (hold ALT to install without packman)
- Change starting processes with ``timeout`` instead of ``pause``
- Change: try install npmdef dependency when package.json is not found in node_modules
- Fix ComponentGenerator path selection
- Fix warning from UnityGLTF api change
- Fix codegen import of register_types on very first build
- engine: Fix networking localhost detection
- engine: update component generator package version (supporting now CODEGEN_START and END sections as well as //@ifdef for fields)
## [1.17.0-pre] - 2022-07-06
- Add mathematics #ifdef
- Change NpmDef importer to enable GUI to be usable in immutable package
- Change Move modules out of this package
- Fix ``Start Server`` killing own server again
- Fix error when searching typescript workspace in wrong directory
- Change lightmap extension to be object
- engine: change lightmap extension to be object
## [1.16.0-pre] - 2022-07-06
- Add DeviceFlag component
- Add build stats log to successfully built log printing info about file sizes
- Add warning for when Unity returns missing/null lightmap
- Add VideoPlayer ``isPlaying`` that actually checks if video is currently playing
- Add ObjectField for npmdef files to SceneEditor
- Fix BuildTarget for 2022
- Fix serializing UnityEvent without any listeners
- Fix seriailizing component ``enable`` state
- Fix skybox in production builds
- Improve VideoTrack editor preview
- Improve glitch deploy error message when project name is wrong
- Update gltf-transform versions in project templates
- Update UnityGLTF method names for compatibility with 1.10.0-pre
- engine: Add DeviceFlag component
- engine: Fix VideoPlayer loop and playback speed
- engine: Improve VideoTrack sync
## [1.15.0-pre] - 2022-07-04
- add VideoTrack export
- add Spline export
- fix ComponentCompiler finding path automatically
- fix Unity.Mathematics float2, float3, float4 serialization
- change: ExportInfo shows version during installation
- engine: fix ``enabled`` not being always assigned
- engine: fix react-three-fiber component setting camera
- engine: add support for custom timeline track
- engine: add VideoTrack npmdef
## [1.14.3-pre] - 2022-07-01
- Add: installation progress now tracks and warns on installations taking longer than 5 minutes
- engine: Change; PlayableDirector Wrap.None now stops/resets timeline on end
- engine: Change; PlayableDirector now stops on disabling
## [1.14.2-pre] - 2022-07-01
- Update UnityGltf dependency
- engine: fix timeline clip offsets and hold
- engine: fix timeline animationtrack support for post-extrapolation (hold, loop, pingpong)
## [1.14.1-pre] - 2022-06-30
- Fix: exception in code watcher when creating new npmdef
- Fix: issue when deleting npmdef
- engine: improve timeline clip offsets
## [1.14.0-pre] - 2022-06-30
- Add: export timeline AnimationTrack TrackOffset
- engine: Improved timeline clip- and track offset (ongoing)
- engine: Change assigning all serialized properties by default again (instead of require ``@allProperties`` decorator)
- engine: Change; deprecate ``@allProperties`` and ``@strict`` decorators
## [1.13.2-pre] - 2022-06-29
- Fix Playmode override
- Fix: Dispose code watcher on npmdef rebuild
- Add button to open npmdef directory in commandline
- Change: keep commandline open on error
- engine: add methods for unsubscribing to EventList and make constructor args optional
- engine: change camera to not change transform anymore
## [1.13.1-pre] - 2022-06-28
- Fix support for Unity 2022.1
- engine: add support for transparent rendering using camera background alpha
## [1.13.0-pre] - 2022-06-27
- Add: transform gizmo component
- Change: component generator for npmdef is not required anymore
- Change: component gen runs in background now
- Fix: typescript drag drop adding component twice in some cases
- engine: update component gen package dependency
- engine: fix redundant camera creation when exported in GLTF
- engine: fix orbit controls focus lerp, stops now on input
## [1.12.1-pre] - 2022-06-25
- Override PlayMode in sub-scene
- engine: lightmaps encoding fix
- engine: directional light direction fix
## [1.12.0-pre] - 2022-06-25
- SceneAsset: add buttons to open vscode workspace and start server
## [1.11.1-pre] - 2022-06-25
- AnimatorController: can now be re-used on multiple objects
- Add support for exporting current scene to glb, export scene on save when used in running server
- Fix: issue that caused multi-select in hierarchy being changed
- Add glb and gltf hot-reload option to vite.config in template
- Add context menu to ``ExportInfo`` to update vite.config from template
- engine: animator controler can handle multiple target animators
- engine: fix WebXR being a child of WebARSessionRoot
- engine: improve Camera, OrbitControls, Lights OnEnable/Disable behaviour
- engine: add ``Input.getKeyPressed()``
## [1.10.0-pre] - 2022-06-23
- Support exporting multiple lightmaps
- Fix custom reflection being saved to ``Assets/Reflection.exr``
- engine: fix light error "can't add object to self" when re-enabled
- engine: remove extension log
- engine: log missing info when UnityEvent has not target (or method not found)
- engine: use lightmap index for supporting multiple lightmaps
## [1.10.0-pre] - 2022-06-23
- Support exporting multiple lightmaps
- Fix custom reflection being saved to ``Assets/Reflection.exr``
- engine: fix light error "can't add object to self" when re-enabled
- engine: remove extension log
- engine: log missing info when UnityEvent has not target (or method not found)
- engine: use lightmap index for supporting multiple lightmaps
## [1.9.0-pre] - 2022-06-23
- Initial support for exporting SceneAssets
- GridHelper improved gizmo
- engine: Camera dont set skybox when in XR
- engine: dont add lights to scene if baked
## [1.8.1-pre] - 2022-06-22
- Automatically install referenced npmdef packages
- Refactor IBuildCallbackReceiver to be async
- Remove producing resouces.glb
- engine: fix threejs dependency pointer
## [1.8.0-pre.1] - 2022-06-22
- Add project info inspector to scene asset
- Add custom context menu to scene asset containing three export projects
- Export lightmaps and skybox as part of extension
- Known issue: production build skybox is not working correctly yet
- Fix dragdrop typescript attempting to add non-component-types to objects
- Allow overriding threejs version in project
- Bump UnityGLTF dependency
- engine: ``<needle-tiny>`` added awaitable ``getContext()`` (waits for scene being loaded to be used in external js)
- engine: fix finding main camera warning
- engine: add ``SourceIdentifier`` to components to be used to get gltf specific data (e.g. lightmaps shipped per gltf)
- engine: persistent asset resolve fix
- engine: update three dependency to support khr_pointer
- engine: remove custom khr_pointer extension
- engine: fix WebARSessionRoot exported in gltf
- engine: smaller AR reticle
## [1.7.0-pre] - 2022-06-17
- Component generator inspector: add foldout and currently installed version
- Npmdef: fix register_type when no types are in npmdef (previously it would only update the file if any type was found)
- Npmdef: importer now deletes codegen directory when completely empty
- Export: referenced prefabs dont require GltfObject component anymore
- engine: create new GltfLoader per loading request
- engine: fix bug in core which could lead to scripts being registered multiple times
- engine: Added SyncedRoom auto rejoin option (to handle disconnection by server due to window inactivity)
- engine: guid resolving first in loaded gltf and retry in whole scene on fail
- engine: fix nullref in DropListener
- engine: register main camera before first awake
## [1.6.0-pre.1] - 2022-06-15
- fix serializing components implementing IEnumerable (e.g. Animation component)
- update UnityGLTF dependency
- engine: add ``GameObject.getOrAddComponent``
- engine: ``OrbitControl`` exposing controlled object
- engine: ``getWorldPosition`` now uses buffer of cached vector3's instead of only one
- engine: add ``AvatarMarker`` to synced camera (also allows to easily attach ``PlayerColor``)
- engine: fix ``Animation`` component when using khr_pointer extension
- engine: ``VideoPlayer`` expose current time
- engine: fix ``Animator.runtimeController`` serialization
- engine: make ``SyncedRoom.tryJoinRoom`` public
## [1.5.1-pre] - 2022-06-13
- Generate components from js files
- Fix compiler error in 2022
- Improve component generator editor watchlist
- Serialize dictionary as object with key[] value[] lists
- Prevent running exporter while editor is building
- Remove empty folder triggering warning
- Fix component generator running multiple times per file when file was saved multiple times.
## [1.5.0-pre] - 2022-06-12
- Add ``Create/Typescript`` context menu
- Improved npmdef and typescript UX
- Improved component codegen: does now also delete generated components when typescript file or class will be deleted
- Component gen produces stable guid (generated from type name)
## [1.4.0-pre] - 2022-06-11
- Bumb UnityGLTF dependency to 1.8.0-pre
- Add typescript editor integration to NpmDef importer: typescript files are now being displayed in project browser with look and feel of native Unity C# components. They also show a link to the matching Unity C# component.
- Fix PathUtil error
- Fix register-types generator deleting imports for modules that are not installed in current project
## [1.3.4-pre] - 2022-06-10
- Custom shader: start supporting export for Unity 2022.1
- Custom shader: basic default texture support
- engine: allow ``@serializeable`` taking abstract types
- engine: add ``Renderer.sharedMaterials`` support
## [1.3.3-pre] - 2022-06-09
- engine: move log behind debug flag
- engine: improved serialization property assignment respecting getter only properties
- engine: add optional serialization callbacks to ``ISerializable``
- engine: default to only assign declared properties
## [1.3.2-pre] - 2022-06-09
- update UnityGLTF dependency to 1.7.0-pre
- add google drive module (wip)
- project gen: fix path with spaces
- ExportInfo: fix dependency list for npmdef (for Unity 2022)
- set types dirty before building
- engine: downloading dropped file shows minimal preview box
- engine: ``DropListener`` can use localhost
- engine: ``SyncedRoom`` avoid reload due to room parameter
- engine: ``LODGroup`` instantiate workaround
- engine: improve deserialization supporting multiple type levels
## [1.3.1-pre.2] - 2022-05-30
- minor url parsing fix
- engine: change md5 hashing package
- engine: file upload logs proper server error
## [1.3.1-pre.1] - 2022-05-30
- Check if toktx is installed for production build
- Lightmap export: treat wrong quality setting as error
- engine: disable light in gltf if mode is baked
- engine: use tiny starter as default networking backend
- engine: synced file init fix for resolving references
- engine: allow removing of gen.js completely
- engine: expose ``Camera.buildCamera`` for core allowing to use blender camera
- engine: on filedrop only add drag control if none is found
## [1.3.1-pre] - 2022-05-27
- Improved ``ComponentGenerator`` inspector UX
- Add inspector extension for ``AdditionalComponentData<>`` implementations
- Update vite template index.html and index.scriban
- engine: fix networked flatbuffer state not being stored
- engine: make ``src`` on ``<needle-tiny>`` web component optional
- engine: ``src`` can now point to glb or gltf directly
- engine: fix ``Raycaster`` registration
- engine: add ``GameObject.destroySynced``
- engine: add ``context.setCurrentCamera``
- engine: make ``DropListener`` to EventTarget
- engine: make ``DropListener`` accept explicit backend url
## [1.3.0-pre.1] - 2022-05-26
- NPM Definition importer show package name
- PackageUtils: add indent
- MenuItem "Setup Scene" adds ``ComponentGenerator``
- Added minor warnings and disabled menu items for non existing project
- Fix gltf transform textures output when used in custom shaders only
- Fix ``ExportShader`` asset label for gltf extension
## [1.3.0-pre] - 2022-05-25
- Add ``ExportShader`` asset label to mark shader or material for export
- Add output folder path to ``IBuildDistCallbackReceiver`` interface
- Add button to NpmDef importer to re-generate all typescript components
- Add ``IAdditionalComponentData`` and ``AdditionalComponentData`` to easily emit additional data for another component
- engine: fix ``VideoPlayer`` being hidden, play automatically muted until interaction
- engine: added helpers to update window history
- engine: fix setting custom shader ``Vector4`` property
## [1.2.0-pre.4] - 2022-05-25
- Fix project validator local path check
- remove ``@no-check```(instead should add node_modules as baseUrl in tsconfig)
- fix ``Animation`` component serialization
- engine: fix tsc error in ``Animation`` component
- engine: fix ``Animation`` component assigning animations for GameObject again
- engine: fix ``Animation`` calling play before awake
- engine: ``AnimatorController`` handle missing motion (not assigned in Unity)
- engine: ``AnimatorController.IsInTransition()`` fix
## [1.2.0-pre.1] - 2022-05-20
- Disable separate installation of ``npmdef`` on build again as it would cause problems with react being bundled twice
- Add resolve for react and react-fiber to template vite.config
- Adding ``@no-check`` to react component as a temporary build fix solution
- Make template ``floor.fbx`` readable
- engine: minor tsc issues fixed
## [1.2.0-pre] - 2022-05-20
- Add initial react-three-fiber template
- Vite template: cleanup dependencies and add http2 memory workaround
- Dont show dependencies list in ``ExportInfo`` component when project does not exist yet
- Creating new npmdef with default ``.gitignore`` and catch IOException
- Building with referenced but uninstalled npmdef will now attempt to install those automatically
- engine: add ``isManagedExternally`` if renderer is not owned (e.g. when using react-fiber)
## [1.1.0-pre.6] - 2022-05-19
- Add resolve module for peer dependencies (for ``npmdef``) to vite project template
- Various NullReferenceException fixes
- Easily display and edit ``npmdef`` dependencies in ``ExportInfo`` component
- Add problem detection and run auto resolve for some of those problems (e.g. uninstalled dependency)
- engine: add basic support for ``stopEventPropagation`` (to make e.g. ``DragControls`` camera control agnostic in preparation of react support)
## [1.1.0-pre.5] - 2022-05-19
- ``Clean install`` does now delete node_modules and package-lock
- Mark types dirty after installation to fix missing types on first time install
- Fix ``npmdef`` registration on first project load
## [1.1.0-pre.2] - 2022-05-18
- improved ``NpmDef`` support
## [1.1.0-pre] - 2022-05-17
- fix ``EventList`` outside of gltf
- fix ``EventList`` without any function assigned (``No Function`` in Unity)
- fix minimal template gizmo icon copy
- start implementing ``NpmDef`` support allowing for modular project setup.
- engine: support changing ``WebARSessionRoot.arScale`` changing at runtime
## [1.0.0-pre.31] - 2022-05-12
- engine: fix webx avatar instantiate
- engine: stop input preventing key event defaults
## [1.0.0-pre.30] - 2022-05-12
- replace glb in collab sandbox template with fbx
- minor change in ``ComponentGenerator`` log
- add update info and button to ``ExportInfo`` component
- engine: log error if ``instantiate`` is called with false parent
- engine: fix instantiate with correct ``AnimatorController`` cloning
## [1.0.0-pre.29] - 2022-05-11
- engine: fix ``@syncField()``
- engine: fix ``AssetReference.instantiate`` and ``AssetReference.instantiateSynced`` parenting
- engine: improve ``PlayerSync`` and ``PlayerState``
## [1.0.0-pre.28] - 2022-05-11
- Move ``PlayerState`` and ``PlayerSync`` to experimental components
- Add TypeUtils to get all known typescript components
- Add docs to ``SyncTransform`` component
- Add support for ``UnityEvent.off`` state
- engine: prepend three canvas to the web element instead of appending
- engine: ``SyncedRoom`` logs warning when disconnected
- engine: internal networking does not attempt to reconnect on connection closed
- engine: internal networking now empties user list when disconnected from room
- engine: ``GameObject.instantiate`` does not always generate new guid to support cases where e.g. ``SyncTransform`` is on cloned object and requires unique id
- engine: ``syncedInstantiate`` add fallback to ``Context.Current`` when missing
- engine: ``EventList`` refactored to use list of ``CallInfo`` objects internally instead of plain function array to more easily attach meta info like ``UnityEvent.off``
- engine: add ``GameObject.instantiateSynced``
## [1.0.0-pre.27] - 2022-05-10
- add directory check to ``ComponentGenerator``
- parse glitch url in ``Networking.localhost``
- engine: fix font path
- engine: add ``debugnewscripts`` url parameter
- engine: start adding simplifcation to automatic instance creation + sync per player
- engine: allow InstantiateOptions in ``GameObject.instantiate`` to be inlined as e.g. ``{ position: ... }``
- engine: add ``AvatarMarker`` creation and destroy events
- engine: fix networking message buffering
## [1.0.0-pre.26] - 2022-05-10
- Fix js emitter writing guid for glTF root which caused guid to be present on two objects and thus resolved references for gltf root were wrong
- Improved ``SyncedRoom`` and ``Networking`` components tooltips and info
- Improved ``SyncedCam`` reference assignment - warn if asset is assigned instead of scene reference
- Build error fix
- Added versions to ``ExportInfo`` editor and context menu to quickly access package.jsons and changelogs
## [1.0.0-pre.25] - 2022-05-08
- Unity 2022 enter PlayMode fix for broken skybox when invoked from play button or ``[InitializeOnLoad]``
- Unity 2022 minor warning / obsolete fixes
- remove GltFast toggle in ``GltfObject`` as currently not supported/used
- fix build error
- rename and update scene templates
- engine: ``SpatialTrigger`` is serializable
- engine: fix ``DragControls`` offset when using without ground
- engine: fix ``WebXRController`` interaction with UI ``Button.onClick``
## [1.0.0-pre.24] - 2022-05-04
- fix ifdef in template component
- allow disabling component gen component
- fix exporting asset: check if it is root
- fix ``InputAction`` locking export
- engine: fix gltf extension not awaiting dependencies
- engine: fix persistent asset @serializable check for arrays
- engine: add ``setWorldScale``
- engine: fix ``instantiate`` setting position
- engine: ``AssetReference`` does now create new instance in ``instantiate`` call
- engine: add awaitable ``delay`` util method
- engine: fix scripts being active when loaded in gltf but never added to scene
- engine: minimal support for mocking pointer input
- engine: emit minimal down and up input events when in AR
## [1.0.0-pre.23] - 2022-05-03
- show warning in ``^2021`` that templating is currently not supported
- clean install now asks to stop running servers before running
- engine: improved default loading element
- play button does now ask to create a project if none exits
## [1.0.0-pre.22] - 2022-05-02
- lightmaps fixed
- glitch upload shows time estimate
- deployment build error fix
- json pointer resolve
- improved auto install
- started basic ``SpriteRenderer`` support
- basic ``AnimationCurve`` support
- fixed ``PlayerColor``
- fixed ``persistent_assets`` and ``serializeable`` conflict
- basic export of references to components in root prefab
## [1.0.0-pre.21] - 2022-04-30
- cleanup ``WebXR`` and ``WebXRSync``
- Play button does not also trigger installation and setup when necessary
- Fixed addressables export
- Added doc links to ``ComponentGenerator`` and updated urls in welcome window.
- ``Deployment.GlitchModel`` does now support Undo
## [1.0.0-pre.20] - 2022-04-29
- add internal publish button
- dont emit ``khr_techniques_webgl`` extension when not exporting custom shaders
- fix environment light export
- use newtonsoft converters when serializing additional data
- add ``Open Server`` button to ``ExportInfo`` component
- ``component-compiler`` logs command and log output file
## [1.0.0-pre.18] - 2022-04-27
- refactor extension serialization to use Newtonsoft
## [1.0.0-pre.11] - 2022-04-22
- initial release
Reference in New Issue View Git Blame Copy Permalink