mage-engine 3.25.2 → 3.25.3

package/dist/mage.js

@@ -53720,7 +53720,8 @@ const LIGHT_NOT_FOUND = `${PREFIX} This light was not created properly.`;
 const LIGHT_HOLDER_MODEL_NOT_FOUND = `${PREFIX} This light holder model can't be found.`;
 const SOUND_HOLDER_MODEL_NOT_FOUND = `${PREFIX} This sound holder model can't be found.`;
 const LABEL_DOMELEMENT_MISSING = `${PREFIX} Could not create Label, domElement is missing. Did you forget to set the this.element ref on your component?`;
-const NO_VALID_LEVEL_DATA_PROVIDED = `${PREFIX} No valid level data (json or url) provided`;/**! 
+const NO_VALID_LEVEL_DATA_PROVIDED = `${PREFIX} No valid level data (json or url) provided`;
+const THIRD_PERSON_CONTROL_TARGET_MISSING = `${PREFIX} ThirdPersonControl requires a target element. Please provide a valid target.`;/**! 
  * hotkeys-js v3.13.7 
  * A simple micro-library for defining and dispatching keyboard shortcuts. It has no dependencies. 
  * 
@@ -56475,10 +56476,16 @@ let Physics = /*#__PURE__*/function (_EventDispatcher) {
     value: function init() {
       if (Config$1.physics().enabled) {
         this.createWorker();
+
+        // Resolve ammo.js using MAGE_ASSETS_BASE_URL (same as models,
+        // images, and audio) so the path works identically in local
+        // preview and production.
+        const baseUrl = env.MAGE_ASSETS_BASE_URL;
+        const host = baseUrl ? `${getHostURL()}/${baseUrl}` : getHostURL();
         this.worker.postMessage({
           event: PHYSICS_EVENTS.LOAD.AMMO,
           ...Config$1.physics(),
-          host: getHostURL()
+          host
         });
         return new Promise(resolve => {
           const isWorkerReady = () => this.workerReady;
@@ -59038,6 +59045,10 @@ let ThirdPersonControl = /*#__PURE__*/function (_EventDispatcher) {
   return _createClass(ThirdPersonControl, [{
     key: "init",
     value: function init() {
+      if (!this.character) {
+        console.error(THIRD_PERSON_CONTROL_TARGET_MISSING);
+        return;
+      }
       this._onClick = this.onClick.bind(this);
       this._onMouseMove = this.onMouseMove.bind(this);
       this._onKeyDown = this.onKeyDown.bind(this);
@@ -59053,7 +59064,7 @@ let ThirdPersonControl = /*#__PURE__*/function (_EventDispatcher) {
 
       // In non-physics mode, use the character's starting Y as ground level
       // when no explicit value was provided, so it doesn't free-fall on start.
-      if (!this.hasPhysicsEnabled() && this.character) {
+      if (!this.hasPhysicsEnabled()) {
         const startY = this.character.getPosition().y;
         if (this.options.groundLevel === 0.5 && startY > 1) {
           this.options.groundLevel = startY;
@@ -59061,7 +59072,7 @@ let ThirdPersonControl = /*#__PURE__*/function (_EventDispatcher) {
         // Start grounded so the first jump works
         this.canJump = true;
       }
-      if (this.hasPhysicsEnabled() && this.character) {
+      if (this.hasPhysicsEnabled()) {
         this.addCharacterToPhysics();
       }
     }
@@ -59090,7 +59101,7 @@ let ThirdPersonControl = /*#__PURE__*/function (_EventDispatcher) {
   }, {
     key: "getCharacter",
     value: function getCharacter() {
-      return this.character || this.camera;
+      return this.character;
     }
 
     // --- Pointer Lock ---
@@ -59410,7 +59421,7 @@ let ThirdPersonControl = /*#__PURE__*/function (_EventDispatcher) {
   }, {
     key: "physicsUpdate",
     value: function physicsUpdate() {
-      if (this.hasPhysicsEnabled() && this.character) {
+      if (this.hasPhysicsEnabled()) {
         // Re-enable jumping when grounded AND space is released
         const grounded = this.character.getPhysicsState("grounded");
         if (grounded && !this.spaceHeld) {
@@ -59440,9 +59451,7 @@ let ThirdPersonControl = /*#__PURE__*/function (_EventDispatcher) {
       }
 
       // Always position camera relative to character
-      if (this.character) {
-        this.updateCameraPosition();
-      }
+      this.updateCameraPosition();
     }
   }]);
 }(EventDispatcher);let FlyControl = /*#__PURE__*/function (_EventDispatcher) {
@@ -59837,8 +59846,26 @@ let Controls = /*#__PURE__*/function (_EventDispatcher) {
     }
   }, {
     key: "setThirdPersonControls",
-    value: function setThirdPersonControls(options) {
+    value: async function setThirdPersonControls(options) {
       this.disposePreviousControls([CONTROLS.FPS, CONTROLS.FLY, CONTROLS.ORBIT]);
+
+      // Ensure the global physics system is initialised when the control
+      // requests physics.  The builder/preview config may not have enabled
+      // physics explicitly, so we enable it on-demand here.
+      if (options.physicsEnabled && !Config$1.physics().enabled) {
+        Config$1.physics().enabled = true;
+        await Physics$1.init();
+
+        // Entities loaded before physics was enabled had their
+        // enablePhysics() calls silently skipped.  Now that the
+        // worker is ready, add every entity that has pending
+        // physics options to the world.
+        Universe$1.forEach(element => {
+          if (element._physicsEnabled && !Physics$1.hasElement(element)) {
+            Physics$1.add(element, element.getPhysicsOptions());
+          }
+        });
+      }
       this.controls[CONTROLS.TPS] = new ThirdPersonControl(Scene$1.getCamera(), Scene$1.getDOMElement(), options);
       this.controls[CONTROLS.TPS].init();
       return this.controls[CONTROLS.TPS];
@@ -61268,7 +61295,7 @@ function applyMiddleware() {
 
 var thunk = createThunkMiddleware();
 thunk.withExtraArgument = createThunkMiddleware;var name = "mage-engine";
-var version$1 = "3.25.2";
+var version$1 = "3.25.3";
 var description = "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.";
 var main = "dist/mage.js";
 var author$1 = {
@@ -64986,6 +65013,7 @@ let Element$1 = /*#__PURE__*/function (_Entity) {
     key: "enablePhysics",
     value: function enablePhysics(options = {}) {
       this.setPhysicsOptions(options);
+      this._physicsEnabled = true;
       if (Config$1.physics().enabled) {
         Physics$1.add(this, options);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mage-engine",
-    "version": "3.25.2",
+    "version": "3.25.3",
     "description": "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.",
     "main": "dist/mage.js",
     "author": {