Valheim Mod Manager

Valheim Mod マネージャー

概要

Thunderstore.io から Valheim の MOD を管理するためのシンプルなコマンドライン アプリケーション。

• テスト用にローカルにインストールされた MOD を管理します
• プレーヤーに ZIP エクスポートを提供します
• 公開時にMODを自動的にサーバーにデプロイします

Valheim MOD マネージャーのデモビデオ

要件

(ピップ付き)

pip3 install packaging python-magic paramiko

(ネイティブパッケージを使用)

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

Python3 と [packaging、python-magic、paramiko] パッケージ。 Ubuntu 22.04 および Debian 12 と Python 3.11 でテスト済み

構成

config.yml.DEFAULT config.ymlにコピーし、必要に応じて調整します。

デバッグ

デバッグ出力のためにデバッグ フラグをtrueに設定します。

ゲームディレクトリ

ローカルの Valheim インストールの場所に設定します

エクスポートプレフィックス

エクスポートするファイル名に設定します。サーバー名または意味のあるものを先頭に追加する場合に便利です。

エクスポートディレクトリ

バンドルされた MOD をエクスポートし、情報を変更するためのディレクトリ。ユーザーへの自動デプロイのために Nextcloud によって管理されるディレクトリに自由に設定できます。

更新日

「更新された」パッケージの日数を設定します。これを「14」に設定すると、過去 14 日間に更新されたすべてのプラグインが「更新された」パッケージのエクスポートにエクスポートされます。

sftp_host

エクスポート中に「サーバー」プラグインを自動的にデプロイするには、IP またはホスト名に設定します。空の場合、このロジックはスキップされます

sftp_user

SSH 経由で接続するユーザー名 (キーベースの認証のみ)

sftp_path

Valheim がインストールされている専用サーバー上のパス (自動展開用)

オーバーライドサーバー

サーバー展開を強制するプラグインのカンマ区切りリスト 通常、「server」タグのフラグが付いている 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 は別の作者によって公開されていますが、名前は同じです)。

1. インストールされている Mod をリストする

インストールされている MOD をリストすると一目瞭然です。現在インストールされている MOD とバージョンが一覧表示されます。

2.新規インストール

新しい MOD をインストールするには、MOD 名またはサンダーストア URL を検索します。どのバージョンをインストールするかを選択するオプションが表示されます (デフォルトは最新バージョン)。依存関係は自動的に処理されます。

3. アップデートを確認する

ロードしたら、 Check For Updatesを使用してローカル MOD を更新できます。これにより、インストールされているすべての MOD を迅速に更新できるようになります。

4.Modをアンインストールする

Mod の削除はUninstall Modによって実行されますが、ユーザー エクスポート パッケージの場合、更新時にそれらの Mod を手動で削除する必要があるため、どの Mod が削除されるかをユーザーに通知することが重要です。 (残念なことに、ZIP ファイルは「このディレクトリを削除」オプションをサポートしていません。)

MOD がインストール、削除、または更新されると、ローカル ゲーム クライアントは自動的に更新されます。これにより、導入前に MOD をテストできます。 (これは重要です。一部の MOD はゲームやキャラクターを壊す可能性があることに注意してください。)不正な動作をしている MOD については、 Revert Modificationsで元に戻すことができます。これにより、MOD が元のデプロイされた状態にロールバックされます (完全に削除されるか、特定のバージョンにリセットされます)。

最後に、 Export/Package Modsユーザーのためにさまざまなファイルを作成します。完全なエクスポートには、すべての MOD と BepInEx、過去 (デフォルト) 14 日間に更新された MOD のみを含む更新 zip、すべての変更を含む公開可能な CHANGELOG、および現在インストールされているすべての MOD とそのMOD を含む MODS ファイルが含まれます。バージョン。

サーバー改造

Server-sideフラグでタグ付けされた MOD の場合、プライベート サーバーにデプロイするために.cache/serverにもコピーされます。

sftp_オプションが設定されている場合、ライブラリは新しいバンドルのリリース時にこれらの MOD をゲーム サーバーに自動的にアップロードします。

手動でデプロイする場合は、準備ができたらこれらのファイルをゲーム サーバーにコピーするだけです。

テクニカルノート

このアプリケーションはファイル キャッシュを多用します。 thunderstore.io からの完全なパッケージ リストは 1 時間に 1 回 (デフォルト) のみダウンロードされ、MOD パッケージは.cache/packagesに保存されるため、同じパッケージを繰り返しインストールする場合にサイトから再度ダウンロードする必要はありません。