roavatar-renderer 1.8.0 → 1.9.0

package/dist/index.d.ts

@@ -431,6 +431,7 @@ export declare class Assembly {
     rootNode: AssemblyNode;
     allNodes: AssemblyNode[] | undefined;
     allConnectors: Instance[] | undefined;
+    linearVelocity: Vector3;
     constructor(rootPart: Instance);
     getNodeDescendants(): AssemblyNode[];
     getPartDescendants(): Instance[];
@@ -1655,6 +1656,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 */
@@ -1837,8 +1840,15 @@ export declare function getCameraCFrameForAvatarNonCustomized(rig: Instance): CF
  */
 export declare function getCameraCFrameForHeadshotCustomized(rig: Instance, fov: number, yRot: number, distance: number): CFrame | undefined;
 
+export declare function getCameraCFrameForHeadshotNonCustomized(rig: Instance, newLighting?: boolean): {
+    cframe: CFrame;
+    fov: number;
+};
+
 export declare function getCharacterTorsoCFrame(character: Instance): CFrame;
 
+export declare function getCloseupCameraCFrame(character: Instance, newLighting?: boolean): Instance;
+
 /**
  * @category Mesh
  */
@@ -2725,7 +2735,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;
@@ -3096,6 +3115,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;
@@ -3170,10 +3191,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
      */
@@ -3201,6 +3224,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;
 }
@@ -3717,6 +3744,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;
@@ -3852,6 +3880,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;
@@ -44179,27 +44184,38 @@ class AccessoryWrapper extends InstanceWrapper {
               }
             }
           }
-          if (!bodyAttachment) {
-            return;
-          }
-          if (!accessoryAttachment) {
-            return;
-          }
           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 (bodyAttachment && accessoryAttachment) {
+            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);
+          }
         }
       }
     }
@@ -48094,7 +48110,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" }));
@@ -48650,6 +48666,11 @@ class ObjectDesc extends RenderDesc {
     }
     if (this.materialDesc.result) {
       this.materialDesc.updateResult();
+      if (this.results) {
+        for (const result of this.results) {
+          result.visible = this.materialDesc.visible;
+        }
+      }
     }
   }
   static shouldRenderInstance(instance) {
@@ -51917,7 +51938,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,
@@ -51928,7 +51962,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" }));
@@ -51943,7 +51977,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" }));
@@ -52412,7 +52446,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);
@@ -52522,6 +52556,7 @@ class EmitterGroupDesc extends RenderDesc {
   lastCframe = new CFrame();
   cframe = new CFrame();
   emitterDir = NormalId.Top;
+  parentVelocity = new Vector3();
   emitterDescs = [];
   //special for emitter group
   getRandomLocalPos() {
@@ -52621,6 +52656,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;
@@ -52831,6 +52875,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,
@@ -52857,7 +52909,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" }));
@@ -52963,7 +53015,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" }));
@@ -52993,6 +53045,9 @@ class ScriptWrapper extends InstanceWrapper {
       case "HatScript2.0":
         this.HatScript20(this.instance);
         break;
+      case "TrailTestRoAvatar":
+        this.TrailTestRoAvatar(this.instance);
+        break;
     }
   }
   //Scripts
@@ -53216,8 +53271,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" }));
@@ -53274,25 +53347,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)) {
@@ -53740,7 +53826,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)) {
@@ -62894,6 +63242,63 @@ function getAvatarCameraCFrame(character, applyEmote, isFallbackEmoteApplied, fi
   setupCamera(camera, cameraOptions);
   return camera;
 }
+function getCloseupCameraCFrame(character, newLighting = true) {
+  const cameraOffsetX = 0;
+  const cameraOffsetY = 0;
+  const baseHatZoom = 30;
+  const maxHatZoom = 100;
+  const headAttachments = [];
+  const head = character.FindFirstChild("Head");
+  let headPos = new Vector3();
+  let headCF = new CFrame();
+  if (head) {
+    headPos = head.Prop("Position");
+    headCF = head.Prop("CFrame");
+    for (const child of head.GetChildren()) {
+      if (child.IsA("Attachment")) {
+        headAttachments.push(child.Prop("Name"));
+      }
+    }
+  }
+  let maxDimension = 0;
+  for (const child of character.GetChildren()) {
+    if (child.IsA("Accessory")) {
+      const handle = child.FindFirstChild("Handle");
+      if (handle) {
+        const handlePos = handle.Prop("Position");
+        let hasHeadAttachment = false;
+        for (const att of handle.GetChildren()) {
+          if (att.IsA("Attachment") && headAttachments.includes(att.Prop("Name"))) {
+            hasHeadAttachment = true;
+            break;
+          }
+        }
+        if (hasHeadAttachment) {
+          const size = handle.Prop("Size").divide(new Vector3(2, 2, 2)).add(handlePos).minus(headPos);
+          size.Z = 0;
+          if (size.magnitude() > maxDimension) {
+            maxDimension = size.magnitude();
+          }
+        }
+      }
+    }
+  }
+  const maxHatOffset = 0.5;
+  maxDimension = Math.min(1, maxDimension / 3);
+  maxDimension *= maxDimension;
+  const viewOffset = headCF.multiply(new CFrame(cameraOffsetX, cameraOffsetY + maxHatOffset * maxDimension, 0.1));
+  let yAngle = -Math.PI / 16;
+  if (newLighting) {
+    yAngle = 0;
+  }
+  const positionOffset = headCF.clone();
+  const toAdd = multiply(normalize(CFrame.Angles(0, yAngle, 0).lookVector()), [3, 3, 3]);
+  positionOffset.Position = add(positionOffset.Position, toAdd);
+  const camera = createThumbnailCamera();
+  camera.setProperty("CFrame", CFrame.lookAt(positionOffset.Position, viewOffset.Position));
+  camera.setProperty("FieldOfView", baseHatZoom + (maxHatZoom - baseHatZoom) * maxDimension);
+  return camera;
+}
 function getCorners(cframe, size) {
   const halfX = size.X / 2;
   const halfY = size.Y / 2;
@@ -62959,7 +63364,7 @@ function getExtents(cframe, parts) {
 function getExtentsWorld(rig) {
   const rigParts = [];
   for (const child of rig.GetDescendants()) {
-    if (child.createWrapper()?.IsA("BasePart")) {
+    if (child.createWrapper()?.IsA("BasePart") && !(child.Prop("Name") === "HumanoidRootPart")) {
       rigParts.push(child);
     }
   }
@@ -63021,6 +63426,13 @@ function getCameraCFrameForHeadshotCustomized(rig, fov2, yRot, distance2) {
     return cameraCF;
   }
 }
+function getCameraCFrameForHeadshotNonCustomized(rig, newLighting = true) {
+  const camera = getCloseupCameraCFrame(rig, newLighting);
+  const cameraCF = camera.Prop("CFrame");
+  const cameraFOV = camera.Prop("FieldOfView");
+  camera.Destroy();
+  return { cframe: cameraCF, fov: cameraFOV };
+}
 function getCameraCFrameForAvatarCustomized(rig, fov2, yRot) {
   const camera = getAvatarCameraCFrame(rig, void 0, void 0, fov2, {
     optCameraYRot: yRot,
@@ -63334,6 +63746,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;
@@ -63547,10 +63963,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) {
@@ -63559,8 +64004,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);
         }
       }
@@ -63610,7 +64056,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(() => {
@@ -63725,6 +64172,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();
@@ -64211,7 +64671,9 @@ export {
   getCameraCFrameForAvatarCustomized,
   getCameraCFrameForAvatarNonCustomized,
   getCameraCFrameForHeadshotCustomized,
+  getCameraCFrameForHeadshotNonCustomized,
   getCharacterTorsoCFrame,
+  getCloseupCameraCFrame,
   getDistIndexArray,
   getExtents,
   getExtentsCenter,

package/package.json

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