@needle-tools/engine 5.1.12 → 5.1.14

package/src/engine/engine_gameobject.ts

@@ -7,14 +7,14 @@ import { ComponentLifecycleEvents } from "./engine_components_internal.js";
 import { activeInHierarchyFieldName } from "./engine_constants.js";
 import { editorGuidKeyName } from "./engine_constants.js";
 import { $isUsingInstancing, InstancingUtil } from "./engine_instancing.js";
+import { type InstantiateContext, type InstantiateReferenceMap, type ObjectCloneReference,resolveInstanceReferences } from "./engine_instantiate_resolve.js";
 import { processNewScripts } from "./engine_mainloop_utils.js";
 import type { syncInstantiate } from "./engine_networking_instantiate.js";
 import { InstantiateIdProvider } from "./engine_networking_instantiate.js";
-import { resolveInstanceReferences, type InstantiateReferenceMap, type InstantiateContext, type ObjectCloneReference } from "./engine_instantiate_resolve.js";
 import { assign } from "./engine_serialization_core.js";
 import { Context, registerComponent } from "./engine_setup.js";
 import { getTempQuaternion, logHierarchy, setWorldPosition, setWorldQuaternion } from "./engine_three_utils.js";
-import { type Constructor, type GuidsMap, type IComponent as Component, type IComponent, type IGameObject as GameObject, type UIDProvider, isComponent } from "./engine_types.js";
+import { type Constructor, type GuidsMap, type IComponent as Component, type IComponent, type IGameObject as GameObject, isComponent,type UIDProvider } from "./engine_types.js";
 import { deepClone, getParam, tryFindObject } from "./engine_utils.js";
 import { apply } from "./js-extensions/index.js";
 

package/src/engine/engine_gltf_builtin_components.ts

@@ -5,7 +5,7 @@ import { LogType, showBalloonMessage } from "./debug/index.js";
 import { addNewComponent } from "./engine_components.js";
 import { builtinComponentKeyName, editorGuidKeyName } from "./engine_constants.js";
 import { debugExtension } from "./engine_default_parameters.js";
-import { generateGuidsForHierarchy, resolveStringGuidsInHierarchy, originalComponentNameKey } from "./engine_instantiate_resolve.js";
+import { generateGuidsForHierarchy, originalComponentNameKey,resolveStringGuidsInHierarchy } from "./engine_instantiate_resolve.js";
 import { InstantiateIdProvider } from "./engine_networking_instantiate.js"
 import { isLocalNetwork } from "./engine_networking_utils.js";
 import { deserializeObject, serializeObject } from "./engine_serialization.js";

package/src/engine/engine_init.ts

@@ -8,7 +8,7 @@ import { initBuiltinTypes } from "./codegen/register_types.js";
 import { initSpatialConsole } from "./debug/debug_spatial_console.js";
 import { initAddressableSerializers } from "./engine_addressables.js";
 import { ensureAudioContextIsResumed } from "./engine_audio.js";
-import { $LgNkf } from "./engine_license.js";
+import { $tbhNjEbR } from "./engine_license.js";
 import { initNeedleLoader } from "./engine_loaders.js";
 import { initPhysics } from "./engine_physics_rapier.js";
 import { initBuiltinSerializers } from "./engine_serialization_builtin_serializer.js";
@@ -59,7 +59,7 @@ export function initEngine() {
     initPhysics();
     initXR();
     initSpatialConsole();
-    $LgNkf();
+    $tbhNjEbR();
 
     // Must be last. customElements.define() upgrades existing <needle-engine>
     // elements synchronously, which can trigger context.create() and dispatch

package/src/engine/engine_input.ts

@@ -969,7 +969,7 @@ export class Input implements IInput {
         window.removeEventListener('contextmenu', this.onContextMenu);
 
         this._htmlEventSource?.removeEventListener('pointerdown', this.onPointerDown);
-        window.removeEventListener('pointermove', this.onPointerMove);
+        window.removeEventListener('pointermove', this.onPointerMove, true);
         window.removeEventListener('pointerup', this.onPointerUp);
         window.removeEventListener('pointercancel', this.onPointerCancel);
 
@@ -1625,4 +1625,4 @@ export declare type KeyCode =
 // OPEN_BRACKET = 219,
 // BACK_SLASH = 220,
 // CLOSE_BRACKET = 221,
-// SINGLE_QUOTE = 222
+// SINGLE_QUOTE = 222

package/src/engine/engine_instantiate_resolve.ts

@@ -2,7 +2,7 @@ import type { Color, Euler, Matrix2, Matrix3, Matrix4, Object3D, Quaternion, Vec
 
 import { InstantiateIdProvider } from "./engine_networking_instantiate.js";
 import { isSerializable } from "./engine_serialization_core.js";
-import { type GuidsMap, type IComponent, type UIDProvider, isComponent } from "./engine_types.js";
+import { type GuidsMap, type IComponent, isComponent,type UIDProvider } from "./engine_types.js";
 import { getParam } from "./engine_utils.js";
 
 const debug = getParam("debuginstantiate");

package/src/engine/engine_license.ts

@@ -7,21 +7,53 @@ import { SSR } from "./engine_ssr.js";
 import type { IContext } from "./engine_types.js";
 import { DeviceUtilities, getParam } from "./engine_utils.js";
 
+// License UI polling must stop when its context goes away; otherwise timers retain scenes.
+const licenseIntervals = new WeakMap<IContext, Set<ReturnType<typeof setInterval>>>();
+const licenseTimeouts = new WeakMap<IContext, Set<ReturnType<typeof setTimeout>>>();
+const disposedLicenseContexts = new WeakSet<IContext>();
+ContextRegistry.registerCallback(ContextEvent.ContextDestroying, ({ context }) => {
+    disposedLicenseContexts.add(context);
+    for (const timer of licenseIntervals.get(context) ?? []) clearInterval(timer);
+    licenseIntervals.delete(context);
+    for (const timer of licenseTimeouts.get(context) ?? []) clearTimeout(timer);
+    licenseTimeouts.delete(context);
+});
+function setLicenseInterval(ctx: IContext, callback: () => void, delay: number) {
+    if (disposedLicenseContexts.has(ctx)) return undefined;
+    let timers = licenseIntervals.get(ctx);
+    if (!timers) licenseIntervals.set(ctx, timers = new Set());
+    const timer = setInterval(callback, delay);
+    timers.add(timer);
+    return timer;
+}
+
+function setLicenseTimeout(ctx: IContext, callback: () => void, delay: number) {
+    if (disposedLicenseContexts.has(ctx)) return undefined;
+    let timers = licenseTimeouts.get(ctx);
+    if (!timers) licenseTimeouts.set(ctx, timers = new Set());
+    const timer = setTimeout(() => {
+        timers.delete(timer);
+        callback();
+    }, delay);
+    timers.add(timer);
+    return timer;
+}
+
 const debug = getParam("__debuglic__");
 
-const _cEnXH: ((result: boolean) => void)[] = [];
+const hfq: ((result: boolean) => void)[] = [];
 
 // DO NOT EDIT MANUALLY
-let $ZtH: string = "";
+let _QsjWa: string = "";
 // eslint-disable-next-line prefer-const
-let $YjoJUHqQ: string = "";
+let _puYWsjJC: string = "";
 
 if (debug) {
-    console.log("License Type: " + $ZtH);
-    if ($YjoJUHqQ) {
-        console.log("License JWT: " + $YjoJUHqQ);
+    console.log("License Type: " + _QsjWa);
+    if (_puYWsjJC) {
+        console.log("License JWT: " + _puYWsjJC);
         try {
-            const payload = JSON.parse(atob($YjoJUHqQ.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
+            const payload = JSON.parse(atob(_puYWsjJC.split(".")[1].replace(/-/g, '+').replace(/_/g, '/')));
             console.log("License JWT payload:", payload);
         }
         catch { console.log("License JWT payload: (failed to decode)"); }
@@ -32,8 +64,8 @@ if (debug) {
 }
 
 /** @internal */
-export function _$VfAckLjB() {
-    switch ($ZtH) {
+export function _$xBhfh() {
+    switch (_QsjWa) {
         case "pro":
         case "enterprise":
             return true;
@@ -42,8 +74,8 @@ export function _$VfAckLjB() {
 }
 
 /** @internal */
-export function _$EHSDVcNK() {
-    switch ($ZtH) {
+export function __YFTdTh() {
+    switch (_QsjWa) {
         case "indie":
             return true;
     }
@@ -51,8 +83,8 @@ export function _$EHSDVcNK() {
 }
 
 /** @internal */
-export function hTrHNMkg() {
-    switch ($ZtH) {
+export function _$qEBaEKr() {
+    switch (_QsjWa) {
         case "edu":
             return true;
     }
@@ -60,20 +92,26 @@ export function hTrHNMkg() {
 }
 
 /** @internal */
-export function $uxbFepO() {
-    return _$VfAckLjB() || _$EHSDVcNK() || hTrHNMkg();
+export function __alnviAJA() {
+    return _$xBhfh() || __YFTdTh() || _$qEBaEKr();
 }
 
 
 /** @internal */
-export function OLF(cb: (result: boolean) => void) {
-    if (_$VfAckLjB() || _$EHSDVcNK() || hTrHNMkg())
-        return cb(true);
-    _cEnXH.push(cb);
+export function dRcEhn(cb: (result: boolean) => void) {
+    if (_$xBhfh() || __YFTdTh() || _$qEBaEKr()) {
+        cb(true);
+        return () => {};
+    }
+    hfq.push(cb);
+    return () => {
+        const index = hfq.indexOf(cb);
+        if (index >= 0) hfq.splice(index, 1);
+    };
 }
 
-function IAHYYGp(result: boolean) {
-    for (const cb of _cEnXH) {
+function $rpNGR(result: boolean) {
+    for (const cb of hfq) {
         try {
             cb(result);
         }
@@ -88,7 +126,7 @@ function IAHYYGp(result: boolean) {
 
 // ECDSA P-256 public key for verifying license JWTs (verification-only, safe to ship)
 /* eslint-disable no-secrets/no-secrets -- public key, not a secret */
-const __uWGGJiBM = {
+const $jkMSKnw = {
     kty: "EC",
     crv: "P-256",
     x: "A34nyKMjhQYVgzeE4tyLUYdx34TAKogDa7v7PRaO9Lg",
@@ -112,7 +150,7 @@ function base64urlDecode(str: string): Uint8Array {
  * Verify a JWT license token and return the `type` claim if valid.
  * Returns null if the JWT is missing, malformed, or has an invalid signature.
  */
-async function tRvZ(jwt: string): Promise<string | null> {
+async function Twm(jwt: string): Promise<string | null> {
     if (!jwt) return null;
     try {
         const parts = jwt.split(".");
@@ -122,7 +160,7 @@ async function tRvZ(jwt: string): Promise<string | null> {
 
         const key = await crypto.subtle.importKey(
             "jwk",
-            __uWGGJiBM,
+            $jkMSKnw,
             { name: "ECDSA", namedCurve: "P-256" },
             false,
             ["verify"]
@@ -182,24 +220,24 @@ async function tRvZ(jwt: string): Promise<string | null> {
 }
 
 /** Verify the injected JWT and update the license type if valid.
- * The engine ONLY trusts the JWT — the plain $ZtH string is ignored. */
+ * The engine ONLY trusts the JWT — the plain _QsjWa string is ignored. */
 let _jwtVerificationPromise: Promise<void> | undefined = undefined;
-async function _$TVYwursi(): Promise<void> {
-    // NOTE: do NOT add an `if (!$YjoJUHqQ) return` guard here.
+async function _$qGmvPvr(): Promise<void> {
+    // NOTE: do NOT add an `if (!_puYWsjJC) return` guard here.
     // esbuild (Vite dependency pre-bundling) would see the variable as constant ""
     // and tree-shake the entire JWT verification code path.
-    const jwt = $YjoJUHqQ;
+    const jwt = _puYWsjJC;
     // Clear after reading — this reassignment also prevents esbuild from
     // constant-folding the variable (it now has multiple assignment sites).
-    $YjoJUHqQ = "";
-    const verifiedType = await tRvZ(jwt);
+    _puYWsjJC = "";
+    const verifiedType = await Twm(jwt);
     if (verifiedType) {
-        $ZtH = verifiedType;
+        _QsjWa = verifiedType;
         if (debug) console.log("License type set from verified JWT: " + verifiedType);
-        IAHYYGp($uxbFepO());
+        $rpNGR(__alnviAJA());
     }
     else {
-        $ZtH = "basic";
+        _QsjWa = "basic";
         if (debug && jwt) console.warn("JWT verification failed — license reset to basic");
     }
 }
@@ -318,11 +356,11 @@ export namespace Telemetry {
         if (!domElement) domElement = document.querySelector<HTMLElement>("needle-engine");
         if (!domElement && !context) return false;
 
-        // The no-telemetry attribute opts out of all telemetry for every license tier.
+        // The no-telemetry attribute is available to PRO and Enterprise builds.
         // NOTE: this does NOT affect license enforcement — the /check call, the "forbidden"
         // overlay and the watermark/logo run on separate, ungated code paths.
         const attribute = domElement?.getAttribute("no-telemetry");
-        if (attribute === "" || attribute === "true" || attribute === "1") {
+        if (_$xBhfh() && (attribute === "" || attribute === "true" || attribute === "1")) {
             if (debug) console.debug("Telemetry is disabled via no-telemetry attribute");
             return false;
         }
@@ -650,18 +688,18 @@ export namespace Telemetry {
 }
 
 
-export function $LgNkf() {
+export function $tbhNjEbR() {
 
-    if($ZtH === "") $ZtH = "basic";
+    if(_QsjWa === "") _QsjWa = "basic";
 
     // Start JWT verification — must be here (not top-level) to avoid tree-shaking
-    _jwtVerificationPromise = _$TVYwursi();
+    _jwtVerificationPromise = _$qGmvPvr();
 
     Telemetry.init();
     ContextRegistry.registerCallback(ContextEvent.ContextRegistered, evt => {
-        _$xBCv(evt.context);
-        __iMpjhj(evt.context);
-        setTimeout(() => _ZQiK(evt.context), 2000);
+        _$toCs(evt.context);
+        $DAPYU(evt.context);
+        setLicenseTimeout(evt.context, () => _qzMSGyVj(evt.context), 2000);
     });
     // ContextCreated fires after the renderer exists, so the canvas is available for context-loss monitoring
     ContextRegistry.registerCallback(ContextEvent.ContextCreated, evt => {
@@ -670,17 +708,17 @@ export function $LgNkf() {
     });
 }
 
-export let UxRDt: Promise<void> | undefined = undefined;
+export let _$bDVSQf: Promise<void> | undefined = undefined;
 let applicationIsForbidden = false;
 let applicationForbiddenText = "";
-async function _dFNhgjF() {
+async function $TPLZ() {
     // Only perform the runtime license check once
-    if (UxRDt) return UxRDt;
+    if (_$bDVSQf) return _$bDVSQf;
     // Wait for JWT verification to complete first (if running)
     if (_jwtVerificationPromise) {
         await _jwtVerificationPromise;
     }
-    if ($ZtH === "basic") {
+    if (_QsjWa === "basic") {
         try {
             const licenseUrl = "https://needle.tools/api/v1/needle-engine/check?location=" + encodeURIComponent(window.location.href) + "&version=" + VERSION + "&generator=" + encodeURIComponent(GENERATOR);
             const res = await fetch(licenseUrl, {
@@ -692,29 +730,29 @@ async function _dFNhgjF() {
             if (res?.status === 200) {
                 applicationIsForbidden = false;
                 if (debug) console.log("License check succeeded");
-                $ZtH = "pro";
-                IAHYYGp(true);
+                _QsjWa = "pro";
+                $rpNGR(true);
             }
             else if (res?.status === 403) {
-                IAHYYGp(false);
+                $rpNGR(false);
                 applicationIsForbidden = true;
                 applicationForbiddenText = await res.text();
             }
             else {
-                IAHYYGp(false);
+                $rpNGR(false);
                 if (debug) console.log("License check failed with status " + res?.status);
             }
         }
         catch (err) {
-            IAHYYGp(false);
+            $rpNGR(false);
             if (debug) console.error("License check failed", err);
         }
     }
-    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + $ZtH + "\"");
+    else if (debug) console.log("Runtime license check is skipped because license is already applied as \"" + _QsjWa + "\"");
 }
-UxRDt = _dFNhgjF();
+_$bDVSQf = $TPLZ();
 
-async function __iMpjhj(ctx: IContext) {
+async function $DAPYU(ctx: IContext) {
     function createForbiddenElement() {
         const div = document.createElement("div");
         div.className = "needle-forbidden";
@@ -755,7 +793,7 @@ async function __iMpjhj(ctx: IContext) {
         const expectedTextStyle = text.style.cssText;
         const forbiddenText = applicationForbiddenText?.length > 1 ? applicationForbiddenText : "This web application has been paused.<br/>You might be in violation of the Needle Engine terms of use.<br/>Please contact the Needle support if you think this is a mistake.";
         text.innerHTML = forbiddenText;
-        setInterval(() => {
+        setLicenseInterval(ctx, () => {
             if (text.innerHTML !== forbiddenText) text.innerHTML = forbiddenText;
             if (text.parentNode !== div) div.appendChild(text);
             if (div.style.cssText !== expectedStyle) div.style.cssText = expectedStyle;
@@ -765,7 +803,7 @@ async function __iMpjhj(ctx: IContext) {
     }
     let forbiddenElement = createForbiddenElement();
     const expectedCSS = forbiddenElement.style.cssText;
-    setInterval(() => {
+    setLicenseInterval(ctx, () => {
         if (applicationIsForbidden === true) {
             if (forbiddenElement.style.cssText !== expectedCSS) forbiddenElement = createForbiddenElement();
             if (ctx.domElement.shadowRoot) {
@@ -779,40 +817,40 @@ async function __iMpjhj(ctx: IContext) {
     }, 500)
 }
 
-async function _$xBCv(ctx: IContext) {
+async function _$toCs(ctx: IContext) {
     try {
-        if (!_$VfAckLjB() && !_$EHSDVcNK()) {
-            return WksKzhWY(ctx);
+        if (!_$xBhfh() && !__YFTdTh()) {
+            return $BkPUwzsT(ctx);
         }
     }
     catch (err) {
         if (debug) console.log("License check failed", err)
-        return WksKzhWY(ctx)
+        return $BkPUwzsT(ctx)
     }
-    if (debug) WksKzhWY(ctx)
+    if (debug) $BkPUwzsT(ctx)
 }
 
 
 
-async function WksKzhWY(ctx: IContext) {
+async function $BkPUwzsT(ctx: IContext) {
 
     // if the engine loads faster than the license check, we need to capture the ready event here
     let isReady = false;
     ctx.domElement.addEventListener("ready", () => isReady = true);
 
-    await UxRDt?.catch(() => { });
+    await _$bDVSQf?.catch(() => { });
 
 
-    if (_$VfAckLjB() || _$EHSDVcNK()) return;
-    if ($uxbFepO() === false) _yCdKI();
+    if (_$xBhfh() || __YFTdTh()) return;
+    if (__alnviAJA() === false) EyGW();
 
     // check if the engine is already ready (meaning has finished loading)
     if (isReady) {
-        __hUZrkc(ctx);
+        __vrAZI(ctx);
     }
     else {
         ctx.domElement.addEventListener("ready", () => {
-            __hUZrkc(ctx);
+            __vrAZI(ctx);
         });
     }
 }
@@ -820,7 +858,7 @@ async function WksKzhWY(ctx: IContext) {
 // const licenseElementIdentifier = "needle-license-element";
 // const licenseDuration = 10000;
 // const licenseDelay = 1200;
-function __hUZrkc(ctx: IContext) {
+function __vrAZI(ctx: IContext) {
 
     const style = `
         position: relative;
@@ -833,7 +871,7 @@ function __hUZrkc(ctx: IContext) {
         padding: 10px;
         padding-left: 30px;
     `;
-    if ($ZtH === "edu") {
+    if (_QsjWa === "edu") {
         if (navigator.webdriver) {
             console.log("This project is supported by Needle for Education – https://needle.tools");
         }
@@ -871,7 +909,7 @@ function __hUZrkc(ctx: IContext) {
     banner.style.cssText = bannerStyle;
     banner.addEventListener("click", () => { window.open("https://needle.tools", "_blank") });
     let expectedBannerStyle = banner.style.cssText;
-    setTimeout(() => {
+    setLicenseTimeout(ctx, () => {
         bannerStyle = bannerStyle.replace("opacity: 0", "opacity: 1");
         bannerStyle = bannerStyle.replace("transform: translateY(10px)", "transform: translateY(0)");
         banner.style.cssText = bannerStyle;
@@ -879,7 +917,7 @@ function __hUZrkc(ctx: IContext) {
     }, 100);
 
     // ensure the banner is always visible
-    const interval = setInterval(() => {
+    const interval = setLicenseInterval(ctx, () => {
         const parent = ctx.domElement.shadowRoot || ctx.domElement;
         if (banner.parentNode !== parent) {
             parent.appendChild(banner);
@@ -890,16 +928,16 @@ function __hUZrkc(ctx: IContext) {
         }
     }, 1000);
 
-    if (hTrHNMkg()) {
+    if (_$qEBaEKr()) {
         const removeDelay = 20_000;
-        setTimeout(() => {
+        setLicenseTimeout(ctx, () => {
             clearInterval(interval);
             banner?.remove();
             // show the logo every x minutes
             const intervalInMinutes = 5;
-            setTimeout(() => {
+            setLicenseTimeout(ctx, () => {
                 if (ctx.domElement.parentNode)
-                    __hUZrkc(ctx);
+                    __vrAZI(ctx);
             }, 1000 * 60 * intervalInMinutes)
         }, removeDelay);
     }
@@ -910,7 +948,7 @@ function __hUZrkc(ctx: IContext) {
 const base64Logo = "data:image/webp;base64,UklGRrABAABXRUJQVlA4WAoAAAAQAAAAHwAAHwAAQUxQSKEAAAARN6CmbSM4WR7vdARON11EBDq3fLiNbVtVzpMCPlKAEzsx0Y/x+Ovuv4dn0EFE/ydAvz6YggXzgh5sVgXM/zOC/4sii7qgGvB5N7hmuQYwkvazWAu1JPW41FXSHq6pnaQWvqYH18Fc0j1hO/BFTtIeSBlJi5w6qIIO7IOrwhFsB2Yxukif0FTRLpXswHR8MxbslKe9VZsn/Ub5C7YFOpqSTABWUDgg6AAAAFAGAJ0BKiAAIAA+7VyoTqmkpCI3+qgBMB2JbACdMt69DwMIQBLhkTO6XwY00UEDK6cNIDnuNibPf0EgAP7Y1myuiQHLDsF/0h5unrGh6WAbv7aegg2ZMd3uRKfT/3SJztcaujYfTvMXspfCTmYcoO6a+vhC3ss4M8uM58t4siiu59I4aOl59e9Sr6xoxYlHf2v+NnBNpJYeJf8jABQAId/PXuBkLEFkiCucgSGEcfhvajql/j3reCGl0M5/9gQWy7ayNPs+wlvIxFnNfSlfuND4CZOCyxOHhRqOmHN4ULHo3tCSrUNvgAA=";
 
 let lastLogTime = 0;
-async function _yCdKI(_logo?: string) {
+async function EyGW(_logo?: string) {
     const now = Date.now();
     if (now - lastLogTime < 2000) return;
     lastLogTime = now;
@@ -943,7 +981,7 @@ async function _yCdKI(_logo?: string) {
 }
 
 
-async function _ZQiK(context: IContext) {
+async function _qzMSGyVj(context: IContext) {
     // isAllowed() now also covers cross-origin-isolated pages (where beacons can't be sent)
     // and Do Not Track / GPC.
     if (!Telemetry.isAllowed(context)) {
@@ -957,7 +995,7 @@ async function _ZQiK(context: IContext) {
 
             // current url without query parameters
             const currentUrl = window.location.href.split("?")[0];
-            const license = $ZtH;
+            const license = _QsjWa;
 
             const beaconData = {
                 license,

package/src/engine/engine_lifecycle_functions_internal.ts

@@ -148,13 +148,27 @@ function internalInvokeLifecycleFunctions(ctx: Context, evt: Event) {
     }
 }
 
-const bufferArray = new Array<RegisteredLifecycleMethod>();
+const buffers: Array<Array<RegisteredLifecycleMethod>> = [];
+let invocationDepth = 0;
 const hookContext: LifecycleHookContext = {
     context: null as any as Context
 };
 
 function invoke(ctx: Context, methods: Array<RegisteredLifecycleMethod>, invokeOnce: boolean) {
-    bufferArray.length = 0;
+    // Reuse storage per nesting depth: hooks may synchronously invoke other hooks.
+    const bufferArray = buffers[invocationDepth] ?? (buffers[invocationDepth] = []);
+    invocationDepth++;
+    try {
+        invokeWithBuffer(ctx, methods, invokeOnce, bufferArray);
+    }
+    finally {
+        // One-time/unregistered callbacks can capture entire scenes as well.
+        bufferArray.length = 0;
+        invocationDepth--;
+    }
+}
+
+function invokeWithBuffer(ctx: Context, methods: Array<RegisteredLifecycleMethod>, invokeOnce: boolean, bufferArray: Array<RegisteredLifecycleMethod>) {
     for (let i = 0; i < methods.length; i++) {
         bufferArray.push(methods[i]);
     }
@@ -168,6 +182,7 @@ function invoke(ctx: Context, methods: Array<RegisteredLifecycleMethod>, invokeO
         }
 
         if (invoke) {
+            const previousContext = hookContext.context;
             try {
                 hookContext.context = ctx;
                 entry.method?.call(hookContext, ctx);
@@ -175,6 +190,10 @@ function invoke(ctx: Context, methods: Array<RegisteredLifecycleMethod>, invokeO
             catch (e) {
                 console.error("Error in lifecycle method", e);
             }
+            finally {
+                // This shared receiver must not keep the last invoked context alive.
+                hookContext.context = previousContext;
+            }
         }
 
         // Remove the method if it's a one time call

package/src/engine/engine_materialpropertyblock.ts

@@ -1,5 +1,8 @@
 import { BufferGeometry, Camera, Color, Euler,Group, Material, Object3D, Scene, Texture, Vector2, Vector3, Vector4, WebGLRenderer } from "three";
 
+import { isDevEnvironment } from "./debug/index.js";
+import { getParam } from "./engine_utils.js";
+
 
 // @TODO: we need to detect objects with materials both transparent and NOT transparent. These need to be updated in scene.onBeforeRender to have correct renderlists
 
@@ -657,6 +660,13 @@ const onAfterRenderListPush = function (this: Object3D, _object: Object3D, _geom
 }
 
 // #region OnBeforeRender
+/**
+ * Set once the "envMap on MeshBasicMaterial is not supported" warning has been logged, so it only appears once.
+ * @internal
+ */
+let didWarnBasicMaterialEnvMap = false;
+const debugReflectionProbe = getParam("debugreflectionprobe");
+
 /**
  * Main callback invoked before rendering an object.
  * Applies property block overrides and defines to the material.
@@ -726,6 +736,17 @@ const onBeforeRender_MaterialBlock: ObjectRenderCallback = function (this: Objec
     for (const override of overrides) {
         if (override.value === null) continue;
 
+        // Reflection probe overrides on MeshBasicMaterial cause rendering glitches, so none are applied.
+        // No original values are recorded, so onAfterRender leaves these properties untouched.
+        if (mat.isMeshBasicMaterial === true &&
+            (override.name === "envMap" || override.name === "envMapRotation" || override.name === "envMapIntensity")) {
+            if (override.name === "envMap" && !didWarnBasicMaterialEnvMap && (isDevEnvironment() || debugReflectionProbe)) {
+                didWarnBasicMaterialEnvMap = true;
+                console.warn(`MaterialPropertyBlock: Ignoring envMap override on MeshBasicMaterial (object: "${this.name}", material: "${material.name}"). Use a lit material such as MeshStandardMaterial if reflection probes are intended.`);
+            }
+            continue;
+        }
+
         const currentValue = mat[override.name];
 
         const existingOriginal = originalValues.find((o: OriginalValue) => o.name === override.name);

package/src/engine/engine_networking.ts

@@ -7,13 +7,13 @@ import type { Networking } from "../engine-components/Networking.js";
 import type { SyncedRoom } from "../engine-components/SyncedRoom.js";
 import * as schemes from "../engine-schemes/schemes.js";
 import { isDevEnvironment } from './debug/index.js';
+import type { DisposeFn } from "./engine_disposable.js";
 import { Telemetry } from './engine_license.js';
+import { WebsocketTransport } from './engine_networking.transport.websocket.js';
 import { PeerNetworking } from './engine_networking_peer.js';
 import { type IModel, type INetworkConnection, type INetworkTransport, SendQueue } from './engine_networking_types.js';
-import { WebsocketTransport } from './engine_networking.transport.websocket.js';
 import { isHostedOnGlitch } from './engine_networking_utils.js';
 import { Context } from './engine_setup.js';
-import type { DisposeFn } from "./engine_disposable.js";
 import * as utils from "./engine_utils.js";
 
 /** @internal Symbol used to attach the original callback to unsubscribe functions returned by beginListen/beginListenBinary */

package/src/engine/engine_networking_blob.ts

@@ -1,7 +1,7 @@
 import { FileLoader } from "three";
 
 import { showBalloonWarning } from "./debug/index.js";
-import { $uxbFepO } from "./engine_license.js";
+import { __alnviAJA } from "./engine_license.js";
 import { delay } from "./engine_utils.js";
 import { md5AsBytes, md5Hex, sha256Base64 } from "./engine_utils_hash.js";
 
@@ -45,7 +45,7 @@ export namespace BlobStorage {
      */
     export function canUpload(info: { filesize: number }) {
         const sizeInMB = info.filesize / 1024 / 1024;
-        if ($uxbFepO()) {
+        if (__alnviAJA()) {
             return sizeInMB < maxSizeInMB;
         }
         return sizeInMB < maxFreeSizeInMB;
@@ -100,7 +100,7 @@ export namespace BlobStorage {
             console.warn(`Your file is too large for uploading (${filesizeInMB.toFixed(1)}MB). Max allowed size is ${maxSizeInMB}MB`);
             return null;
         }
-        else if (!$uxbFepO() && filesizeInMB > maxFreeSizeInMB) {
+        else if (!__alnviAJA() && filesizeInMB > maxFreeSizeInMB) {
             if (opts?.silent !== true) showBalloonWarning(`File is too large for uploading. Please get a <a href=\"https://needle.tools/pricing\" target=\"_blank\">commercial license</a> to upload files larger than 5MB`);
             console.warn(`Your file is too large for uploading (${filesizeInMB.toFixed(1)}MB). Max size is 5MB for non-commercial users. Please get a commercial license at https://needle.tools/pricing for larger files (up to 50MB)`);
             return null;