Valheim Mod Manager

Gestionnaire de modules Valheim

Aperçu

Application simple en ligne de commande pour gérer les mods pour Valheim depuis Thunderstore.io.

• Gère les mods installés localement pour les tests
• Fournit une exportation ZIP pour les joueurs
• Déploie automatiquement les mods sur le serveur lors de la publication

Vidéo de démonstration du gestionnaire de mods Valheim

Exigences

(avec pépin)

pip3 install packaging python-magic paramiko

(avec les packages natifs)

sudo apt install python3-packaging python3-magic python3-paramiko

Python3 et les packages [packaging, python-magic, paramiko]. Testé sur Ubuntu 22.04 et Debian 12 avec Python 3.11

Configuration

Copiez config.yml.DEFAULT dans config.yml et ajustez si nécessaire.

déboguer

Définissez l'indicateur de débogage sur true pour la sortie de débogage

répertoire de jeu

Définir sur l’emplacement de votre installation locale de Valheim

préfixe d'exportation

Définissez le nom du fichier à exporter, utile pour ajouter le nom de votre serveur ou quelque chose de significatif.

répexport

Répertoire pour exporter les mods groupés et modifier les informations, n'hésitez pas à définir un répertoire géré par Nextcloud pour un déploiement automatique pour vos utilisateurs !

jours de mise à jour

Définissez le nombre de jours pour les packages "mis à jour", en définissant ce paramètre sur "14", tout plugin mis à jour au cours des 14 derniers jours sera exporté dans l'exportation du package "mis à jour".

hôte_sftp

Définissez l'adresse IP ou le nom d'hôte pour déployer automatiquement les plugins "serveur" lors de l'exportation. si vide, cette logique est ignorée

utilisateur_sftp

Nom d'utilisateur avec lequel se connecter via SSH (authentification par clé uniquement)

chemin_sftp

Chemin sur le serveur dédié sur lequel Valheim est installé (pour le déploiement automatique)

override_server

Liste de plugins séparés par des virgules pour forcer le déploiement du serveur. Généralement, seuls les mods marqués avec la balise "server" sont déployés, mais parfois les développeurs de mods ne l'incluent pas.

En utilisant

Exécutez ./cli.py pour exécuter le script interactif.

Valheim Mod Manager

1: List Mods Installed
2: Install New Mod
3: Check For Updates
4: Uninstall Mod
5: Revert Modifications
6: Export/Package Mods
Q: Quit Application

Enter 1-6:

Le flux de travail général pour utiliser ce script : exécutez le script pour charger vos mods de jeu actuels dans le gestionnaire. Vous devrez peut-être sélectionner l'auteur que le mod doit utiliser (certains mods sont publiés par des auteurs différents mais portent le même nom).

1. Liste des modules installés

La liste des mods installés est explicite ; il répertorie les mods et les versions que vous avez actuellement installés.

2. Installer un nouveau

L'installation d'un nouveau mod peut être effectuée en recherchant le nom du mod ou l'URL de Thunderstore. Il vous sera proposé de choisir la version à installer (par défaut, la version la plus récente). Les dépendances sont gérées automatiquement.

3. Vérifiez les mises à jour

Une fois chargé, vous pouvez mettre à jour vos mods locaux via Check For Updates . Cela vous donnera la possibilité de mettre à jour rapidement tous les mods installés.

4. Désinstaller le module

La suppression des modules est effectuée via Uninstall Mod , mais pour les packages d'exportation d'utilisateurs, il est important d'informer les utilisateurs des mods qui sont supprimés, car ils devront les supprimer manuellement lors de la mise à jour. (Malheureusement, les fichiers ZIP ne prennent pas en charge l'option "supprimer ce répertoire".)

Votre client de jeu local est automatiquement mis à jour lorsque les mods sont installés, supprimés ou mis à jour. Cela vous permet de tester un mod avant son déploiement. (Remarque, c'est important ! Certains mods briseront votre jeu/personnage !) Pour les mods qui se comportent mal, ils peuvent être annulés via Revert Modifications . Cela ramènera un mod à son état de déploiement d'origine (soit supprimé complètement, soit réinitialisé à une version spécifique).

Enfin, Export/Package Mods créera une variété de fichiers pour vos utilisateurs. Une exportation complète contiendra tous les mods et BepInEx, un zip de mise à jour qui contient uniquement les mods mis à jour au cours des 14 derniers jours (par défaut), un CHANGELOG qui peut être publié contenant toutes les modifications et un fichier MODS qui contient tous les mods actuellement installés et leurs versions.

Mods serveur

Pour les mods marqués avec l'indicateur Server-side , ils sont également copiés dans .cache/server pour être déployés sur votre serveur privé.

Si les options sftp_ sont configurées, la bibliothèque téléchargera automatiquement ces mods sur votre serveur de jeu lors de la sortie d'un nouveau bundle.

Pour les déploiements manuels, copiez simplement ces fichiers sur votre serveur de jeu lorsque vous êtes prêt.

Notes techniques

Cette application utilise beaucoup la mise en cache de fichiers. La liste complète des packages de Thunderstore.io n'est téléchargée qu'une fois par heure (par défaut) et les packages de modules sont stockés dans .cache/packages , donc les installations répétées du même package n'ont pas besoin d'être téléchargées à nouveau depuis le site.