Mod の読み込み
Minecraft Bedrock 自体には Mod の仕組みがありません。Mod はネイティブコードで、ゲームの起動時にローダーがゲームのプロセスへ読み込みます。このページでは、LeviLauncher が使うローダー、Mod の置き場所、そして Mod を追加するいくつかの方法の関係を説明します。
Mod の置き場所 Windows
どのインスタンスにも mods\ フォルダーがあります(フォルダーとファイルを参照)。各 Mod はその中の 1 つのフォルダーで、Mod を説明する manifest.json を持ちます。
| フィールド | 意味 |
|---|---|
name |
Mod の名前。 |
entry |
ローダーが読み込むファイル。Mod のフォルダーからの相対パス(.dll)。 |
version |
Mod のバージョン。 |
type |
どのローダーが読み込むか。preload-native は LeviLauncher のネイティブローダー用、LeviLamina 用の Mod には独自の種類があります。 |
author |
作者(省略可)。 |
Mod は 1 つのインスタンスに属します。ゲームデータだけに関わる隔離の影響は受けません。
Mod をオフにする(Mod管理 で、または LeviLauncher.exe mod disable)と、その manifest.json の名前が manifest.json.close に変わり、オンにすると元に戻ります。Mod のファイルはそのまま残り、manifest.json を探すローダーからはその Mod が見えなくなります。
2 つのローダー Windows
LeviLauncher のネイティブローダー
LeviLauncher はインスタンスをインストールまたは準備するとき、自身のローダー LeviLauncher.dll をゲームの実行ファイルの横に置き、実行ファイルのインポートに追加して、Windows がゲームと一緒に読み込むようにします。これは x64 ビルドで、GDK でも UWP でも同じように働きます。隔離もこの仕組みで動いています。
ゲームが起動すると、ネイティブローダーは mods\ 内のフォルダーを名前順に調べ、type が preload-native の各 Mod の entry を読み込みます。manifest.json のないフォルダーとほかの種類の Mod は飛ばします。インスタンスに別のプリローダー(ゲームの横の preloader.dll)がある場合、ネイティブローダーは Mod の読み込みをすべてそちらに任せます。ネイティブローダーには Visual C++ ランタイム(x64)が必要で、LeviLauncher がその有無を確認してインストールを提案します。
LeviLamina
LeviLamina は LeviMC の Mod ローダーです。LeviMC Mods の Mod の多くは LeviLamina の Mod で、インスタンスのゲームバージョンに対応したバージョンの LeviLamina が必要です。LeviLauncher は、対応バージョンの GDK インスタンスに LeviLamina を内蔵パッケージマネージャーのパッケージとしてインストールします(バージョンのインストール時の LeviLamina をインストール スイッチ、または インスタンス設定 の ローダー タブ)。
Mod を追加する 3 つの方法 Windows
| 追加するもの | LeviLauncher の動作 |
|---|---|
LeviMC Mods の Mod(または mod install owner/repo) |
lip 互換の内蔵パッケージマネージャーでパッケージとしてインストールします。このプラットフォーム向けのリリースをダウンロードし、依存するパッケージをインストールし、インスタンスの .lip\state.json に記録します。Mod が LeviLamina を必要とし、インストール済みのものが合わない(または未インストールの)場合は、先に互換性のある LeviLamina をインストールします。こうして入れた Mod はパッケージとして更新・削除できます。 |
.mcmod パッケージ(または .zip) |
mods\ 内の新しいフォルダーに展開します。アーカイブには manifest.json が必要です。 |
単体の .dll |
mods\ 内の新しいフォルダーに置き、manifest.json を書きます。既定では、ファイル名を名前に、preload-native を種類に、0.0.0 をバージョンにします。 |
パッケージは、lip.toml と .lip\state.json の中で side(client または server)と platform(win-x64 など)によって動作する場所を示します。クライアントには、LeviLauncher は Mod に client バリアントがあればそれを、なければ既定のバリアントをインストールします。古いパッケージの移行を含む詳細はMod と統合を参照してください。
Android Android
Android 版はネイティブ Mod、つまりゲームのプロセスで動く .so ライブラリを読み込みます。Mod を入れた環境は隔離したバージョンにまとめ、信頼できる入手元の Mod だけをインストールしてください。自分で作る場合は、LeviLamina のドキュメントの Android native mods に従ってください。