Spectral Music Player - DV

von darklady310187 aka Selene310187



Version: 1.3




*************************************


Wichtig:
########

Update von Version 1.2 auf 1.3:
Es muss nur die .bsa-Datei durch die neue ersetzt werden.
 

Update von vorherigen Versionen auf Version 1.2

Nachdem du deinen Spielstand geladen hast, stoppe die aktuelle Musikwiedergabe der Playlisten und drücke erneut auf den Abspielen-Button.
Dies legt den Wert einer neu hinzugefügten Globalen Variable fest, die für das Cleanup (Aufräum) Skript* benötigt wird. 
Wenn die Option zum automatischen Entfernen der Standard-Musik aktiv ist, deaktiviere diese in den Einstellungen und aktiviere sie
anschließend wieder, damit die Änderungen** wirksam werden. Speichere deinen Spielstand.

* Wenn die Musikwiedergabe der Playlisten aktiv ist, stellt das Skript sicher, dass die benutzerdefinierte Musik nach Laden eines 
Spielstands nicht stecken bleibt (die benutzerdefinierte Musik wird über den Befehl add() eingebunden, aber es gibt einen Bug, der diese
Musik in deinen Spielstand einbackt). Das Skript entfernt alle Spuren der benutzerdefinierten Musik und fügt sie nach ein paar Sekunden
wieder hinzu. Mehr Informationen über den add()-Befehl (MusikType-Variante): https://www.creationkit.com/index.php?title=Add_-_MusicType

** Die Option zum automatischen Entfernen der Standard-Musik wird nun über eine neu hinzugefügte Global Variable gesteuert. Vorher nutzte
ich eine Int-Variable. Diese war aber nicht persistent genug (wenn der Spielstand neugeladen wird, konnte das Aufräum-Skript den Wert dieser 
Variable nicht auslesen).



*************************************





Schritt 1: Die Musik hinzufügen 
===============================

Kopiere den Music-Ordner, die Spectral Music Player.bsa und die Spectral Music Player.esp vom Archiv in deinen Data-Ordner.

Lade ein Musik-Paket deiner Wahl vom Skyrim SE NexusMods herunter. 

Alternativ kannst du jede MP3 (oder ähnliches Audioformat) in das .xwm-Format (oder .wav) mit einem Konvertierungstool umwandeln, 
wie z. B. Yakitori Audio Converter: https://www.nexusmods.com/skyrimspecialedition/mods/17765

Packe bis zu 50 Songs in jeden CustomSongs...-Unterorder unter Data\Music\BetterUntoldLegendsRewards 

Wenn du Probleme mit .wav-Sound-Dateien hast, konvertiere sie ins .xwm-Format 

Stelle sicher, dass Windows die Dateiendungen nicht versteckt.

Ändere die Dateinamen entsprechend um:


Track001.xwm
...
Track050.xwm


oder 


Track001.wav
...
Track050.wav

Wer möchte, kann den Umbenennungsprozess zum Beispiel mit Advanced Renamer (https://www.advancedrenamer.com) vereinfachen: 
- klicke auf "Add method” > New Name
– Gebe ein: Track0
– Klicke auf <Inc Nr>…
– Ziehe die Songs, die umbenannt werden sollen in das Fenster des Programms
– Klicke auf “Start batch” und dann auf “Start”


Schritt 2: Aktiviere die Spectral Music Player.esp
==================================================
Das Aktivieren der Esp ist z. B. im Hauptmenü des Spiels möglich (Spiel starten -> Mods -> Ladereihenfolge -> Kästchen anhaken). 
Alternativ kannst du Vortex (anfängerfreundlich) und Wrye Bash (bringt ein paar nette Spielereien wie das Anlegen von Savegame-Profilen mit)
verwenden; beides gibt es auf Nexusmods.com.


Schritt 3: Rufe das "Spektraler Musikabspieler"-Menü auf
========================================================

Rufe die Spektrale Trommel mittels des Beschwörungszaubers "Bardenwissen – Musikerweiterung" herbei und spreche sie an. Den Zauber kannst du 
am Gerbgestell herstellen, sobald du über eine der Belohnungen dieser Quest verfügst, egal welche.


Schritt 4: Passe die Musiktitel-Limits an
=========================================
Gehe hierfür ins Ingame-Musikabspieler-Menü und navigiere zu Settings > Musiktitel-Limits. Nehme als Wert für das Limit die Anzahl der Tracks 
im dazugehörigen Unterordner.
Verfügbare Kategorien für benutzerdefinierte Songs:
Stadt, Taverne, Zuhause, Kampf, Erkundung und Dungeon.


Schritt 5: Wähle einen Modus ("Modi")
=====================================
Spring-Modus:
Dies ist der Standard-Modus. Das nächste Lied wird nach X Sekunden gespielt (die Anzahl der Sekunden ist unter Einstellungen einstellbar). 
Du kannst mit den Playlist-Buttons wie "Nächstes", "Vorheriges" oder "Zufällig" steuern, welches Lied nun gespielt wird.

Schleifen-Modus:
Die Songs werden immer in einer zufälligen Reifenfolge und in voller Länge gespielt. Wegen der zufälligen Natur dieses Modus ist die Playlist-Steuerung 
auf die Buttons "Abspielen", "Pausieren" und "Beenden" beschränkt.



Schritt 6: Wähle den Kampfmusiktyp, der während des Kampfes zu hören ist (Einstellungen > Kampfmusik)
=====================================================================================================
Der Standard-Kampfmusiktyp ist Skyrims Standard-Kampfmusik ("Standard"). Die anderen Kampfmusiktypen sind "Trommeln" (die Standard-Trommel-Sounds der 
Spektralen Trommel) und "Benutzerdefiniert" (wenn die Lieder des CustomSongsCombat-Ordners während des Kampfes abgespielt werden sollen)


Schritt 7: Wähle eine Playlist und habe Spaß!
=============================================
Sobald du eine Playlist ausgewählt hast, bestätige deine Auswahl mit Abspielen. Sie wird der Sektion "Aktuelle Playlist" im Hauptmenü des Spektralen 
Musikabspielers zugewiesen. Klicke auf Beenden, um die Playlist aus dieser Sektion zu entfernen. Ein Klick auf Pausieren pausiert die aktuelle 
Musikwiedergabe (stattdessen wird ein Stille-Track abgespielt), ohne dass die Playlist aus der Sektion "Aktuelle Playlist" entfernt wird.




Rechtliches:
============
Die Mod ist Open Source, sofern die Nutzung nicht kommerziell ist*. Du kannst mit der Mod machen, was du möchtest, solange du meinen 
Namen (darklady310187) in deinen Danksagungen erwähnst.

* einzige Ausnahme: Ich erlaube Donation Points auf Nexus Mods

Hier sind ein paar Ideen für mögliche Projekte: Du könntest die Mod als Framework für dein eigenes Musik-Paket nutzen. Oder baue Spieldosen
für deine Hausmod (die relevanten Skripte haben das Word "Music" im ihrem Namen).




Versionsgeschichte:
===================

Version Beta 1:
--------------- 	
Erstveröffentlichung der englischen Version


Version Beta 1.1:
-----------------
Wenn die Trommel mit dem Standard-Beschwörungszauber beschworen wird und anschließend mit der "Musikerweiterung"-Version, verschwinden nun die 
Hintergrund-Trommelschläge, sodass sie nicht mehr die Wiedergabe deiner ausgewählten Playlist stören

Das Zauberbuch kann alternativ per Konsolenbefehl hinzugefügt werden*: startquest BB03AddTomeDrum
Bestätige mit Return- oder Enter-Taste. Der Konsolenbefehl startet eine Quest, die das Buch ohne Benachrichtigung deinem Inventar hinzufügt. 
Nachdem das Buch hinzugefügt wurde, lässt sich die Quest mit diesem Konsolenbefehl stoppen: stopquest BB03AddTomeDrum


* Falls du die technischen Details wissen möchtest: Das Zauberbuch wird per Quest Alias (die Reference-Alias-Variante) hinzugefügt. Der erste Reference Alias
ist für den Spieler (verwende "Specific Reference" und "Select Forced Ref") und der zweite ist für das Zauberbuch, welcher als Fill Type "Create Reference to Object"
nutzt (bei "Create" wählst du "In" aus und in der nächsten Dropdown-Liste den Spieler-Alias aus). Wichtig: Die Quest sollte die Option "Run Once" aktiviert haben,
damit das Zauberbuch nur einmal hinzugefügt wird.
Mehr Informationen über Quest Aliases: https://www.creationkit.com/index.php?title=Quest_Aliases


Version 1.0:		
------------
Die Option zum automatischen Entfernen der Standard-Musik funktioniert nun für alle Playlisten statt nur einer

den Text im "Standardmusik entfernen"-Menü gekürzt, da ein Teil davon im Spiel abgeschnitten wurde

Die Meldung "Wähle einen anderen Kampfmusiktyp" erscheint nun als Message in der linken oberen Ecke des Bildschirms anstelle einer Messagebox

Die Esp wurde aufgeräumt, indem ich nicht mehr benötigte Einträge entfernt habe


Version 1.1:
------------
optionale Fortsetzung der Musikwiedergabe nachdem der Trommel befohlen wurde, zu verschwinden (deaktiviert in der Standardeinstellung; > Einstellungen, Seite 2)

Du kannst das Menü des Musikabspieler per Fernbedienung aufrufen, die auch funktioniert, wenn die Trommel nicht anwesend ist. Diese Option findest du ebenfalls
auf Seite 2 der Einstellungen.


Version 1.2:		
-------------

Wenn der Standard-Kampfmusiktyp aktiv ist, wird die Wiedergabe der Nicht-Kampfmusik der Schleifen-Modus-Playlisten fortgeführt
nachdem der Kampf beendet wurde

die Standard-Kampfmusik wird schneller beendet (dies sollte auch den Fehler mit der steckengebliebenen Kampfmusik im Vanilla-Spiel beheben)

Nachdem Neuladen eines Spielstand wird die Wiedergabe der Schleifen-Modus-Playlisten inklusive der benutzerdefinierten Kampfmusik und der
Trommel-Kampfmusik fortgeführt (es dauert ein paar Sekunden, bis die benutzerdefinierte Musik wieder gespielt wird)

Fehler behoben, dass die Option zum automatischen Entfernen der Standard-Musik nach Neuladen eines Spielstands nicht funktioniert. 
Der Fix entfaltet seine Wirkung erst, wenn du diese Option in den Einstellungen ausschaltest und anschließend wieder anschaltest.


Pluginbeschreibung: verfügt nun über fehlenden Konsolenbefehl, der die Quest stoppt, die das Zauberbuch deinem Inventar hinzufügt

Korrektur der Ingame-Beschreibung - Erweiterte Kampf-Buffs: Sie besagte, dass diese Buffs ebenfalls Gesundheit erhöhen. Dies wurde
aber im Laufe der Entwicklung entfernt.

Korrektur der Ingame-Beschreibung - Fernbedienung: es wurde irrtümlicherweise erwähnt, dass man sie auf eine Schnelltaste legen kann.
Während des Testens der neuen Version stellte ich fest, dass man normale Items der Kategorie "Verschieden" nicht auf Schnelltasten
legen kann

Korrektur der Ingame-Beschreibung - Automatische Entfernung der Standardmusik: das Feauture wird erst ausgeführt, wenn du auf den Abspielen-Button
klickst UND das Hauptmenü des Musikabspielers schließt 

Erstveröffentlichung der deutschen Version 
(Ich hatte zwar kurzzeitig eine deutsche Fassung der Version 1.1 veröffentlicht. Aber aufgrund der Fehler, die ich kurz nach der Veröffentlichung 
entdeckte, zog ich diese wieder zurück)


Version 1.3:
------------

Nachdem du der Trommel befohlen hast zu verschwinden, taucht sie nun nach einer Schnellreise nicht wieder auf 
und erscheint erst wieder, wenn sie per Zauber herbeigerufen wird.





Bugs/Einschränkungen:
=====================

Keine Musik in manchen Cellen:
Wenn eine Celle keine Musik zugewiesen bekommen hat, hörst du in dieser keine Musik von den Playlisten

Gleichzeitiges Hören von Standardmusik und benutzerdefinierter Musik:
Während der Entwicklung stellte ich fest, dass die Engine manchmal Probleme hat, die Standardmusik zu pausieren wenn die Musik von den Playlisten abgespielt
wird, sodass man beides gleichzeitig hört. Deswegen habe ich das Feature der automatischen Entfernung der Standardmusik eingebaut (die Entfernung ist nur 
temporär, keine Sorge). Das Feature kann jederzeit in den Einstellungen deaktiviert werden. Alternativ kannst du die Standardmusik manuell mittels der Option 
"Standardmusik entfernen" entfernen (auch hier ist die Entfernung temporär).

Verzögerte Musikwiedergabe:
Wenn du an einem Kampf teilnimmst/ihn beendest oder einen Spielstand neulädst, kann es ein paar Sekunden dauern, bis die benutzerdefinierte Musik anfängt zu
spielen. Der Grund für die Verzögerung am Anfang eines Kampfes kommt wahrscheinlich von der Zielsuche-Funktion, die festlegt, welche Kampfmusik für den
derzeitigen Gegner gespielt werden soll. Oder es hat der Priorität der benutzerdefinierten Kampfmusik/Trommel-Kampfmusik zu tun, die die gleiche
Priorität wie die Standard-Kampfmusik aufweist (ich kann diese nicht höher setzen, da diese dann womöglich mit der speziellen Kampfmusik des Spiels in
Konflikt kommen). Für die verzögerte Musikwiedergabe der Playlisten nach Neuladen eines Spielstands ist das Aufräum-Skript verantwortlich (siehe zweite 
Anmerkung im Abschnitt "Update von vorherigen Versionen auf Version 1.2")





Danksagungen:
==============	
	
Danke an Dylbill für das "Message Menu Tutorial SSE", insbesondere die Videoversion:
https://www.nexusmods.com/skyrimspecialedition/mods/46410
https://youtu.be/BbIvY-Jer0g
https://youtu.be/RIej0my5q3w