用于管理来自 Thunderstore.io 的 Valheim 模组的简单命令行应用程序。
《瓦尔海姆》模组管理器演示视频
(带点)
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 天内更新的任何插件
设置为 IP 或主机名以在导出期间自动部署“服务器”插件。如果为空,则跳过此逻辑
通过 SSH 连接的用户名(仅限基于密钥的身份验证)
安装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 由不同作者发布但具有相同的名称)。
列出已安装的模组是不言自明的;它列出了您当前安装的模组和版本。
可以通过搜索 mod 名称或 Thunderstore URL 来安装新 mod。您将看到要安装哪个版本的选项(默认为最新版本)。依赖关系是自动处理的。
加载后,您可以通过Check For Updates
更新本地模组。这将使您能够快速更新已安装的任何/所有模组。
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
中,因此重复安装同一软件包无需再次从该站点下载。