@newkrok/three-particles 0.1.0 → 0.3.0

package/README.md

@@ -1,23 +1,21 @@
 # THREE Particles
-Particle sytem for ThreeJS
+
+Particle system for ThreeJS
 
 # THREE Particles Editor
+
 You can create your own particle effects with it's editor https://github.com/NewKrok/three-particles-editor
 
 # Live demo
+
 https://newkrok.com/three-particles-editor/index.html
 
 # Install
+
 npm package https://www.npmjs.com/package/@newkrok/three-particles
 
 Install with npm
 `npm i @newkrok/three-particles`
 
 Add as a package.json dependency
-`
-"dependencies": {
-    ...
-    "@newkrok/three-particles": "0.0.1"
-    ...
-  },
- `
+`"dependencies": { ... "@newkrok/three-particles": "0.2.2" ... }, `

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newkrok/three-particles",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Particle system for ThreeJS",
   "main": "src/js/three-particles.js",
   "bin": {
@@ -22,6 +22,10 @@
     "url": "https://github.com/NewKrok/three-particles/issues"
   },
   "homepage": "https://github.com/NewKrok/three-particles#readme",
+  "dependencies": {
+    "three": "0.135.0",
+    "easing-functions": "1.0.1"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   }

package/src/js/effects/shaders/particle-system-fragment-shader.glsl.js

@@ -2,20 +2,30 @@ const ParticleSystemFragmentShader = `
   uniform sampler2D map;
   uniform float elapsed;
   uniform float fps;
+  uniform bool useFPSForFrameIndex;
   uniform vec2 tiles;
 
   varying vec4 vColor;
-  varying float vLifeTime;
+  varying float vLifetime;
+  varying float vStartLifetime;
   varying float vRotation;
+  varying float vStartFrame;
 
   void main()
   {
     gl_FragColor = vColor;
     float mid = 0.5;
 
-    float frameIndex = max(min(vLifeTime / 1000.0 * fps, tiles.x * tiles.y - 1.0), 0.0);
+    float frameIndex = round(vStartFrame) + (
+      useFPSForFrameIndex == true
+        ? fps == 0.0
+            ? 0.0
+            : max((vLifetime / 1000.0) * fps, 0.0)
+        : max(min(floor(min(vLifetime / vStartLifetime, 1.0) * (tiles.x * tiles.y)), tiles.x * tiles.y - 1.0), 0.0)
+    );
+        
     float spriteXIndex = floor(mod(frameIndex, tiles.x));
-    float spriteYIndex = floor(mod(frameIndex / tiles.y, tiles.y));
+    float spriteYIndex = floor(mod(frameIndex / tiles.x, tiles.y));
 
     vec2 frameUV = vec2(
       gl_PointCoord.x / tiles.x + spriteXIndex / tiles.x,

package/src/js/effects/shaders/particle-system-vertex-shader.glsl.js

@@ -1,27 +1,33 @@
 const ParticleSystemVertexShader = `
-  attribute float startSize;
+  attribute float size;
   attribute float colorR;
   attribute float colorG;
   attribute float colorB;
   attribute float colorA;
-  attribute float lifeTime;
+  attribute float lifetime;
+  attribute float startLifetime;
   attribute float rotation;
+  attribute float startFrame;
 
   varying mat4 vPosition;
   varying vec4 vColor;
-  varying float vLifeTime;
+  varying float vLifetime;
+  varying float vStartLifetime;
   varying float vRotation;
+  varying float vStartFrame;
 
   void main()
   {
     vColor = vec4(colorR, colorG, colorB, colorA);
-    vLifeTime = lifeTime;
+    vLifetime = lifetime;
+    vStartLifetime = startLifetime;
     vRotation = rotation;
+    vStartFrame = startFrame;
 
     vec4 mvPosition = modelViewMatrix * vec4(position, 1.0);
-    gl_PointSize = startSize * (100.0 / length(mvPosition.xyz));
+    gl_PointSize = size * (100.0 / length(mvPosition.xyz));
     gl_Position = projectionMatrix * mvPosition;
   }
-`
+`;
 
-export default ParticleSystemVertexShader
+export default ParticleSystemVertexShader;

package/src/js/effects/three-particles/three-particles-curves.js

@@ -0,0 +1,74 @@
+import Easing from "easing-functions";
+
+export const CurveFunction = {
+  LINEAR: "LINEAR",
+  QUADRATIC_IN: "QUADRATIC_IN",
+  QUADRATIC_OUT: "QUADRATIC_OUT",
+  QUADRATIC_IN_OUT: "QUADRATIC_IN_OUT",
+  CUBIC_IN: "CUBIC_IN",
+  CUBIC_OUT: "CUBIC_OUT",
+  CUBIC_IN_OUT: "CUBIC_IN_OUT",
+  QUARTIC_IN: "QUARTIC_IN",
+  QUARTIC_OUT: "QUARTIC_OUT",
+  QUARTIC_IN_OUT: "QUARTIC_IN_OUT",
+  QUINTIC_IN: "QUINTIC_IN",
+  QUINTIC_OUT: "QUINTIC_OUT",
+  QUINTIC_IN_OUT: "QUINTIC_IN_OUT",
+  SINUSOIDAL_IN: "SINUSOIDAL_IN",
+  SINUSOIDAL_OUT: "SINUSOIDAL_OUT",
+  SINUSOIDAL_IN_OUT: "SINUSOIDAL_IN_OUT",
+  EXPONENTIAL_IN: "EXPONENTIAL_IN",
+  EXPONENTIAL_OUT: "EXPONENTIAL_OUT",
+  EXPONENTIAL_IN_OUT: "EXPONENTIAL_IN_OUT",
+  CIRCULAR_IN: "CIRCULAR_IN",
+  CIRCULAR_OUT: "CIRCULAR_OUT",
+  CIRCULAR_IN_OUT: "CIRCULAR_IN_OUT",
+  ELASTIC_IN: "ELASTIC_IN",
+  ELASTIC_OUT: "ELASTIC_OUT",
+  ELASTIC_IN_OUT: "ELASTIC_IN_OUT",
+  BACK_IN: "BACK_IN",
+  BACK_OUT: "BACK_OUT",
+  BACK_IN_OUT: "BACK_IN_OUT",
+  BOUNCE_IN: "BOUNCE_IN",
+  BOUNCE_OUT: "BOUNCE_OUT",
+  BOUNCE_IN_OUT: "BOUNCE_IN_OUT",
+};
+
+const CurveFunctionMap = {
+  [CurveFunction.LINEAR]: Easing.Linear.None,
+  [CurveFunction.QUADRATIC_IN]: Easing.Quadratic.In,
+  [CurveFunction.QUADRATIC_OUT]: Easing.Quadratic.Out,
+  [CurveFunction.QUADRATIC_IN_OUT]: Easing.Quadratic.InOut,
+  [CurveFunction.CUBIC_IN]: Easing.Cubic.In,
+  [CurveFunction.CUBIC_OUT]: Easing.Cubic.Out,
+  [CurveFunction.CUBIC_IN_OUT]: Easing.Cubic.InOut,
+  [CurveFunction.QUARTIC_IN]: Easing.Quartic.In,
+  [CurveFunction.QUARTIC_OUT]: Easing.Quartic.Out,
+  [CurveFunction.QUARTIC_IN_OUT]: Easing.Quartic.InOut,
+  [CurveFunction.QUINTIC_IN]: Easing.Quintic.In,
+  [CurveFunction.QUINTIC_OUT]: Easing.Quintic.Out,
+  [CurveFunction.QUINTIC_IN_OUT]: Easing.Quintic.InOut,
+  [CurveFunction.SINUSOIDAL_IN]: Easing.Sinusoidal.In,
+  [CurveFunction.SINUSOIDAL_OUT]: Easing.Sinusoidal.Out,
+  [CurveFunction.SINUSOIDAL_IN_OUT]: Easing.Sinusoidal.InOut,
+  [CurveFunction.EXPONENTIAL_IN]: Easing.Exponential.In,
+  [CurveFunction.EXPONENTIAL_OUT]: Easing.Exponential.Out,
+  [CurveFunction.EXPONENTIAL_IN_OUT]: Easing.Exponential.InOut,
+  [CurveFunction.CIRCULAR_IN]: Easing.Circular.In,
+  [CurveFunction.CIRCULAR_OUT]: Easing.Circular.Out,
+  [CurveFunction.CIRCULAR_IN_OUT]: Easing.Circular.InOut,
+  [CurveFunction.ELASTIC_IN]: Easing.Elastic.In,
+  [CurveFunction.ELASTIC_OUT]: Easing.Elastic.Out,
+  [CurveFunction.ELASTIC_IN_OUT]: Easing.Elastic.InOut,
+  [CurveFunction.BACK_IN]: Easing.Back.In,
+  [CurveFunction.BACK_OUT]: Easing.Back.Out,
+  [CurveFunction.BACK_IN_OUT]: Easing.Back.InOut,
+  [CurveFunction.BOUNCE_IN]: Easing.Bounce.In,
+  [CurveFunction.BOUNCE_OUT]: Easing.Bounce.Out,
+  [CurveFunction.BOUNCE_IN_OUT]: Easing.Bounce.InOut,
+};
+
+export const getCurveFunction = (curveFunction) =>
+  typeof curveFunction === "function"
+    ? curveFunction
+    : CurveFunctionMap[curveFunction];

package/src/js/effects/three-particles/three-particles-modifiers.js

@@ -0,0 +1,44 @@
+import { getCurveFunction } from "./three-particles-curves.js";
+
+const modifiers = [
+  // {key:"colorOverLifetime", attributeKeys:["colorR", "colorG", "colorB"]},
+  {
+    key: "opacityOverLifetime",
+    attributeKeys: ["colorA"],
+    startValueKeys: ["startOpacity"],
+  },
+  {
+    key: "sizeOverLifetime",
+    attributeKeys: ["size"],
+    startValueKeys: ["startSize"],
+  },
+];
+
+export const applyModifiers = ({
+  startValues,
+  normalizedConfig,
+  attributes,
+  particleLifetimePercentage,
+  particleIndex,
+  forceUpdate = false,
+}) => {
+  modifiers.forEach(({ key, attributeKeys, startValueKeys }) => {
+    const modifier = normalizedConfig[key];
+    if (modifier.isActive) {
+      const multiplier = getCurveFunction(modifier.curveFunction)(
+        particleLifetimePercentage
+      );
+      attributeKeys.forEach((attributeKey, index) => {
+        attributes[attributeKey].array[particleIndex] =
+          startValues[startValueKeys[index]][particleIndex] * multiplier;
+        attributes[attributeKey].needsUpdate = true;
+      });
+    } else if (forceUpdate) {
+      attributeKeys.forEach((attributeKey, index) => {
+        attributes[attributeKey].array[particleIndex] =
+          startValues[startValueKeys[index]][particleIndex];
+        attributes[attributeKey].needsUpdate = true;
+      });
+    }
+  });
+};

package/src/js/effects/{three-particles-utils.js → three-particles/three-particles-utils.js}

@@ -1,5 +1,24 @@
 import * as THREE from "three/build/three.module.js";
 
+export const patchObject = (
+  objectA,
+  objectB,
+  config = { skippedProperties: [], applyToFirstObject: false }
+) => {
+  const result = {};
+  Object.keys(objectA).forEach((key) => {
+    if (!config.skippedProperties || !config.skippedProperties.includes(key)) {
+      if (typeof objectA[key] === "object" && objectA[key] && objectB[key]) {
+        result[key] = patchObject(objectA[key], objectB[key], config);
+      } else {
+        result[key] = objectB[key] === 0 ? 0 : objectB[key] || objectA[key];
+        if (config.applyToFirstObject) objectA[key] = result[key];
+      }
+    }
+  });
+  return result;
+};
+
 export const calculateRandomPositionAndVelocityOnSphere = (
   position,
   velocity,
@@ -81,7 +100,7 @@ export const calculateRandomPositionAndVelocityOnCone = (
       sinNormalizedAngle *
       speedMultiplierByPosition *
       randomizedSpeed,
-    -Math.cos(normalizedAngle) * randomizedSpeed
+    Math.cos(normalizedAngle) * randomizedSpeed
   );
 };
 
@@ -106,12 +125,12 @@ export const calculateRandomPositionAndVelocityOnCircle = (
     radius * radiusThickness * randomizedDistanceRatio * yDirection;
   position.z = 0;
 
-  const positionLength = position.length();
-
   const randomizedSpeed = THREE.MathUtils.randFloat(
     startSpeed.min,
     startSpeed.max
   );
+
+  const positionLength = position.length();
   const speedMultiplierByPosition = 1 / positionLength;
   velocity.set(
     position.x * speedMultiplierByPosition * randomizedSpeed,
@@ -119,3 +138,24 @@ export const calculateRandomPositionAndVelocityOnCircle = (
     0
   );
 };
+
+export const calculateRandomPositionAndVelocityOnRectangle = (
+  position,
+  velocity,
+  startSpeed,
+  { rotation, scale }
+) => {
+  const xOffset = Math.random() * scale.x - scale.x / 2;
+  const yOffset = Math.random() * scale.y - scale.y / 2;
+  const rotationX = THREE.Math.degToRad(rotation.x);
+  const rotationY = THREE.Math.degToRad(rotation.y);
+  position.x = xOffset * Math.cos(rotationY);
+  position.y = yOffset * Math.cos(rotationX);
+  position.z = xOffset * Math.sin(rotationY) - yOffset * Math.sin(rotationX);
+
+  const randomizedSpeed = THREE.MathUtils.randFloat(
+    startSpeed.min,
+    startSpeed.max
+  );
+  velocity.set(0, 0, randomizedSpeed);
+};

package/src/js/effects/three-particles.js

@@ -3,11 +3,15 @@ import * as THREE from "three/build/three.module.js";
 import {
   calculateRandomPositionAndVelocityOnCircle,
   calculateRandomPositionAndVelocityOnCone,
+  calculateRandomPositionAndVelocityOnRectangle,
   calculateRandomPositionAndVelocityOnSphere,
-} from "./three-particles-utils.js";
+  patchObject,
+} from "./three-particles/three-particles-utils.js";
 
-import ParticleSystemFragmentShader from "./shaders/particle-system-fragment-shader.glsl.js";
-import ParticleSystemVertexShader from "./shaders/particle-system-vertex-shader.glsl.js";
+import { CurveFunction } from "./three-particles/three-particles-curves.js";
+import ParticleSystemFragmentShader from "./three-particles/shaders/particle-system-fragment-shader.glsl.js";
+import ParticleSystemVertexShader from "./three-particles/shaders/particle-system-vertex-shader.glsl.js";
+import { applyModifiers } from "./three-particles/three-particles-modifiers.js";
 
 // Float32Array is not enough accurate when we are storing timestamp in it so we just remove unnecessary time
 const float32Helper = 1638200000000;
@@ -27,9 +31,81 @@ export const Shape = {
   RECTANGLE: "RECTANGLE",
 };
 
-const defaultTextureSheetAnimation = {
-  tiles: new THREE.Vector2(1.0, 1.0),
-  fps: 30.0,
+export const TimeMode = {
+  LIFETIME: "LIFETIME",
+  FPS: "FPS",
+};
+
+export const getDefaultParticleSystemConfig = () =>
+  JSON.parse(JSON.stringify(DEFAULT_PARTICLE_SYSTEM_CONFIG));
+
+const DEFAULT_PARTICLE_SYSTEM_CONFIG = {
+  transform: {
+    position: { x: 0, y: 0, z: 0 },
+    rotation: { x: 0, y: 0, z: 0 },
+    scale: { x: 1, y: 1, z: 1 },
+  },
+  duration: 5.0,
+  looping: true,
+  startDelay: { min: 0.0, max: 0.0 },
+  startLifetime: { min: 2.0, max: 2.0 },
+  startSpeed: { min: 1.0, max: 1.0 },
+  startSize: { min: 1.0, max: 1.0 },
+  startRotation: { min: 0.0, max: 0.0 },
+  startColor: {
+    min: { r: 1.0, g: 1.0, b: 1.0 },
+    max: { r: 1.0, g: 1.0, b: 1.0 },
+  },
+  startOpacity: { min: 1.0, max: 1.0 },
+  gravity: 0.0,
+  simulationSpace: SimulationSpace.LOCAL,
+  maxParticles: 100.0,
+  emission: {
+    rateOverTime: 10.0,
+    rateOverDistance: 0.0,
+  },
+  shape: {
+    shape: Shape.SPHERE,
+    sphere: {
+      radius: 1.0,
+      radiusThickness: 1.0,
+      arc: 360.0,
+    },
+    cone: {
+      angle: 25.0,
+      radius: 1.0,
+      radiusThickness: 1.0,
+      arc: 360.0,
+    },
+    circle: {
+      radius: 1.0,
+      radiusThickness: 1.0,
+      arc: 360.0,
+    },
+    rectangle: {
+      rotation: { x: 0.0, y: 0.0 }, // TODO: add z rotation
+      scale: { x: 1.0, y: 1.0 },
+    },
+  },
+  map: null,
+  sizeOverLifetime: {
+    isActive: false,
+    curveFunction: CurveFunction.LINEAR,
+  },
+  /* colorOverLifetime: {
+    isActive: false,
+    curveFunction: CurveFunction.LINEAR,
+  }, */
+  opacityOverLifetime: {
+    isActive: false,
+    curveFunction: CurveFunction.LINEAR,
+  },
+  textureSheetAnimation: {
+    tiles: new THREE.Vector2(1.0, 1.0),
+    timeMode: TimeMode.LIFETIME,
+    fps: 10.0,
+    startFrame: { min: 0.0, max: 0.0 },
+  },
 };
 
 const createFloat32Attributes = ({
@@ -53,7 +129,7 @@ const createFloat32Attributes = ({
 };
 
 const calculatePositionAndVelocity = (
-  { shape, sphere, cone, circle },
+  { shape, sphere, cone, circle, rectangle },
   startSpeed,
   position,
   velocity
@@ -85,79 +161,57 @@ const calculatePositionAndVelocity = (
         circle
       );
       break;
+
+    case Shape.RECTANGLE:
+      calculateRandomPositionAndVelocityOnRectangle(
+        position,
+        velocity,
+        startSpeed,
+        rectangle
+      );
+      break;
   }
 };
 
-export const createParticleSystem = ({
-  duration = 5.0,
-  looping = true,
-  startDelay = { min: 0.0, max: 0.0 },
-  startLifeTime = { min: 5.0, max: 5.0 },
-  startSpeed = { min: 5.0, max: 5.0 },
-  startSize = { min: 1.0, max: 1.0 },
-  startRotation = { min: 0.0, max: 0.0 },
-  startColor = {
-    min: { r: 1.0, g: 1.0, b: 1.0 },
-    max: { r: 1.0, g: 1.0, b: 1.0 },
-  },
-  startOpacity = { min: 1.0, max: 1.0 },
-  gravity = 0.0,
-  simulationSpace = SimulationSpace.LOCAL,
-  maxParticles = 100,
-  emission = {
-    rateOverTime: 10.0,
-    rateOverDistance: 0.0,
-  },
-  shape,
-  map,
-  onUpdate = null,
-  onComplete = null,
-  textureSheetAnimation = defaultTextureSheetAnimation,
-}) => {
+export const createParticleSystem = (
+  config = DEFAULT_PARTICLE_SYSTEM_CONFIG
+) => {
   const now = Date.now();
-  const lastWorldPosition = new THREE.Vector3(-99999, -99999, -99999);
-  const worldPositionChange = new THREE.Vector3();
-  const generalData = { distanceFromLastEmitByDistance: 0 };
-
-  const normalizedStartDelay = { min: 0.0, max: 0.0, ...startDelay };
-  const normalizedStartLifeTime = { min: 5.0, max: 5.0, ...startLifeTime };
-  const normalizedStartSpeed = { min: 5.0, max: 5.0, ...startSpeed };
-  const normalizedStartSize = { min: 1.0, max: 1.0, ...startSize };
-  const normalizedStartRotation = { min: 0.0, max: 0.0, ...startRotation };
-  const normalizedStartColor = {
-    min: { r: 1.0, g: 1.0, b: 1.0, ...startColor.min },
-    max: { r: 1.0, g: 1.0, b: 1.0, ...startColor.max },
-  };
-  const normalizedStartOpacity = { min: 0.0, max: 0.0, ...startOpacity };
-  const normalizedEmission = {
-    rateOverTime: 10.0,
-    rateOverDistance: 0.0,
-    ...emission,
-  };
-  const normalizedShape = {
-    shape: Shape.SPHERE,
-    sphere: {
-      radius: 1.0,
-      radiusThickness: 1.0,
-      arc: 360.0,
-      ...shape.sphere,
-    },
-    cone: {
-      angle: 25,
-      radius: 1.0,
-      radiusThickness: 1.0,
-      arc: 360.0,
-      ...shape.cone,
-    },
-    circle: {
-      radius: 1.0,
-      radiusThickness: 1.0,
-      arc: 360.0,
-      ...shape.circle,
-    },
-    ...shape,
+  const generalData = {
+    distanceFromLastEmitByDistance: 0,
+    lastWorldPosition: new THREE.Vector3(-99999),
+    currentWorldPosition: new THREE.Vector3(-99999),
+    worldPositionChange: new THREE.Vector3(),
+    worldQuaternion: new THREE.Quaternion(),
+    lastWorldQuaternion: new THREE.Quaternion(-99999),
+    worldEuler: new THREE.Euler(),
+    gravityVelocity: new THREE.Vector3(0, 0, 0),
+    startValues: {},
   };
 
+  const normalizedConfig = patchObject(DEFAULT_PARTICLE_SYSTEM_CONFIG, config);
+  const {
+    transform,
+    duration,
+    looping,
+    startDelay,
+    startLifetime,
+    startSpeed,
+    startSize,
+    startRotation,
+    startColor,
+    startOpacity,
+    gravity,
+    simulationSpace,
+    maxParticles,
+    emission,
+    shape,
+    map,
+    onUpdate,
+    onComplete,
+    textureSheetAnimation,
+  } = normalizedConfig;
+
   const startPositions = Array.from(
     { length: maxParticles },
     () => new THREE.Vector3()
@@ -167,21 +221,15 @@ export const createParticleSystem = ({
     () => new THREE.Vector3()
   );
 
-  const rawUniforms = {
-    ...defaultTextureSheetAnimation,
-    ...textureSheetAnimation,
-  };
-  rawUniforms.tiles = rawUniforms.tiles
-    ? rawUniforms.tiles
-    : defaultTextureSheetAnimation.tiles;
-
-  const uniforms = Object.keys(rawUniforms).reduce(
-    (prev, key) => ({
-      ...prev,
-      [key]: { value: rawUniforms[key] },
-    }),
-    {}
-  );
+  const startValueKeys = ["startSize", "startOpacity"];
+  startValueKeys.forEach((key) => {
+    generalData.startValues[key] = Array.from({ length: maxParticles }, () =>
+      THREE.MathUtils.randFloat(
+        normalizedConfig[key].min,
+        normalizedConfig[key].max
+      )
+    );
+  });
 
   const material = new THREE.ShaderMaterial({
     uniforms: {
@@ -191,7 +239,15 @@ export const createParticleSystem = ({
       map: {
         value: map,
       },
-      ...uniforms,
+      tiles: {
+        value: textureSheetAnimation.tiles,
+      },
+      fps: {
+        value: textureSheetAnimation.fps,
+      },
+      useFPSForFrameIndex: {
+        value: textureSheetAnimation.timeMode === TimeMode.FPS,
+      },
     },
     vertexShader: ParticleSystemVertexShader,
     fragmentShader: ParticleSystemFragmentShader,
@@ -205,8 +261,8 @@ export const createParticleSystem = ({
 
   for (let i = 0; i < maxParticles; i++)
     calculatePositionAndVelocity(
-      normalizedShape,
-      normalizedStartSpeed,
+      shape,
+      startSpeed,
       startPositions[i],
       velocities[i]
     );
@@ -228,39 +284,29 @@ export const createParticleSystem = ({
 
   createFloat32AttributesRequest("isActive", false);
   createFloat32AttributesRequest("creationTime", 0);
-  createFloat32AttributesRequest("lifeTime", 0);
-  createFloat32AttributesRequest("startLifeTime", () =>
-    THREE.MathUtils.randFloat(
-      normalizedStartLifeTime.min,
-      normalizedStartLifeTime.max
+  createFloat32AttributesRequest("lifetime", 0);
+  createFloat32AttributesRequest("startLifetime", () =>
+    THREE.MathUtils.randFloat(startLifetime.min, startLifetime.max)
+  );
+  createFloat32AttributesRequest("startFrame", () =>
+    THREE.MathUtils.randInt(
+      textureSheetAnimation.startFrame.min,
+      textureSheetAnimation.startFrame.max
     )
   );
 
   createFloat32AttributesRequest("opacity", 0);
 
-  createFloat32Attributes({
-    geometry,
-    propertyName: "rotation",
-    maxParticles,
-    factory: () =>
-      THREE.Math.degToRad(
-        THREE.MathUtils.randFloat(
-          normalizedStartRotation.min,
-          normalizedStartRotation.max
-        )
-      ),
-  });
+  createFloat32AttributesRequest("rotation", () =>
+    THREE.Math.degToRad(
+      THREE.MathUtils.randFloat(startRotation.min, startRotation.max)
+    )
+  );
 
-  createFloat32Attributes({
-    geometry,
-    propertyName: "startSize",
-    maxParticles,
-    factory: () =>
-      THREE.MathUtils.randFloat(
-        normalizedStartSize.min,
-        normalizedStartSize.max
-      ),
-  });
+  createFloat32AttributesRequest(
+    "size",
+    (_, index) => generalData.startValues.startSize[index]
+  );
 
   createFloat32AttributesRequest("rotation", 0);
 
@@ -268,30 +314,25 @@ export const createParticleSystem = ({
   createFloat32AttributesRequest(
     "colorR",
     () =>
-      normalizedStartColor.min.r +
-      colorRandomRatio *
-        (normalizedStartColor.max.r - normalizedStartColor.min.r)
+      startColor.min.r +
+      colorRandomRatio * (startColor.max.r - startColor.min.r)
   );
   createFloat32AttributesRequest(
     "colorG",
     () =>
-      normalizedStartColor.min.g +
-      colorRandomRatio *
-        (normalizedStartColor.max.g - normalizedStartColor.min.g)
+      startColor.min.g +
+      colorRandomRatio * (startColor.max.g - startColor.min.g)
   );
   createFloat32AttributesRequest(
     "colorB",
     () =>
-      normalizedStartColor.min.b +
-      colorRandomRatio *
-        (normalizedStartColor.max.b - normalizedStartColor.min.b)
+      startColor.min.b +
+      colorRandomRatio * (startColor.max.b - startColor.min.b)
   );
   createFloat32AttributesRequest("colorA", 0);
 
   const deactivateParticle = (particleIndex) => {
     geometry.attributes.isActive.array[particleIndex] = false;
-    geometry.attributes.lifeTime.array[particleIndex] = 0;
-    geometry.attributes.lifeTime.needsUpdate = true;
     geometry.attributes.colorA.array[particleIndex] = 0;
     geometry.attributes.colorA.needsUpdate = true;
   };
@@ -304,54 +345,46 @@ export const createParticleSystem = ({
     const colorRandomRatio = Math.random();
 
     geometry.attributes.colorR.array[particleIndex] =
-      normalizedStartColor.min.r +
-      colorRandomRatio *
-        (normalizedStartColor.max.r - normalizedStartColor.min.r);
+      startColor.min.r +
+      colorRandomRatio * (startColor.max.r - startColor.min.r);
     geometry.attributes.colorR.needsUpdate = true;
 
     geometry.attributes.colorG.array[particleIndex] =
-      normalizedStartColor.min.g +
-      colorRandomRatio *
-        (normalizedStartColor.max.g - normalizedStartColor.min.g);
+      startColor.min.g +
+      colorRandomRatio * (startColor.max.g - startColor.min.g);
     geometry.attributes.colorG.needsUpdate = true;
 
     geometry.attributes.colorB.array[particleIndex] =
-      normalizedStartColor.min.b +
-      colorRandomRatio *
-        (normalizedStartColor.max.b - normalizedStartColor.min.b);
+      startColor.min.b +
+      colorRandomRatio * (startColor.max.b - startColor.min.b);
     geometry.attributes.colorB.needsUpdate = true;
 
-    geometry.attributes.colorA.array[particleIndex] = THREE.MathUtils.randFloat(
-      normalizedStartOpacity.min,
-      normalizedStartOpacity.max
-    );
-    geometry.attributes.colorA.needsUpdate = true;
+    geometry.attributes.startFrame.array[particleIndex] =
+      THREE.MathUtils.randInt(
+        textureSheetAnimation.startFrame.min,
+        textureSheetAnimation.startFrame.max
+      );
+    geometry.attributes.startFrame.needsUpdate = true;
 
-    geometry.attributes.startLifeTime.array[particleIndex] =
-      THREE.MathUtils.randFloat(
-        normalizedStartLifeTime.min,
-        normalizedStartLifeTime.max
-      ) * 1000;
-    geometry.attributes.startLifeTime.needsUpdate = true;
+    geometry.attributes.startLifetime.array[particleIndex] =
+      THREE.MathUtils.randFloat(startLifetime.min, startLifetime.max) * 1000;
+    geometry.attributes.startLifetime.needsUpdate = true;
 
-    geometry.attributes.startSize.array[particleIndex] =
-      THREE.MathUtils.randFloat(
-        normalizedStartSize.min,
-        normalizedStartSize.max
-      );
-    geometry.attributes.startSize.needsUpdate = true;
+    generalData.startValues.startSize[particleIndex] =
+      THREE.MathUtils.randFloat(startSize.min, startSize.max);
+    generalData.startValues.startOpacity[particleIndex] =
+      THREE.MathUtils.randFloat(startOpacity.min, startOpacity.max);
 
     geometry.attributes.rotation.array[particleIndex] = THREE.Math.degToRad(
-      THREE.MathUtils.randFloat(
-        normalizedStartRotation.min,
-        normalizedStartRotation.max
-      )
+      THREE.MathUtils.randFloat(startRotation.min, startRotation.max)
     );
+
     geometry.attributes.rotation.needsUpdate = true;
+    geometry.attributes.colorB.needsUpdate = true;
 
     calculatePositionAndVelocity(
-      normalizedShape,
-      normalizedStartSpeed,
+      shape,
+      startSpeed,
       startPositions[particleIndex],
       velocities[particleIndex]
     );
@@ -364,26 +397,34 @@ export const createParticleSystem = ({
       startPositions[particleIndex].z;
     particleSystem.geometry.attributes.position.needsUpdate = true;
 
-    geometry.attributes.lifeTime.array[particleIndex] = 0;
-    geometry.attributes.lifeTime.needsUpdate = true;
+    geometry.attributes.lifetime.array[particleIndex] = 0;
+    geometry.attributes.lifetime.needsUpdate = true;
+
+    applyModifiers({
+      startValues: generalData.startValues,
+      normalizedConfig,
+      attributes: particleSystem.geometry.attributes,
+      particleLifetimePercentage: 0,
+      particleIndex,
+      forceUpdate: true,
+    });
   };
 
   const particleSystem = new THREE.Points(geometry, material);
   particleSystem.sortParticles = true;
 
+  particleSystem.position.copy(transform.position);
+  particleSystem.rotation.x = THREE.Math.degToRad(transform.rotation.x);
+  particleSystem.rotation.y = THREE.Math.degToRad(transform.rotation.y);
+  particleSystem.rotation.z = THREE.Math.degToRad(transform.rotation.z);
+  particleSystem.scale.copy(transform.scale);
+
   const calculatedCreationTime =
-    now +
-    THREE.MathUtils.randFloat(
-      normalizedStartDelay.min,
-      normalizedStartDelay.max
-    ) *
-      1000;
+    now + THREE.MathUtils.randFloat(startDelay.min, startDelay.max) * 1000;
 
   createdParticleSystems.push({
     particleSystem,
     generalData,
-    lastWorldPosition,
-    worldPositionChange,
     onUpdate,
     onComplete,
     creationTime: calculatedCreationTime,
@@ -392,7 +433,8 @@ export const createParticleSystem = ({
     looping,
     simulationSpace,
     gravity,
-    emission: normalizedEmission,
+    emission,
+    normalizedConfig,
     iterationCount: 0,
     velocities,
     deactivateParticle,
@@ -412,14 +454,11 @@ export const destroyParticleSystem = (particleSystem) => {
   particleSystem.parent.remove(particleSystem);
 };
 
-export const updateParticleSystems = ({ delta, elapsed }) => {
-  const now = Date.now();
+export const updateParticleSystems = ({ now, delta, elapsed }) => {
   createdParticleSystems.forEach((props) => {
     const {
       onUpdate,
       generalData,
-      lastWorldPosition,
-      worldPositionChange,
       onComplete,
       particleSystem,
       creationTime,
@@ -427,6 +466,7 @@ export const updateParticleSystems = ({ delta, elapsed }) => {
       duration,
       looping,
       emission,
+      normalizedConfig,
       iterationCount,
       velocities,
       deactivateParticle,
@@ -434,34 +474,65 @@ export const updateParticleSystems = ({ delta, elapsed }) => {
       simulationSpace,
       gravity,
     } = props;
-    const lifeTime = now - creationTime;
+
+    const {
+      lastWorldPosition,
+      currentWorldPosition,
+      worldPositionChange,
+      lastWorldQuaternion,
+      worldQuaternion,
+      worldEuler,
+      gravityVelocity,
+    } = generalData;
+
+    const lifetime = now - creationTime;
     particleSystem.material.uniforms.elapsed.value = elapsed;
 
-    if (
-      lastWorldPosition.x !== -99999 &&
-      lastWorldPosition.y !== -99999 &&
-      lastWorldPosition.z !== -99999
-    )
+    particleSystem.getWorldPosition(currentWorldPosition);
+    if (lastWorldPosition.x !== -99999)
       worldPositionChange.set(
-        particleSystem.position.x - lastWorldPosition.x,
-        particleSystem.position.y - lastWorldPosition.y,
-        particleSystem.position.z - lastWorldPosition.z
+        currentWorldPosition.x - lastWorldPosition.x,
+        currentWorldPosition.y - lastWorldPosition.y,
+        currentWorldPosition.z - lastWorldPosition.z
       );
     generalData.distanceFromLastEmitByDistance += worldPositionChange.length();
-    lastWorldPosition.copy(particleSystem.position);
+    particleSystem.getWorldPosition(lastWorldPosition);
+
+    particleSystem.getWorldQuaternion(worldQuaternion);
+    if (
+      lastWorldQuaternion.x === -99999 ||
+      lastWorldQuaternion.x != worldQuaternion.x ||
+      lastWorldQuaternion.y != worldQuaternion.y ||
+      lastWorldQuaternion.z != worldQuaternion.z
+    ) {
+      worldEuler.setFromQuaternion(worldQuaternion);
+      lastWorldQuaternion.copy(worldQuaternion);
+
+      const tempPosX = particleSystem.position.x;
+      const tempPosY = particleSystem.position.y;
+      const tempPosZ = particleSystem.position.z;
+      gravityVelocity.set(0, gravity, 0);
+      particleSystem.position.set(0, 0, 0);
+      particleSystem.updateMatrixWorld();
+      particleSystem.worldToLocal(gravityVelocity);
+      particleSystem.position.set(tempPosX, tempPosY, tempPosZ);
+      particleSystem.updateMatrixWorld();
+    }
 
     particleSystem.geometry.attributes.creationTime.array.forEach(
       (entry, index) => {
         if (particleSystem.geometry.attributes.isActive.array[index]) {
-          const particleLifeTime = now - float32Helper - entry;
+          const particleLifetime = now - float32Helper - entry;
           if (
-            particleLifeTime >
-            particleSystem.geometry.attributes.startLifeTime.array[index]
+            particleLifetime >
+            particleSystem.geometry.attributes.startLifetime.array[index]
           )
             deactivateParticle(index);
           else {
             const velocity = velocities[index];
-            velocity.y -= gravity;
+            velocity.x -= gravityVelocity.x;
+            velocity.y -= gravityVelocity.y;
+            velocity.z -= gravityVelocity.z;
 
             if (
               gravity !== 0 ||
@@ -483,22 +554,26 @@ export const updateParticleSystems = ({ delta, elapsed }) => {
               particleSystem.geometry.attributes.position.needsUpdate = true;
             }
 
-            particleSystem.geometry.attributes.lifeTime.array[index] =
-              particleLifeTime;
-            particleSystem.geometry.attributes.lifeTime.needsUpdate = true;
-
-            // TEMP
-            particleSystem.geometry.attributes.colorA.array[index] =
-              1 -
-              particleLifeTime /
-                particleSystem.geometry.attributes.startLifeTime.array[index];
-            particleSystem.geometry.attributes.colorA.needsUpdate = true;
+            particleSystem.geometry.attributes.lifetime.array[index] =
+              particleLifetime;
+            particleSystem.geometry.attributes.lifetime.needsUpdate = true;
+
+            const particleLifetimePercentage =
+              particleLifetime /
+              particleSystem.geometry.attributes.startLifetime.array[index];
+            applyModifiers({
+              startValues: generalData.startValues,
+              normalizedConfig,
+              attributes: particleSystem.geometry.attributes,
+              particleLifetimePercentage,
+              particleIndex: index,
+            });
           }
         }
       }
     );
 
-    if (looping || lifeTime < duration * 1000) {
+    if (looping || lifetime < duration * 1000) {
       const emissionDelta = now - lastEmissionTime;
       const neededParticlesByTime = Math.floor(
         emission.rateOverTime * (emissionDelta / 1000)
@@ -546,7 +621,7 @@ export const updateParticleSystems = ({ delta, elapsed }) => {
           particleSystem,
           delta,
           elapsed,
-          lifeTime,
+          lifetime,
           iterationCount: iterationCount + 1,
         });
     } else if (onComplete)