Valheim Mod Manager

瓦爾海姆模組經理

概述

用於管理來自 Thunderstore.io 的 Valheim 模組的簡單命令列應用程式。

• 管理本地安裝的模組以進行測試
• 為玩家提供ZIP導出
• 發布後自動將模組部署到伺服器

《瓦爾海姆》模組管理器示範視頻

要求

（帶點）

pip3 install packaging python-magic paramiko

（使用原生套件）

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

Python3 和 [packaging、python-magic、paramiko] 套件。使用 Python 3.11 在 Ubuntu 22.04 和 Debian 12 上進行測試

配置

將config.yml.DEFAULT複製到config.yml並依需求進行調整。

偵錯

將調試標誌設為true以進行調試輸出

遊戲目錄

設定為您本地 Valheim 安裝的位置

導出前綴

設定為要匯出的檔案名，對於在前面新增伺服器名稱或有意義的名稱很有用。

匯出目錄

用於匯出捆綁模組和變更資訊的目錄，請隨意設定為由 Nextcloud 管理的目錄，以便為您的使用者自動部署！

更新天數

設定「更新」套件的天數，將其設定為「14」將在「更新」套件匯​​出中匯出過去 14 天內更新的任何插件

sftp_主機

設定為 IP 或主機名稱以在匯出期間自動部署「伺服器」插件。如果為空，則跳過此邏輯

sftp_用戶

透過 SSH 連線的使用者名稱（僅限基於金鑰的身份驗證）

sftp_路徑

安裝Valheim的專用伺服器上的路徑（用於自動部署）

覆蓋伺服器

用於強制伺服器部署的以逗號分隔的外掛程式清單通常只會部署標有「伺服器」標籤的 mod，但有時 mod 開發人員不會包含該內容。

使用

執行./cli.py以執行互動式腳本。

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:

使用此腳本的一般工作流程：執行腳本將目前的遊戲模組載入到管理器中。您可能需要選擇 mod 應使用哪一位作者（某些 mod 由不同作者發布但具有相同的名稱）。

1. 列出已安裝的模組

列出已安裝的模組是不言自明的；它列出了您目前安裝的模組和版本。

2. 安裝新的

可以透過搜尋 mod 名稱或 Thunderstore URL 來安裝新 mod。您將看到要安裝哪個版本的選項（預設為最新版本）。依賴關係是自動處理的。

3.檢查更新

載入後，您可以透過Check For Updates更新本機模組。這將使您能夠快速更新已安裝的任何/所有模組。

4.卸載模組

Mod 刪除是透過Uninstall Mod執行的，但對於用戶匯出包，通知用戶哪些 mod 被刪除非常重要，因為他們需要在更新時手動刪除這些 mod。 （遺憾的是，ZIP 檔案不支援「刪除此目錄」選項。）

安裝、刪除或更新模組時，您的本機遊戲用戶端會自動更新。這允許您在部署之前測試模組。 （注意，這很重要！某些模組會破壞您的遊戲/角色！）對於行為不當的模組，可以透過Revert Modifications來恢復它們。這會將 mod 回滾到其原始部署狀態（完全刪除或重置回特定版本）。

最後， Export/Package Mods將為您的使用者建立各種檔案。完整匯出將包含所有 mod 和 BepInEx、僅包含最近（預設）14 天內更新的 mod 的更新 zip、可發佈的包含所有變更的 CHANGELOG，以及包含所有目前安裝的 mod 及其的 MODS 檔案。

伺服器模組

對於標有Server-side標誌的 mod，它們也會被複製到.cache/server中以部署到您的私人伺服器。

如果配置了sftp_選項，程式庫將在發布新套件時自動將這些 mod 上傳到您的遊戲伺服器。

對於手動部署，只需在準備好後將這些檔案複製到您的遊戲伺服器即可。

技術說明

該應用程式大量使用檔案快取。 Thunderstore.io 的完整軟體包清單每小時僅下載一次（預設），且 mod 軟體包儲存在.cache/packages中，因此重複安裝相同軟體包無需再次從該網站下載。