mage-engine 3.23.17 → 3.23.23

package/dist/mage.js

@@ -53992,6 +53992,7 @@ var DEPRECATIONS = {
 };
 var IMPORTER_ERROR_ELEMENT_CREATION = "".concat(PREFIX, " Error while creating element: ");
 var IMPORTER_ERROR_LIGHT_CREATION = "".concat(PREFIX, " Error while creating light: ");
+var IMPORTER_ERROR_SOUND_CREATION = "".concat(PREFIX, " Error while creating sound: ");
 var IMPORTER_ERROR_UNKNOWN_ELEMENT_SUBTYPE = "".concat(PREFIX, " Unknown element subtype: ");
 var ONCREATE_NOT_AVAILABLE = "".concat(PREFIX, " Your scene needs a onCreate method.");
 var PATH_NOT_FOUND = "".concat(PREFIX, " can't find requested path");
@@ -56323,7 +56324,7 @@ var convertAmmoVector = function convertAmmoVector(_ref2) {
   };
 };var utils=/*#__PURE__*/Object.freeze({__proto__:null,DEFAULT_DESCRIPTION:DEFAULT_DESCRIPTION$1,mapColliderTypeToAddEvent:mapColliderTypeToAddEvent$1,extractBoundingBox:extractBoundingBox,extractBiggestBoundingBox:extractBiggestBoundingBox,extractBoundingSphere:extractBoundingSphere,extractBiggestBoundingSphere:extractBiggestBoundingSphere,parseBoundingBoxSize:parseBoundingBoxSize,extractPositionAndQuaternion:extractPositionAndQuaternion$1,extractBoxDescription:extractBoxDescription,extractSphereDescription:extractSphereDescription,getBoxDescriptionForElement:getBoxDescriptionForElement$1,getSphereDescriptionForElement:getSphereDescriptionForElement,mapColliderTypeToDescription:mapColliderTypeToDescription$1,iterateGeometries:iterateGeometries$1,convertAmmoVector:convertAmmoVector});var getHostURL = function getHostURL() {
   return "".concat(document.location.protocol, "//").concat(document.location.host);
-};var _excluded$a = ["uuid"];
+};var _excluded$c = ["uuid"];
 var COLLIDER_TYPES = COLLIDER_TYPES$1;
 var getBoxDescriptionForElement = getBoxDescriptionForElement$1,
     extractPositionAndQuaternion = extractPositionAndQuaternion$1,
@@ -56397,7 +56398,7 @@ var Physics = /*#__PURE__*/function (_EventDispatcher) {
 
     _defineProperty$1(_assertThisInitialized(_this), "handleBodyUpdate", function (_ref3) {
       var uuid = _ref3.uuid,
-          data = _objectWithoutProperties(_ref3, _excluded$a);
+          data = _objectWithoutProperties(_ref3, _excluded$c);
 
       var element = Universe$1.getByUUID(uuid);
 
@@ -56835,6 +56836,7 @@ var Physics$1 = new Physics();var Scene = /*#__PURE__*/function () {
       var fog = Config$1.fog();
       this.scene = new Scene$2();
       this.scene.name = name;
+      this.elements = [];
 
       if (fog.enabled) {
         this.fog(fog.color, fog.density);
@@ -56968,7 +56970,9 @@ var Physics$1 = new Physics();var Scene = /*#__PURE__*/function () {
       // destroy renderer
       this.renderer.dispose(); // remove listener to resize
 
-      this.detachListeners();
+      this.detachListeners(); // clear elements array
+
+      this.elements = [];
     }
   }, {
     key: "createCamera",
@@ -58254,7 +58258,7 @@ function applyMiddleware() {
 
 var thunk = createThunkMiddleware();
 thunk.withExtraArgument = createThunkMiddleware;var name$1 = "mage-engine";
-var version$1 = "3.23.17";
+var version$1 = "3.23.23";
 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 = {
@@ -59530,7 +59534,7 @@ if (!self.fetch) {
   self.Headers = Headers;
   self.Request = Request;
   self.Response = Response;
-}var _excluded$9 = ["wheels", "accelerationKey", "brakingKey", "rightKey", "leftKey", "debug", "autostart"];
+}var _excluded$b = ["wheels", "accelerationKey", "brakingKey", "rightKey", "leftKey", "debug", "autostart"];
 
 var BaseCar = /*#__PURE__*/function (_BaseScript) {
   _inherits(BaseCar, _BaseScript);
@@ -59558,7 +59562,7 @@ var BaseCar = /*#__PURE__*/function (_BaseScript) {
           options.debug;
           var _options$autostart = options.autostart,
           autostart = _options$autostart === void 0 ? true : _options$autostart,
-          physicsOptions = _objectWithoutProperties(options, _excluded$9);
+          physicsOptions = _objectWithoutProperties(options, _excluded$b);
 
       this.car = element;
       this.wheels = wheels;
@@ -61778,7 +61782,7 @@ var populateMap = function populateMap(map, data) {
     map.set(k, data[k]);
   });
   return map;
-};var map$1=/*#__PURE__*/Object.freeze({__proto__:null,serializeMap:serializeMap,deserialiseMap:deserialiseMap,populateMap:populateMap});var _excluded$8 = ["position", "quaternion"],
+};var map$1=/*#__PURE__*/Object.freeze({__proto__:null,serializeMap:serializeMap,deserialiseMap:deserialiseMap,populateMap:populateMap});var _excluded$a = ["position", "quaternion"],
     _excluded2 = ["applyPhysicsUpdate"],
     _excluded3 = ["dt", "event"];
 var COLLIDER_TAG = "collider";
@@ -61968,7 +61972,7 @@ var Element$1 = /*#__PURE__*/function (_Entity) {
     _defineProperty$1(_assertThisInitialized(_this), "handlePhysicsUpdate", function (_ref6) {
       var position = _ref6.position,
           quaternion = _ref6.quaternion,
-          data = _objectWithoutProperties(_ref6, _excluded$8);
+          data = _objectWithoutProperties(_ref6, _excluded$a);
 
       _this.setPosition(position);
 
@@ -62331,7 +62335,11 @@ var Element$1 = /*#__PURE__*/function (_Entity) {
       var color = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : MATERIAL_PROPERTIES_DEFAULT_VALUES[PROPERTIES.COLOR];
 
       var _setColor = function _setColor(material) {
-        return material.color = new Color$1(color);
+        if (color && _typeof(color) === 'object' && 'r' in color && 'g' in color && 'b' in color) {
+          material.color.setRGB(color.r, color.g, color.b);
+        } else {
+          material.color = new Color$1(color);
+        }
       };
 
       if (color) {
@@ -62487,7 +62495,15 @@ var Element$1 = /*#__PURE__*/function (_Entity) {
       var color = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : MATERIAL_PROPERTIES_DEFAULT_VALUES[PROPERTIES.SPECULAR];
 
       var _setSpecularColor = function _setSpecularColor(material) {
-        return material[PROPERTIES.SPECULAR] = new Color$1(color);
+        if (color && _typeof(color) === 'object' && 'r' in color && 'g' in color && 'b' in color) {
+          if (!material[PROPERTIES.SPECULAR]) {
+            material[PROPERTIES.SPECULAR] = new Color$1();
+          }
+
+          material[PROPERTIES.SPECULAR].setRGB(color.r, color.g, color.b);
+        } else {
+          material[PROPERTIES.SPECULAR] = new Color$1(color);
+        }
       };
 
       applyMaterialChange(this.getBody(), _setSpecularColor);
@@ -62551,7 +62567,15 @@ var Element$1 = /*#__PURE__*/function (_Entity) {
       var value = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : MATERIAL_PROPERTIES_DEFAULT_VALUES[PROPERTIES.EMISSIVE];
 
       var _setEmissive = function _setEmissive(material) {
-        return material[PROPERTIES.EMISSIVE] = new Color$1(value);
+        if (value && _typeof(value) === 'object' && 'r' in value && 'g' in value && 'b' in value) {
+          if (!material[PROPERTIES.EMISSIVE]) {
+            material[PROPERTIES.EMISSIVE] = new Color$1();
+          }
+
+          material[PROPERTIES.EMISSIVE].setRGB(value.r, value.g, value.b);
+        } else {
+          material[PROPERTIES.EMISSIVE] = new Color$1(value);
+        }
       };
 
       applyMaterialChange(this.getBody(), _setEmissive);
@@ -63720,7 +63744,7 @@ var Plane = /*#__PURE__*/function (_Element) {
   }]);
 
   return Box;
-}(Element$1);var _excluded$7 = ["anisotropy", "sizeAttenuation", "depthTest", "depthWrite"];
+}(Element$1);var _excluded$9 = ["anisotropy", "sizeAttenuation", "depthTest", "depthWrite"];
 
 var validateAnisotropy = function validateAnisotropy(anisotropy) {
   var max = Scene$1.getRenderer().capabilities.getMaxAnisotropy();
@@ -63756,7 +63780,7 @@ var Sprite = /*#__PURE__*/function (_Element) {
         depthTest = _options$depthTest === void 0 ? true : _options$depthTest,
         _options$depthWrite = options.depthWrite,
         depthWrite = _options$depthWrite === void 0 ? true : _options$depthWrite,
-        rest = _objectWithoutProperties(options, _excluded$7);
+        rest = _objectWithoutProperties(options, _excluded$9);
 
     var texture = Images$1.get(spriteTexture);
 
@@ -87035,7 +87059,7 @@ var Proton = three_proton_min.exports;var ParticleEmitterGroup = /*#__PURE__*/fu
   }]);
 
   return ParticleEmitterGroup;
-}(Entity);var _excluded$6 = ["initializers", "behaviours", "texture", "color", "rate"];
+}(Entity);var _excluded$8 = ["initializers", "behaviours", "texture", "color", "rate"];
 var DEFAULT_PARTICLE_COLOR = PALETTES.BASE.BLACK;
 var SYSTEM_DISPOSE_TIMEOUT = 700;
 
@@ -87060,7 +87084,7 @@ var ProtonParticleEmitter = /*#__PURE__*/function (_ParticleEmitter) {
         _options$color = options.color,
         color = _options$color === void 0 ? DEFAULT_PARTICLE_COLOR : _options$color,
         rate = options.rate,
-        rest = _objectWithoutProperties(options, _excluded$6);
+        rest = _objectWithoutProperties(options, _excluded$8);
 
     var parsedOptions = _objectSpread2$1({
       initializers: initializers,
@@ -87277,7 +87301,7 @@ var Explosion = /*#__PURE__*/function (_ParticleEmitterGroup) {
   }
 
   return Explosion;
-}(ParticleEmitterGroup);var _excluded$5 = ["texture", "direction", "size", "strength", "colors"];
+}(ParticleEmitterGroup);var _excluded$7 = ["texture", "direction", "size", "strength", "colors"];
 
 var getFireRate = function getFireRate() {
   return new Proton.Rate(new Proton.Span(10, 15), new Proton.Span(0.05, 0.1));
@@ -87311,7 +87335,7 @@ var Fire = /*#__PURE__*/function (_ProtonParticleEmitte) {
         _options$strength = options.strength,
         strength = _options$strength === void 0 ? 100 : _options$strength,
         colors = options.colors,
-        rest = _objectWithoutProperties(options, _excluded$5);
+        rest = _objectWithoutProperties(options, _excluded$7);
 
     var fireOptions = _objectSpread2$1({
       rate: getFireRate(),
@@ -90990,6 +91014,9 @@ var Level = /*#__PURE__*/function (_EventDispatcher) {
   }, {
     key: "onCreate",
     value: function onCreate() {}
+  }, {
+    key: "onStart",
+    value: function onStart() {}
   }, {
     key: "onUpdate",
     value: function onUpdate() {}
@@ -91301,7 +91328,11 @@ var storage = new Storage();var Light$1 = /*#__PURE__*/function (_Entity) {
   }, {
     key: "setColor",
     value: function setColor(color) {
-      this.body.color = color;
+      if (color && _typeof(color) === 'object' && 'r' in color && 'g' in color && 'b' in color) {
+        this.body.color.setRGB(color.r, color.g, color.b);
+      } else {
+        this.body.color.set(color);
+      }
     }
   }, {
     key: "getColor",
@@ -91615,6 +91646,12 @@ var PointLight$1 = /*#__PURE__*/function (_Light) {
         shadowCamera: this.getShadowCameraNearFar()
       });
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return new PointLight(data.options);
+    }
   }]);
 
   return PointLight;
@@ -92029,6 +92066,12 @@ var SpotLight$1 = /*#__PURE__*/function (_Light) {
         angle: this.getAngle()
       });
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return new SpotLight(data.options);
+    }
   }]);
 
   return SpotLight;
@@ -92197,7 +92240,11 @@ var SpotLight$1 = /*#__PURE__*/function (_Light) {
   }, {
     key: "setColor",
     value: function setColor(color) {
-      this.body.color = color;
+      if (color && _typeof(color) === 'object' && 'r' in color && 'g' in color && 'b' in color) {
+        this.body.color.setRGB(color.r, color.g, color.b);
+      } else {
+        this.body.color.set(color);
+      }
     }
   }, {
     key: "getColor",
@@ -92318,9 +92365,20 @@ var HemisphereLight$1 = /*#__PURE__*/function (_Light) {
           sky = _ref.sky,
           ground = _ref.ground;
 
-      if (sky && ground) {
-        _this.getBody().color = sky;
-        _this.getBody().groundColor = ground;
+      if (sky !== undefined) {
+        if (_typeof(sky) === 'object' && 'r' in sky && 'g' in sky && 'b' in sky) {
+          _this.getBody().color.setRGB(sky.r, sky.g, sky.b);
+        } else {
+          _this.getBody().color.set(sky);
+        }
+      }
+
+      if (ground !== undefined) {
+        if (_typeof(ground) === 'object' && 'r' in ground && 'g' in ground && 'b' in ground) {
+          _this.getBody().groundColor.setRGB(ground.r, ground.g, ground.b);
+        } else {
+          _this.getBody().groundColor.set(ground);
+        }
       }
     });
 
@@ -92414,6 +92472,12 @@ var HemisphereLight$1 = /*#__PURE__*/function (_Light) {
         } : color
       });
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return new HemisphereLight(data.options);
+    }
   }]);
 
   return HemisphereLight;
@@ -92665,7 +92729,638 @@ var SunLight$1 = /*#__PURE__*/function (_Light) {
   }]);
 
   return SunLight;
-}(Light$1);var difference = function difference(a, b) {
+}(Light$1);var DEFAULT_SETUP_CONFIG$1 = {
+  deferred: false
+};
+
+var Sound$1 = /*#__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$1 : _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;
+    _this.detuneValue = 0;
+
+    if (!_this.setupConfig.deferred) {
+      _this.setupAudio();
+    }
+
+    _this.setName(name);
+
+    _this.setBody({
+      body: new Object3D()
+    });
+
+    _this.setEntityType(ENTITY_TYPES.AUDIO.TYPE);
+
+    _this.setEntitySubtype(ENTITY_TYPES.AUDIO.SUBTYPES.DEFAULT);
+
+    Scene$1.add(_this.getBody(), _assertThisInitialized(_this));
+    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.HELPER, TAGS.SOUNDS.HELPER, TAGS.SOUNDS.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();
+      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.detuneValue = value;
+        this.audioNode.detune.value = this.detuneValue;
+      }
+    }
+  }, {
+    key: "getDetune",
+    value: function getDetune() {
+      return this.detuneValue;
+    }
+  }, {
+    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: "usingHelper",
+    value: function usingHelper() {
+      return !!this.isUsingHelper;
+    }
+  }, {
+    key: "hasHolder",
+    value: function hasHolder() {
+      return !!this.holder;
+    }
+  }, {
+    key: "toJSON",
+    value: function toJSON() {
+      var parseJSON = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
+      return _objectSpread2$1(_objectSpread2$1({}, _get(_getPrototypeOf(Sound.prototype), "toJSON", this).call(this, parseJSON)), {}, {
+        source: this.source,
+        loop: this.loop,
+        loopStart: this.loopStart,
+        loopEnd: this.loopEnd,
+        autoplay: this.autoplay,
+        reconnectOnReset: this.reconnectOnReset,
+        volume: this.getVolume(),
+        detune: this.getDetune(),
+        hasPlayed: this.hasPlayed,
+        playing: this.isPlaying(),
+        connected: this.isConnected(),
+        duration: this.hasBuffer() ? this.duration : 0,
+        sampleRate: this.hasBuffer() ? this.sampleRate : 0,
+        numberOfChannels: this.hasBuffer() ? this.numberOfChannels : 0
+      });
+    }
+  }, {
+    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;
+    }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var source = data.source,
+          loop = data.loop,
+          loopStart = data.loopStart,
+          loopEnd = data.loopEnd,
+          autoplay = data.autoplay,
+          reconnectOnReset = data.reconnectOnReset,
+          _data$options = data.options,
+          options = _data$options === void 0 ? {} : _data$options;
+      return new Sound(_objectSpread2$1({
+        source: source,
+        loop: loop,
+        loopStart: loopStart,
+        loopEnd: loopEnd,
+        autoplay: autoplay,
+        reconnectOnReset: reconnectOnReset
+      }, options));
+    }
+  }]);
+
+  return Sound;
+}(Entity);var _excluded$6 = ["name"];
+
+var AmbientSound$1 = /*#__PURE__*/function (_Sound) {
+  _inherits(AmbientSound, _Sound);
+
+  var _super = _createSuper(AmbientSound);
+
+  function AmbientSound(source) {
+    var _this;
+
+    var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+        _ref$name = _ref.name,
+        name = _ref$name === void 0 ? generateRandomName("AmbientSound") : _ref$name,
+        options = _objectWithoutProperties(_ref, _excluded$6);
+
+    _classCallCheck(this, AmbientSound);
+
+    _this = _super.call(this, _objectSpread2$1({
+      source: source,
+      name: name
+    }, options));
+
+    _this.setEntityType(ENTITY_TYPES.AUDIO.TYPE);
+
+    _this.setEntitySubtype(ENTITY_TYPES.AUDIO.SUBTYPES.AMBIENT);
+
+    return _this;
+  }
+
+  _createClass(AmbientSound, null, [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var source = data.source,
+          loop = data.loop,
+          loopStart = data.loopStart,
+          loopEnd = data.loopEnd,
+          autoplay = data.autoplay,
+          reconnectOnReset = data.reconnectOnReset,
+          name = data.name,
+          _data$options = data.options,
+          options = _data$options === void 0 ? {} : _data$options;
+      return new AmbientSound(source, _objectSpread2$1({
+        loop: loop,
+        loopStart: loopStart,
+        loopEnd: loopEnd,
+        autoplay: autoplay,
+        reconnectOnReset: reconnectOnReset,
+        name: name
+      }, options));
+    }
+  }]);
+
+  return AmbientSound;
+}(Sound$1);var _excluded$5 = ["name"];
+
+var DirectionalSound$1 = /*#__PURE__*/function (_Sound) {
+  _inherits(DirectionalSound, _Sound);
+
+  var _super = _createSuper(DirectionalSound);
+
+  function DirectionalSound(source) {
+    var _this;
+
+    var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},
+        _ref$name = _ref.name,
+        name = _ref$name === void 0 ? generateRandomName("DirectionalSound") : _ref$name,
+        options = _objectWithoutProperties(_ref, _excluded$5);
+
+    _classCallCheck(this, DirectionalSound);
+
+    _this = _super.call(this, _objectSpread2$1({
+      source: source,
+      name: name
+    }, options));
+
+    _this.setEntityType(ENTITY_TYPES.AUDIO.TYPE);
+
+    _this.setEntitySubtype(ENTITY_TYPES.AUDIO.SUBTYPES.DIRECTIONAL);
+
+    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;
+    }
+  }, {
+    key: "createPannerNode",
+    value: function createPannerNode() {
+      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var _options$coneInnerAng = options.coneInnerAngleDegrees,
+          coneInnerAngleDegrees = _options$coneInnerAng === void 0 ? 360 : _options$coneInnerAng,
+          _options$coneOuterAng = options.coneOuterAngleDegrees,
+          coneOuterAngleDegrees = _options$coneOuterAng === void 0 ? 0 : _options$coneOuterAng,
+          _options$coneOuterGai = options.coneOuterGain,
+          coneOuterGain = _options$coneOuterGai === void 0 ? 0 : _options$coneOuterGai,
+          _options$maxDistance = options.maxDistance,
+          maxDistance = _options$maxDistance === void 0 ? 10000 : _options$maxDistance,
+          _options$rolloffFacto = options.rolloffFactor,
+          rolloffFactor = _options$rolloffFacto === void 0 ? 1 : _options$rolloffFacto,
+          _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.refDistance = refDistance;
+      this.pannerNode.maxDistance = maxDistance;
+      this.pannerNode.rolloffFactor = rolloffFactor;
+      this.pannerNode.coneInnerAngle = coneInnerAngleDegrees;
+      this.pannerNode.coneOuterAngle = coneOuterAngleDegrees;
+      this.pannerNode.coneOuterGain = coneOuterGain;
+    }
+  }, {
+    key: "connect",
+    value: function connect() {
+      if (this.connected) {
+        this.disconnect();
+      }
+
+      this.volumeNode.connect(Audio$1.getMasterVolumeNode());
+      this.pannerNode.connect(this.volumeNode);
+      this.audioNode.connect(this.pannerNode);
+      this.connected = true;
+      this.tryAutoplay();
+    }
+  }, {
+    key: "disconnect",
+    value: function disconnect() {
+      if (this.connected) {
+        this.volumeNode.disconnect();
+        this.pannerNode.disconnect();
+        this.audioNode.disconnect();
+        this.connected = false;
+      }
+    }
+  }, {
+    key: "updatePannerOrientation",
+    value: function updatePannerOrientation() {
+      var vec = new Vector3$1(0, 0, 1);
+      var m = this.getBody().matrixWorld;
+      var mx = m.elements[12],
+          my = m.elements[13],
+          mz = m.elements[14];
+      m.elements[12] = m.elements[13] = m.elements[14] = 0;
+      vec.applyMatrix4(m);
+      vec.normalize();
+      this.pannerNode.orientationX.setValueAtTime(vec.x, Audio$1.context.currentTime);
+      this.pannerNode.orientationY.setValueAtTime(vec.y, Audio$1.context.currentTime);
+      this.pannerNode.orientationZ.setValueAtTime(vec.z, Audio$1.context.currentTime);
+      m.elements[12] = mx;
+      m.elements[13] = my;
+      m.elements[14] = mz;
+    }
+  }, {
+    key: "updatePannerPosition",
+    value: function updatePannerPosition() {
+      this.getBody().updateMatrixWorld();
+      var position = new Vector3$1();
+      position.setFromMatrixPosition(this.getBody().matrixWorld);
+      this.pannerNode.positionX.setValueAtTime(position.x, Audio$1.context.currentTime);
+      this.pannerNode.positionY.setValueAtTime(position.y, Audio$1.context.currentTime);
+      this.pannerNode.positionZ.setValueAtTime(position.z, Audio$1.context.currentTime);
+    }
+  }, {
+    key: "update",
+    value: function update(dt) {
+      _get(_getPrototypeOf(DirectionalSound.prototype), "update", this).call(this, dt);
+
+      if (this.hasPannerNode()) {
+        this.updatePannerOrientation();
+        this.updatePannerPosition();
+      }
+    }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var source = data.source,
+          loop = data.loop,
+          loopStart = data.loopStart,
+          loopEnd = data.loopEnd,
+          autoplay = data.autoplay,
+          reconnectOnReset = data.reconnectOnReset,
+          name = data.name,
+          _data$options = data.options,
+          options = _data$options === void 0 ? {} : _data$options;
+      return new DirectionalSound(source, _objectSpread2$1({
+        loop: loop,
+        loopStart: loopStart,
+        loopEnd: loopEnd,
+        autoplay: autoplay,
+        reconnectOnReset: reconnectOnReset,
+        name: name
+      }, options));
+    }
+  }]);
+
+  return DirectionalSound;
+}(Sound$1);var difference = function difference(a, b) {
   var s = new Set(b);
   return a.filter(function (x) {
     return !s.has(x);
@@ -92980,7 +93675,7 @@ var Importer = /*#__PURE__*/function () {
     value: function completeElementCreation(element, elementData, options) {
       Importer.completeCommonCreationSteps(element, elementData, options); // setting material
 
-      if (elementData.materials.length) {
+      if (elementData.materials && elementData.materials.length) {
         var defaultMaterialOptionKeys = MATERIAL_PROPERTIES_MAP[elementData.materialType];
         var disallowedMaterialOptions = difference(Object.keys(elementData.materials[0]), defaultMaterialOptionKeys);
         var materialOptions = omit(disallowedMaterialOptions, elementData.materials[0]);
@@ -92988,14 +93683,43 @@ var Importer = /*#__PURE__*/function () {
       } // setting textures
 
 
-      var parsedTextures = JSON.parse(elementData.textures);
-      element.setNormalScale();
-      Object.keys(parsedTextures).forEach(function (textureType) {
-        var _parsedTextures$textu = parsedTextures[textureType],
-            id = _parsedTextures$textu.id,
-            options = _parsedTextures$textu.options;
-        element.setTexture(id, textureType, options);
-      });
+      if (elementData.textures) {
+        var parsedTextures = JSON.parse(elementData.textures);
+        element.setNormalScale();
+        Object.keys(parsedTextures).forEach(function (textureType) {
+          var _parsedTextures$textu = parsedTextures[textureType],
+              id = _parsedTextures$textu.id,
+              options = _parsedTextures$textu.options;
+          element.setTexture(id, textureType, options);
+        });
+      } // setting shadow properties
+
+
+      if (elementData.shadow) {
+        var castShadow = elementData.shadow.cast;
+        var receiveShadow = elementData.shadow.receive;
+
+        if (castShadow !== undefined) {
+          element.getBody().castShadow = castShadow;
+        }
+
+        if (receiveShadow !== undefined) {
+          element.getBody().receiveShadow = receiveShadow;
+        } // For models, also traverse children
+
+
+        if (element.isModel()) {
+          element.getBody().traverse(function (child) {
+            if (castShadow !== undefined) {
+              child.castShadow = castShadow;
+            }
+
+            if (receiveShadow !== undefined) {
+              child.receiveShadow = receiveShadow;
+            }
+          });
+        }
+      }
     }
   }, {
     key: "completeLightCreation",
@@ -93006,7 +93730,12 @@ var Importer = /*#__PURE__*/function () {
       })); // setting color and intensity
 
       light.setColor(lightData.color);
-      light.setIntensity(lightData.intensity); // setting light-specific properties
+      light.setIntensity(lightData.intensity); // setting castShadow
+
+      if (lightData.castShadow !== undefined) {
+        light.setCastShadow(lightData.castShadow);
+      } // setting light-specific properties
+
 
       if (lightData.distance !== undefined) {
         light.setDistance(lightData.distance);
@@ -93022,14 +93751,6 @@ var Importer = /*#__PURE__*/function () {
 
       if (lightData.penumbra !== undefined) {
         light.setPenumbra(lightData.penumbra);
-      } // setting ground color for hemisphere lights
-
-
-      if (lightData.ground !== undefined && lightData.sky !== undefined) {
-        light.setColor({
-          sky: lightData.sky,
-          ground: lightData.ground
-        });
       } // setting shadow properties
 
 
@@ -93139,6 +93860,22 @@ var Importer = /*#__PURE__*/function () {
         sprite.setDepthWrite(depthWrite);
       }
     }
+  }, {
+    key: "completeSoundCreation",
+    value: function completeSoundCreation(sound, soundData, options) {
+      Importer.completeCommonCreationSteps(sound, soundData, _objectSpread2$1(_objectSpread2$1({}, options), {}, {
+        skipOpacity: true,
+        skipScale: true
+      })); // setting sound-specific properties
+
+      if (soundData.volume !== undefined) {
+        sound.setVolume(soundData.volume);
+      }
+
+      if (soundData.detune !== undefined) {
+        sound.detune(soundData.detune);
+      }
+    }
   }, {
     key: "parseLevelData",
     value: function parseLevelData() {
@@ -93147,7 +93884,13 @@ var Importer = /*#__PURE__*/function () {
       var _data$elements = data.elements,
           elements = _data$elements === void 0 ? [] : _data$elements,
           _data$lights = data.lights,
-          lights = _data$lights === void 0 ? [] : _data$lights;
+          lights = _data$lights === void 0 ? [] : _data$lights,
+          _data$audio = data.audio,
+          audio = _data$audio === void 0 ? [] : _data$audio,
+          _data$sounds = data.sounds,
+          sounds = _data$sounds === void 0 ? [] : _data$sounds; // Support both 'audio' and 'sounds' keys for backwards compatibility
+
+      var allSounds = [].concat(_toConsumableArray(audio), _toConsumableArray(sounds));
       elements.forEach(function (data) {
         try {
           if (data.entitySubType === ENTITY_TYPES.MODEL.TYPE) {
@@ -93254,6 +93997,30 @@ var Importer = /*#__PURE__*/function () {
         } catch (error) {
           console.error(IMPORTER_ERROR_LIGHT_CREATION, data.name, data.entitySubType, error.stack);
         }
+      }); // processing sounds
+
+      allSounds.forEach(function (data) {
+        try {
+          switch (data.entitySubType) {
+            case ENTITY_TYPES.AUDIO.SUBTYPES.DEFAULT:
+              Importer.completeSoundCreation(Sound$1.create(data), data, options);
+              break;
+
+            case ENTITY_TYPES.AUDIO.SUBTYPES.AMBIENT:
+              Importer.completeSoundCreation(AmbientSound$1.create(data), data, options);
+              break;
+
+            case ENTITY_TYPES.AUDIO.SUBTYPES.DIRECTIONAL:
+              Importer.completeSoundCreation(DirectionalSound$1.create(data), data, options);
+              break;
+
+            default:
+              // Try to create as basic Sound if entitySubType not recognized
+              Importer.completeSoundCreation(Sound$1.create(data), data, options);
+          }
+        } catch (error) {
+          console.error(IMPORTER_ERROR_SOUND_CREATION, data.name, data.entitySubType, error.stack);
+        }
       });
     }
   }]);
@@ -93307,7 +94074,11 @@ var Importer = /*#__PURE__*/function () {
           _this.getCurrentLevel().init();
 
           storage.load().then(Importer.parseLevelData).then(function () {
-            return resolve(_this.getCurrentLevel());
+            if (_this.getCurrentLevel().onStart instanceof Function) {
+              _this.getCurrentLevel().onStart();
+            }
+
+            resolve(_this.getCurrentLevel());
           });
         } else {
           Physics$1.waitForState(PHYSICS_STATES.READY).then(function () {
@@ -93317,7 +94088,11 @@ var Importer = /*#__PURE__*/function () {
 
             var levelData = Config$1.getLevelData(_this.getCurrentLevel().getPath()) || {};
             Importer.importLevelSnapshot(levelData).then(function () {
-              return resolve(_this.getCurrentLevel());
+              if (_this.getCurrentLevel().onStart instanceof Function) {
+                _this.getCurrentLevel().onStart();
+              }
+
+              resolve(_this.getCurrentLevel());
             }).catch(reject);
           });
         }
@@ -93881,407 +94656,7 @@ var Cone = /*#__PURE__*/function (_Element) {
   }]);
 
   return Cone;
-}(Element$1);var DEFAULT_SETUP_CONFIG$1 = {
-  deferred: false
-};
-
-var Sound$1 = /*#__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$1 : _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;
-    _this.detuneValue = 0;
-
-    if (!_this.setupConfig.deferred) {
-      _this.setupAudio();
-    }
-
-    _this.setName(name);
-
-    _this.setBody({
-      body: new Object3D()
-    });
-
-    _this.setEntityType(ENTITY_TYPES.AUDIO.DEFAULT);
-
-    Scene$1.add(_this.getBody(), _assertThisInitialized(_this));
-    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.HELPER, TAGS.SOUNDS.HELPER, TAGS.SOUNDS.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();
-      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.detuneValue = value;
-        this.audioNode.detune.value = this.detuneValue;
-      }
-    }
-  }, {
-    key: "getDetune",
-    value: function getDetune() {
-      return this.detuneValue;
-    }
-  }, {
-    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: "usingHelper",
-    value: function usingHelper() {
-      return !!this.isUsingHelper;
-    }
-  }, {
-    key: "hasHolder",
-    value: function hasHolder() {
-      return !!this.holder;
-    }
-  }, {
-    key: "toJSON",
-    value: function toJSON() {
-      var parseJSON = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : false;
-      return _objectSpread2$1(_objectSpread2$1({}, _get(_getPrototypeOf(Sound.prototype), "toJSON", this).call(this, parseJSON)), {}, {
-        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.hasBuffer() ? this.duration : 0,
-        sampleRate: this.hasBuffer() ? this.sampleRate : 0,
-        numberOfChannels: this.hasBuffer() ? this.numberOfChannels : 0
-      });
-    }
-  }, {
-    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 _excluded$2 = ["name"];
+}(Element$1);var _excluded$2 = ["name"];
 
 var AmbientSound = /*#__PURE__*/function (_Sound) {
   _inherits(AmbientSound, _Sound);
@@ -94303,11 +94678,37 @@ var AmbientSound = /*#__PURE__*/function (_Sound) {
       name: name
     }, options));
 
-    _this.setEntityType(ENTITY_TYPES.AUDIO.AMBIENT);
+    _this.setEntityType(ENTITY_TYPES.AUDIO.TYPE);
+
+    _this.setEntitySubtype(ENTITY_TYPES.AUDIO.SUBTYPES.AMBIENT);
 
     return _this;
   }
 
+  _createClass(AmbientSound, null, [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var source = data.source,
+          loop = data.loop,
+          loopStart = data.loopStart,
+          loopEnd = data.loopEnd,
+          autoplay = data.autoplay,
+          reconnectOnReset = data.reconnectOnReset,
+          name = data.name,
+          _data$options = data.options,
+          options = _data$options === void 0 ? {} : _data$options;
+      return new AmbientSound(source, _objectSpread2$1({
+        loop: loop,
+        loopStart: loopStart,
+        loopEnd: loopEnd,
+        autoplay: autoplay,
+        reconnectOnReset: reconnectOnReset,
+        name: name
+      }, options));
+    }
+  }]);
+
   return AmbientSound;
 }(Sound$1);var _excluded$1 = ["name"];
 
@@ -94331,7 +94732,9 @@ var DirectionalSound = /*#__PURE__*/function (_Sound) {
       name: name
     }, options));
 
-    _this.setEntityType(ENTITY_TYPES.AUDIO.DIRECTIONAL);
+    _this.setEntityType(ENTITY_TYPES.AUDIO.TYPE);
+
+    _this.setEntitySubtype(ENTITY_TYPES.AUDIO.SUBTYPES.DIRECTIONAL);
 
     return _this;
   }
@@ -94435,6 +94838,28 @@ var DirectionalSound = /*#__PURE__*/function (_Sound) {
         this.updatePannerPosition();
       }
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var source = data.source,
+          loop = data.loop,
+          loopStart = data.loopStart,
+          loopEnd = data.loopEnd,
+          autoplay = data.autoplay,
+          reconnectOnReset = data.reconnectOnReset,
+          name = data.name,
+          _data$options = data.options,
+          options = _data$options === void 0 ? {} : _data$options;
+      return new DirectionalSound(source, _objectSpread2$1({
+        loop: loop,
+        loopStart: loopStart,
+        loopEnd: loopEnd,
+        autoplay: autoplay,
+        reconnectOnReset: reconnectOnReset,
+        name: name
+      }, options));
+    }
   }]);
 
   return DirectionalSound;
@@ -94512,7 +94937,9 @@ var Sound = /*#__PURE__*/function (_Entity) {
       body: new Object3D()
     });
 
-    _this.setEntityType(ENTITY_TYPES.AUDIO.DEFAULT);
+    _this.setEntityType(ENTITY_TYPES.AUDIO.TYPE);
+
+    _this.setEntitySubtype(ENTITY_TYPES.AUDIO.SUBTYPES.DEFAULT);
 
     Scene$1.add(_this.getBody(), _assertThisInitialized(_this));
     Audio$1.add(_assertThisInitialized(_this));
@@ -94810,6 +95237,7 @@ var Sound = /*#__PURE__*/function (_Entity) {
         loopStart: this.loopStart,
         loopEnd: this.loopEnd,
         autoplay: this.autoplay,
+        reconnectOnReset: this.reconnectOnReset,
         volume: this.getVolume(),
         detune: this.getDetune(),
         hasPlayed: this.hasPlayed,
@@ -94835,6 +95263,27 @@ var Sound = /*#__PURE__*/function (_Entity) {
     get: function get() {
       return this.buffer.numberOfChannels;
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      var source = data.source,
+          loop = data.loop,
+          loopStart = data.loopStart,
+          loopEnd = data.loopEnd,
+          autoplay = data.autoplay,
+          reconnectOnReset = data.reconnectOnReset,
+          _data$options = data.options,
+          options = _data$options === void 0 ? {} : _data$options;
+      return new Sound(_objectSpread2$1({
+        source: source,
+        loop: loop,
+        loopStart: loopStart,
+        loopEnd: loopEnd,
+        autoplay: autoplay,
+        reconnectOnReset: reconnectOnReset
+      }, options));
+    }
   }]);
 
   return Sound;
@@ -95588,6 +96037,12 @@ var PointLight = /*#__PURE__*/function (_Light) {
         shadowCamera: this.getShadowCameraNearFar()
       });
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return new PointLight(data.options);
+    }
   }]);
 
   return PointLight;
@@ -95892,6 +96347,12 @@ var SpotLight = /*#__PURE__*/function (_Light) {
         angle: this.getAngle()
       });
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return new SpotLight(data.options);
+    }
   }]);
 
   return SpotLight;
@@ -95932,9 +96393,20 @@ var HemisphereLight = /*#__PURE__*/function (_Light) {
           sky = _ref.sky,
           ground = _ref.ground;
 
-      if (sky && ground) {
-        _this.getBody().color = sky;
-        _this.getBody().groundColor = ground;
+      if (sky !== undefined) {
+        if (_typeof(sky) === 'object' && 'r' in sky && 'g' in sky && 'b' in sky) {
+          _this.getBody().color.setRGB(sky.r, sky.g, sky.b);
+        } else {
+          _this.getBody().color.set(sky);
+        }
+      }
+
+      if (ground !== undefined) {
+        if (_typeof(ground) === 'object' && 'r' in ground && 'g' in ground && 'b' in ground) {
+          _this.getBody().groundColor.setRGB(ground.r, ground.g, ground.b);
+        } else {
+          _this.getBody().groundColor.set(ground);
+        }
       }
     });
 
@@ -96028,6 +96500,12 @@ var HemisphereLight = /*#__PURE__*/function (_Light) {
         } : color
       });
     }
+  }], [{
+    key: "create",
+    value: function create() {
+      var data = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      return new HemisphereLight(data.options);
+    }
   }]);
 
   return HemisphereLight;