Valheim Mod Manager

Valheim Mod Manager

Überblick

Einfache Befehlszeilenanwendung zum Verwalten von Mods für Valheim über Thunderstore.io.

• Verwaltet lokal installierte Mods zum Testen
• Bietet ZIP-Export für Spieler
• Stellt Mods bei der Veröffentlichung automatisch auf dem Server bereit

Valheim-Mod-Manager-Demovideo

Anforderungen

(mit Pip)

pip3 install packaging python-magic paramiko

(mit nativen Paketen)

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

Python3 und die Pakete [packaging, python-magic, paramiko]. Getestet auf Ubuntu 22.04 und Debian 12 mit Python 3.11

Konfiguration

Kopieren Sie config.yml.DEFAULT nach config.yml und passen Sie es nach Bedarf an.

debuggen

Setzen Sie das Debug-Flag für die Debug-Ausgabe auf true

gamedir

Stellen Sie den Speicherort Ihrer lokalen Valheim-Installation ein

Exportpräfix

Legen Sie den Namen der zu exportierenden Datei fest. Dies ist nützlich, um Ihren Servernamen oder etwas aussagekräftiges voranzustellen.

Exportverzeichnis

Verzeichnis zum Exportieren gebündelter Mods und Änderungsinformationen. Sie können es gerne auf ein von Nextcloud verwaltetes Verzeichnis für die automatische Bereitstellung für Ihre Benutzer festlegen!

Updatetage

Legen Sie die Anzahl der Tage für „aktualisierte“ Pakete fest. Wenn Sie diesen Wert auf „14“ setzen, werden alle Plugins, die in den letzten 14 Tagen aktualisiert wurden, in den „aktualisierten“ Paketexport exportiert

sftp_host

Legen Sie die IP-Adresse oder den Hostnamen fest, um beim Export automatisch „Server“-Plugins bereitzustellen. wenn leer, wird diese Logik übersprungen

sftp_user

Benutzername für die Verbindung über SSH (nur schlüsselbasierte Authentifizierung)

sftp_path

Pfad auf dem dedizierten Server, auf dem Valheim installiert ist (für die automatische Bereitstellung)

override_server

Durch Kommas getrennte Liste von Plugins, um die Serverbereitstellung zu erzwingen. Normalerweise werden nur Mods bereitgestellt, die mit dem „Server“-Tag gekennzeichnet sind, aber manchmal schließen Mod-Entwickler dies nicht ein.

Benutzen

Führen Sie ./cli.py aus, um das interaktive Skript auszuführen.

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:

Der allgemeine Arbeitsablauf für die Verwendung dieses Skripts: Führen Sie das Skript aus, um Ihre aktuellen Spielmods in den Manager zu laden. Möglicherweise müssen Sie auswählen, welchen Autor der Mod verwenden soll (einige Mods werden von verschiedenen Autoren veröffentlicht, haben aber denselben Namen).

1. Installierte Mods auflisten

Die Auflistung der installierten Mods ist selbsterklärend; Es listet die Mods und Versionen auf, die Sie derzeit installiert haben.

2. Neu installieren

Die Installation eines neuen Mods kann durch die Suche nach dem Mod-Namen oder der Thunderstore-URL erfolgen. Ihnen wird die Option angezeigt, welche Version Sie installieren möchten (standardmäßig ist die neueste Version). Abhängigkeiten werden automatisch gehandhabt.

3. Suchen Sie nach Updates

Nach dem Laden können Sie Ihre lokalen Mods über Check For Updates aktualisieren. Dadurch haben Sie die Möglichkeit, alle installierten Mods schnell zu aktualisieren.

4. Mod deinstallieren

Das Entfernen von Mods erfolgt über Uninstall Mod . Bei Benutzerexportpaketen ist es jedoch wichtig, Benutzer darüber zu informieren, welche Mods entfernt werden, da sie diese Mods bei der Aktualisierung manuell entfernen müssen. (ZIP-Dateien unterstützen die Option „Dieses Verzeichnis löschen“ leider nicht.)

Ihr lokaler Spielclient wird automatisch aktualisiert, wenn Mods installiert, entfernt oder aktualisiert werden. Auf diese Weise können Sie einen Mod vor der Bereitstellung testen. (Beachten Sie, dass dies wichtig ist! Einige Mods zerstören Ihr Spiel/Ihren Charakter!) Mods, die sich schlecht benehmen, können über Revert Modifications rückgängig gemacht werden. Dadurch wird ein Mod auf seinen ursprünglichen Bereitstellungsstatus zurückgesetzt (entweder ganz entfernt oder auf eine bestimmte Version zurückgesetzt).

Schließlich erstellen Export/Package Mods eine Vielzahl von Dateien für Ihre Benutzer. Ein vollständiger Export enthält alle Mods und BepInEx, eine Update-ZIP-Datei, die nur Mods enthält, die in den letzten (standardmäßig) 14 Tagen aktualisiert wurden, ein CHANGELOG, das veröffentlicht werden kann und alle Änderungen enthält, und eine MODS-Datei, die alle derzeit installierten Mods und deren enthält Versionen.

Server-Mods

Mods, die mit dem Flag Server-side gekennzeichnet sind, werden auch in .cache/server kopiert, um sie auf Ihrem privaten Server bereitzustellen.

Wenn die sftp_ Optionen konfiguriert sind, lädt die Bibliothek diese Mods automatisch auf Ihren Spieleserver hoch, wenn ein neues Bundle veröffentlicht wird.

Für manuelle Bereitstellungen kopieren Sie diese Dateien einfach auf Ihren Spieleserver, wenn Sie fertig sind.

Technische Hinweise

Diese Anwendung nutzt das Datei-Caching stark aus. Die vollständige Paketliste von Thunderstore.io wird (standardmäßig) nur einmal pro Stunde heruntergeladen und Mod-Pakete werden in .cache/packages gespeichert, sodass bei wiederholten Installationen desselben Pakets kein erneuter Download von der Website erforderlich ist.