mage-engine 3.22.5 → 3.22.6

package/dist/mage.js

@@ -53962,11 +53962,13 @@ var KEYBOARD_COMBO_ALREADY_REGISTERED = "".concat(PREFIX, " Keyboard combo alrea
 var PHYSICS_ELEMENT_CANT_BE_REMOVED = "".concat(PREFIX, " This element can't be removed from physics world.");
 var PHYSICS_ELEMENT_ALREADY_STORED = "".concat(PREFIX, " This element has already been added to the world.");
 var ASSETS_AUDIO_LOAD_FAIL = "".concat(PREFIX, " Could not load audio.");
+var ASSETS_AUDIO_FILE_LOAD_FAIL = "".concat(PREFIX, " Could not load desired audio file.");
 var ASSETS_MODEL_LOAD_FAIL = "".concat(PREFIX, " Could not load model.");
 var AUDIO_CONTEXT_NOT_AVAILABLE = "".concat(PREFIX, " No Audio Context available, sorry.");
 var AUDIO_UNABLE_TO_LOAD_SOUND = "".concat(PREFIX, " Unable to load sound, sorry.");
+var AUDIO_SOURCE_NOT_DEFINED = "".concat(PREFIX, " No audio source defined. Set a source for this sound.");
 var LIGHT_NOT_FOUND = "".concat(PREFIX, " This light was not created properly.");
-var LIGHT_HOLDER_MODEL_NOT_FOUND = "".concat(PREFIX, " This light holder model can't be found.");
+var LIGHT_HOLDER_MODEL_NOT_FOUND$1 = "".concat(PREFIX, " This light holder model can't be found.");
 var LABEL_DOMELEMENT_MISSING = "".concat(PREFIX, " Could not create Label, domElement is missing. Did you forget to set the this.element ref on your component?");var BaseScript = /*#__PURE__*/function () {
   _createClass(BaseScript, [{
     key: "__check",
@@ -55223,6 +55225,9 @@ var TAGS = {
     HOLDER: "TAGS.LIGHTS.HOLDER",
     HELPER: "TAGS.LIGHTS.HELPER",
     TARGET: "TAGS.LIGHTS.TARGET"
+  },
+  SOUNDS: {
+    HOLDER: "TAGS.SOUNDS.HOLDER"
   }
 };var lib_constants=/*#__PURE__*/Object.freeze({__proto__:null,ALMOST_ZERO:ALMOST_ZERO,UP:UP$1,DOWN:DOWN$1,LEFT:LEFT,RIGHT:RIGHT,FRONT:FRONT,BACK:BACK,VECTOR_UP:VECTOR_UP,VECTOR_DOWN:VECTOR_DOWN,VECTOR_LEFT:VECTOR_LEFT,VECTOR_RIGHT:VECTOR_RIGHT,VECTOR_FRONT:VECTOR_FRONT,VECTOR_BACK:VECTOR_BACK,ORIGIN:ORIGIN,ZERO_QUATERNION:ZERO_QUATERNION,MATERIALS:MATERIALS,TEXTURES:TEXTURES,EFFECTS:EFFECTS,COLLISION_EVENT:COLLISION_EVENT,COLORS:COLORS,ASSETS_TYPES:ASSETS_TYPES,OUTPUT_ENCODINGS:OUTPUT_ENCODINGS,DEFAULT_OUTPUT_ENCODING:DEFAULT_OUTPUT_ENCODING,ROOT:ROOT,DIVIDER:DIVIDER,HASH:HASH,EMPTY:EMPTY$2,QUERY_START:QUERY_START,DEFAULT_SELECTOR:DEFAULT_SELECTOR,BEFORE_UNLOAD:BEFORE_UNLOAD,HASH_CHANGE:HASH_CHANGE,TAGS:TAGS});var buildAssetId = function buildAssetId(name, level) {
   return level ? "".concat(level, "_").concat(name) : name;
@@ -57762,8 +57767,8 @@ function applyMiddleware() {
 }
 
 var thunk = createThunkMiddleware();
-thunk.withExtraArgument = createThunkMiddleware;var name = "mage-engine";
-var version$1 = "3.22.5";
+thunk.withExtraArgument = createThunkMiddleware;var name$1 = "mage-engine";
+var version$1 = "3.22.6";
 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 = {
@@ -57846,7 +57851,7 @@ var devDependencies = {
 	"rollup-plugin-web-worker-loader": "1.6.1"
 };
 var packageJSON = {
-	name: name,
+	name: name$1,
 	version: version$1,
 	description: description,
 	main: main,
@@ -68761,8 +68766,8 @@ var DEFAULT_AUDIO_NODE_VOLUME = 5;
 var DEFAULT_AUDIO_NODE_RAMP_TIME = 100; // value in ms
 
 var AUDIO_RAMPS = {
-  LINEAR: 'LINEAR',
-  EXPONENTIAL: 'EXPONENTIAL'
+  LINEAR: "LINEAR",
+  EXPONENTIAL: "EXPONENTIAL"
 };
 var Audio = /*#__PURE__*/function () {
   function Audio() {
@@ -68775,29 +68780,33 @@ var Audio = /*#__PURE__*/function () {
     });
 
     _defineProperty$1(this, "load", function () {
-      var audio = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var audioAssets = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
       var level = arguments.length > 1 ? arguments[1] : undefined;
-      _this.audio = audio;
+      _this.audioAssets = audioAssets;
 
       _this.createAudioContext();
 
-      if (Object.keys(_this.audio).length === 0) {
+      if (Object.keys(_this.audioAssets).length === 0) {
         return Promise.resolve();
       }
 
-      return Promise.all(Object.keys(_this.audio).map(function (id) {
-        return _this.loadSingleFile(id, level);
+      return Promise.all(Object.keys(_this.audioAssets).map(function (id) {
+        return _this.loadAssetByName(id, level);
       })).catch(function (e) {
-        console.log(ASSETS_AUDIO_LOAD_FAIL);
+        console.error(ASSETS_AUDIO_LOAD_FAIL);
         console.log(e);
         return Promise.resolve();
       });
     });
 
-    _defineProperty$1(this, "loadSingleFile", function (name, level) {
-      var path = _this.audio[name];
-      var request = new XMLHttpRequest();
+    _defineProperty$1(this, "loadAssetByName", function (name, level) {
+      var path = _this.audioAssets[name];
       var id = buildAssetId(name, level);
+      return _this.loadAsset(path, id);
+    });
+
+    _defineProperty$1(this, "loadAsset", function (path, id) {
+      var request = new XMLHttpRequest();
       return new Promise(function (resolve) {
         request.open("GET", path, true);
         request.responseType = "arraybuffer";
@@ -68805,10 +68814,11 @@ var Audio = /*#__PURE__*/function () {
         request.onreadystatechange = function (e) {
           if (request.readyState === 4 && request.status === 200) {
             _this.context.decodeAudioData(request.response, function (buffer) {
-              _this.map[id] = buffer;
+              _this.buffersMap[id] = buffer;
               resolve();
             }, function () {
-              _this.map[id] = null;
+              _this.buffersMap[id] = null;
+              console.error(ASSETS_AUDIO_FILE_LOAD_FAIL);
               resolve();
             });
           }
@@ -68820,15 +68830,16 @@ var Audio = /*#__PURE__*/function () {
 
     this.masterVolumeNode = null;
     this.context = null;
-    this.sounds = [];
-    this.map = {};
+    this.levelSounds = [];
+    this.buffersMap = {};
+    this.audioAssets = {};
     this.currentLevel = ROOT;
   }
 
   _createClass(Audio, [{
     key: "reset",
     value: function reset() {
-      this.sounds = [];
+      this.levelSounds = [];
     }
   }, {
     key: "hasContext",
@@ -68838,7 +68849,7 @@ var Audio = /*#__PURE__*/function () {
   }, {
     key: "hasSounds",
     value: function hasSounds() {
-      return this.sounds.length > 0;
+      return this.levelSounds.length > 0;
     }
   }, {
     key: "createAudioContext",
@@ -68892,12 +68903,12 @@ var Audio = /*#__PURE__*/function () {
   }, {
     key: "get",
     value: function get(id) {
-      return this.map[id] || this.map[buildAssetId(id, this.currentLevel)] || false;
+      return this.buffersMap[id] || this.buffersMap[buildAssetId(id, this.currentLevel)] || false;
     }
   }, {
     key: "add",
     value: function add(sound) {
-      this.sounds.push(sound);
+      this.levelSounds.push(sound);
     }
   }, {
     key: "updateListenerPosition",
@@ -68936,8 +68947,8 @@ var Audio = /*#__PURE__*/function () {
   }, {
     key: "dispose",
     value: function dispose() {
-      for (var index in this.sounds) {
-        var sound = this.sounds[index];
+      for (var index in this.levelSounds) {
+        var sound = this.levelSounds[index];
         sound.dispose();
       }
 
@@ -68955,8 +68966,8 @@ var Audio = /*#__PURE__*/function () {
 
       var start = new Date();
 
-      for (var index in this.sounds) {
-        var sound = this.sounds[index];
+      for (var index in this.levelSounds) {
+        var sound = this.levelSounds[index];
         sound.update(dt);
         if (+new Date() - start > TIME_FOR_UPDATE) break;
       }
@@ -82981,7 +82992,7 @@ var MeshLoader$1 = new MeshLoader();var Light = /*#__PURE__*/function (_Entity)
         _this.holder = holderSprite;
         return true;
       } else {
-        console.warn(LIGHT_HOLDER_MODEL_NOT_FOUND);
+        console.warn(LIGHT_HOLDER_MODEL_NOT_FOUND$1);
         return false;
       }
     });
@@ -83072,7 +83083,7 @@ var MeshLoader$1 = new MeshLoader();var Light = /*#__PURE__*/function (_Entity)
         this.body.position.set(x, y, z);
       }
 
-      if (this.hasHolder() & updateHolder) {
+      if (this.hasHolder() && updateHolder) {
         this.holder.setPosition({
           x: x,
           y: y,
@@ -91040,7 +91051,11 @@ var Cone = /*#__PURE__*/function (_Element) {
   }
 
   return Cone;
-}(Element$1);var Sound = /*#__PURE__*/function (_Entity) {
+}(Element$1);var DEFAULT_SETUP_CONFIG$1 = {
+  deferred: false
+};
+
+var Sound$1 = /*#__PURE__*/function (_Entity) {
   _inherits(Sound, _Entity);
 
   var _super = _createSuper(Sound);
@@ -91059,8 +91074,10 @@ var Cone = /*#__PURE__*/function (_Element) {
         loopEnd = options.loopEnd,
         autoplay = options.autoplay,
         reconnectOnReset = options.reconnectOnReset,
+        _options$setupConfig = options.setupConfig,
+        setupConfig = _options$setupConfig === void 0 ? DEFAULT_SETUP_CONFIG$1 : _options$setupConfig,
         _options$name = options.name,
-        name = _options$name === void 0 ? generateRandomName('sound') : _options$name;
+        name = _options$name === void 0 ? generateRandomName("sound") : _options$name;
     _this = _super.call(this, _objectSpread2$1(_objectSpread2$1({}, options), {}, {
       source: source,
       loop: loop,
@@ -91081,6 +91098,7 @@ var Cone = /*#__PURE__*/function (_Element) {
       _this.connect();
     });
 
+    _this.setupConfig = setupConfig;
     _this.source = source;
     _this.loop = loop;
     _this.loopStart = loopStart;
@@ -91090,12 +91108,15 @@ var Cone = /*#__PURE__*/function (_Element) {
     _this.name = name;
     _this.connected = false;
     _this.playing = false;
+    _this.setupCompleted = false;
     _this.hasPlayed = false;
     _this.buffer = null;
     _this.audioNode = null;
     _this.volumeNode = null;
 
-    _this.setupAudio();
+    if (!_this.setupConfig.deferred) {
+      _this.setupAudio();
+    }
 
     _this.setName(name);
 
@@ -91106,10 +91127,58 @@ var Cone = /*#__PURE__*/function (_Element) {
     _this.setEntityType(ENTITY_TYPES.AUDIO.DEFAULT);
 
     Audio$1.add(_assertThisInitialized(_this));
+
+    if (_this.isSetupCompleted()) {
+      _this.connect();
+    }
+
     return _this;
   }
 
   _createClass(Sound, [{
+    key: "addHelpers",
+    value: function addHelpers() {
+      var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+          _ref$holderName = _ref.holderName,
+          holderName = _ref$holderName === void 0 ? "soundholder" : _ref$holderName,
+          _ref$holderSize = _ref.holderSize,
+          holderSize = _ref$holderSize === void 0 ? 0.05 : _ref$holderSize;
+
+      var holderSprite = new HelperSprite(holderSize, holderSize, holderName, {
+        name: holderName
+      });
+
+      if (holderSprite) {
+        holderSprite.setSizeAttenuation(false);
+        holderSprite.setDepthTest(false);
+        holderSprite.setDepthWrite(false);
+        holderSprite.setSerializable(false);
+        holderSprite.setPosition(this.getPosition());
+        holderSprite.addTags([TAGS.LIGHTS.HELPER, TAGS.LIGHTS.HOLDER, name]);
+        holderSprite.setHelperTarget(this);
+        this.holder = holderSprite;
+        return true;
+      } else {
+        console.warn(LIGHT_HOLDER_MODEL_NOT_FOUND);
+        return false;
+      }
+    }
+  }, {
+    key: "isPlaying",
+    value: function isPlaying() {
+      return this.playing;
+    }
+  }, {
+    key: "isSetupCompleted",
+    value: function isSetupCompleted() {
+      return this.setupCompleted;
+    }
+  }, {
+    key: "isConnected",
+    value: function isConnected() {
+      return this.connected;
+    }
+  }, {
     key: "setupAudio",
     value: function setupAudio() {
       this.createAudioNode();
@@ -91118,6 +91187,17 @@ var Cone = /*#__PURE__*/function (_Element) {
       this.setupAudioNodeLoop();
       this.audioNode.removeEventListener(ENTITY_EVENTS.AUDIO.ENDED, this.onSoundEnded.bind(this));
       this.audioNode.addEventListener(ENTITY_EVENTS.AUDIO.ENDED, this.onSoundEnded.bind(this));
+      this.setupCompleted = true;
+    }
+  }, {
+    key: "setSource",
+    value: function setSource(source) {
+      this.source = source;
+    }
+  }, {
+    key: "getSource",
+    value: function getSource() {
+      return this.source;
     }
   }, {
     key: "createAudioNode",
@@ -91140,14 +91220,14 @@ var Cone = /*#__PURE__*/function (_Element) {
   }, {
     key: "tryAutoplay",
     value: function tryAutoplay() {
-      if (this.autoplay && !this.hasPlayed) {
+      if (this.autoplay && !this.hasPlayed && !this.setupConfig.deferred) {
         this.play();
       }
     }
   }, {
     key: "connect",
     value: function connect() {
-      if (this.connected) {
+      if (this.isConnected()) {
         this.disconnect();
       }
 
@@ -91159,7 +91239,7 @@ var Cone = /*#__PURE__*/function (_Element) {
   }, {
     key: "disconnect",
     value: function disconnect() {
-      if (this.connected) {
+      if (this.isConnected()) {
         this.volumeNode.disconnect();
         this.audioNode.disconnect();
         this.connected = false;
@@ -91176,7 +91256,7 @@ var Cone = /*#__PURE__*/function (_Element) {
   }, {
     key: "getVolume",
     value: function getVolume() {
-      return this.volumeNode.gain.value;
+      return this.volumeNode ? this.volumeNode.gain.value : Audio$1.getVolume();
     }
   }, {
     key: "setVolume",
@@ -91192,15 +91272,21 @@ var Cone = /*#__PURE__*/function (_Element) {
   }, {
     key: "setBuffer",
     value: function setBuffer() {
+      if (!this.getSource()) {
+        console.error(AUDIO_SOURCE_NOT_DEFINED);
+        return false;
+      }
+
       var buffer = Audio$1.get(this.source);
 
       if (!buffer) {
         console.error(AUDIO_UNABLE_TO_LOAD_SOUND);
-        return;
+        return false;
       }
 
       this.buffer = buffer;
       this.audioNode.buffer = buffer;
+      return true;
     }
   }, {
     key: "play",
@@ -91208,7 +91294,10 @@ var Cone = /*#__PURE__*/function (_Element) {
       var volume = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.getVolume();
       var delay = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DEFAULT_AUDIO_NODE_RAMP_TIME;
       var ramp = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : AUDIO_RAMPS.LINEAR;
-      if (this.playing) return Promise.resolve();
+      if (this.isPlaying()) return this;
+      if (!this.isSetupCompleted()) this.setupAudio();
+      if (!this.isConnected()) this.connect();
+      console.log("goin to start playing at volume", volume, this.source);
       this.setVolume(0);
       this.audioNode.start();
       this.hasPlayed = true;
@@ -91251,9 +91340,15 @@ var Cone = /*#__PURE__*/function (_Element) {
     key: "detune",
     value: function detune(value) {
       if (this.audioNode) {
-        this.audioNode.detune.value = value;
+        this.detune = value;
+        this.audioNode.detune.value = this.detune;
       }
     }
+  }, {
+    key: "getDetune",
+    value: function getDetune() {
+      return this.detune;
+    }
   }, {
     key: "addEffect",
     value: function addEffect(effect) {
@@ -91282,6 +91377,50 @@ var Cone = /*#__PURE__*/function (_Element) {
         this.plainGainNode.gain.setValueAtTime(0.3, Audio$1.context.currentTime);
       }
     }
+  }, {
+    key: "setPosition",
+    value: function setPosition(where) {
+      var _ref2 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+          _ref2$updateHolder = _ref2.updateHolder,
+          updateHolder = _ref2$updateHolder === void 0 ? true : _ref2$updateHolder;
+
+      var position = _objectSpread2$1(_objectSpread2$1({}, this.getPosition()), where);
+
+      var x = position.x,
+          y = position.y,
+          z = position.z;
+
+      if (this.hasBody()) {
+        this.body.position.set(x, y, z);
+      }
+
+      if (this.hasHolder() && updateHolder) {
+        this.holder.setPosition({
+          x: x,
+          y: y,
+          z: z
+        });
+      }
+    }
+  }, {
+    key: "toJSON",
+    value: function toJSON() {
+      return _objectSpread2$1(_objectSpread2$1({}, _get(_getPrototypeOf(Sound.prototype), "toJSON", this).call(this)), {}, {
+        source: this.source,
+        loop: this.loop,
+        loopStart: this.loopStart,
+        loopEnd: this.loopEnd,
+        autoplay: this.autoplay,
+        volume: this.getVolume(),
+        detune: this.getDetune(),
+        hasPlayed: this.hasPlayed,
+        playing: this.isPlaying(),
+        connected: this.isConnected(),
+        duration: this.duration,
+        sampleRate: this.sampleRate,
+        numberOfChannels: this.numberOfChannels
+      });
+    }
   }, {
     key: "sampleRate",
     get: function get() {
@@ -91312,7 +91451,7 @@ var AmbientSound = /*#__PURE__*/function (_Sound) {
 
     var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
         _ref$name = _ref.name,
-        name = _ref$name === void 0 ? generateRandomName('AmbientSound') : _ref$name,
+        name = _ref$name === void 0 ? generateRandomName("AmbientSound") : _ref$name,
         options = _objectWithoutProperties(_ref, _excluded$2);
 
     _classCallCheck(this, AmbientSound);
@@ -91324,13 +91463,11 @@ var AmbientSound = /*#__PURE__*/function (_Sound) {
 
     _this.setEntityType(ENTITY_TYPES.AUDIO.AMBIENT);
 
-    _this.connect();
-
     return _this;
   }
 
   return AmbientSound;
-}(Sound);var _excluded$1 = ["name"];
+}(Sound$1);var _excluded$1 = ["name"];
 
 var DirectionalSound = /*#__PURE__*/function (_Sound) {
   _inherits(DirectionalSound, _Sound);
@@ -91342,7 +91479,7 @@ var DirectionalSound = /*#__PURE__*/function (_Sound) {
 
     var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
         _ref$name = _ref.name,
-        name = _ref$name === void 0 ? generateRandomName('DirectionalSound') : _ref$name,
+        name = _ref$name === void 0 ? generateRandomName("DirectionalSound") : _ref$name,
         options = _objectWithoutProperties(_ref, _excluded$1);
 
     _classCallCheck(this, DirectionalSound);
@@ -91354,14 +91491,17 @@ var DirectionalSound = /*#__PURE__*/function (_Sound) {
 
     _this.setEntityType(ENTITY_TYPES.AUDIO.DIRECTIONAL);
 
-    _this.createPannerNode(options);
-
-    _this.connect();
-
     return _this;
   }
 
   _createClass(DirectionalSound, [{
+    key: "setupAudio",
+    value: function setupAudio() {
+      _get(_getPrototypeOf(DirectionalSound.prototype), "setupAudio", this).call(this);
+
+      this.createPannerNode(this.options);
+    }
+  }, {
     key: "hasPannerNode",
     value: function hasPannerNode() {
       return !!this.pannerNode;
@@ -91383,8 +91523,8 @@ var DirectionalSound = /*#__PURE__*/function (_Sound) {
           _options$refDistance = options.refDistance,
           refDistance = _options$refDistance === void 0 ? 1 : _options$refDistance;
       this.pannerNode = Audio$1.context.createPanner();
-      this.pannerNode.panningModel = 'HRTF';
-      this.pannerNode.distanceModel = 'inverse';
+      this.pannerNode.panningModel = "HRTF";
+      this.pannerNode.distanceModel = "inverse";
       this.pannerNode.refDistance = refDistance;
       this.pannerNode.maxDistance = maxDistance;
       this.pannerNode.rolloffFactor = rolloffFactor;
@@ -91456,7 +91596,395 @@ var DirectionalSound = /*#__PURE__*/function (_Sound) {
   }]);
 
   return DirectionalSound;
-}(Sound);var BLOB_TYPE = 'application/javascript';
+}(Sound$1);var DEFAULT_SETUP_CONFIG = {
+  deferred: false
+};
+
+var Sound = /*#__PURE__*/function (_Entity) {
+  _inherits(Sound, _Entity);
+
+  var _super = _createSuper(Sound);
+
+  function Sound() {
+    var _this;
+
+    var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+
+    _classCallCheck(this, Sound);
+
+    var source = options.source,
+        _options$loop = options.loop,
+        loop = _options$loop === void 0 ? false : _options$loop,
+        loopStart = options.loopStart,
+        loopEnd = options.loopEnd,
+        autoplay = options.autoplay,
+        reconnectOnReset = options.reconnectOnReset,
+        _options$setupConfig = options.setupConfig,
+        setupConfig = _options$setupConfig === void 0 ? DEFAULT_SETUP_CONFIG : _options$setupConfig,
+        _options$name = options.name,
+        name = _options$name === void 0 ? generateRandomName("sound") : _options$name;
+    _this = _super.call(this, _objectSpread2$1(_objectSpread2$1({}, options), {}, {
+      source: source,
+      loop: loop,
+      loopStart: loopStart,
+      loopEnd: loopEnd,
+      autoplay: autoplay,
+      reconnectOnReset: reconnectOnReset,
+      name: name
+    }));
+
+    _defineProperty$1(_assertThisInitialized(_this), "reset", function () {
+      _this.playing = false;
+
+      _this.disconnect();
+
+      _this.setupAudio();
+
+      _this.connect();
+    });
+
+    _this.setupConfig = setupConfig;
+    _this.source = source;
+    _this.loop = loop;
+    _this.loopStart = loopStart;
+    _this.loopEnd = loopEnd;
+    _this.autoplay = autoplay;
+    _this.reconnectOnReset = reconnectOnReset;
+    _this.name = name;
+    _this.connected = false;
+    _this.playing = false;
+    _this.setupCompleted = false;
+    _this.hasPlayed = false;
+    _this.buffer = null;
+    _this.audioNode = null;
+    _this.volumeNode = null;
+
+    if (!_this.setupConfig.deferred) {
+      _this.setupAudio();
+    }
+
+    _this.setName(name);
+
+    _this.setBody({
+      body: new Object3D()
+    });
+
+    _this.setEntityType(ENTITY_TYPES.AUDIO.DEFAULT);
+
+    Audio$1.add(_assertThisInitialized(_this));
+
+    if (_this.isSetupCompleted()) {
+      _this.connect();
+    }
+
+    return _this;
+  }
+
+  _createClass(Sound, [{
+    key: "addHelpers",
+    value: function addHelpers() {
+      var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+          _ref$holderName = _ref.holderName,
+          holderName = _ref$holderName === void 0 ? "soundholder" : _ref$holderName,
+          _ref$holderSize = _ref.holderSize,
+          holderSize = _ref$holderSize === void 0 ? 0.05 : _ref$holderSize;
+
+      var holderSprite = new HelperSprite(holderSize, holderSize, holderName, {
+        name: holderName
+      });
+
+      if (holderSprite) {
+        holderSprite.setSizeAttenuation(false);
+        holderSprite.setDepthTest(false);
+        holderSprite.setDepthWrite(false);
+        holderSprite.setSerializable(false);
+        holderSprite.setPosition(this.getPosition());
+        holderSprite.addTags([TAGS.LIGHTS.HELPER, TAGS.LIGHTS.HOLDER, name]);
+        holderSprite.setHelperTarget(this);
+        this.holder = holderSprite;
+        return true;
+      } else {
+        console.warn(LIGHT_HOLDER_MODEL_NOT_FOUND);
+        return false;
+      }
+    }
+  }, {
+    key: "isPlaying",
+    value: function isPlaying() {
+      return this.playing;
+    }
+  }, {
+    key: "isSetupCompleted",
+    value: function isSetupCompleted() {
+      return this.setupCompleted;
+    }
+  }, {
+    key: "isConnected",
+    value: function isConnected() {
+      return this.connected;
+    }
+  }, {
+    key: "setupAudio",
+    value: function setupAudio() {
+      this.createAudioNode();
+      this.createVolumeNode();
+      this.setBuffer();
+      this.setupAudioNodeLoop();
+      this.audioNode.removeEventListener(ENTITY_EVENTS.AUDIO.ENDED, this.onSoundEnded.bind(this));
+      this.audioNode.addEventListener(ENTITY_EVENTS.AUDIO.ENDED, this.onSoundEnded.bind(this));
+      this.setupCompleted = true;
+    }
+  }, {
+    key: "setSource",
+    value: function setSource(source) {
+      this.source = source;
+    }
+  }, {
+    key: "getSource",
+    value: function getSource() {
+      return this.source;
+    }
+  }, {
+    key: "createAudioNode",
+    value: function createAudioNode() {
+      this.audioNode = Audio$1.context.createBufferSource();
+    }
+  }, {
+    key: "setupAudioNodeLoop",
+    value: function setupAudioNodeLoop() {
+      this.audioNode.loop = this.loop;
+      this.audioNode.loopEnd = this.loopEnd === undefined ? this.duration : this.loopEnd;
+      this.audioNode.loopStart = this.loopStart === undefined ? this.duration : this.loopStart;
+    }
+  }, {
+    key: "createVolumeNode",
+    value: function createVolumeNode() {
+      this.volumeNode = Audio$1.context.createGain();
+      this.volumeNode.gain.value = DEFAULT_AUDIO_NODE_VOLUME;
+    }
+  }, {
+    key: "tryAutoplay",
+    value: function tryAutoplay() {
+      if (this.autoplay && !this.hasPlayed && !this.setupConfig.deferred) {
+        this.play();
+      }
+    }
+  }, {
+    key: "connect",
+    value: function connect() {
+      if (this.isConnected()) {
+        this.disconnect();
+      }
+
+      this.volumeNode.connect(Audio$1.getMasterVolumeNode());
+      this.audioNode.connect(this.volumeNode);
+      this.connected = true;
+      this.tryAutoplay();
+    }
+  }, {
+    key: "disconnect",
+    value: function disconnect() {
+      if (this.isConnected()) {
+        this.volumeNode.disconnect();
+        this.audioNode.disconnect();
+        this.connected = false;
+      }
+    }
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      _get(_getPrototypeOf(Sound.prototype), "dispose", this).call(this);
+
+      this.stop();
+      this.disconnect();
+    }
+  }, {
+    key: "getVolume",
+    value: function getVolume() {
+      return this.volumeNode ? this.volumeNode.gain.value : Audio$1.getVolume();
+    }
+  }, {
+    key: "setVolume",
+    value: function setVolume() {
+      var value = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : DEFAULT_AUDIO_NODE_VOLUME;
+      this.volumeNode.gain.setValueAtTime(value, Audio$1.context.currentTime);
+    }
+  }, {
+    key: "hasBuffer",
+    value: function hasBuffer() {
+      return !!this.buffer;
+    }
+  }, {
+    key: "setBuffer",
+    value: function setBuffer() {
+      if (!this.getSource()) {
+        console.error(AUDIO_SOURCE_NOT_DEFINED);
+        return false;
+      }
+
+      var buffer = Audio$1.get(this.source);
+
+      if (!buffer) {
+        console.error(AUDIO_UNABLE_TO_LOAD_SOUND);
+        return false;
+      }
+
+      this.buffer = buffer;
+      this.audioNode.buffer = buffer;
+      return true;
+    }
+  }, {
+    key: "play",
+    value: function play() {
+      var volume = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.getVolume();
+      var delay = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : DEFAULT_AUDIO_NODE_RAMP_TIME;
+      var ramp = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : AUDIO_RAMPS.LINEAR;
+      if (this.isPlaying()) return this;
+      if (!this.isSetupCompleted()) this.setupAudio();
+      if (!this.isConnected()) this.connect();
+      console.log("goin to start playing at volume", volume, this.source);
+      this.setVolume(0);
+      this.audioNode.start();
+      this.hasPlayed = true;
+      this.playing = true;
+      var audioDelay = delay / 1000; // linearRampToValueAtTime/exponentialRampToValueAtTime requires time to be expressed in seconds
+
+      if (ramp === AUDIO_RAMPS.LINEAR) {
+        this.volumeNode.gain.linearRampToValueAtTime(volume, Audio$1.context.currentTime + audioDelay);
+      } else {
+        this.volumeNode.gain.exponentialRampToValueAtTime(volume, Audio$1.context.currentTime + audioDelay);
+      }
+
+      return this;
+    }
+  }, {
+    key: "onSoundEnded",
+    value: function onSoundEnded() {
+      this.reset();
+      this.dispatchEvent({
+        type: ENTITY_EVENTS.AUDIO.ENDED
+      });
+    }
+  }, {
+    key: "stop",
+    value: function stop() {
+      var delay = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : DEFAULT_AUDIO_NODE_RAMP_TIME;
+      var ramp = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : AUDIO_RAMPS.LINEAR;
+      var audioDelay = delay / 1000; // linearRampToValueAtTime/exponentialRampToValueAtTime requires time to be expressed in seconds
+
+      if (ramp === AUDIO_RAMPS.LINEAR) {
+        this.volumeNode.gain.linearRampToValueAtTime(ALMOST_ZERO, Audio$1.context.currentTime + audioDelay);
+      } else {
+        this.volumeNode.gain.exponentialRampToValueAtTime(ALMOST_ZERO, Audio$1.context.currentTime + audioDelay);
+      }
+
+      setTimeout(this.reset, delay);
+      return this;
+    }
+  }, {
+    key: "detune",
+    value: function detune(value) {
+      if (this.audioNode) {
+        this.detune = value;
+        this.audioNode.detune.value = this.detune;
+      }
+    }
+  }, {
+    key: "getDetune",
+    value: function getDetune() {
+      return this.detune;
+    }
+  }, {
+    key: "addEffect",
+    value: function addEffect(effect) {
+      if (!this.hasEffect() && effect) {
+        this.convolverNode = Audio$1.context.createConvolver();
+        this.mixerNode = Audio$1.createGain();
+
+        if (this.hasPannerNode()) {
+          this.pannerNode.disconnect();
+          this.pannerNode.connect(this.mixerNode);
+        } else {
+          this.volumeNode.disconnect();
+          this.volumeNode.connect(this.mixerNode);
+        } //creating gains
+
+
+        this.plainGainNode = Audio$1.context.createGain();
+        this.convolverGainNode = Audio$1.context.createGain(); //connect mixer to new gains
+
+        this.mixerNode.connect(this.plainGainNode);
+        this.mixerNode.connect(this.convolverGainNode);
+        this.plainGainNode.connect(Audio$1.getMasterVolumeNode());
+        this.convolverGainNode.connect(Audio$1.getMasterVolumeNode());
+        this.convolverNode.buffer = Audio$1.get(effect);
+        this.convolverGainNode.gain.setValueAtTime(0.7, Audio$1.context.currentTime);
+        this.plainGainNode.gain.setValueAtTime(0.3, Audio$1.context.currentTime);
+      }
+    }
+  }, {
+    key: "setPosition",
+    value: function setPosition(where) {
+      var _ref2 = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+          _ref2$updateHolder = _ref2.updateHolder,
+          updateHolder = _ref2$updateHolder === void 0 ? true : _ref2$updateHolder;
+
+      var position = _objectSpread2$1(_objectSpread2$1({}, this.getPosition()), where);
+
+      var x = position.x,
+          y = position.y,
+          z = position.z;
+
+      if (this.hasBody()) {
+        this.body.position.set(x, y, z);
+      }
+
+      if (this.hasHolder() && updateHolder) {
+        this.holder.setPosition({
+          x: x,
+          y: y,
+          z: z
+        });
+      }
+    }
+  }, {
+    key: "toJSON",
+    value: function toJSON() {
+      return _objectSpread2$1(_objectSpread2$1({}, _get(_getPrototypeOf(Sound.prototype), "toJSON", this).call(this)), {}, {
+        source: this.source,
+        loop: this.loop,
+        loopStart: this.loopStart,
+        loopEnd: this.loopEnd,
+        autoplay: this.autoplay,
+        volume: this.getVolume(),
+        detune: this.getDetune(),
+        hasPlayed: this.hasPlayed,
+        playing: this.isPlaying(),
+        connected: this.isConnected(),
+        duration: this.duration,
+        sampleRate: this.sampleRate,
+        numberOfChannels: this.numberOfChannels
+      });
+    }
+  }, {
+    key: "sampleRate",
+    get: function get() {
+      return this.buffer.sampleRate;
+    }
+  }, {
+    key: "duration",
+    get: function get() {
+      return this.buffer.duration * 1000;
+    }
+  }, {
+    key: "numberOfChannels",
+    get: function get() {
+      return this.buffer.numberOfChannels;
+    }
+  }]);
+
+  return Sound;
+}(Entity);var BLOB_TYPE = 'application/javascript';
 var createBlob = function createBlob(task) {
   return new Blob(['(', task.toString(), ')()'], {
     type: BLOB_TYPE

package/package.json

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