@needle-tools/engine 4.1.0-beta → 4.1.0-beta.2

package/lib/engine-components/webxr/WebXRRig.d.ts

@@ -11,12 +11,22 @@ import { Behaviour } from "../Component.js";
 export declare class XRRig extends Behaviour implements IXRRig {
     priority: number;
     get isActive(): boolean;
-    /** Sets this rig to be the active XR rig (needs to be called during an active XR session) */
+    /**
+     * Sets this rig to be the active XR rig (needs to be called during an active XR session)
+     * Note that this might modify the priority of this rig to be the highest.
+    */
     setAsActiveXRRig(): void;
+    /**
+     * Sets the priority of the rig.
+     */
+    setPriority(value: number): void;
+    /** @internal */
     awake(): void;
     isXRRig(): boolean;
     supportsXR(_mode: XRSessionMode): boolean;
     private _startScale?;
+    /** @internal */
     onEnterXR(args: NeedleXREventArgs): void;
+    /** @internal */
     onLeaveXR(args: NeedleXREventArgs): void;
 }

package/lib/engine-components/webxr/WebXRRig.js

@@ -20,10 +20,20 @@ const debug = getParam("debugwebxr");
 export class XRRig extends Behaviour {
     priority = 0;
     get isActive() { return this.activeAndEnabled && this.gameObject.visible; }
-    /** Sets this rig to be the active XR rig (needs to be called during an active XR session) */
+    /**
+     * Sets this rig to be the active XR rig (needs to be called during an active XR session)
+     * Note that this might modify the priority of this rig to be the highest.
+    */
     setAsActiveXRRig() {
         NeedleXRSession.active?.setRigActive(this);
     }
+    /**
+     * Sets the priority of the rig.
+     */
+    setPriority(value) {
+        this.priority = value;
+    }
+    /** @internal */
     awake() {
         if (debug) {
             const gizmoObj = new Object3D();
@@ -43,12 +53,14 @@ export class XRRig extends Behaviour {
         return true;
     }
     _startScale;
+    /** @internal */
     onEnterXR(args) {
         this._startScale = this.gameObject.scale.clone();
         args.xr.addRig(this);
         if (debug)
             console.log("WebXR: add Rig", this.name, this.priority);
     }
+    /** @internal */
     onLeaveXR(args) {
         args.xr.removeRig(this);
         if (this._startScale && this.gameObject)

package/lib/engine-components/webxr/WebXRRig.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebXRRig.js","sourceRoot":"","sources":["../../../src/engine-components/webxr/WebXRRig.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAW,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,OAAO,EAA0B,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,OAAO,KAAM,SAAQ,SAAS;IAGhC,QAAQ,GAAW,CAAC,CAAC;IAErB,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3E,6FAA6F;IAC7F,gBAAgB;QACZ,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK;QACD,IAAI,KAAK,EAAE;YACP,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAiB,CAAC;YAC/C,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,GAAG;gBACH,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;SAC5B;IACL,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,UAAU,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,WAAW,CAAW;IAE9B,SAAS,CAAC,IAAuB;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjD,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,IAAG,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC;IACD,SAAS,CAAC,IAAuB;QAC7B,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU;YACnC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;CAEJ;AA3CG;IADC,YAAY,EAAE;uCACM"}
+{"version":3,"file":"WebXRRig.js","sourceRoot":"","sources":["../../../src/engine-components/webxr/WebXRRig.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAW,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAE9E,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,OAAO,EAA0B,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AAErC;;;;;GAKG;AACH,MAAM,OAAO,KAAM,SAAQ,SAAS;IAGhC,QAAQ,GAAW,CAAC,CAAC;IAErB,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3E;;;MAGE;IACF,gBAAgB;QACZ,eAAe,CAAC,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD;;OAEG;IACH,WAAW,CAAC,KAAa;QACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,gBAAgB;IAChB,KAAK;QACD,IAAI,KAAK,EAAE;YACP,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAiB,CAAC;YAC/C,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,GAAG;gBACH,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;SAC5B;IACL,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,UAAU,CAAC,KAAoB;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAEO,WAAW,CAAW;IAE9B,gBAAgB;IAChB,SAAS,CAAC,IAAuB;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjD,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,KAAK;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD,gBAAgB;IAChB,SAAS,CAAC,IAAuB;QAC7B,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU;YACnC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;CAGJ;AAxDG;IADC,YAAY,EAAE;uCACM"}

package/lib/needle-engine.js

@@ -28,10 +28,10 @@ function registerGlobal(obj) {
         Needle[key] = obj[key];
     }
 }
-// import * as Component from "./engine-components/Component.js";
-// registerGlobal(Component);
-// import * as Components from "./engine-components/codegen/components.js";
-// registerGlobal(Components);
+import * as Component from "./engine-components/Component.js";
+registerGlobal(Component);
+import * as Components from "./engine-components/codegen/components.js";
+registerGlobal(Components);
 import { GameObject } from "./engine-components/Component.js";
 for (const method of Object.getOwnPropertyNames(GameObject)) {
     switch (method) {
@@ -59,5 +59,5 @@ if (!globalThis["THREE"]) {
     globalThis["THREE"] = THREE;
 }
 else
-    console.warn("Threejs is already imported");
+    console.warn("Three.js is already imported");
 //# sourceMappingURL=needle-engine.js.map

package/lib/needle-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"needle-engine.js","sourceRoot":"","sources":["../src/needle-engine.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AACpC,OAAO,0BAA0B,CAAC;AAClC,OAAO,0BAA0B,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC;AAExC,0CAA0C;AAC1C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACjH,MAAM,MAAM,GAAG;IACX,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,eAAe;IAChC,IAAI,EAAE;QACF,WAAW,EAAE,QAAQ;KACxB;IACD,KAAK,EAAE;QACH,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,cAAc,EAAE,cAAc;KACjC;CACJ,CAAC;AACF,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,KAAK,SAAS,EAAE;IAC7C,OAAO,CAAC,IAAI,CAAC,sCAAsC,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACtF;AACD,SAAS,cAAc,CAAC,GAAW;IAC/B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;KAC1B;AACL,CAAC;AACD,iEAAiE;AACjE,6BAA6B;AAE7B,2EAA2E;AAC3E,8BAA8B;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE;IACzD,QAAQ,MAAM,EAAE;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACP,SAAS;QACb;YACI,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM;KACb;CACJ;AAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;IACvB,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;CACjC;KACI;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;QACtB,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;KAC3C;CACJ;AAGD,wBAAwB;AACxB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;IACtB,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;CAC/B;;IACI,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC"}
+{"version":3,"file":"needle-engine.js","sourceRoot":"","sources":["../src/needle-engine.ts"],"names":[],"mappings":"AAAA,OAAO,4BAA4B,CAAC;AACpC,OAAO,0BAA0B,CAAC;AAClC,OAAO,0BAA0B,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yCAAyC,CAAC;AACxD,cAAc,yBAAyB,CAAC;AAExC,0CAA0C;AAC1C,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACjH,MAAM,MAAM,GAAG;IACX,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,eAAe,EAAE,eAAe;IAChC,IAAI,EAAE;QACF,WAAW,EAAE,QAAQ;KACxB;IACD,KAAK,EAAE;QACH,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,QAAQ;QAClB,cAAc,EAAE,cAAc;KACjC;CACJ,CAAC;AACF,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,KAAK,SAAS,EAAE;IAC7C,OAAO,CAAC,IAAI,CAAC,sCAAsC,UAAU,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;CACtF;AACD,SAAS,cAAc,CAAC,GAAW;IAC/B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE;QACnB,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;KAC1B;AACL,CAAC;AACD,OAAO,KAAK,SAAS,MAAM,kCAAkC,CAAC;AAC9D,cAAc,CAAC,SAAS,CAAC,CAAC;AAE1B,OAAO,KAAK,UAAU,MAAM,2CAA2C,CAAC;AACxE,cAAc,CAAC,UAAU,CAAC,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE;IACzD,QAAQ,MAAM,EAAE;QACZ,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa,CAAC;QACnB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACP,SAAS;QACb;YACI,MAAM,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM;KACb;CACJ;AAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;IACvB,UAAU,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC;CACjC;KACI;IACD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;QACtB,UAAU,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;KAC3C;CACJ;AAGD,wBAAwB;AACxB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;IACtB,UAAU,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;CAC/B;;IACI,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/engine",
-  "version": "4.1.0-beta",
+  "version": "4.1.0-beta.2",
   "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in",
   "main": "dist/needle-engine.umd.cjs",
   "exports": {
@@ -81,7 +81,7 @@
   ],
   "dependencies": {
     "@dimforge/rapier3d-compat": "^0.14.0",
-    "@needle-tools/gltf-progressive": "^2.1.0-alpha.3",
+    "@needle-tools/gltf-progressive": "^2.1.0-alpha.4",
     "@webxr-input-profiles/motion-controllers": "^1.0.0",
     "flatbuffers": "2.0.4",
     "md5": "^2.3.0",
@@ -93,7 +93,7 @@
     "three": "npm:@needle-tools/three@^0.169.4",
     "three-mesh-bvh": "^0.8.3",
     "three-mesh-ui": "npm:@needle-tools/three-mesh-ui@^7.1.5-alpha.5",
-    "three.quarks": "0.15.5",
+    "three.quarks": "0.15.6",
     "uuid": "^9.0.0",
     "websocket-ts": "^2.1.5"
   },

package/src/engine/codegen/register_types.ts

@@ -1,6 +1,6 @@
 /* eslint-disable */
 import { TypeStore } from "./../engine_typestore.js"
-
+
 // Import types
 import { AlignmentConstraint } from "../../engine-components/AlignmentConstraint.js";
 import { Animation } from "../../engine-components/Animation.js";
@@ -220,7 +220,7 @@ import { XRFlag } from "../../engine-components/webxr/XRFlag.js";
 import { PlayerSync } from "../../engine-components-experimental/networking/PlayerSync.js";
 import { PlayerState } from "../../engine-components-experimental/networking/PlayerSync.js";
 import { PresentationMode } from "../../engine-components-experimental/Presentation.js";
-
+
 // Register types
 TypeStore.add("AlignmentConstraint", AlignmentConstraint);
 TypeStore.add("Animation", Animation);

package/src/engine/xr/NeedleXRSession.ts

@@ -712,8 +712,11 @@ export class NeedleXRSession implements INeedleXRSession {
     /** Sets a XRRig to be active which will parent the camera to this rig */
     setRigActive(rig: IXRRig) {
         const i = this._rigs.indexOf(rig);
+        const currentlyActive = this._rigs[0];
         this._rigs.splice(i, 1);
         this._rigs.unshift(rig);
+        // if there's another rig currently active we need to make sure we have at least the same priority
+        rig.priority = currentlyActive?.priority ?? 0;
         this.updateActiveXRRig();
     }
     /**

package/src/engine-components/GroundProjection.ts

@@ -3,7 +3,7 @@ import { GroundedSkybox as GroundProjection } from 'three/examples/jsm/objects/G
 
 import { Gizmos } from "../engine/engine_gizmos.js";
 import { serializable } from "../engine/engine_serialization_decorator.js";
-import { getBoundingBox, getTempVector, getWorldScale, Graphics, setVisibleInCustomShadowRendering,setWorldPosition } from "../engine/engine_three_utils.js";
+import { getBoundingBox, getTempVector, getWorldScale, Graphics, setVisibleInCustomShadowRendering, setWorldPosition } from "../engine/engine_three_utils.js";
 import { delayForFrames, getParam, Watch as Watch } from "../engine/engine_utils.js";
 import { Behaviour } from "./Component.js";
 
@@ -37,7 +37,7 @@ export class GroundProjectedEnv extends Behaviour {
     @serializable()
     set radius(val: number) {
         this._radius = val;
-        this.updateProjection();
+        if (this._projection) this.updateProjection();
     }
     get radius(): number { return this._radius; }
     private _radius: number = 50;
@@ -49,7 +49,7 @@ export class GroundProjectedEnv extends Behaviour {
     @serializable()
     set height(val: number) {
         this._height = val;
-        this.updateProjection();
+        if (this._projection) this.updateProjection();
     }
     get height(): number { return this._height; }
     private _height: number = 3;
@@ -68,7 +68,7 @@ export class GroundProjectedEnv extends Behaviour {
     get arBlending(): number { return this._arblending; }
     private _arblending = 0;
 
-    private _lastEnvironment?: Texture;
+    private _lastBackground?: Texture;
     private _lastRadius?: number;
     private _lastHeight?: number;
     private _projection?: GroundProjection;
@@ -88,9 +88,10 @@ export class GroundProjectedEnv extends Behaviour {
                 this.updateAndCreate();
         }
         if (!this._watcher) {
-            this._watcher = new Watch(this.context.scene, "environment");
+            this._watcher = new Watch(this.context.scene, "background");
             this._watcher.subscribeWrite(_ => {
-                this.updateProjection();
+                if (debug) console.log("Background changed", this.context.scene.background);
+                this._needsTextureUpdate = true;
             });
         }
     }
@@ -101,13 +102,13 @@ export class GroundProjectedEnv extends Behaviour {
     }
     /** @internal */
     onEnterXR(): void {
-        if(!this.activeAndEnabled) return;
+        if (!this.activeAndEnabled) return;
         this._needsTextureUpdate = true;
         this.updateProjection();
     }
     /** @internal */
     async onLeaveXR() {
-        if(!this.activeAndEnabled) return;
+        if (!this.activeAndEnabled) return;
         await delayForFrames(1);
         this.updateProjection();
     }
@@ -121,8 +122,8 @@ export class GroundProjectedEnv extends Behaviour {
         if (blurrinessChanged) {
             this.updateProjection();
         }
-        else if (this._needsTextureUpdate) {
-            this.updateBlurriness();
+        else if (this._needsTextureUpdate && this.context.scene.background instanceof Texture) {
+            this.updateBlurriness(this.context.scene.background, this.context.scene.backgroundBlurriness);
         }
     }
 
@@ -138,10 +139,16 @@ export class GroundProjectedEnv extends Behaviour {
      * Updates the ground projection. This is called automatically when the environment or settings change.
      */
     updateProjection() {
-        if (!this.context.scene.environment) {
+        if (!this.context.scene.background) {
+            this._projection?.removeFromParent();
+            return;
+        }
+        const backgroundTexture = this.context.scene.background;
+        if (!(backgroundTexture instanceof Texture)) {
             this._projection?.removeFromParent();
             return;
         }
+
         if (this.context.xr?.isPassThrough || this.context.xr?.isAR) {
             if (this.arBlending === 0) {
                 this._projection?.removeFromParent();
@@ -152,25 +159,25 @@ export class GroundProjectedEnv extends Behaviour {
         if (!this.gameObject || this.destroyed) {
             return;
         }
-        
+
         let needsNewAutoFit = true;
         // offset here must be zero (and not .01) because the plane occlusion (when mesh tracking is active) is otherwise not correct
         const offset = 0;
-        if (!this._projection || this.context.scene.environment !== this._lastEnvironment || this._height !== this._lastHeight || this._radius !== this._lastRadius) {
-            if (debug)
-                console.log("Create/Update Ground Projection", this.context.scene.environment.name);
+
+        const hasChanged = backgroundTexture !== this._lastBackground || this._height !== this._lastHeight || this._radius !== this._lastRadius;
+
+        if (!this._projection || hasChanged) {
+            if (debug) console.log("Create/Update Ground Projection", backgroundTexture.name);
+
             this._projection?.removeFromParent();
-            if (!this._projection || (this.context.scene.environment !== this._lastEnvironment || this._lastHeight !== this._height || this._lastRadius !== this._radius)) {
-                try {
-                    this._projection = new GroundProjection(this.context.scene.environment, this._height, this.radius, 64);
-                }
-                catch (e) {
-                    console.error("Failed to enable GroundProjection for environment", e);
-                    return;
-                }
+
+            try {
+                this._projection = new GroundProjection(backgroundTexture, this._height, this._radius, 64);
+            }
+            catch (e) {
+                console.error("Error creating three GroundProjection", e);
+                return;
             }
-            else
-                needsNewAutoFit = false;
             this._projection.position.y = this._height - offset;
             this._projection.name = "GroundProjection";
             setVisibleInCustomShadowRendering(this._projection, false);
@@ -205,35 +212,35 @@ export class GroundProjectedEnv extends Behaviour {
         this.env.radius = this._radius;
         this.env.height = this._height;
         */
-       
+
         if (this.context.scene.backgroundBlurriness > 0.001 && this._needsTextureUpdate) {
-            this.updateBlurriness();
+            this.updateBlurriness(backgroundTexture, this.context.scene.backgroundBlurriness);
         }
 
-        this._lastEnvironment = this.context.scene.environment;
+        this._lastBackground = backgroundTexture;
         this._lastHeight = this._height;
         this._lastRadius = this._radius;
-
         this._needsTextureUpdate = false;
     }
 
     private _blurrynessShader: ShaderMaterial | null = null;
     private _lastBlurriness: number = -1;
 
-    private updateBlurriness() {
+    private updateBlurriness(texture: Texture, blurriness: number) {
         if (!this._projection) {
             return;
         }
-        else if (!this.context.scene.environment) {
+        else if (!texture) {
             return;
         }
+
         this._needsTextureUpdate = false;
-        if (debug) console.log("Update Blurriness", this.context.scene.backgroundBlurriness);
+        if (debug) console.log("Update Blurriness", blurriness);
         this._blurrynessShader ??= new ShaderMaterial({
             name: "GroundProjectionBlurriness",
             uniforms: {
-                map: { value: this.context.scene.environment },
-                blurriness: { value: this.context.scene.backgroundBlurriness },
+                map: { value: texture },
+                blurriness: { value: blurriness },
                 blending: { value: 0 },
                 alphaFactor: { value: 1 }
             },
@@ -241,9 +248,10 @@ export class GroundProjectedEnv extends Behaviour {
             fragmentShader: blurFragmentShader
         });
         this._blurrynessShader.depthWrite = false;
-        this._blurrynessShader.uniforms.blurriness.value = this.context.scene.backgroundBlurriness;
-        this._lastBlurriness = this.context.scene.backgroundBlurriness;
-        this.context.scene.environment.needsPMREMUpdate = true;
+        this._blurrynessShader.uniforms.map.value = texture;
+        this._blurrynessShader.uniforms.blurriness.value = 1;//blurriness;
+        this._lastBlurriness = blurriness;
+        texture.needsUpdate = true;
 
         const wasTransparent = this._projection.material.transparent;
         this._projection.material.transparent = (this.context.xr?.isAR === true && this.arBlending > 0.000001) ?? false;
@@ -266,7 +274,7 @@ export class GroundProjectedEnv extends Behaviour {
         }
 
         // Update the texture
-        this._projection.material.map = Graphics.copyTexture(this.context.scene.environment, this._blurrynessShader);
+        this._projection.material.map = Graphics.copyTexture(texture, this._blurrynessShader);
         this._projection.material.depthTest = true;
         this._projection.material.depthWrite = false;
     }

package/src/engine-components/OrbitControls.ts

@@ -297,6 +297,14 @@ export class OrbitControls extends Behaviour implements ICameraController {
             this._controls = new ThreeOrbitControls(cam!, element);
             cam?.quaternion.copy(mat!)
             if (defaultKeys === undefined) defaultKeys = { ...this._controls.keys };
+            // set controls look point in front of the current camera by default
+            // it may be overriden by the autoTarget feature
+            // but if we don't do this and autoTarget is OFF then the camera will turn to look at 0 0 0 of the scene 
+            const worldPosition = getWorldPosition(cam);
+            const forward = this.gameObject.worldForward;
+            const dist = 2.5;
+            const lookAt = worldPosition.clone().sub(forward.multiplyScalar(dist));
+            this._controls.target.copy(lookAt);
         }
 
         if (this._controls) {

package/src/engine-components/RigidBody.ts

@@ -1,13 +1,14 @@
 import { Matrix4, Object3D, Quaternion, Vector3, Vector3Like } from "three";
 
 import { isDevEnvironment } from "../engine/debug/index.js";
+import { MODULES } from "../engine/engine_modules.js";
 import { CollisionDetectionMode, RigidbodyConstraints } from "../engine/engine_physics.types.js";
 import { serializable } from "../engine/engine_serialization_decorator.js";
 import { Context, FrameEvent } from "../engine/engine_setup.js";
 import { getWorldPosition } from "../engine/engine_three_utils.js";
 import type { IRigidbody, Vec3 } from "../engine/engine_types.js";
 import { validate } from "../engine/engine_util_decorator.js";
-import { Watch } from "../engine/engine_utils.js";
+import { delayForFrames, Watch } from "../engine/engine_utils.js";
 import { Behaviour } from "./Component.js";
 
 class TransformWatch {
@@ -318,11 +319,16 @@ export class Rigidbody extends Behaviour implements IRigidbody {
         }
         this._watch.start(true, true);
         this.startCoroutine(this.beforePhysics(), FrameEvent.LateUpdate);
-        if (isDevEnvironment() && !this.context.physics.engine?.getBody(this)) {
+        if (isDevEnvironment()) {
             if (!globalThis["NEEDLE_USE_RAPIER"])
                 console.warn(`Rigidbody could not be created: Rapier physics are explicitly disabled.`);
-            else
-                console.warn(`Rigidbody could not be created. Ensure \"(${this.name}\" has a Collider component.`);
+            else {
+                MODULES.RAPIER_PHYSICS.ready().then(async () => {
+                    await delayForFrames(1);
+                    if (!this.context.physics.engine?.getBody(this))
+                        console.warn(`Rigidbody could not be created. Ensure \"(${this.name}\" has a Collider component.`);
+                })
+            }
         }
     }
 
@@ -340,7 +346,7 @@ export class Rigidbody extends Behaviour implements IRigidbody {
     }
 
     // need to do this right before updating physics to prevent rendered object glitching through physical bodies
-    *beforePhysics() {
+    * beforePhysics() {
         while (true) {
             if (this._propertiesChanged) {
                 this._propertiesChanged = false;

package/src/engine-components/SpatialTrigger.ts

@@ -62,23 +62,23 @@ export class SpatialTriggerReceiver extends Behaviour {
 
     }
 
-    currentIntersected: SpatialTrigger[] = [];
-    lastIntersected: SpatialTrigger[] = [];
+    readonly currentIntersected: SpatialTrigger[] = [];
+    readonly lastIntersected: SpatialTrigger[] = [];
 
     onEnterTrigger(trigger: SpatialTrigger): void {
         if(debug) console.log("ENTER TRIGGER", this.name, trigger.name, this, trigger);
         trigger.raiseOnEnterEvent(this);
-        this.onEnter?.invoke(this, trigger);
+        this.onEnter?.invoke();
     }
     onExitTrigger(trigger: SpatialTrigger): void {
-        if(debug) console.log("EXIT TRIGGER", this.name, trigger.name, this, trigger);
+        if(debug) console.log("EXIT TRIGGER", this.name, trigger.name, );
         trigger.raiseOnExitEvent(this);
-        this.onExit?.invoke(this, trigger);
+        this.onExit?.invoke();
     }
 
     onStayTrigger(trigger: SpatialTrigger): void {
         trigger.raiseOnStayEvent(this);
-        this.onStay?.invoke(this, trigger);
+        this.onStay?.invoke();
     }
 }
 

package/src/engine-components/TransformGizmo.ts

@@ -1,4 +1,4 @@
-import { MathUtils,Mesh, MeshBasicMaterial, Object3D } from "three";
+import { MathUtils, Mesh, MeshBasicMaterial, Object3D } from "three";
 import { TransformControls } from "three/examples/jsm/controls/TransformControls.js";
 
 import * as params from "../engine/engine_default_parameters.js";
@@ -26,7 +26,15 @@ export class TransformGizmo extends Behaviour {
     @serializable()
     public scaleSnap: number = .25;
 
-    private control?: TransformControls;
+    /**
+     * Get the underlying three.js TransformControls instance.
+     * @returns The TransformControls instance.
+     */
+    get control() {
+        return this._control;
+    }
+
+    private _control?: TransformControls;
     private orbit?: OrbitControls;
 
     /** @internal */
@@ -35,12 +43,12 @@ export class TransformGizmo extends Behaviour {
 
         if (!this.context.mainCamera) return;
 
-        if (!this.control) {
-            this.control = new TransformControls(this.context.mainCamera, this.context.renderer.domElement);
-            this.control.enabled = true;
-            this.control.getRaycaster().layers.set(2);
-            this.control.size = 1;
-            const obj = ("_root" in this.control ? this.control._root : this.control) as Object3D;
+        if (!this._control) {
+            this._control = new TransformControls(this.context.mainCamera, this.context.renderer.domElement);
+            this._control.enabled = true;
+            this._control.getRaycaster().layers.set(2);
+            this._control.size = 1;
+            const obj = ("_root" in this._control ? this._control._root : this._control) as Object3D;
             obj.traverse(x => {
                 const mesh = x as Mesh;
                 mesh.layers.set(2);
@@ -54,12 +62,12 @@ export class TransformGizmo extends Behaviour {
             this.orbit = GameObject.getComponentInParent(this.context.mainCamera, OrbitControls) ?? undefined;
         }
 
-        if (this.control) {
-            const obj = this.control.getHelper();
+        if (this._control) {
+            const obj = this._control.getHelper();
             this.context.scene.add(obj);
-            this.control.attach(this.gameObject);
+            this._control.attach(this.gameObject);
 
-            this.control?.addEventListener('dragging-changed', this.onControlChangedEvent);
+            this._control?.addEventListener('dragging-changed', this.onControlChangedEvent);
             window.addEventListener('keydown', this.windowKeyDownListener);
             window.addEventListener('keyup', this.windowKeyUpListener);
         }
@@ -67,25 +75,25 @@ export class TransformGizmo extends Behaviour {
 
     /** @internal */
     onDisable() {
-        this.control?.getHelper()?.removeFromParent();
-        this.control?.removeEventListener('dragging-changed', this.onControlChangedEvent);
+        this._control?.getHelper()?.removeFromParent();
+        this._control?.removeEventListener('dragging-changed', this.onControlChangedEvent);
         window.removeEventListener('keydown', this.windowKeyDownListener);
         window.removeEventListener('keyup', this.windowKeyUpListener);
     }
 
     enableSnapping() {
-        if (this.control) {
-            this.control.setTranslationSnap(this.translationSnap);
-            this.control.setRotationSnap(MathUtils.degToRad(this.rotationSnapAngle));
-            this.control.setScaleSnap(this.scaleSnap);
+        if (this._control) {
+            this._control.setTranslationSnap(this.translationSnap);
+            this._control.setRotationSnap(MathUtils.degToRad(this.rotationSnapAngle));
+            this._control.setScaleSnap(this.scaleSnap);
         }
     }
 
     disableSnapping() {
-        if (this.control) {
-            this.control.setTranslationSnap(null);
-            this.control.setRotationSnap(null);
-            this.control.setScaleSnap(null);
+        if (this._control) {
+            this._control.setTranslationSnap(null);
+            this._control.setRotationSnap(null);
+            this._control.setScaleSnap(null);
         }
     }
 
@@ -104,11 +112,11 @@ export class TransformGizmo extends Behaviour {
 
     private windowKeyDownListener = (event) => {
         if (!this.enabled) return;
-        if (!this.control) return;
+        if (!this._control) return;
         switch (event.keyCode) {
 
             case 81: // Q
-                this.control.setSpace(this.control.space === 'local' ? 'world' : 'local');
+                this._control.setSpace(this._control.space === 'local' ? 'world' : 'local');
                 break;
 
             case 16: // Shift
@@ -116,40 +124,40 @@ export class TransformGizmo extends Behaviour {
                 break;
 
             case 87: // W
-                this.control.setMode('translate');
+                this._control.setMode('translate');
                 break;
 
             case 69: // E
-                this.control.setMode('rotate');
+                this._control.setMode('rotate');
                 break;
 
             case 82: // R
-                this.control.setMode('scale');
+                this._control.setMode('scale');
                 break;
             case 187:
             case 107: // +, =, num+
-                this.control.setSize(this.control.size + 0.1);
+                this._control.setSize(this._control.size + 0.1);
                 break;
 
             case 189:
             case 109: // -, _, num-
-                this.control.setSize(Math.max(this.control.size - 0.1, 0.1));
+                this._control.setSize(Math.max(this._control.size - 0.1, 0.1));
                 break;
 
             case 88: // X
-                this.control.showX = !this.control.showX;
+                this._control.showX = !this._control.showX;
                 break;
 
             case 89: // Y
-                this.control.showY = !this.control.showY;
+                this._control.showY = !this._control.showY;
                 break;
 
             case 90: // Z
-                this.control.showZ = !this.control.showZ;
+                this._control.showZ = !this._control.showZ;
                 break;
 
             case 32: // Spacebar
-                this.control.enabled = !this.control.enabled;
+                this._control.enabled = !this._control.enabled;
                 break;
         }
     }

package/src/engine-components/VideoPlayer.ts

@@ -1017,7 +1017,6 @@ class ScreenspaceTexture extends ShaderMaterial {
             else
             {
                 vec4 texcolor = texture2D(map, vUv);
-                texcolor = sRGBTransferOETF(texcolor);
                 gl_FragColor = texcolor;
             }
         }

package/src/engine-components/particlesystem/ParticleSystemModules.ts

@@ -685,7 +685,7 @@ export class ShapeModule implements EmitterShape {
     }
 
     update(_system: QParticleSystem, _delta: number): void {
-        throw new Error('Method not implemented: use onUpdate');
+        /* this is called by quarks */
     }
 
     onUpdate(system: IParticleSystem, _context: Context, simulationSpace: ParticleSystemSimulationSpace, obj: Object3D) {