@nodetool-ai/game-renderer 0.8.3 → 0.8.4-a13.1

package/dist/.nodetool-build-stamp

@@ -1 +1 @@
-2026-10-12T12:30:00.497Z
+2026-10-15T22:44:25.338Z

package/dist/audio/music.d.ts

@@ -0,0 +1,38 @@
+import type { GameScene } from "@nodetool-ai/protocol";
+type StreamingSettings = NonNullable<NonNullable<GameScene["music"]>["streaming"]>;
+/** Owns a streamed track and its media lifecycle. Media time never enters simulation. */
+export declare class GameStreamingMusicVoice {
+    private readonly context;
+    private readonly url;
+    private readonly settings;
+    private readonly volume;
+    private readonly fadeSeconds;
+    private readonly offset;
+    private readonly status;
+    private readonly ended;
+    private readonly playing;
+    private readonly media;
+    private readonly source;
+    private readonly gain;
+    private readonly controller;
+    private timer;
+    private disposed;
+    private paused;
+    private started;
+    private playGeneration;
+    private fadeStart;
+    private fadeOut;
+    private end;
+    constructor(context: AudioContext, url: string, destination: AudioNode, settings: StreamingSettings, volume: number, fadeSeconds: number, offset: () => number, status: (message: string) => void, ended: () => void, playing?: () => void);
+    load(): void;
+    private ready;
+    private play;
+    private fail;
+    pause(): void;
+    resume(): void;
+    stop(fadeSeconds: number): void;
+    private scheduleFadeOut;
+    dispose(): void;
+}
+export {};
+//# sourceMappingURL=music.d.ts.map

package/dist/audio/music.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"music.d.ts","sourceRoot":"","sources":["../../src/audio/music.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,KAAK,iBAAiB,GAAG,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAOnF,yFAAyF;AACzF,qBAAa,uBAAuB;IAehC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAEpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAvB1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAiE;IAChF,OAAO,CAAC,GAAG,CAAK;IAEhB,YACmB,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,MAAM,EAC5B,WAAW,EAAE,SAAS,EACL,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,MAAM,EACpB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,EACjC,KAAK,EAAE,MAAM,IAAI,EACjB,OAAO,GAAE,MAAM,IAAsB,EAsBvD;IAED,IAAI,IAAI,IAAI,CAKX;IAED,OAAO,CAAC,KAAK;IAab,OAAO,CAAC,IAAI;IAuBZ,OAAO,CAAC,IAAI;IAKZ,KAAK,IAAI,IAAI,CAeZ;IAED,MAAM,IAAI,IAAI,CAeb;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAU9B;IAED,OAAO,CAAC,eAAe;IAUvB,OAAO,IAAI,IAAI,CAYd;CACF"}

package/dist/audio/music.js

@@ -0,0 +1,186 @@
+/** Logical music time includes the intro once, then repeats the authored loop. */
+function loopOffset(seconds, start, end) {
+    return seconds < end ? seconds : start + (seconds - start) % (end - start);
+}
+/** Owns a streamed track and its media lifecycle. Media time never enters simulation. */
+export class GameStreamingMusicVoice {
+    context;
+    url;
+    settings;
+    volume;
+    fadeSeconds;
+    offset;
+    status;
+    ended;
+    playing;
+    media = new Audio();
+    source;
+    gain;
+    controller = new AbortController();
+    timer;
+    disposed = false;
+    paused = false;
+    started = false;
+    playGeneration = 0;
+    fadeStart = 0;
+    fadeOut;
+    end = 0;
+    constructor(context, url, destination, settings, volume, fadeSeconds, offset, status, ended, playing = () => undefined) {
+        this.context = context;
+        this.url = url;
+        this.settings = settings;
+        this.volume = volume;
+        this.fadeSeconds = fadeSeconds;
+        this.offset = offset;
+        this.status = status;
+        this.ended = ended;
+        this.playing = playing;
+        this.media.crossOrigin = "anonymous";
+        this.media.preload = "metadata";
+        this.source = context.createMediaElementSource(this.media);
+        this.gain = context.createGain();
+        this.source.connect(this.gain).connect(destination);
+        this.gain.gain.setValueAtTime(0, context.currentTime);
+        const signal = this.controller.signal;
+        this.media.addEventListener("loadedmetadata", () => this.ready(), { signal });
+        this.media.addEventListener("timeupdate", () => {
+            if (!this.paused && this.end > 0 && this.media.currentTime >= this.end) {
+                this.media.currentTime = loopOffset(this.media.currentTime, settings.loopStartSeconds, this.end);
+            }
+        }, { signal });
+        this.media.addEventListener("ended", () => {
+            if (!this.paused && !this.disposed && this.end > 0) {
+                this.media.currentTime = settings.loopStartSeconds;
+                this.play();
+            }
+        }, { signal });
+        this.media.addEventListener("error", () => this.fail("the media could not be loaded"), { signal });
+    }
+    load() {
+        if (this.disposed)
+            return;
+        this.media.src = this.url;
+        this.media.load();
+        if (this.media.readyState >= 1)
+            this.ready();
+    }
+    ready() {
+        if (this.disposed)
+            return;
+        const duration = this.media.duration;
+        const end = this.settings.loopEndSeconds ?? duration;
+        if (!Number.isFinite(duration) || duration <= 0 || this.settings.loopStartSeconds >= end || end > duration) {
+            this.fail("loop points must fit inside the track duration");
+            return;
+        }
+        this.end = end;
+        this.media.loop = this.settings.loopStartSeconds === 0 && this.settings.loopEndSeconds === undefined;
+        if (!this.paused)
+            this.resume();
+    }
+    play() {
+        const generation = ++this.playGeneration;
+        void this.media.play().then(() => {
+            if (generation !== this.playGeneration) {
+                return;
+            }
+            if (this.disposed || this.paused) {
+                this.media.pause();
+            }
+            else {
+                this.media.currentTime = loopOffset(Math.max(0, this.offset()), this.settings.loopStartSeconds, this.end);
+                if (!this.started) {
+                    this.started = true;
+                    this.playing();
+                    this.fadeStart = this.context.currentTime;
+                    this.gain.gain.setValueAtTime(this.fadeSeconds > 0 ? 0 : this.volume, this.fadeStart);
+                    if (this.fadeSeconds > 0)
+                        this.gain.gain.linearRampToValueAtTime(this.volume, this.fadeStart + this.fadeSeconds);
+                }
+            }
+        }).catch((error) => {
+            if (!this.disposed && !this.paused && generation === this.playGeneration) {
+                this.fail(error instanceof Error ? error.message : String(error));
+            }
+        });
+    }
+    fail(message) {
+        this.status(`Streaming music could not play: ${message}`);
+        this.dispose();
+    }
+    pause() {
+        if (this.paused)
+            return;
+        if (this.fadeOut) {
+            const now = this.context.currentTime;
+            const elapsed = Math.max(0, now - this.fadeOut.start);
+            const seconds = Math.max(0, this.fadeOut.seconds - elapsed);
+            const volume = this.fadeOut.volume * Math.max(0, 1 - elapsed / this.fadeOut.seconds);
+            this.fadeOut = { start: now, seconds, volume };
+            this.gain.gain.cancelScheduledValues(now);
+            this.gain.gain.setValueAtTime(volume, now);
+            if (this.timer !== undefined)
+                clearTimeout(this.timer);
+        }
+        this.paused = true;
+        this.playGeneration += 1;
+        this.media.pause();
+    }
+    resume() {
+        if (this.disposed)
+            return;
+        const wasPaused = this.paused;
+        this.paused = false;
+        if (this.end === 0)
+            return;
+        if (wasPaused && this.fadeOut) {
+            if (this.fadeOut.seconds === 0) {
+                this.dispose();
+                return;
+            }
+            this.fadeOut.start = this.context.currentTime;
+            this.scheduleFadeOut();
+        }
+        this.media.currentTime = loopOffset(Math.max(0, this.offset()), this.settings.loopStartSeconds, this.end);
+        this.play();
+    }
+    stop(fadeSeconds) {
+        if (this.disposed)
+            return;
+        if (fadeSeconds === 0 || this.paused || !this.started) {
+            this.dispose();
+            return;
+        }
+        const now = this.context.currentTime;
+        const current = this.fadeSeconds > 0 ? this.volume * Math.min(1, Math.max(0, (now - this.fadeStart) / this.fadeSeconds)) : this.volume;
+        this.fadeOut = { start: now, seconds: fadeSeconds, volume: current };
+        this.scheduleFadeOut();
+    }
+    scheduleFadeOut() {
+        const fade = this.fadeOut;
+        if (!fade)
+            return;
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.gain.gain.cancelScheduledValues(fade.start);
+        this.gain.gain.setValueAtTime(fade.volume, fade.start);
+        this.gain.gain.linearRampToValueAtTime(0, fade.start + fade.seconds);
+        this.timer = setTimeout(() => this.dispose(), fade.seconds * 1000);
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.timer !== undefined)
+            clearTimeout(this.timer);
+        this.controller.abort();
+        this.fadeOut = undefined;
+        this.pause();
+        this.media.removeAttribute("src");
+        this.media.load();
+        this.source.disconnect();
+        this.gain.disconnect();
+        this.ended();
+    }
+}
+//# sourceMappingURL=music.js.map

package/dist/audio/music.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"music.js","sourceRoot":"","sources":["../../src/audio/music.ts"],"names":[],"mappings":"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"}

package/dist/audio/player.d.ts

@@ -1,9 +1,11 @@
-import { type GameAssetBinding, type GameAssetBinding3D, type GameAudioMixerInput, type GameEvent, type GameEvent3D, type GameSnapshot } from "@nodetool-ai/protocol";
+import { type GameAssetBinding, type GameAssetBinding3D, type GameAudioMixerInput, type GameEvent, type GameEvent3D, type GameSnapshot, type GameScene } from "@nodetool-ai/protocol";
 import { type GameAudioMixerState } from "./mixer.js";
 import { type GameAudioSpatialQuality, type GameAudioSpatialView } from "./spatial.js";
 export interface GameAudioOptions {
     readonly assets: Readonly<Record<string, GameAssetBinding | GameAssetBinding3D>>;
     readonly tickRate: number;
+    /** Scene music settings are presentation configuration, separate from snapshots. */
+    readonly scenes?: ReadonlyArray<Pick<GameScene, "id" | "music">>;
     readonly resolveAsset: (binding: GameAssetBinding | GameAssetBinding3D) => Promise<string | null>;
     readonly status: (message: string) => void;
     readonly context?: AudioContext;
@@ -17,6 +19,11 @@ export declare class GameAudioPlayer {
     private options;
     private readonly context;
     private readonly mixer;
+    private readonly failedStreams;
+    private readonly streamed;
+    private readonly deferredDecodedFades;
+    private readonly deferredFades;
+    private readonly streamingFades;
     private readonly buffers;
     private readonly voices;
     private readonly fading;
@@ -37,6 +44,8 @@ export declare class GameAudioPlayer {
     private mixerSettings;
     /** Applies edited mixer settings. Playing voices keep playing on their buses. */
     updateMixer(settings: GameAudioMixerInput | undefined): void;
+    /** Updates scene presentation settings without replacing the audio context. */
+    updateScenes(scenes: GameAudioOptions["scenes"]): void;
     /** Player-facing bus volume, for example from a settings screen. */
     setBusVolume(busId: string, volume: number): void;
     setBusMuted(busId: string, muted: boolean): void;
@@ -50,6 +59,10 @@ export declare class GameAudioPlayer {
     resume(): void;
     sync(snapshot: Pick<GameSnapshot, "tick" | "music" | "sceneId">): void;
     private startDesiredMusic;
+    private streamingSettings;
+    private voiceCount;
+    private makeVoiceRoom;
+    private startStream;
     /**
      * Moves the listener and every spatial voice to a rendered frame. Players call it once per rendered frame with the view
      * built from the interpolated frame, so positions follow what is on screen. Emitters missing from the view keep their last position.
@@ -60,6 +73,7 @@ export declare class GameAudioPlayer {
     /** Plays audio events and lets other simulation events drive mixer snapshot transitions. */
     handle(event: GameEvent | GameEvent3D): void;
     private start;
+    private finishDeferredFades;
     private stop;
     reset(snapshot: Pick<GameSnapshot, "tick" | "music" | "sceneId">): void;
     dispose(): void;

package/dist/audio/player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/audio/player.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/audio/player.ts"],"names":[],"mappings":"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"}

package/dist/audio/player.js

@@ -1,4 +1,5 @@
 import { gameAudioMixer } from "@nodetool-ai/protocol";
+import { GameStreamingMusicVoice } from "./music.js";
 import { GameAudioMixer } from "./mixer.js";
 import { createGameAudioPanner, gameAudioDopplerRate, gameAudioVelocity, placeGameAudioListener, placeGameAudioPanner, setGameAudioDopplerRate } from "./spatial.js";
 import { playBuiltinGameVoice, stopGameVoice } from "./voices.js";
@@ -8,6 +9,11 @@ export class GameAudioPlayer {
     options;
     context;
     mixer;
+    failedStreams = new Set();
+    streamed = new Map();
+    deferredDecodedFades = new Map();
+    deferredFades = new Map();
+    streamingFades = new Map();
     buffers = new Map();
     voices = new Map();
     fading = new Set();
@@ -43,6 +49,21 @@ export class GameAudioPlayer {
             return;
         this.mixer.update(this.mixerSettings(settings));
     }
+    /** Updates scene presentation settings without replacing the audio context. */
+    updateScenes(scenes) {
+        if (this.disposed)
+            return;
+        const before = this.streamingSettings();
+        this.options = { ...this.options, scenes };
+        for (const scene of scenes ?? []) {
+            if (scene.music?.streaming)
+                this.buffers.delete(scene.music.assetId);
+        }
+        if (JSON.stringify(before) !== JSON.stringify(this.streamingSettings()) && this.desiredMusic) {
+            this.stop(this.desiredMusic.voiceId, 0);
+            this.startDesiredMusic();
+        }
+    }
     /** Player-facing bus volume, for example from a settings screen. */
     setBusVolume(busId, volume) {
         if (!this.disposed)
@@ -103,13 +124,24 @@ export class GameAudioPlayer {
                 this.fading.delete(voice);
             }
         }
+        for (const [id, stream] of this.streamed) {
+            if (changed.has(stream.assetId))
+                this.stop(id, 0);
+        }
+        for (const [voice, assetId] of this.streamingFades) {
+            if (changed.has(assetId))
+                voice.dispose();
+        }
+        if (this.desiredMusic && changed.has(this.desiredMusic.assetId))
+            this.failedStreams.delete(this.desiredMusic.voiceId);
         this.options = { ...this.options, assets };
         this.preload();
         this.startDesiredMusic();
     }
     preload() {
+        const streamedSlots = new Set((this.options.scenes ?? []).flatMap((scene) => scene.music?.streaming ? [scene.music.assetId] : []));
         for (const [id, binding] of Object.entries(this.options.assets)) {
-            if (binding.mediaKind === "audio" && !binding.assetId.startsWith("builtin:"))
+            if (binding.mediaKind === "audio" && !binding.assetId.startsWith("builtin:") && !streamedSlots.has(id))
                 void this.buffer(id);
         }
     }
@@ -117,6 +149,7 @@ export class GameAudioPlayer {
         if (this.disposed || this.paused)
             return;
         try {
+            this.failedStreams.clear();
             await this.context.resume();
             this.startDesiredMusic();
         }
@@ -128,11 +161,22 @@ export class GameAudioPlayer {
         if (this.disposed || this.paused)
             return;
         this.paused = true;
+        for (const stream of this.streamed.values())
+            stream.voice.pause();
+        for (const voice of this.streamingFades.keys())
+            voice.pause();
         void this.context.suspend().catch(() => this.options.status("Audio could not pause"));
     }
     resume() {
         this.paused = false;
-        void this.unlock();
+        void this.unlock().then(() => {
+            if (!this.paused && !this.disposed && this.context.state === "running") {
+                for (const stream of this.streamed.values())
+                    stream.voice.resume();
+                for (const voice of this.streamingFades.keys())
+                    voice.resume();
+            }
+        });
     }
     sync(snapshot) {
         if (this.disposed)
@@ -154,23 +198,115 @@ export class GameAudioPlayer {
         if (this.desiredMusic?.voiceId !== next?.voiceId || this.desiredMusic?.startTick !== next?.startTick ||
             this.desiredMusic?.assetId !== next?.assetId || this.desiredMusic?.volume !== next?.volume ||
             this.desiredMusic?.fadeInTicks !== next?.fadeInTicks || this.desiredMusic?.fadeOutTicks !== next?.fadeOutTicks) {
-            if (this.desiredMusic)
-                this.stop(this.desiredMusic.voiceId, this.desiredMusic.fadeOutTicks);
+            if (this.desiredMusic) {
+                const outgoing = this.streamed.get(this.desiredMusic.voiceId);
+                const decoded = this.voices.get(this.desiredMusic.voiceId);
+                const incomingStream = next && this.options.scenes?.find(scene => scene.id === snapshot.sceneId)?.music?.streaming;
+                if (incomingStream && (outgoing || decoded)) {
+                    if (decoded) {
+                        this.voices.delete(decoded.id);
+                        this.fading.add(decoded);
+                        this.deferredDecodedFades.set(decoded, this.desiredMusic.fadeOutTicks);
+                    }
+                    this.pending.delete(this.desiredMusic.voiceId);
+                    if (outgoing) {
+                        this.streamed.delete(this.desiredMusic.voiceId);
+                        this.failedStreams.delete(this.desiredMusic.voiceId);
+                        this.streamingFades.set(outgoing.voice, outgoing.assetId);
+                        this.deferredFades.set(outgoing.voice, this.desiredMusic.fadeOutTicks);
+                    }
+                }
+                else {
+                    this.stop(this.desiredMusic.voiceId, this.desiredMusic.fadeOutTicks);
+                }
+            }
+            if (!next) {
+                this.finishDeferredFades();
+            }
             this.desiredMusic = next;
         }
         this.startDesiredMusic();
     }
     startDesiredMusic() {
         const music = this.desiredMusic;
-        if (!music || !this.options.assets[music.assetId] || this.paused || this.context.state !== "running" || this.voices.has(music.voiceId) || this.pending.has(music.voiceId))
+        if (!music || !this.options.assets[music.assetId] || this.paused || this.context.state !== "running" || this.voices.has(music.voiceId) || this.streamed.has(music.voiceId) || this.failedStreams.has(music.voiceId) || this.pending.has(music.voiceId))
             return;
+        const streaming = this.streamingSettings() !== undefined;
         const token = Symbol();
         this.pending.set(music.voiceId, { token, assetId: music.assetId });
         void this.start(music.voiceId, music.assetId, true, music.volume, music.fadeInTicks, music.fadeOutTicks, token, music.startTick)
-            .catch((error) => this.options.status(`Music could not start: ${error instanceof Error ? error.message : String(error)}`))
+            .catch((error) => {
+            if (this.pending.get(music.voiceId)?.token !== token)
+                return;
+            if (streaming)
+                this.failedStreams.add(music.voiceId);
+            this.options.status(`Music could not start: ${error instanceof Error ? error.message : String(error)}`);
+        })
             .finally(() => { if (this.pending.get(music.voiceId)?.token === token)
             this.pending.delete(music.voiceId); });
     }
+    streamingSettings() {
+        const music = this.options.scenes?.find((scene) => scene.id === this.sceneId)?.music;
+        return music?.assetId === this.desiredMusic?.assetId ? music?.streaming : undefined;
+    }
+    voiceCount() {
+        return this.voices.size + this.fading.size + this.streamed.size + this.streamingFades.size;
+    }
+    makeVoiceRoom() {
+        if (this.voiceCount() < MAX_VOICES)
+            return true;
+        const stream = this.streamingFades.keys().next().value;
+        if (stream)
+            stream.dispose();
+        else {
+            const fade = this.fading.values().next().value;
+            if (fade) {
+                fade.source.stop();
+                this.fading.delete(fade);
+            }
+            else {
+                const effect = [...this.voices.values()].find((voice) => !voice.loop);
+                if (!effect)
+                    return false;
+                this.stop(effect.id, 0);
+            }
+        }
+        return this.voiceCount() < MAX_VOICES;
+    }
+    async startStream(id, assetId, volume, fadeInTicks, logicalStartTick, token, settings) {
+        const generation = this.generation;
+        const binding = this.options.assets[assetId];
+        if (!binding)
+            return;
+        const url = await this.options.resolveAsset(binding);
+        if (this.disposed || this.paused || generation !== this.generation || this.context.state !== "running" ||
+            this.pending.get(id)?.token !== token || this.streamed.has(id))
+            return;
+        if (!url)
+            throw new Error("asset URL is unavailable");
+        if (!this.makeVoiceRoom())
+            return;
+        const bus = this.mixer.busFor(assetId, true);
+        const voice = new GameStreamingMusicVoice(this.context, url, this.mixer.input(bus), settings, volume, fadeInTicks / this.options.tickRate, () => Math.max(0, this.tick - logicalStartTick) / this.options.tickRate, (message) => {
+            if (this.streamed.get(id)?.voice === voice) {
+                this.failedStreams.add(id);
+            }
+            this.options.status(message);
+        }, () => {
+            this.mixer.voiceEnded(bus);
+            if (this.streamed.get(id)?.voice === voice)
+                this.streamed.delete(id);
+            this.streamingFades.delete(voice);
+            this.deferredFades.delete(voice);
+        }, () => {
+            if (this.streamed.get(id)?.voice === voice) {
+                this.finishDeferredFades();
+            }
+        });
+        this.streamed.set(id, { voice, assetId });
+        this.mixer.voiceStarted(bus);
+        voice.load();
+    }
     /**
      * Moves the listener and every spatial voice to a rendered frame. Players call it once per rendered frame with the view
      * built from the interpolated frame, so positions follow what is on screen. Emitters missing from the view keep their last position.
@@ -251,23 +387,17 @@ export class GameAudioPlayer {
             }
             return;
         }
+        const streaming = logicalStartTick === undefined ? undefined : this.streamingSettings();
+        if (streaming && logicalStartTick !== undefined) {
+            await this.startStream(id, assetId, volume, fadeInTicks, logicalStartTick, token, streaming);
+            return;
+        }
         const buffer = await this.buffer(assetId);
         if (!buffer || this.disposed || this.paused || this.context.state !== "running" || generation !== this.generation ||
             this.pending.get(id)?.token !== token || this.voices.has(id))
             return;
-        if (this.voices.size + this.fading.size >= MAX_VOICES && this.fading.size > 0) {
-            const fading = this.fading.values().next().value;
-            if (fading) {
-                fading.source.stop();
-                this.fading.delete(fading);
-            }
-        }
-        if (this.voices.size + this.fading.size >= MAX_VOICES) {
-            const oldestEffect = [...this.voices.values()].find((voice) => !voice.loop);
-            if (!oldestEffect)
-                return;
-            this.stop(oldestEffect.id, 0);
-        }
+        if (!this.makeVoiceRoom())
+            return;
         const source = this.context.createBufferSource();
         const gain = this.context.createGain();
         source.buffer = buffer;
@@ -291,15 +421,39 @@ export class GameAudioPlayer {
             if (this.voices.get(id) === voice)
                 this.voices.delete(id);
             this.fading.delete(voice);
+            this.deferredDecodedFades.delete(voice);
             source.disconnect();
             gain.disconnect();
             output.release();
         };
         const offset = logicalStartTick === undefined ? 0 : Math.max(0, this.tick - logicalStartTick) / this.options.tickRate;
         source.start(0, loop && buffer.duration > 0 ? offset % buffer.duration : 0);
+        if (logicalStartTick !== undefined) {
+            this.finishDeferredFades();
+        }
+    }
+    finishDeferredFades() {
+        const outgoing = [...this.deferredFades];
+        this.deferredFades.clear();
+        for (const [voice, ticks] of outgoing) {
+            voice.stop(ticks / this.options.tickRate);
+        }
+        for (const [voice, ticks] of this.deferredDecodedFades) {
+            if (this.fading.has(voice)) {
+                stopGameVoice(voice, this.context, ticks, this.options.tickRate, this.fading);
+            }
+        }
+        this.deferredDecodedFades.clear();
     }
     stop(id, fadeTicks) {
         this.pending.delete(id);
+        this.failedStreams.delete(id);
+        const stream = this.streamed.get(id);
+        if (stream) {
+            this.streamed.delete(id);
+            this.streamingFades.set(stream.voice, stream.assetId);
+            stream.voice.stop(fadeTicks / this.options.tickRate);
+        }
         const voice = this.voices.get(id);
         if (!voice)
             return;
@@ -309,11 +463,17 @@ export class GameAudioPlayer {
     reset(snapshot) {
         this.generation += 1;
         this.pending.clear();
+        this.failedStreams.clear();
+        for (const id of this.streamed.keys())
+            this.stop(id, 0);
+        for (const voice of this.streamingFades.keys())
+            voice.dispose();
         for (const id of this.voices.keys())
             this.stop(id, 0);
         for (const voice of this.fading)
             voice.source.stop();
         this.fading.clear();
+        this.deferredDecodedFades.clear();
         this.desiredMusic = null;
         this.mixer.reset(snapshot.sceneId);
         this.sync(snapshot);
@@ -324,11 +484,17 @@ export class GameAudioPlayer {
         this.disposed = true;
         this.generation += 1;
         this.pending.clear();
+        this.failedStreams.clear();
+        for (const id of this.streamed.keys())
+            this.stop(id, 0);
+        for (const voice of this.streamingFades.keys())
+            voice.dispose();
         for (const id of this.voices.keys())
             this.stop(id, 0);
         for (const voice of this.fading)
             voice.source.stop();
         this.fading.clear();
+        this.deferredDecodedFades.clear();
         this.buffers.clear();
         this.mixer.dispose();
         void this.context.close();