minerender 2.1.0-alpha.61 → 2.1.0-alpha.62

package/dist/browser/index.d.mts

@@ -901,7 +901,7 @@ declare class DefaultBlockStates implements MinecraftAsset {
     [k: string]: BlockStatePropertyDefaults;
 }
 
-/** `entity-models/animations/<namespace>/<model id>.json`: vanilla's keyframe animations of one model. */
+/** `entity-models/animations/<namespace>/<model id>.json`: native and sampled vanilla animation clips. */
 interface EntityAnimationFile extends MinecraftAsset {
     id: string;
     animations: Record<string, EntityAnimation>;
@@ -910,6 +910,8 @@ interface EntityAnimation {
     /** Seconds. */
     length: number;
     loop: boolean;
+    /** Geometry layer targeted by this clip; defaults to `main`. */
+    layer?: string;
     /** Part name anywhere in a layer; `root` is the layer's root part. */
     bones: Record<string, EntityAnimationBone>;
 }
@@ -947,7 +949,7 @@ declare class Entities {
     static getPassList(modelKey: BasicAssetKey): Promise<EntityModelPass[]>;
     static getEntity(modelKey: BasicAssetKey, textureKey?: BasicAssetKey, options?: EntityModelOptions): Promise<Maybe<EntityModel>>;
     /**
-     * Vanilla's keyframe animations of a model by name, or undefined when the model or the selected version has none.
+     * Native and sampled vanilla clips by name, or undefined when the model or selected version has none.
      */
     static getAnimations(modelKey: BasicAssetKey): Promise<Maybe<Record<string, EntityAnimation>>>;
     static resolveTexture(modelKey: BasicAssetKey): Promise<Maybe<AssetKey>>;
@@ -1209,11 +1211,11 @@ declare class EntityAnimationPlayer {
     get animation(): EntityAnimation | undefined;
     get time(): number;
     /**
-     * Starts an animation on the named parts below each layer root. The current pose of a part becomes its default;
-     * bones without a matching part are skipped.
+     * Starts an animation on matching named parts. Supplied baked poses are the baseline for offsets;
+     * without them, the current pose is used. Stopping restores the pose from before playback.
      */
-    play(layers: Object3D[], animation: EntityAnimation, options?: EntityAnimationOptions): void;
-    /** Restores the default poses. Returns whether an animation was active. */
+    play(layers: Object3D[], animation: EntityAnimation, options?: EntityAnimationOptions, poses?: ReadonlyMap<Object3D, EntityModelPart["pose"]>): void;
+    /** Restores the poses from before playback. Returns whether an animation was active. */
     stop(): boolean;
     /** Forgets the animation without touching the parts, for parts that no longer exist. */
     clear(): void;
@@ -1235,7 +1237,8 @@ declare class EntityObject extends SceneObject {
     private scrollTicker;
     /** Entity age in ticks, as vanilla's `ageInTicks`; drives the scrolling render modes. */
     age: number;
-    private readonly animationPlayer;
+    private readonly animationPlayers;
+    private readonly partPoses;
     constructor(entity: EntityModel, options?: Partial<EntityObjectOptions>);
     init(): Promise<void>;
     dispose(): void;
@@ -1244,17 +1247,21 @@ declare class EntityObject extends SceneObject {
     private updateScrollSubscription;
     /** Applies the entity age to the scrolling materials; the ticker calls this 20 times per second. */
     private updateScroll;
-    /** The animation started by {@link playAnimation}, until {@link stopAnimation} or disposal. */
+    /** The first active clip, until playback is stopped or the object is disposed. */
     get animation(): Maybe<EntityAnimation>;
+    /** Clips playing together, each targeting a separate geometry layer. */
+    get activeAnimations(): readonly EntityAnimation[];
     /** Seconds since the animation started, before looping. */
     get animationTime(): number;
     /**
-     * Poses the object from a keyframe animation of {@link Entities.getAnimations}, replacing the current one.
-     * Parts of every layer are matched by name and their current pose is the default the offsets add to.
+     * Plays a clip from {@link Entities.getAnimations}, replacing all active clips.
+     * Offsets apply to the baked pose in the clip's layer (`main` by default), including repeated draws of that layer.
      * The object owns no clock: call {@link advanceAnimation} per frame, or {@link setAnimationTime}.
      */
     playAnimation(animation: EntityAnimation, options?: EntityAnimationOptions): void;
-    /** Stops the animation and restores the default pose. */
+    /** Plays one clip per selected geometry layer, with a shared clock and no blending between clips. */
+    playAnimations(animations: readonly EntityAnimation[], options?: EntityAnimationOptions): void;
+    /** Stops all clips and restores the poses from before playback. */
     stopAnimation(): void;
     /** Poses the object at an explicit time in seconds. Has no effect without an animation. */
     setAnimationTime(seconds: number): void;

package/dist/browser/index.d.ts

@@ -901,7 +901,7 @@ declare class DefaultBlockStates implements MinecraftAsset {
     [k: string]: BlockStatePropertyDefaults;
 }
 
-/** `entity-models/animations/<namespace>/<model id>.json`: vanilla's keyframe animations of one model. */
+/** `entity-models/animations/<namespace>/<model id>.json`: native and sampled vanilla animation clips. */
 interface EntityAnimationFile extends MinecraftAsset {
     id: string;
     animations: Record<string, EntityAnimation>;
@@ -910,6 +910,8 @@ interface EntityAnimation {
     /** Seconds. */
     length: number;
     loop: boolean;
+    /** Geometry layer targeted by this clip; defaults to `main`. */
+    layer?: string;
     /** Part name anywhere in a layer; `root` is the layer's root part. */
     bones: Record<string, EntityAnimationBone>;
 }
@@ -947,7 +949,7 @@ declare class Entities {
     static getPassList(modelKey: BasicAssetKey): Promise<EntityModelPass[]>;
     static getEntity(modelKey: BasicAssetKey, textureKey?: BasicAssetKey, options?: EntityModelOptions): Promise<Maybe<EntityModel>>;
     /**
-     * Vanilla's keyframe animations of a model by name, or undefined when the model or the selected version has none.
+     * Native and sampled vanilla clips by name, or undefined when the model or selected version has none.
      */
     static getAnimations(modelKey: BasicAssetKey): Promise<Maybe<Record<string, EntityAnimation>>>;
     static resolveTexture(modelKey: BasicAssetKey): Promise<Maybe<AssetKey>>;
@@ -1209,11 +1211,11 @@ declare class EntityAnimationPlayer {
     get animation(): EntityAnimation | undefined;
     get time(): number;
     /**
-     * Starts an animation on the named parts below each layer root. The current pose of a part becomes its default;
-     * bones without a matching part are skipped.
+     * Starts an animation on matching named parts. Supplied baked poses are the baseline for offsets;
+     * without them, the current pose is used. Stopping restores the pose from before playback.
      */
-    play(layers: Object3D[], animation: EntityAnimation, options?: EntityAnimationOptions): void;
-    /** Restores the default poses. Returns whether an animation was active. */
+    play(layers: Object3D[], animation: EntityAnimation, options?: EntityAnimationOptions, poses?: ReadonlyMap<Object3D, EntityModelPart["pose"]>): void;
+    /** Restores the poses from before playback. Returns whether an animation was active. */
     stop(): boolean;
     /** Forgets the animation without touching the parts, for parts that no longer exist. */
     clear(): void;
@@ -1235,7 +1237,8 @@ declare class EntityObject extends SceneObject {
     private scrollTicker;
     /** Entity age in ticks, as vanilla's `ageInTicks`; drives the scrolling render modes. */
     age: number;
-    private readonly animationPlayer;
+    private readonly animationPlayers;
+    private readonly partPoses;
     constructor(entity: EntityModel, options?: Partial<EntityObjectOptions>);
     init(): Promise<void>;
     dispose(): void;
@@ -1244,17 +1247,21 @@ declare class EntityObject extends SceneObject {
     private updateScrollSubscription;
     /** Applies the entity age to the scrolling materials; the ticker calls this 20 times per second. */
     private updateScroll;
-    /** The animation started by {@link playAnimation}, until {@link stopAnimation} or disposal. */
+    /** The first active clip, until playback is stopped or the object is disposed. */
     get animation(): Maybe<EntityAnimation>;
+    /** Clips playing together, each targeting a separate geometry layer. */
+    get activeAnimations(): readonly EntityAnimation[];
     /** Seconds since the animation started, before looping. */
     get animationTime(): number;
     /**
-     * Poses the object from a keyframe animation of {@link Entities.getAnimations}, replacing the current one.
-     * Parts of every layer are matched by name and their current pose is the default the offsets add to.
+     * Plays a clip from {@link Entities.getAnimations}, replacing all active clips.
+     * Offsets apply to the baked pose in the clip's layer (`main` by default), including repeated draws of that layer.
      * The object owns no clock: call {@link advanceAnimation} per frame, or {@link setAnimationTime}.
      */
     playAnimation(animation: EntityAnimation, options?: EntityAnimationOptions): void;
-    /** Stops the animation and restores the default pose. */
+    /** Plays one clip per selected geometry layer, with a shared clock and no blending between clips. */
+    playAnimations(animations: readonly EntityAnimation[], options?: EntityAnimationOptions): void;
+    /** Stops all clips and restores the poses from before playback. */
     stopAnimation(): void;
     /** Poses the object at an explicit time in seconds. Has no effect without an animation. */
     setAnimationTime(seconds: number): void;