PapyrusUtil SE - Fonctions utilitaires de script pour moddeurs

1. Description
2. Exigences
3. Installation
4. Désinstallation
5. Mise à jour
6. Compatibilité et problèmes
7. Crédits
8. Journal des modifications


1. Description

Ce plugin SKSE permet d'enregistrer un nombre quelconque de valeurs de type entier, flottant, formulaire et chaîne de caractères, soit dans n'importe quel formulaire, soit globalement depuis des scripts Papyrus. Il prend également en charge les listes de ces types de données. Ces valeurs sont accessibles depuis n'importe quel mod, ce qui facilite la compatibilité dynamique.

PapyrusUtil.psc - Vérification de version et initialisation des tableaux de variables.
StorageUtil.psc Stockez des variables et des listes de données dans un formulaire, puis récupérez-les en utilisant le formulaire et le nom de la variable comme clés. Consultez le fichier .psc pour la documentation.
JsonUtil.psc - Similaire à StorageUtil.psc, mais enregistre les données dans des fichiers .json externes personnalisés au lieu de formulaires, ce qui permet de les personnaliser en dehors du jeu et de les stocker indépendamment d'un fichier de sauvegarde utilisateur.
MiscUtil.psc - quelques commandes diverses.
ActorUtil.psc - Remplacement du package d'acteur.

2. Exigences
SKSE SE/AE 2.2.6+ http://skse.silverlock.org/
Bibliothèque d'adresses pour les plugins SKSE : https://www.nexusmods.com/skyrimspecialedition/mods/32444

3. Installation
Utilisez un gestionnaire de mods ou extrayez les fichiers manuellement.


4. Désinstallation
Supprimez les fichiers que vous avez ajoutés à l'étape 9 de l'installation.


5. Mise à jour
Il suffit d'écraser tous les fichiers.


6. Compatibilité et problèmes
Devrait être compatible avec tout.


7. Crédits
exiledviper - Maintenance et refactorisation continues du code source du plugin original
meh321 - version originale, idée, conversion de la bibliothèque d'adresses
Équipe SKSE – pour avoir rendu ce plugin possible
milzschnitte - pour des suggestions
eventHandler, Expired, aers, arha, ianpatt - Assistance à la conversion et à la mise à jour SKSE64



8. Journal des modifications

4.6 AE/SE - 18/01/2024
Mise à jour pour SKSE64 AE/SE 2.2.6 et Skyrim 1.6.1170

4.5 AE/SE - 12/05/2023
Mise à jour pour SKSE64 AE/SE 2.2.4 et Skyrim 1.6.1130

4.4 AE/SE - 01/07/2022
Mise à jour pour SKSE AE version 2.2.2
Ajout des fonctions ListRandom() à StorageUtil et JsonUtil
Corrections de bugs

4.3 AE/SE - 01/07/2022
Mise à jour pour SKSE AE version 2.1.5

4.2 AE/SE - 14/12/2021
Mise à jour pour SKSE AE version 2.1.4

4.1 AE/SE - 23/11/2021
Mise à jour pour SKSE AE version 2.1.3
Mise à jour pour la bibliothèque d'adresses

4.0 AE/SE - 19/11/2021
Mise à jour pour SKSE AE version 2.1.2
Ajout des fonctions RemoveDupe(), GetDiff() et GetMatching() à PapyrusUtil.psc
Correction d'un problème où JsonUtil renvoyait une valeur de formulaire incorrecte lorsque le plugin associé était déchargé.

3.9 SE - 02/04/2020
Chargement fixe des formulaires FF alloués à partir de la sauvegarde partagée
L'emplacement du fichier journal a été modifié : Mes Documents/Mes Jeux/Skyrim Special Edition/SKSE/PapyrusUtilDev.log

3.8 SE - 22/11/2019
Mise à jour pour SKSE 2.0.17
Correction du traitement des formulaires provenant du fichier ESL

3.7b SE - 17/06/2019
Mise à jour pour SKSE64 SE 2.0.16

3.7 SE - 19/03/2019
Mise à jour pour SKSE 2.0.13-15
Ajout de MiscUtil.FoldersInFolder()

3.6b SE - 09/10/2018
Mise à jour pour SKSE64 SE 2.0.11

3.6 SE - 09/10/2018
Mise à jour pour SKSE64 SE 2.0.9/2.0.10

3.5 SE - 09/10/2018
Mise à jour pour SKSE64 SE 2.0.8
Correction des fonctions de numérisation des cellules de MiscUtil

3.4b SE - 04/05/2018
Mise à jour pour SKSE64 SE 2.0.7
Scripts copiés dans le répertoire /source/scripts du Creation Kit


3.4 SE - 01/05/2018
Réintégration des fonctions liées au TFC
Réintégration des fonctions de remplacement du package ActorUtil
Correction d'un problème où les formulaires pouvaient parfois être mal enregistrés ou renvoyés lorsqu'un fichier .esl était actif dans l'ordre de chargement.

Correctif 3.3c SE - 12/04/2017
Mise à jour pour SKSE64 SE 2.0.6

Correctif 3.3b SE - 11/12/2017
Mise à jour pour SKSE64 SE 2.0.5
Réintégration de la fonction MiscUtil.SetMenus()


3.3 SE - 21/10/2017
Version initiale SKSE64



3.3 - 15/09/2016
Divers correctifs pour différents problèmes de plantage et de performances
Nouvelles fonctionnalités de JsonUtil :
Ajout de fonctions de chemin arbitraire pour permettre un formatage JSON personnalisé.
JsonInFolder(string folder) permet d'obtenir un tableau des fichiers JSON présents dans un dossier donné.
Nouvelle fonction MiscUtil :
Utilisez ScanCellNPCsByFaction() pour rechercher des acteurs appartenant à une faction donnée dans une cellule.
Nouvelle fonction de PapyrusUtil :
Utilisez GetScriptVersion() pour obtenir la version du script actuellement installée, qui peut différer de la valeur DLL de GetVersion() en fonction de l'installation variée et/ou défectueuse du mod par l'utilisateur. 
Correctifs :
Corrections apportées à la gestion des fichiers JsonUtil et aux valeurs manquantes
Il y a beaucoup d'autres correctifs dont je ne me souviens plus précisément pour le moment.


3.2 - 01/04/2016

• Nombreuses corrections pour divers problèmes de plantage et de performances
• Nouvelles fonctionnalités de JsonUtil :
      Unload() - Décharge de la mémoire un fichier utilisé par JsonUtil, en enregistrant éventuellement les modifications au préalable. IsPendingSave() - Vérifie si le fichier JSON donné a été modifié depuis son dernier chargement/enregistrement. IsGood() - Vérifie si le fichier JSON donné est actuellement chargé et ne contient aucune erreur. GetErrors() - Renvoie une chaîne formatée contenant les erreurs d'analyse JSON, le cas échéant. JsonInFolder() - Renvoie un tableau de tous les fichiers JSON présents dans un répertoire donné.
• Nouvelles fonctionnalités de StorageUtil :
      CompterObj<type> Prefix() - compte le nombre de clés commençant par une chaîne de caractères dans un objet spécifique. ClearObj<type> Prefix() - supprime toutes les valeurs dont les clés commencent par une chaîne de caractères sur un objet spécifique
• Nouvelles fonctions MiscUtil :
      FilesInFolder() : Renvoie un tableau de tous les fichiers, ou de ceux ayant une extension donnée, contenus dans un dossier. ScanCellActors() : Obtient un tableau des acteurs proches dans une cellule correspondant aux critères. ScanCellObjects() : Obtient un tableau des objets proches d&#39;un type de formulaire spécifique dans une cellule correspondant aux critères. WriteToFile() : Réintégré après avoir été supprimé lors d&#39;une mise à jour précédente. ReadFromFile() : Réintégré après avoir été supprimé lors d&#39;une mise à jour précédente.

3.1 - 09/01/2015

• Correction d&#39;un bug provoquant un plantage lors du chargement des sauvegardes pour certains utilisateurs.
• Nombre ajouté<type> La fonction Prefix() de StorageUtil et JsonUtil compte le nombre de clés commençant par une chaîne de caractères.
• Ajout de Clear<type> Prefix() à StorageUtil - supprime toutes les valeurs dont les clés commencent par une chaîne de caractères
• Ajout de pincement<type> () à StorageUtil - obtient une valeur et la renvoie, puis la supprime du stockage.
• Ajout d&#39;un quart de travail<type> List() à StorageUtil - récupère la première valeur d&#39;une liste puis la supprime de cette liste.
• Ajout de pop<type> List() à StorageUtil - récupère la dernière valeur d&#39;une liste puis la supprime de cette liste.
  

3.0 - 21/08/2015

• REQUIERT SKSE 1.7.3
• StorageUtil &amp; JsonUtil Int/Float/String/FormListToArray()
• Diverses nouvelles fonctions utilitaires et de tableaux dans PapyrusUtil.psc
• Diverses autres nouvelles fonctions dont je ne me souviens plus, principalement liées à la manipulation ou au renvoi de tableaux.
• Correction de divers bugs liés aux plantages
• Performances améliorées pour de nombreuses fonctions
• SUPPRIMÉ MiscUtil.WriteToFile(),ReadFromFile(),ExecuteBat() - Ces fonctions étaient largement inutilisées, représentaient un risque pour la sécurité et étaient mieux réalisées par d&#39;autres moyens.
  

2.8 - 10/03/2014

• Correction d&#39;un bug critique qui faisait que StringListRemove faisait exactement l&#39;inverse de ce que vous attendiez.
• Correction d&#39;un problème de plantage rencontré par certains utilisateurs lors du chargement de fichiers JSON externes par le plugin.
• Ajout de fonctions d&#39;initialisation de tableau Papyrus à PapyrusUtil.psc
  

2.7 - 09/09/2014

• Réactivation de la sauvegarde des packages de remplacement.
• Ajout des fonctions AdjustInt/FloatValue() et Int/FloatListAdjust() à StorageUtil et JsonUtil ; fonctions raccourcies pour ajuster les valeurs existantes de +/- une valeur donnée.
• Ajout d&#39;une fonction ClearAll() à JsonUtil pour vider le contenu d&#39;un fichier JSON externe.
• Nettoyage de diverses fonctions natives afin de mieux vérifier la validité des arguments transmis et ainsi éviter d&#39;éventuels plantages.
  

2.6 - 08/11/2014

• Correction d&#39;un bug provoquant un plantage/blocage lors de la tentative de chargement d&#39;un fichier externe inexistant.
  

2.5 - 08/08/2014

• REQUIERT SKSE 1.7.1
• Réécriture du code source du plugin
• Ajout d&#39;un nouveau script JsonUtil
• Fonction ListSlice() pour copier une liste dans un tableau Papyrus
• Fonction ListCopy() pour copier un tableau Papyrus dans une liste
• Fonction ListResize() pour modifier la longueur de la liste
• Diverses autres corrections de bugs et nouvelles fonctionnalités mineures