roavatar-renderer 1.8.1 → 1.9.1

package/dist/index.d.ts

@@ -72,6 +72,11 @@ export declare class AccessoryWrapper extends InstanceWrapper {
     static requiredProperties: string[];
     setup(): void;
     created(): void;
+    /**
+     *
+     * @returns [bodyAttachment, handleAttachment] or undefined
+     */
+    getBodyAccessoryAttachmentPair(): [Instance, Instance] | undefined;
     AccessoryBuildWeld(): void;
 }
 
@@ -431,6 +436,7 @@ export declare class Assembly {
     rootNode: AssemblyNode;
     allNodes: AssemblyNode[] | undefined;
     allConnectors: Instance[] | undefined;
+    linearVelocity: Vector3;
     constructor(rootPart: Instance);
     getNodeDescendants(): AssemblyNode[];
     getPartDescendants(): Instance[];
@@ -1655,6 +1661,8 @@ export declare const FLAGS: {
      * @deprecated This can now be set per-scene
      * */
     PARTICLES_START_FULL_FRAMERATE: number;
+    /**amount of segments a trail can create per second */
+    TRAIL_FPS: number;
     /**shows ThreeJS SkeletonHelper */
     SHOW_SKELETON_HELPER: boolean;
     /**if set the skeleton helper will only show if the instance has the name */
@@ -1891,7 +1899,7 @@ export declare function getOffsetArray(inner: FileMesh, outer: FileMesh): ([Vec3
 
 export declare function getOriginalAttachmentOrientation(attachment: Instance): Vector3;
 
-export declare function getOriginalAttachmentPosition(attachment: Instance): Vector3;
+export declare function getOriginalAttachmentPosition(attachment: Instance, currentScale: Vector3): Vector3;
 
 export declare function getOriginalSize(part: Instance): Vector3;
 
@@ -2732,7 +2740,16 @@ export declare class ModelWrapper extends InstanceWrapper {
 /**
  * @category InstanceWrapper
  */
-export declare class Motor6DWrapper extends JointInstanceWrapper {
+export declare class Motor6DWrapper extends MotorWrapper {
+    static className: string;
+    static requiredProperties: string[];
+    setup(): void;
+}
+
+/**
+ * @category InstanceWrapper
+ */
+declare class MotorWrapper extends JointInstanceWrapper {
     static className: string;
     static requiredProperties: string[];
     setup(): void;
@@ -3103,6 +3120,8 @@ export declare class OutfitRenderer {
     doCameraUpdateOnLoad: boolean; /**Makes camera update when new avatar has loaded */
     doCameraUpdate: boolean; /**Does camera update every frame */
     doAddInstance: boolean; /**If outfitRenderer should call RBXRenderer.addInstance(), setting this to false will make OutfitRenderer return success early */
+    doMoveLoose: boolean; /**If outfitRenderer should call this.moveLoose() when certain animations are playing */
+    affectsLinearVelocity: boolean; /**If outfitRenderer should set the AssemblyLinearVelocity every animateOnce */
     forceAnimationLoop: boolean; /**If future loaded animations should be set to loop */
     backgroundRenderer: BackgroundRenderer;
     currentlyChangingRig: boolean;
@@ -3177,10 +3196,12 @@ export declare class OutfitRenderer {
      * Starts updating the animation of the outfit per frame
      */
     startAnimating(): void;
+    /**Animates moveLoose */
+    animateMoveLoose(deltaTime: number): void;
     /**
      * Updates the animation once
      */
-    animateOnce(deltaTimeOverride?: number): void;
+    animateOnce(deltaTimeOverride?: number, forceTime?: number, forceKeyframe?: number): void;
     /**
      * Stops updating the animation of the outfit per frame
      */
@@ -3208,6 +3229,10 @@ export declare class OutfitRenderer {
      * Updates rendered particles so they face the camera without simulating them (usually used when generating thumbnails)
      */
     updateParticleMatrix(): void;
+    /**
+     * Moves "loose" things such as particles and trails by the Vec3 given, used to simulate character movement without actually moving the character
+     */
+    moveLoose(vec: Vec3): void;
     /**Calls destroy on the rig, stops animating and disconnects connections. The OutfitRenderer should not be interacted with after this */
     destroy(): void;
 }
@@ -3724,6 +3749,7 @@ declare class RenderDesc extends DisposableDesc {
     fromInstance(_child: Instance): void;
     compileResults(_renderer: THREE.WebGLRenderer, _scene: THREE.Scene): Promise<THREE.Object3D[] | Response | undefined>;
     updateResults(): void;
+    moveLoose(_diff: Vec3): void;
     static shouldRenderInstance(_instance: Instance): boolean;
     static register(): void;
     static(): typeof RenderDesc;
@@ -3859,6 +3885,7 @@ export declare class ScriptWrapper extends InstanceWrapper {
     Run(): void;
     SoundPlayer(script: Instance): Promise<void>;
     HatScript20(script: Instance): Promise<void>;
+    TrailTestRoAvatar(script: Instance): Promise<void>;
 }
 
 declare class ScriptWrapperData {

package/dist/index.js

@@ -32629,6 +32629,7 @@ const FLAGS = {
   RENDERER_DELTA_TIME_MULTIPLIER: 1,
   PARTICLES_START_FULL: 0,
   PARTICLES_START_FULL_FRAMERATE: 20,
+  TRAIL_FPS: 30,
   //skeleton
   SHOW_SKELETON_HELPER: false,
   SKELETON_HELPER_INSTANCE_NAME: void 0,
@@ -43930,6 +43931,9 @@ class RenderDesc extends DisposableDesc {
     throw new Error("Virtual method updateResults called");
   }
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  moveLoose(_diff2) {
+  }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
   static shouldRenderInstance(_instance) {
     return true;
   }
@@ -44075,6 +44079,7 @@ class Assembly {
   rootNode;
   allNodes;
   allConnectors;
+  linearVelocity = new Vector3(0, 0, 0);
   constructor(rootPart) {
     const checked = [rootPart];
     let depth = 0;
@@ -44159,8 +44164,12 @@ class AccessoryWrapper extends InstanceWrapper {
       this.AccessoryBuildWeld();
     });
   }
-  AccessoryBuildWeld() {
-    if (this.instance.parent && this.instance.className === "Accessory") {
+  /**
+   * 
+   * @returns [bodyAttachment, handleAttachment] or undefined
+   */
+  getBodyAccessoryAttachmentPair() {
+    if (this.instance.parent) {
       const humanoid = this.instance.parent.FindFirstChildOfClass("Humanoid");
       if (humanoid) {
         const handle = this.instance.FindFirstChild("Handle");
@@ -44179,27 +44188,51 @@ class AccessoryWrapper extends InstanceWrapper {
               }
             }
           }
-          if (!bodyAttachment) {
-            return;
-          }
-          if (!accessoryAttachment) {
-            return;
-          }
+          if (bodyAttachment && accessoryAttachment) return [bodyAttachment, accessoryAttachment];
+        }
+      }
+    }
+  }
+  AccessoryBuildWeld() {
+    if (this.instance.parent && this.instance.className === "Accessory") {
+      const humanoid = this.instance.parent.FindFirstChildOfClass("Humanoid");
+      if (humanoid) {
+        const handle = this.instance.FindFirstChild("Handle");
+        if (handle) {
+          const attachmentPair = this.getBodyAccessoryAttachmentPair();
           const oldAccessoryWeld = handle.FindFirstChild("AccessoryWeld");
           if (oldAccessoryWeld) {
             oldAccessoryWeld.Destroy();
           }
-          const weld = new Instance("Weld");
-          weld.addProperty(new Property("Name", DataType.String), "AccessoryWeld");
-          weld.addProperty(new Property("Archivable", DataType.Bool), true);
-          weld.addProperty(new Property("C1", DataType.CFrame), accessoryAttachment.Property("CFrame").clone());
-          weld.addProperty(new Property("C0", DataType.CFrame), bodyAttachment.Property("CFrame").clone());
-          weld.addProperty(new Property("Part1", DataType.Referent), accessoryAttachment.parent);
-          weld.addProperty(new Property("Part0", DataType.Referent), bodyAttachment.parent);
-          weld.addProperty(new Property("Active", DataType.Bool), true);
-          weld.addProperty(new Property("Enabled", DataType.Bool), false);
-          weld.setParent(handle);
-          weld.setProperty("Enabled", true);
+          if (attachmentPair) {
+            const [bodyAttachment, accessoryAttachment] = attachmentPair;
+            const weld = new Instance("Weld");
+            weld.addProperty(new Property("Name", DataType.String), "AccessoryWeld");
+            weld.addProperty(new Property("Archivable", DataType.Bool), true);
+            weld.addProperty(new Property("C1", DataType.CFrame), accessoryAttachment.Property("CFrame").clone());
+            weld.addProperty(new Property("C0", DataType.CFrame), bodyAttachment.Property("CFrame").clone());
+            weld.addProperty(new Property("Part1", DataType.Referent), accessoryAttachment.parent);
+            weld.addProperty(new Property("Part0", DataType.Referent), bodyAttachment.parent);
+            weld.addProperty(new Property("Active", DataType.Bool), true);
+            weld.addProperty(new Property("Enabled", DataType.Bool), false);
+            weld.setParent(handle);
+            weld.setProperty("Enabled", true);
+          } else {
+            const head = this.instance.parent.FindFirstChild("Head");
+            if (!head) return;
+            const attachmentPoint = this.instance.PropOrDefault("AttachmentPoint", new CFrame());
+            const weld = new Instance("Weld");
+            weld.addProperty(new Property("Name", DataType.String), "AccessoryWeld");
+            weld.addProperty(new Property("Archivable", DataType.Bool), true);
+            weld.addProperty(new Property("C1", DataType.CFrame), attachmentPoint.clone());
+            weld.addProperty(new Property("C0", DataType.CFrame), new CFrame());
+            weld.addProperty(new Property("Part1", DataType.Referent), handle);
+            weld.addProperty(new Property("Part0", DataType.Referent), head);
+            weld.addProperty(new Property("Active", DataType.Bool), true);
+            weld.addProperty(new Property("Enabled", DataType.Bool), false);
+            weld.setParent(handle);
+            weld.setProperty("Enabled", true);
+          }
         }
       }
     }
@@ -44459,9 +44492,9 @@ function getOriginalSize(part) {
   }
   return originalSize;
 }
-function scaleChildrenOfPart(part, scaleVector, scaleAttachment = true) {
+function scaleChildrenOfPart(part, scaleVector, alreadyScaledAttachment) {
   for (const child of part.GetDescendants()) {
-    if (child.className === "Attachment" && scaleAttachment) {
+    if (child.className === "Attachment" && child !== alreadyScaledAttachment) {
       let originalPosition = child.Prop("Position");
       originalPosition = originalPosition.multiply(scaleVector);
       const newCF = child.Prop("CFrame").clone();
@@ -44475,10 +44508,11 @@ function scaleChildrenOfPart(part, scaleVector, scaleAttachment = true) {
     }
   }
 }
-function originalChildrenOfPart(part) {
+function originalChildrenOfPart(part, originalSize, currentSize) {
+  const currentScale = currentSize.divide(originalSize);
   for (const child of part.GetDescendants()) {
     if (child.className === "Attachment") {
-      const originalPosition = getOriginalAttachmentPosition(child);
+      const originalPosition = getOriginalAttachmentPosition(child, currentScale);
       const originalOrientation = getOriginalAttachmentOrientation(child);
       const newCF = child.Prop("CFrame").clone();
       newCF.Position = [originalPosition.X, originalPosition.Y, originalPosition.Z];
@@ -44486,7 +44520,7 @@ function originalChildrenOfPart(part) {
       child.setProperty("CFrame", newCF);
     } else if (child.className === "SpecialMesh") {
       if (child.Prop("MeshType") !== MeshType.Head) {
-        const orignalScale = getOriginalMeshScale(child);
+        const orignalScale = getOriginalMeshScale(child, currentScale);
         child.setProperty("Scale", orignalScale);
       }
     }
@@ -44577,32 +44611,36 @@ function ScaleAccessory(accessory, bodyScaleVector, headScaleVector, bodyTypeSca
   } else {
     warn(false, "Failed to find attached part for accessory:", accessory);
   }
-  originalChildrenOfPart(handle);
   const originalSize = getOriginalSize(handle);
-  let hasAdjusted = false;
+  originalChildrenOfPart(handle, originalSize, handle.Prop("Size"));
+  let hasAdjusted = void 0;
+  let attachmentPair = void 0;
   const accessoryDescs = humanoidDescription.GetChildren();
   for (const accessoryDesc of accessoryDescs) {
     if (accessoryDesc.className === "AccessoryDescription") {
-      if (accessoryDesc.Prop("Instance") === accessory) {
-        const attachment = handle.FindFirstChildOfClass("Attachment");
-        if (attachment) {
-          hasAdjusted = true;
-          adjustAttachment(attachment, accessoryDesc.Prop("Position"), accessoryDesc.Prop("Rotation"), accessoryDesc.Prop("Scale"), resultScale);
+      if (accessoryDesc.Prop("Instance") === accessory && accessory.IsA("Accessory")) {
+        const accessoryW = accessory.w;
+        attachmentPair = accessoryW.getBodyAccessoryAttachmentPair();
+        if (attachmentPair) {
+          const handleAttachment = attachmentPair[1];
+          hasAdjusted = handleAttachment;
+          adjustAttachment(handleAttachment, accessoryDesc.Prop("Position"), accessoryDesc.Prop("Rotation"), accessoryDesc.Prop("Scale"), resultScale);
         }
         const adjustScale = accessoryDesc.Prop("Scale");
         resultScale = resultScale.multiply(adjustScale);
       }
     }
   }
-  scaleChildrenOfPart(handle, resultScale, !hasAdjusted);
+  scaleChildrenOfPart(handle, resultScale, hasAdjusted);
   handle.setProperty("Size", originalSize.multiply(resultScale));
   if (accessory.className === "Accessory") {
     const accessoryWrapper = new AccessoryWrapper(accessory);
     accessoryWrapper.AccessoryBuildWeld();
   }
 }
-function getOriginalMeshScale(mesh) {
+function getOriginalMeshScale(mesh, currentScale) {
   let originalScale = mesh.Prop("Scale");
+  originalScale = originalScale.divide(currentScale);
   const originalScaleValue = mesh.FindFirstChild(originalSizeName);
   if (originalScaleValue) {
     originalScale = originalScaleValue.Prop("Value");
@@ -44614,12 +44652,13 @@ function getOriginalMeshScale(mesh) {
   }
   return originalScale;
 }
-function getOriginalAttachmentPosition(attachment) {
+function getOriginalAttachmentPosition(attachment, currentScale) {
   const originalPosition = attachment.FindFirstChild(originalPositionName);
   if (originalPosition) {
     return originalPosition.Prop("Value");
   }
-  const position = attachment.Prop("Position");
+  let position = attachment.Prop("Position");
+  position = position.divide(currentScale);
   const attachmentLocationValue = new Instance("Vector3Value");
   attachmentLocationValue.addProperty(new Property("Name", DataType.String), originalPositionName);
   attachmentLocationValue.addProperty(new Property("Value", DataType.Vector3), position);
@@ -44640,7 +44679,9 @@ function getOriginalAttachmentOrientation(attachment) {
 }
 function ScaleCharacterPart(part, bodyScaleVector, headScaleVector, anthroPercent, wideToNarrow) {
   const partName = part.Prop("Name");
+  const currentSize = part.Prop("Size");
   const originalSize = getOriginalSize(part);
+  const currentScale = currentSize.divide(originalSize);
   let newScaleVector = bodyScaleVector;
   if (partName == "Head") {
     newScaleVector = headScaleVector;
@@ -44690,7 +44731,7 @@ function ScaleCharacterPart(part, bodyScaleVector, headScaleVector, anthroPercen
       if (mesh.Prop("MeshType") == MeshType.Head) {
         headScale = Vector3.new(1, 1, 1);
       }
-      const originalScale = getOriginalMeshScale(mesh);
+      const originalScale = getOriginalMeshScale(mesh, currentScale);
       if (mesh.Prop("MeshType") !== MeshType.Head) {
         mesh.setProperty("Scale", originalScale.multiply(scale).multiply(headScale));
       }
@@ -44720,7 +44761,7 @@ function ScaleCharacterPart(part, bodyScaleVector, headScaleVector, anthroPercen
   part.setProperty("Size", originalSize.multiply(scale).multiply(newScaleVector));
   for (const child of part.GetDescendants()) {
     if (child.className === "Attachment") {
-      const originalAttachment = getOriginalAttachmentPosition(child);
+      const originalAttachment = getOriginalAttachmentPosition(child, currentScale);
       const ogCF = child.Prop("CFrame").clone();
       const newPos = originalAttachment.multiply(scale).multiply(newScaleVector);
       ogCF.Position = [newPos.X, newPos.Y, newPos.Z];
@@ -48094,7 +48135,7 @@ class BasePartWrapper extends InstanceWrapper {
     return connected;
   }
 }
-const __vite_glob_0_5 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_5$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   BasePartWrapper
 }, Symbol.toStringTag, { value: "Module" }));
@@ -51922,7 +51963,20 @@ const __vite_glob_0_19 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.de
   __proto__: null,
   ModelWrapper
 }, Symbol.toStringTag, { value: "Module" }));
-class Motor6DWrapper extends JointInstanceWrapper {
+class MotorWrapper extends JointInstanceWrapper {
+  static className = "Motor";
+  static requiredProperties = [
+    ...super.requiredProperties
+  ];
+  setup() {
+    super.setup();
+  }
+}
+const __vite_glob_0_20 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  MotorWrapper
+}, Symbol.toStringTag, { value: "Module" }));
+class Motor6DWrapper extends MotorWrapper {
   static className = "Motor6D";
   static requiredProperties = [
     ...super.requiredProperties,
@@ -51933,7 +51987,7 @@ class Motor6DWrapper extends JointInstanceWrapper {
     if (!this.instance.HasProperty("Transform")) this.instance.addProperty(new Property("Transform", DataType.CFrame), new CFrame());
   }
 }
-const __vite_glob_0_20 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_21 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   Motor6DWrapper
 }, Symbol.toStringTag, { value: "Module" }));
@@ -51948,7 +52002,7 @@ class PartWrapper extends BasePartWrapper {
     if (!this.instance.HasProperty("shape")) this.instance.addProperty(new Property("shape", DataType.Enum), PartType.Block);
   }
 }
-const __vite_glob_0_21 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_22 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   PartWrapper
 }, Symbol.toStringTag, { value: "Module" }));
@@ -52417,7 +52471,7 @@ class EmitterDesc extends DisposableDesc {
     const velocityOriginal = new Vector3$1(...velocityFront.toVec3()).multiply(velocityMultiplier);
     const velocityLocal = velocityOriginal.applyQuaternion(groupDesc.getNormalQuaternionForVelocity());
     const worldVelocity = velocityLocal.applyQuaternion(new Quaternion().setFromRotationMatrix(groupDesc.cframe.getTHREEMatrix()));
-    const worldVelocityRoblox = new Vector3(...worldVelocity.toArray());
+    const worldVelocityRoblox = new Vector3(...worldVelocity.toArray()).add(groupDesc.parentVelocity);
     let localPos = groupDesc.getRandomLocalPos();
     localPos = localPos.add(this.offset);
     const worldPos = groupDesc.toWorldSpace(localPos);
@@ -52527,6 +52581,7 @@ class EmitterGroupDesc extends RenderDesc {
   lastCframe = new CFrame();
   cframe = new CFrame();
   emitterDir = NormalId.Top;
+  parentVelocity = new Vector3();
   emitterDescs = [];
   //special for emitter group
   getRandomLocalPos() {
@@ -52626,6 +52681,15 @@ class EmitterGroupDesc extends RenderDesc {
         this.higherBound = size.multiply(new Vector3(0.5, 0.5, 0.5));
         this.lowerBound = size.multiply(new Vector3(-0.5, -0.5, -0.5));
       }
+      let lastParent = parent;
+      while (lastParent) {
+        if (lastParent.IsA("BasePart")) {
+          const assembly = lastParent.w.GetAssembly();
+          this.parentVelocity = assembly.linearVelocity.clone();
+          break;
+        }
+        lastParent = lastParent.parent;
+      }
     }
     this.enabled = child.PropOrDefault("Enabled", true);
     const className = child.className;
@@ -52836,6 +52900,14 @@ class EmitterGroupDesc extends RenderDesc {
     }
     this.lastCframe = this.cframe.clone();
   }
+  moveLoose(vec) {
+    for (const emitterDesc of this.emitterDescs) {
+      if (emitterDesc.lockedToPart) continue;
+      for (const particle of emitterDesc.particles) {
+        particle.position = particle.position.add(new Vector3().fromVec3(vec));
+      }
+    }
+  }
 }
 const __vite_glob_0_2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
@@ -52862,7 +52934,7 @@ class ParticleEmitterWrapper extends InstanceWrapper {
     }
   }
 }
-const __vite_glob_0_22 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_23 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   ParticleEmitterWrapper
 }, Symbol.toStringTag, { value: "Module" }));
@@ -52968,7 +53040,7 @@ class SoundWrapper extends InstanceWrapper {
     }
   }
 }
-const __vite_glob_0_24 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_25 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   SoundWrapper
 }, Symbol.toStringTag, { value: "Module" }));
@@ -52998,6 +53070,9 @@ class ScriptWrapper extends InstanceWrapper {
       case "HatScript2.0":
         this.HatScript20(this.instance);
         break;
+      case "TrailTestRoAvatar":
+        this.TrailTestRoAvatar(this.instance);
+        break;
     }
   }
   //Scripts
@@ -53221,8 +53296,26 @@ class ScriptWrapper extends InstanceWrapper {
       }
     }
   }
+  async TrailTestRoAvatar(script) {
+    await Wait(1);
+    const part = script.parent;
+    if (part) {
+      const ogCF = part.Prop("CFrame").clone();
+      while (true) {
+        if (script.destroyed || this.data.shouldStop) return;
+        const newCF = ogCF.clone();
+        const val = Date.now() / 1e3 % 3 / 3 * 2 * Math.PI;
+        const xAdd = Math.sin(val) * 2;
+        const zAdd = Math.cos(val) * 2;
+        newCF.Position[0] += xAdd;
+        newCF.Position[2] += zAdd;
+        part.setProperty("CFrame", newCF);
+        await Wait(1 / 60);
+      }
+    }
+  }
 }
-const __vite_glob_0_23 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_24 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   ScriptWrapper
 }, Symbol.toStringTag, { value: "Module" }));
@@ -53279,25 +53372,38 @@ class ToolWrapper extends InstanceWrapper {
     }
   }
 }
-const __vite_glob_0_25 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_26 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   ToolWrapper
 }, Symbol.toStringTag, { value: "Module" }));
+class UnionOperationWrapper extends BasePartWrapper {
+  static className = "UnionOperation";
+  static requiredProperties = [
+    ...super.requiredProperties
+  ];
+  setup() {
+    super.setup();
+  }
+}
+const __vite_glob_0_27 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  UnionOperationWrapper
+}, Symbol.toStringTag, { value: "Module" }));
 class WedgePartWrapper extends BasePartWrapper {
   static className = "WedgePart";
 }
-const __vite_glob_0_26 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_28 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   WedgePartWrapper
 }, Symbol.toStringTag, { value: "Module" }));
 class WeldWrapper extends JointInstanceWrapper {
   static className = "Weld";
 }
-const __vite_glob_0_27 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+const __vite_glob_0_29 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   WeldWrapper
 }, Symbol.toStringTag, { value: "Module" }));
-const modules$1 = /* @__PURE__ */ Object.assign({ "./instance/Accessory.ts": __vite_glob_0_0$1, "./instance/AccessoryDescription.ts": __vite_glob_0_1$1, "./instance/AnimationConstraint.ts": __vite_glob_0_2$1, "./instance/Animator.ts": __vite_glob_0_3$1, "./instance/Attachment.ts": __vite_glob_0_4, "./instance/BasePart.ts": __vite_glob_0_5, "./instance/BodyColors.ts": __vite_glob_0_6, "./instance/BodyPartDescription.ts": __vite_glob_0_7, "./instance/Bone.ts": __vite_glob_0_8, "./instance/Camera.ts": __vite_glob_0_9, "./instance/Constraint.ts": __vite_glob_0_10, "./instance/Decal.ts": __vite_glob_0_11, "./instance/FaceControls.ts": __vite_glob_0_12, "./instance/HumanoidDescription.ts": __vite_glob_0_13, "./instance/InstanceWrapper.ts": __vite_glob_0_14, "./instance/JointInstance.ts": __vite_glob_0_15, "./instance/MakeupDescription.ts": __vite_glob_0_16, "./instance/ManualWeld.ts": __vite_glob_0_17, "./instance/MeshPart.ts": __vite_glob_0_18, "./instance/Model.ts": __vite_glob_0_19, "./instance/Motor6D.ts": __vite_glob_0_20, "./instance/Part.ts": __vite_glob_0_21, "./instance/ParticleEmitter.ts": __vite_glob_0_22, "./instance/Script.ts": __vite_glob_0_23, "./instance/Sound.ts": __vite_glob_0_24, "./instance/Tool.ts": __vite_glob_0_25, "./instance/WedgePart.ts": __vite_glob_0_26, "./instance/Weld.ts": __vite_glob_0_27 });
+const modules$1 = /* @__PURE__ */ Object.assign({ "./instance/Accessory.ts": __vite_glob_0_0$1, "./instance/AccessoryDescription.ts": __vite_glob_0_1$1, "./instance/AnimationConstraint.ts": __vite_glob_0_2$1, "./instance/Animator.ts": __vite_glob_0_3$1, "./instance/Attachment.ts": __vite_glob_0_4, "./instance/BasePart.ts": __vite_glob_0_5$1, "./instance/BodyColors.ts": __vite_glob_0_6, "./instance/BodyPartDescription.ts": __vite_glob_0_7, "./instance/Bone.ts": __vite_glob_0_8, "./instance/Camera.ts": __vite_glob_0_9, "./instance/Constraint.ts": __vite_glob_0_10, "./instance/Decal.ts": __vite_glob_0_11, "./instance/FaceControls.ts": __vite_glob_0_12, "./instance/HumanoidDescription.ts": __vite_glob_0_13, "./instance/InstanceWrapper.ts": __vite_glob_0_14, "./instance/JointInstance.ts": __vite_glob_0_15, "./instance/MakeupDescription.ts": __vite_glob_0_16, "./instance/ManualWeld.ts": __vite_glob_0_17, "./instance/MeshPart.ts": __vite_glob_0_18, "./instance/Model.ts": __vite_glob_0_19, "./instance/Motor.ts": __vite_glob_0_20, "./instance/Motor6D.ts": __vite_glob_0_21, "./instance/Part.ts": __vite_glob_0_22, "./instance/ParticleEmitter.ts": __vite_glob_0_23, "./instance/Script.ts": __vite_glob_0_24, "./instance/Sound.ts": __vite_glob_0_25, "./instance/Tool.ts": __vite_glob_0_26, "./instance/UnionOperation.ts": __vite_glob_0_27, "./instance/WedgePart.ts": __vite_glob_0_28, "./instance/Weld.ts": __vite_glob_0_29 });
 function RegisterWrappers() {
   for (const module of Object.values(modules$1)) {
     for (const exprt of Object.values(module)) {
@@ -53745,7 +53851,269 @@ const __vite_glob_0_3 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.def
   __proto__: null,
   LightDesc
 }, Symbol.toStringTag, { value: "Module" }));
-const modules = /* @__PURE__ */ Object.assign({ "./attachmentDesc.ts": __vite_glob_0_0, "./beamDesc.ts": __vite_glob_0_1, "./emitterGroupDesc.ts": __vite_glob_0_2, "./lightDesc.ts": __vite_glob_0_3, "./objectDesc.ts": __vite_glob_0_4$1 });
+class TrailSegment {
+  cframe;
+  length;
+  time = 0;
+  constructor(cf, length) {
+    this.cframe = cf;
+    this.length = length;
+  }
+}
+class TrailDesc extends RenderDesc {
+  static classTypes = ["Trail"];
+  lastTime = Date.now() / 1e3;
+  time = Date.now() / 1e3;
+  segmentTime = 0;
+  enabled = true;
+  lightEmission = 0;
+  //blends between normal -> additive blending, how?? graphics magic
+  lightInfluence = 1;
+  texture;
+  textureLength = 1;
+  textureMode = TextureMode.Stretch;
+  color = ColorSequence.fromColor(new Color3(1, 1, 1));
+  transparency = new NumberSequence([new NumberSequenceKeypoint(0, 0.5), new NumberSequenceKeypoint(1, 0.5)]);
+  widthScale = new NumberSequence([new NumberSequenceKeypoint(0, 1), new NumberSequenceKeypoint(1, 1)]);
+  cframe0 = new CFrame();
+  cframe1 = new CFrame();
+  lifetime = 1;
+  maxLength = 0;
+  minLength = 0.1;
+  faceCamera = false;
+  //results
+  results = [];
+  segments = [];
+  get maxSegments() {
+    const maxLength = this.maxLength === 0 ? 9999 : this.maxLength;
+    return Math.ceil(Math.min(this.lifetime * FLAGS.TRAIL_FPS, maxLength / this.minLength)) + 2;
+  }
+  isSame(newDesc) {
+    return this.time === newDesc.time && this.enabled === newDesc.enabled && this.lightEmission === newDesc.lightEmission && this.lightInfluence === newDesc.lightInfluence && this.texture === newDesc.texture && this.textureLength === newDesc.textureLength && this.textureMode === newDesc.textureMode && this.color.isSame(newDesc.color) && this.transparency.isSame(newDesc.transparency) && this.widthScale.isSame(newDesc.widthScale) && this.cframe0.isSame(newDesc.cframe0) && this.cframe1.isSame(newDesc.cframe1) && this.faceCamera === newDesc.faceCamera && this.lifetime === newDesc.lifetime && this.maxLength === newDesc.maxLength && this.minLength === newDesc.minLength;
+  }
+  needsRegeneration(newDesc) {
+    return this.enabled !== newDesc.enabled || this.texture !== newDesc.texture || this.lifetime !== newDesc.lifetime;
+  }
+  virtualFromRenderDesc(newDesc) {
+    this.time = newDesc.time;
+    this.lightEmission = newDesc.lightEmission;
+    this.lightInfluence = newDesc.lightInfluence;
+    this.textureLength = newDesc.textureLength;
+    this.textureMode = newDesc.textureMode;
+    this.color = newDesc.color.clone();
+    this.transparency = newDesc.transparency.clone();
+    this.widthScale = newDesc.widthScale.clone();
+    this.cframe0 = newDesc.cframe0.clone();
+    this.cframe1 = newDesc.cframe1.clone();
+    this.lifetime = newDesc.lifetime;
+    this.maxLength = newDesc.maxLength;
+    this.minLength = newDesc.minLength;
+    this.faceCamera = newDesc.faceCamera;
+  }
+  virtualTransferFrom(oldDesc) {
+    this.segmentTime = oldDesc.segmentTime;
+    this.segments = oldDesc.segments;
+  }
+  fromInstance(child) {
+    this.enabled = child.PropOrDefault("Enabled", this.enabled);
+    this.lightEmission = child.PropOrDefault("LightEmission", this.lightEmission);
+    this.lightInfluence = child.PropOrDefault("LightInfluence", this.lightInfluence);
+    this.texture = child.PropOrDefault("Texture", this.texture);
+    if (!this.texture) {
+      const textureContent = child.PropOrDefault("TextureContent", void 0);
+      if (textureContent) {
+        this.texture = textureContent.uri;
+      }
+    }
+    this.textureLength = child.PropOrDefault("TextureLength", this.textureLength);
+    this.textureMode = child.PropOrDefault("TextureMode", this.textureMode);
+    this.color = child.PropOrDefault("Color", this.color);
+    this.transparency = child.PropOrDefault("Transparency", this.transparency);
+    this.widthScale = child.PropOrDefault("WidthScale", this.widthScale);
+    const att0 = child.PropOrDefault("Attachment0", void 0);
+    if (att0 && att0.IsA("Attachment")) {
+      const att0W = att0.w;
+      this.cframe0 = att0W.getWorldCFrame();
+    }
+    const att1 = child.PropOrDefault("Attachment1", void 0);
+    if (att1 && att1.IsA("Attachment")) {
+      const att1W = att1.w;
+      this.cframe1 = att1W.getWorldCFrame();
+    }
+    this.lifetime = child.PropOrDefault("Lifetime", this.lifetime);
+    this.maxLength = child.PropOrDefault("MaxLength", this.maxLength);
+    this.minLength = child.PropOrDefault("MinLength", this.minLength);
+    this.faceCamera = child.PropOrDefault("FaceCamera", this.faceCamera);
+    if (!FLAGS.BEAMS_ENABLED) this.enabled = false;
+  }
+  async compileResults(renderer, scene) {
+    const originalResults = this.results;
+    this.results = [];
+    if (this.enabled) {
+      let textureResult = void 0;
+      if (this.texture) {
+        textureResult = await getTexture(this.texture);
+        if (textureResult) {
+          textureResult.wrapT = RepeatWrapping;
+        }
+      }
+      const material = new MeshBasicMaterial({
+        side: DoubleSide,
+        map: textureResult,
+        vertexColors: true,
+        transparent: true,
+        depthWrite: false
+      });
+      const geometry = new PlaneGeometry(1, 1, this.maxSegments, 1);
+      const colorValues = new Float32Array((this.maxSegments + 1) * 2 * 4).fill(1);
+      geometry.setAttribute("color", new BufferAttribute(colorValues, 4));
+      const mesh = new Mesh(geometry, material);
+      mesh.frustumCulled = false;
+      mesh.name = this.instance ? this.instance.PropOrDefault("Name", "Unknown") + "_Trail" : "Unknown_Trail";
+      this.results.push(mesh);
+    }
+    if (originalResults) {
+      this.disposeMeshes(scene, originalResults);
+      this.disposeRenderLists(renderer);
+    }
+    this.updateResults();
+    return this.results;
+  }
+  calculateSegmentCFrame() {
+    let newCF = lerpCFrame(this.cframe0, this.cframe1, 0.5);
+    newCF = CFrame.lookAt(newCF.Position, this.cframe0.Position);
+    return newCF;
+  }
+  addSegment() {
+    const newCF = this.calculateSegmentCFrame();
+    const newLength = distance(this.cframe0.Position, this.cframe1.Position);
+    const lastSegment = this.segments[0];
+    if (lastSegment) {
+      const lastSegmentDistance = distance(lastSegment.cframe.Position, newCF.Position);
+      if (lastSegmentDistance <= this.minLength) {
+        return;
+      }
+    }
+    const newSegment = new TrailSegment(newCF, newLength);
+    newSegment.time = this.segmentTime;
+    this.segments.unshift(newSegment);
+  }
+  getSegmentCFrame(i) {
+    if (i <= 0) {
+      return this.calculateSegmentCFrame();
+    } else {
+      const segment = this.segments[specialClamp(i - 1, 0, this.segments.length - 1)];
+      if (segment) {
+        return segment.cframe;
+      } else {
+        return this.calculateSegmentCFrame();
+      }
+    }
+  }
+  getSegmentLength(i) {
+    if (i <= 0) {
+      return distance(this.cframe0.Position, this.cframe1.Position);
+    } else {
+      const segment = this.segments[specialClamp(i - 1, 0, this.segments.length - 1)];
+      if (segment) {
+        return segment.length;
+      } else {
+        return 0;
+      }
+    }
+  }
+  getSegmentTime(i) {
+    if (i <= 0) {
+      return this.segmentTime;
+    } else {
+      const segment = this.segments[specialClamp(i - 1, 0, this.segments.length - 1)];
+      if (segment) {
+        return segment.time;
+      } else {
+        return this.segmentTime;
+      }
+    }
+  }
+  updateResults() {
+    if (!this.results) return;
+    const deltaTime = this.time - this.lastTime;
+    this.segmentTime += deltaTime;
+    const requiredSegmentTime = 1 / FLAGS.TRAIL_FPS;
+    for (const segment of this.segments) {
+      segment.time += deltaTime;
+    }
+    let lastSegmentCF = void 0;
+    for (let i = 0; i < this.segments.length; i++) {
+      let totalLength = 0;
+      const segment = this.segments[i];
+      if (segment.time >= this.lifetime || totalLength > this.maxLength) {
+        this.segments.splice(i, this.segments.length - i);
+        break;
+      }
+      if (lastSegmentCF) {
+        const diff = distance(lastSegmentCF.Position, segment.cframe.Position);
+        totalLength += diff;
+      }
+      lastSegmentCF = segment.cframe;
+    }
+    if (this.segmentTime >= requiredSegmentTime) {
+      this.addSegment();
+      this.segmentTime = 0;
+    }
+    for (const result of this.results) {
+      const resultMaterial = result.material;
+      const resultGeometry = result.geometry;
+      resultMaterial.blending = this.lightEmission > 0.5 ? AdditiveBlending : NormalBlending;
+      const positions = resultGeometry.getAttribute("position");
+      for (let i = 0; i < positions.count; i++) {
+        const index = Math.floor(i % (positions.count / 2));
+        const segmentLength = this.getSegmentLength(index);
+        const segmentCF = this.getSegmentCFrame(index);
+        const normSide = i < positions.count / 2 ? 0.5 : -0.5;
+        const t = this.getSegmentTime(index) / this.lifetime;
+        const side = normSide * segmentLength * this.widthScale.getValue(t, 0);
+        const sideCF = segmentCF.multiply(new CFrame(0, 0, side));
+        positions.setXYZ(i, ...sideCF.Position);
+      }
+      const colors = resultGeometry.getAttribute("color");
+      for (let i = 0; i < colors.count; i++) {
+        const index = Math.floor(i % (positions.count / 2));
+        const t = this.getSegmentTime(index) / this.lifetime;
+        const colorValue = this.color.getValue(t);
+        const transparencyValue = this.transparency.getValue(t, 0);
+        const mult = 1 + this.lightEmission;
+        colors.setXYZW(i, colorValue.R * mult, colorValue.G * mult, colorValue.B * mult, 1 - transparencyValue);
+      }
+      const uvs = resultGeometry.getAttribute("uv");
+      for (let i = 0; i < uvs.count; i++) {
+        const index = Math.floor(i % (positions.count / 2));
+        const t = index / this.segments.length;
+        const normSide = i < positions.count / 2 ? 1 : 0;
+        uvs.setXY(i, normSide, (1 - t) * this.textureLength);
+      }
+      positions.needsUpdate = true;
+      colors.needsUpdate = true;
+      uvs.needsUpdate = true;
+    }
+    this.lastTime = this.time;
+  }
+  moveLoose(vec) {
+    for (const segment of this.segments) {
+      segment.cframe.Position = add(segment.cframe.Position, vec);
+    }
+  }
+  dispose(_renderer, scene) {
+    if (!this.results) return;
+    for (const result of this.results) {
+      scene.remove(result);
+    }
+  }
+}
+const __vite_glob_0_5 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  TrailDesc
+}, Symbol.toStringTag, { value: "Module" }));
+const modules = /* @__PURE__ */ Object.assign({ "./attachmentDesc.ts": __vite_glob_0_0, "./beamDesc.ts": __vite_glob_0_1, "./emitterGroupDesc.ts": __vite_glob_0_2, "./lightDesc.ts": __vite_glob_0_3, "./objectDesc.ts": __vite_glob_0_4$1, "./trailDesc.ts": __vite_glob_0_5 });
 function RegisterRenderDescs() {
   for (const module of Object.values(modules)) {
     for (const exprt of Object.values(module)) {
@@ -63403,6 +63771,10 @@ class OutfitRenderer {
   /**Does camera update every frame */
   doAddInstance = true;
   /**If outfitRenderer should call RBXRenderer.addInstance(), setting this to false will make OutfitRenderer return success early */
+  doMoveLoose = true;
+  /**If outfitRenderer should call this.moveLoose() when certain animations are playing */
+  affectsLinearVelocity = true;
+  /**If outfitRenderer should set the AssemblyLinearVelocity every animateOnce */
   forceAnimationLoop = true;
   /**If future loaded animations should be set to loop */
   backgroundRenderer;
@@ -63616,10 +63988,39 @@ class OutfitRenderer {
       this.animateOnce();
     }, 1e3 / this.animationFPS);
   }
+  /**Animates moveLoose */
+  animateMoveLoose(deltaTime) {
+    if (!this.currentRig) return;
+    const hrp = this.currentRig.FindFirstChild("HumanoidRootPart");
+    if (hrp && hrp.IsA("BasePart")) {
+      if (this.doMoveLoose) {
+        const mainAnim = this.animatorW?.data.currentAnimation;
+        let facing = hrp.Prop("CFrame").lookVector();
+        facing[1] = 1e-3;
+        facing = normalize(facing);
+        let speed = 0;
+        if (mainAnim === "run") speed = 16;
+        else if (mainAnim === "walk") speed = 10;
+        const diff = multiply(facing, [speed, speed, speed]);
+        const deltaDiff = multiply(diff, [deltaTime, deltaTime, deltaTime]);
+        const negDeltaDiff = minus([0, 0, 0], deltaDiff);
+        this.moveLoose(negDeltaDiff);
+        if (this.affectsLinearVelocity) {
+          const hrpW = hrp.w;
+          hrpW.GetAssembly().linearVelocity = new Vector3().fromVec3(diff);
+        }
+      } else {
+        if (this.affectsLinearVelocity) {
+          const hrpW = hrp.w;
+          hrpW.GetAssembly().linearVelocity = new Vector3();
+        }
+      }
+    }
+  }
   /**
    * Updates the animation once
    */
-  animateOnce(deltaTimeOverride) {
+  animateOnce(deltaTimeOverride, forceTime, forceKeyframe) {
     if (this.currentRig && this.auth) {
       const humanoid = this.currentRig.FindFirstChildOfClass("Humanoid");
       if (humanoid) {
@@ -63628,8 +64029,9 @@ class OutfitRenderer {
           const deltaTime = deltaTimeOverride !== void 0 ? deltaTimeOverride : (Date.now() / 1e3 - this.lastFrameTime) * this.deltaTimeMultiplier;
           this.lastFrameTime = Date.now() / 1e3;
           const animatorW = new AnimatorWrapper(animator);
-          animatorW.renderAnimation(deltaTime);
+          animatorW.renderAnimation(deltaTime, forceTime, forceKeyframe);
           this.currentRig.preRender();
+          this.animateMoveLoose(deltaTime);
           if (this.doAddInstance) RBXRenderer.addInstance(this.currentRig, this.auth, this.renderScene);
         }
       }
@@ -63679,7 +64081,8 @@ class OutfitRenderer {
           const animator = humanoid.FindFirstChildOfClass("Animator");
           if (animator) {
             const animatorW = new AnimatorWrapper(animator);
-            const successfullyPlayed = animatorW.playAnimation(name);
+            let successfullyPlayed = animatorW.playAnimation(name);
+            if (!successfullyPlayed && name === "pose") successfullyPlayed = animatorW.playAnimation("idle:0");
             if (!successfullyPlayed && name.startsWith("emote.") && name) {
               const emoteId = BigInt(name.split(".")[1]);
               animatorW.loadAvatarAnimation(emoteId, true, this.forceAnimationLoop).then(() => {
@@ -63794,6 +64197,19 @@ class OutfitRenderer {
       }
     }
   }
+  /**
+   * Moves "loose" things such as particles and trails by the Vec3 given, used to simulate character movement without actually moving the character
+   */
+  moveLoose(vec) {
+    if (vec[0] === 0 && vec[1] === 0 && vec[2] === 0) return;
+    if (!this.currentRig) return;
+    for (const instance of this.currentRig.GetDescendants()) {
+      const renderDesc = this.renderScene.renderDescs.get(instance);
+      if (renderDesc) {
+        renderDesc.moveLoose(vec);
+      }
+    }
+  }
   /**Calls destroy on the rig, stops animating and disconnects connections. The OutfitRenderer should not be interacted with after this */
   destroy() {
     this.stopAnimating();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roavatar-renderer",
-  "version": "1.8.1",
+  "version": "1.9.1",
   "description": "A renderer for Roblox avatars, used by the RoAvatar extension.",
   "author": "steinan",
   "type": "module",