mage-engine 3.23.38 → 3.23.39

package/dist/mage.js

@@ -54641,7 +54641,8 @@ let Keyboard = /*#__PURE__*/function (_EventDispatcher) {
     TYPE: "CAMERA",
     SUBTYPES: {
       DEFAULT: "CAMERA.SUBTYPE.DEFAULT",
-      MAIN: "CAMERA.SUBTYPE.MAIN"
+      MAIN: "CAMERA.SUBTYPE.MAIN",
+      GAME: "CAMERA.SUBTYPE.GAME"
     }
   },
   MESH: {
@@ -54736,7 +54737,7 @@ let Keyboard = /*#__PURE__*/function (_EventDispatcher) {
   UNKNOWN: "UNKNOWN"
 };
 const FLAT_ENTITY_TYPES = [ENTITY_TYPES.SCENE.TYPE, ENTITY_TYPES.CAMERA.TYPE, ENTITY_TYPES.MESH.TYPE, ENTITY_TYPES.LABEL.TYPE, ENTITY_TYPES.LIGHT.TYPE, ENTITY_TYPES.AUDIO.TYPE, ENTITY_TYPES.MODEL.TYPE, ENTITY_TYPES.SPRITE.TYPE, ENTITY_TYPES.PARTICLE.TYPE, ENTITY_TYPES.SCENERY.TYPE, ENTITY_TYPES.HELPER.TYPE, ENTITY_TYPES.UNKNOWN];
-const FLAT_ENTITY_SUBTYPES = [ENTITY_TYPES.SCENE.SUBTYPES.DEFAULT, ENTITY_TYPES.CAMERA.SUBTYPES.DEFAULT, ENTITY_TYPES.CAMERA.SUBTYPES.MAIN, ENTITY_TYPES.MESH.SUBTYPES.DEFAULT, ENTITY_TYPES.MESH.SUBTYPES.BOX, ENTITY_TYPES.MESH.SUBTYPES.SPHERE, ENTITY_TYPES.MESH.SUBTYPES.PLANE, ENTITY_TYPES.MESH.SUBTYPES.CYLINDER, ENTITY_TYPES.MESH.SUBTYPES.CONE, ENTITY_TYPES.MESH.SUBTYPES.CUBE, ENTITY_TYPES.MESH.SUBTYPES.LINE, ENTITY_TYPES.MESH.SUBTYPES.CURVE_LINE, ENTITY_TYPES.MESH.SUBTYPES.AXES, ENTITY_TYPES.MESH.SUBTYPES.GRID, ENTITY_TYPES.MESH.SUBTYPES.TARGET, ENTITY_TYPES.LABEL.SUBTYPES.DEFAULT, ENTITY_TYPES.LIGHT.SUBTYPES.DEFAULT, ENTITY_TYPES.LIGHT.SUBTYPES.AMBIENT, ENTITY_TYPES.LIGHT.SUBTYPES.SUN, ENTITY_TYPES.LIGHT.SUBTYPES.HEMISPHERE, ENTITY_TYPES.LIGHT.SUBTYPES.POINT, ENTITY_TYPES.LIGHT.SUBTYPES.SPOT, ENTITY_TYPES.AUDIO.SUBTYPES.DEFAULT, ENTITY_TYPES.AUDIO.SUBTYPES.DIRECTIONAL, ENTITY_TYPES.AUDIO.SUBTYPES.AMBIENT, ENTITY_TYPES.MODEL.SUBTYPES.DEFAULT, ENTITY_TYPES.SPRITE.SUBTYPES.DEFAULT, ENTITY_TYPES.SPRITE.SUBTYPES.ANIMATED_SPRITE, ENTITY_TYPES.PARTICLE.SUBTYPES.DEFAULT, ENTITY_TYPES.PARTICLE.SUBTYPES.EMITTER, ENTITY_TYPES.PARTICLE.SUBTYPES.SYSTEM, ENTITY_TYPES.PARTICLE.SUBTYPES.EMITTER_GROUP, ENTITY_TYPES.PARTICLE.SUBTYPES.PROTON_EMITTER, ENTITY_TYPES.SCENERY.SUBTYPES.DEFAULT, ENTITY_TYPES.SCENERY.SUBTYPES.SKY, ENTITY_TYPES.SCENERY.SUBTYPES.SKYBOX, ENTITY_TYPES.HELPER.SUBTYPES.GRID, ENTITY_TYPES.HELPER.SUBTYPES.AXES, ENTITY_TYPES.HELPER.SUBTYPES.HELPER_SPRITE];
+const FLAT_ENTITY_SUBTYPES = [ENTITY_TYPES.SCENE.SUBTYPES.DEFAULT, ENTITY_TYPES.CAMERA.SUBTYPES.DEFAULT, ENTITY_TYPES.CAMERA.SUBTYPES.MAIN, ENTITY_TYPES.CAMERA.SUBTYPES.GAME, ENTITY_TYPES.MESH.SUBTYPES.DEFAULT, ENTITY_TYPES.MESH.SUBTYPES.BOX, ENTITY_TYPES.MESH.SUBTYPES.SPHERE, ENTITY_TYPES.MESH.SUBTYPES.PLANE, ENTITY_TYPES.MESH.SUBTYPES.CYLINDER, ENTITY_TYPES.MESH.SUBTYPES.CONE, ENTITY_TYPES.MESH.SUBTYPES.CUBE, ENTITY_TYPES.MESH.SUBTYPES.LINE, ENTITY_TYPES.MESH.SUBTYPES.CURVE_LINE, ENTITY_TYPES.MESH.SUBTYPES.AXES, ENTITY_TYPES.MESH.SUBTYPES.GRID, ENTITY_TYPES.MESH.SUBTYPES.TARGET, ENTITY_TYPES.LABEL.SUBTYPES.DEFAULT, ENTITY_TYPES.LIGHT.SUBTYPES.DEFAULT, ENTITY_TYPES.LIGHT.SUBTYPES.AMBIENT, ENTITY_TYPES.LIGHT.SUBTYPES.SUN, ENTITY_TYPES.LIGHT.SUBTYPES.HEMISPHERE, ENTITY_TYPES.LIGHT.SUBTYPES.POINT, ENTITY_TYPES.LIGHT.SUBTYPES.SPOT, ENTITY_TYPES.AUDIO.SUBTYPES.DEFAULT, ENTITY_TYPES.AUDIO.SUBTYPES.DIRECTIONAL, ENTITY_TYPES.AUDIO.SUBTYPES.AMBIENT, ENTITY_TYPES.MODEL.SUBTYPES.DEFAULT, ENTITY_TYPES.SPRITE.SUBTYPES.DEFAULT, ENTITY_TYPES.SPRITE.SUBTYPES.ANIMATED_SPRITE, ENTITY_TYPES.PARTICLE.SUBTYPES.DEFAULT, ENTITY_TYPES.PARTICLE.SUBTYPES.EMITTER, ENTITY_TYPES.PARTICLE.SUBTYPES.SYSTEM, ENTITY_TYPES.PARTICLE.SUBTYPES.EMITTER_GROUP, ENTITY_TYPES.PARTICLE.SUBTYPES.PROTON_EMITTER, ENTITY_TYPES.SCENERY.SUBTYPES.DEFAULT, ENTITY_TYPES.SCENERY.SUBTYPES.SKY, ENTITY_TYPES.SCENERY.SUBTYPES.SKYBOX, ENTITY_TYPES.HELPER.SUBTYPES.GRID, ENTITY_TYPES.HELPER.SUBTYPES.AXES, ENTITY_TYPES.HELPER.SUBTYPES.HELPER_SPRITE];
 const ENTITY_EVENTS = {
   DISPOSE: "DISPOSE",
   STATE_MACHINE: {
@@ -56793,9 +56794,12 @@ var Physics$1 = new Physics();let Scene = /*#__PURE__*/function () {
     key: "getHierarchy",
     value: function getHierarchy() {
       let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      const camera = this.getCamera(); // Only include camera in hierarchy if it's serializable (scene camera is not)
+
+      const cameraChildren = camera && camera.isSerializable() ? [camera.getHierarchy(options)] : [];
       return [{
         element: this.toJSON(options.parseJSON),
-        children: [this.getCamera().getHierarchy(options), ...this.elements.filter(e => !e.hasParent() && !e.isHelper() && e.isSerializable()).map(e => e.getHierarchy(options))]
+        children: [...cameraChildren, ...this.elements.filter(e => !e.hasParent() && !e.isHelper() && e.isSerializable()).map(e => e.getHierarchy(options))]
       }];
     }
   }, {
@@ -58135,7 +58139,7 @@ function applyMiddleware() {
 
 var thunk = createThunkMiddleware();
 thunk.withExtraArgument = createThunkMiddleware;var name = "mage-engine";
-var version$1 = "3.23.38";
+var version$1 = "3.23.39";
 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 = {
@@ -63006,12 +63010,16 @@ let Element$1 = /*#__PURE__*/function (_Entity) {
       fov = Config$1.camera().fov,
       ratio = Config$1.screen().ratio,
       near = Config$1.camera().near,
-      far = Config$1.camera().far
+      far = Config$1.camera().far,
+      serializable = true
     } = options;
     _this = _super.call(this, {
-      name
+      name,
+      serializable
     });
-    _this.options = options;
+
+    _this.extendOptions(options);
+
     const body = new PerspectiveCamera(fov, ratio, near, far);
 
     _this.setBody({
@@ -63058,6 +63066,58 @@ let Element$1 = /*#__PURE__*/function (_Entity) {
       } = position;
       this.body.lookAt(x, y, z);
     }
+  }, {
+    key: "getFov",
+    value: function getFov() {
+      return this.getBody().fov;
+    }
+  }, {
+    key: "setFov",
+    value: function setFov(fov) {
+      const num = Number(fov);
+      const numericFov = Number.isFinite(num) ? num : 75;
+      this.getBody().fov = numericFov;
+      this.getBody().updateProjectionMatrix();
+    }
+  }, {
+    key: "getNear",
+    value: function getNear() {
+      return this.getBody().near;
+    }
+  }, {
+    key: "setNear",
+    value: function setNear(near) {
+      const num = Number(near);
+      const numericNear = Number.isFinite(num) ? num : 0.1;
+      this.getBody().near = numericNear;
+      this.getBody().updateProjectionMatrix();
+    }
+  }, {
+    key: "getFar",
+    value: function getFar() {
+      return this.getBody().far;
+    }
+  }, {
+    key: "setFar",
+    value: function setFar(far) {
+      const num = Number(far);
+      const numericFar = Number.isFinite(num) ? num : 3000000;
+      this.getBody().far = numericFar;
+      this.getBody().updateProjectionMatrix();
+    }
+  }, {
+    key: "toJSON",
+    value: function toJSON() {
+      let parseJSON = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+
+      if (this.isSerializable()) {
+        return { ..._get(_getPrototypeOf(Camera.prototype), "toJSON", this).call(this, parseJSON),
+          fov: this.getFov(),
+          near: this.getNear(),
+          far: this.getFar()
+        };
+      }
+    }
   }]);
 
   return Camera;
@@ -91145,8 +91205,11 @@ let Level = /*#__PURE__*/function (_EventDispatcher) {
     _defineProperty$1(_assertThisInitialized(_this), "cancelNextAnimationFrame", () => cancelAnimationFrame(_this.requestAnimationFrameId));
 
     _defineProperty$1(_assertThisInitialized(_this), "init", () => {
-      Scene$1.create(_this.getName());
-      Scene$1.createCamera(new Camera());
+      Scene$1.create(_this.getName()); // Scene camera is for editor navigation, not serializable
+
+      Scene$1.createCamera(new Camera({
+        serializable: false
+      }));
       Physics$1.init().then(() => {
         Particles$1.init();
         PostProcessing$1.init();
@@ -94131,10 +94194,43 @@ let Sky = /*#__PURE__*/function (_Element) {
         elements = [],
         lights = [],
         audio = [],
-        sounds = []
+        sounds = [],
+        cameras = []
       } = data; // Support both 'audio' and 'sounds' keys for backwards compatibility
 
-      const allSounds = [...audio, ...sounds]; // Use for...of to properly await async completeElementCreation calls
+      const allSounds = [...audio, ...sounds]; // Process cameras - create game camera entity and apply settings to scene camera
+
+      for (const cameraData of cameras) {
+        if (cameraData.entitySubType === ENTITY_TYPES.CAMERA.SUBTYPES.GAME) {
+          // Create a Camera entity that will appear in the hierarchy (for editor)
+          const gameCamera = new Camera({
+            name: cameraData.name || "Game Camera",
+            fov: cameraData.fov || 75,
+            near: cameraData.near || 0.1,
+            far: cameraData.far || 3000000,
+            serializable: true
+          });
+          gameCamera.setEntitySubtype(ENTITY_TYPES.CAMERA.SUBTYPES.GAME); // Set position and rotation
+
+          if (cameraData.position) gameCamera.setPosition(cameraData.position);
+          if (cameraData.rotation) gameCamera.setRotation(cameraData.rotation); // Set uuid and name for persistence
+
+          if (cameraData.uuid) gameCamera.setUuid(cameraData.uuid);
+          if (cameraData.name) gameCamera.setName(cameraData.name); // Add tags for selectability in editor
+
+          if (cameraData.tags) gameCamera.addTags(cameraData.tags); // Add to Scene.elements so it appears in hierarchy
+
+          Scene$1.add(gameCamera.getBody(), gameCamera); // Also apply to the scene's rendering camera (for deployed games)
+
+          const sceneCamera = Scene$1.getCamera();
+          if (cameraData.position) sceneCamera.setPosition(cameraData.position);
+          if (cameraData.rotation) sceneCamera.setRotation(cameraData.rotation);
+          if (cameraData.fov) sceneCamera.setFov(cameraData.fov);
+          if (cameraData.near) sceneCamera.setNear(cameraData.near);
+          if (cameraData.far) sceneCamera.setFar(cameraData.far);
+        }
+      } // Use for...of to properly await async completeElementCreation calls
+
 
       for (const elementData of elements) {
         try {

package/package.json

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