PapyrusUtil SE – Modder-Skripting-Hilfsfunktionen

1. Beschreibung
2. Anforderungen
3. Installation
4. Deinstallation
5. Aktualisieren
6. Kompatibilität & Probleme
7. Abspann
8. Änderungsübersicht


1. Beschreibung

Dieses SKSE-Plugin ermöglicht das Speichern beliebiger Mengen von Integer-, Float-, Form- und String-Werten in beliebigen Formularen oder global aus Papyrus-Skripten. Es unterstützt auch Listen dieser Datentypen. Die Werte sind von jedem Mod aus zugänglich und gewährleisten so eine einfache dynamische Kompatibilität.

PapyrusUtil.psc - Versionsprüfung & Initialisierung von Variablenarrays.
StorageUtil.psc - Variablen und Datenlisten werden in einem Formular gespeichert, das mithilfe des Formulars und des Variablennamens als Schlüssel wieder abgerufen werden kann. Die Dokumentation finden Sie in der Datei psc.
JsonUtil.psc - ähnlich wie StorageUtil.psc, speichert die Daten jedoch in benutzerdefinierten externen .json-Dateien anstatt in Formularen, sodass sie außerhalb des Spiels angepasst und unabhängig von einer Benutzerspeicherdatei gespeichert werden können.
MiscUtil.psc - einige verschiedene Befehle.
ActorUtil.psc - Actor-Paketüberschreibung.

2. Anforderungen
SKSE SE/AE 2.2.6+ http://skse.silverlock.org/
Adressbibliothek für SKSE-Plugins: https://www.nexusmods.com/skyrimspecialedition/mods/32444

3. Installation
Benutze einen Mod-Manager oder extrahiere die Dateien manuell.


4. Deinstallation
Entfernen Sie die Dateien, die Sie in Installationsschritt 9 hinzugefügt haben.


5. Aktualisierung
Einfach alle Dateien überschreiben.


6. Kompatibilität und Probleme
Sollte mit allem kompatibel sein.


7. Credits
exiledviper – fortlaufende Wartung und Refaktorisierung des Quellcodes des ursprünglichen Plugins
meh321 – Originalversion, Idee, Adressbibliothek-Konvertierung
SKSE-Team – für die Entwicklung dieses Plugins
Milzschnitte - für Vorschläge
eventHandler, Expired, aers, arha, ianpatt – Unterstützung bei SKSE64-Konvertierung und -Aktualisierung



8. Änderungsprotokoll

4.6 AE/SE - 18.01.2024
Aktualisiert für SKSE64 AE/SE 2.2.6 & Skyrim 1.6.1170

4,5 AE/SE - 12.05.2023
Aktualisiert für SKSE64 AE/SE 2.2.4 & Skyrim 1.6.1130

4.4 AE/SE - 01.07.2022
Aktualisiert für SKSE AE Build 2.2.2
Die Funktionen ListRandom() wurden zu StorageUtil und JsonUtil hinzugefügt.
Einige Fehlerbehebungen

4.3 AE/SE - 01.07.2022
Aktualisiert für SKSE AE Build 2.1.5

4.2 AE/SE - 14.12.2021
Aktualisiert für SKSE AE Build 2.1.4

4.1 AE/SE - 23.11.2021
Aktualisiert für SKSE AE Build 2.1.3
Aktualisiert für die Adressbibliothek

4.0 AE/SE - 19.11.2021
Aktualisiert für SKSE AE Build 2.1.2
Die Funktionen RemoveDupe(), GetDiff() und GetMatching() wurden zu PapyrusUtil.psc hinzugefügt.
Es wurde ein Fehler behoben, durch den JsonUtil einen falschen Formularwert zurückgab, wenn das zugehörige Plugin entladen wurde.

3,9 SE - 02.04.2020
Das Laden der FF-zugeordneten Formulare aus der gemeinsamen Speicherung wurde korrigiert.
Der Speicherort der Protokolldatei wurde geändert in: Eigene Dokumente/Eigene Spiele/Skyrim Special Edition/SKSE/PapyrusUtilDev.log

3,8 SE - 22.11.2019
Aktualisiert für SKSE 2.0.17
Problem mit der Verarbeitung von Formularen aus ESL-Dateien behoben

3.7b SE - 17.06.2019
Aktualisiert für SKSE64 SE 2.0.16

3.7 SE - 19.03.2019
Aktualisiert für SKSE 2.0.13-15
MiscUtil.FoldersInFolder() hinzugefügt

3.6b SE - 09.10.2018
Aktualisiert für SKSE64 SE 2.0.11

3.6 SE - 09.10.2018
Aktualisiert für SKSE64 SE 2.0.9/2.0.10

3,5 SE - 09.10.2018
Aktualisiert für SKSE64 SE 2.0.8
Die Scan-Zellen-Funktionen von MiscUtil wurden korrigiert.

3.4b SE - 04.05.2018
Aktualisiert für SKSE64 SE 2.0.7
Die Skripte wurden in den Creation Kit-Pfad /source/scripts kopiert.


3.4 SE - 01.05.2018
TFC-bezogene Funktionen wurden wieder hinzugefügt.
Die Überschreibungsfunktionen des ActorUtil-Pakets wurden wieder hinzugefügt.
Problem behoben, bei dem Formulare manchmal falsche Daten speicherten/zurückgaben, wenn eine .esl-Datei in der Ladereihenfolge aktiv war.

3.3c SE Hotfix – 12.04.2017
Aktualisiert für SKSE64 SE 2.0.6

3.3b SE Hotfix – 11.12.2017
Aktualisiert für SKSE64 SE 2.0.5
Die Funktion MiscUtil.SetMenus() wurde wieder hinzugefügt.


3.3 SE- 21.10.2017
Erste SKSE64-Version veröffentlicht



3.3 - 15.09.2016
Diverse Lösungsansätze für diverse Absturz- und Leistungsprobleme
Neue Funktionen von JsonUtil:
Es wurden beliebige Pfadfunktionen hinzugefügt, um eine benutzerdefinierte JSON-Formatierung zu ermöglichen.
JsonInFolder(string folder) gibt ein Array von JSON-Dateien zurück, die sich in einem bestimmten Ordner befinden.
Neue Funktion von MiscUtil:
ScanCellNPCsByFaction() durchsucht Zellen nach Akteuren innerhalb einer bestimmten Fraktion.
Neue Funktion von PapyrusUtil:
GetScriptVersion() gibt die aktuell installierte Skriptversion an, die je nach Mod-Installation des Benutzers (variant und/oder fehlerhaft) vom DLL-Wert von GetVersion() abweichen kann. 
Behoben:
Einige Korrekturen für die JsonUtil-Dateiverarbeitung und fehlende Werte
Viele weitere Korrekturen, an die ich mich im Moment nicht genau erinnern kann.


3.2 - 01.04.2016

• Zahlreiche Lösungsansätze für diverse Absturz- und Leistungsprobleme
• Neue Funktionen von JsonUtil:
      Unload() – Entlädt eine von JsonUtil verwendete Datei aus dem Speicher und speichert optional vorher die Änderungen. IsPendingSave() – Prüft, ob die angegebene JSON-Datei seit dem letzten Laden/Speichern geändert wurde. IsGood() – Prüft, ob die angegebene JSON-Datei aktuell geladen ist und keine Fehler enthält. GetErrors() – Gibt eine formatierte Zeichenkette mit allen JSON-Parsing-Fehlern zurück, falls vorhanden. JsonInFolder() – Gibt ein Array aller JSON-Dateien in einem angegebenen Verzeichnis zurück.
• Neue Funktionen von StorageUtil:
      CountObj<type> Prefix() - zählt die Anzahl der Schlüssel, die mit string beginnen, in einem bestimmten Objekt. ClearObj<type> Prefix() - entfernt alle Werte eines bestimmten Objekts, deren Schlüssel mit „string“ beginnen.
• Neue Funktionen von MiscUtil:
      FilesInFolder() – Gibt ein Array aller Dateien in einem Ordner oder mit einer bestimmten Dateiendung zurück. ScanCellActors() – Gibt ein Array von Akteuren in einer Zelle zurück, die den Kriterien entsprechen. ScanCellObjects() – Gibt ein Array von Objekten eines bestimmten Typs in einer Zelle zurück, die den Kriterien entsprechen. WriteToFile() – Fügt eine Datei nach dem Entfernen im vorherigen Update wieder hinzu. ReadFromFile() – Fügt eine Datei nach dem Entfernen im vorherigen Update wieder hinzu.

3.1 - 09.01.2015

• Es wurde ein Fehler behoben, der bei einigen Benutzern während des Ladens von Speicherständen zum Absturz führte.
• Hinzugefügte Anzahl<type> Die Prefix()-Funktion von StorageUtil und JsonUtil zählt die Anzahl der Schlüssel, die mit dem Präfix beginnen.
• Klar hinzugefügt<type> Prefix() für StorageUtil - entfernt alle Werte, deren Schlüssel mit dem String beginnen.
• Zupfmittel hinzugefügt<type> () zu StorageUtil - holt einen Wert, gibt ihn zurück und entfernt ihn anschließend aus dem Speicher.
• Schicht hinzugefügt<type> List() zu StorageUtil - holt den ersten Wert einer Liste und entfernt ihn dann aus dieser Liste.
• Pop hinzugefügt<type> List() zu StorageUtil - holt den letzten Wert einer Liste und entfernt ihn dann aus dieser Liste.
  

3.0 - 21.08.2015

• ERFORDERT SKSE 1.7.3
• StorageUtil &amp; JsonUtil Int/Float/String/FormListToArray()
• Diverse neue Hilfs- und Arrayfunktionen in PapyrusUtil.psc
• Diverse weitere neue Funktionen, an die ich mich nicht erinnern kann, die hauptsächlich mit dem Umgang mit oder der Rückgabe von Arrays zusammenhängen.
• Diverse absturzbedingte Fehler wurden behoben.
• Verbesserte Leistung für viele Funktionen
• ENTFERNT MiscUtil.WriteToFile(),ReadFromFile(),ExecuteBat() - Funktionen wurden größtenteils nicht genutzt, stellten ein Sicherheitsrisiko dar und konnten besser auf andere Weise erreicht werden.
  

2.8 - 10.03.2014

• Ein kritischer Fehler wurde behoben, der dazu führte, dass StringListRemove genau das Gegenteil von dem tat, was man eigentlich wollte.
• Es wurde ein Problem behoben, das bei einigen Benutzern beim Laden externer JSON-Dateien durch das Plugin zum Absturz des Desktops auftrat.
• PapyrusUtil.psc wurden Funktionen zur Initialisierung von Papyrus-Arrays hinzugefügt.
  

2.7 - 09.09.2014

• Die Speicherung von Paketüberschreibungen wurde wieder hinzugefügt.
• Die Funktionen `AdjustInt/FloatValue()` und `Int/FloatListAdjust()` wurden zu `StorageUtil` und `JsonUtil` hinzugefügt. Diese Kurzfunktionen ermöglichen das Anpassen vorhandener Werte um einen bestimmten Betrag (+/-).
• JsonUtil wurde um die Funktion ClearAll() erweitert, um den Inhalt externer JSON-Dateien zu leeren.
• Diverse native Funktionen wurden überarbeitet, um besser zu prüfen, ob korrekte Argumente übergeben werden und so potenzielle Abstürze zu verhindern.
  

2.6 - 08.11.2014

• Ein Fehler wurde behoben, der beim Versuch, eine nicht existierende externe Datei zu laden, zu einem Absturz/Einfrieren führte.
  

2.5 - 08.08.2014

• ERFORDERT SKSE 1.7.1
• Überarbeitung des Plugin-Quellcodes
• Neues JsonUtil-Skript hinzugefügt
• Die ListSlice()-Funktion kopiert eine Liste in ein Papyrus-Array.
• Die Funktion ListCopy() kopiert ein Papyrus-Array in eine Liste.
• Die Funktion ListResize() dient zum Ändern der Listenlänge.
• Diverse weitere Fehlerbehebungen und kleinere neue Funktionen