BiomeMusicSync

Synchronisiert die Hintergrundmusik zwischen dem Host und allen Spielern, die sich im selben Biom befinden. Alle hören denselben Track, denselben Clip und dieselbe Position, ohne Stottern oder Aussetzer.

Features

• Host und Spieler im selben Biom hören die Musik synchron.
• In unterschiedlichen Biomen bleibt die normale Musik unverändert.
• Latenzkorrektur über die vom Server synchronisierte Weltzeit.
• Kleine Abweichungen werden über minimale Geschwindigkeitsanpassung ausgeglichen (praktisch nicht hörbar). Nur bei größeren Abweichungen gibt es einen einzelnen Sprung.
• Das Spiel wird daran gehindert, auf dem Client einen anderen Track zu starten, sodass es zu keinen wiederholten Fade-Ins kommt.
• Funktioniert auch nach erneutem Beitreten oder Welt-Wechsel ohne Neustart.

Installation

1. BepInExPack Valheim installieren.
2. BiomeMusicSync.dll in den Ordner BepInEx/plugins legen (oder die Mod über einen Mod-Manager installieren).
3. Alle Spieler (Host und Clients) müssen die Mod installiert haben.

Funktionsweise

• Der Host sendet bei jeder Änderung (Biom, Track, Clip, Wiedergabestatus) sowie einmal pro Sekunde seinen Musikzustand an alle Clients.
• Zusammen mit dem Zustand wird ein gemeinsamer Zeitanker gesendet, also der Zeitpunkt, zu dem der aktuelle Clip auf der Weltzeit bei Position 0 gestartet wäre.
• Jeder Client berechnet daraus selbst die aktuelle Position und gleicht sie an. Befindet er sich im selben Biom wie der Host, wird die Musik synchronisiert.

Hinweise

• Der Host muss ein Spieler sein, da ein dedizierter Server keine Musik abspielt und daher nichts synchronisieren kann.
• Die Mod greift per Reflection auf interne Felder von Valheims MusicMan zu. Nach größeren Spiel-Updates kann eine Anpassung nötig sein.
• Bei Problemen helfen die Warnungen im BepInEx-Log (BepInEx/LogOutput.log). Beim Start sollte die Zeile StartMusic patches: N mit N ≥ 1 erscheinen.

Changelog

0.5.0

• Komplett überarbeitet.
• RPC-Registrierung wird pro Session neu durchgeführt (behebt Ausfälle nach erneutem Beitreten).
• Latenzkorrektur über die gemeinsame Weltzeit.
• Harmony-Patch auf StartMusic, damit das Spiel auf dem Client nicht gegen die Synchronisierung arbeitet.
• Sanftere Drift-Korrektur (kleinerer Pitch-Bereich, Totzone, harter Sprung erst ab 0,5 s).
• Robustere Absender-Prüfung der Host-Pakete.

0.4.0

• Erste Version.