MobileGlues

言語: English | 简体中文 | 繁體中文 | 日本語

[!NOTE]

最新バージョン:

2.0.0

リリースを参照してください。

[!NOTE]

互換性のある Minecraft のシェーダーについては、CompatibleShaders.mdをご覧ください。

互換性のある Minecraft の MOD については、CompatibleMods.mdをご覧ください。

お使いのデバイスでの動作状況を確認するには、Mod Support Matrix または Shader Support Matrix をご参照ください。

MobileGlues（「モバイルで、GL は ES を使用する」の意）は、ホストの OpenGL ES 3.x（ベストは 3.2、最低 3.0）上で動作する GL 実装で、Minecraft Java Edition の実行を目的としています。

機能

1. Minecraft のSodium MOD を動作可能。

2. Minecraft のIris MOD または Optifine を使用して、ほとんどの Minecraft シェーダーをレンダリング可能。

3. JourneyMap や Create など、カスタムレンダリングルーチンを持つ一部の Minecraft MOD を動作可能。

4. その他の利便性向上機能：ES ドライバーとして ANGLE を任意で使用、シェーダーパックの再読み込みを速くするシェーダーキャッシュ、Minecraft の GPU 使用率表示への対応など。

シェーダー開発者の方へ

1. MobileGlues は次の処理を自動的に行います：

   • デスクトップ GLSL から GLSL ES への変換
   • layout(binding) 構文の除去
   • version ディレクティブの処理
   • 精度は必ず明示的に宣言してください：

     precision highp float;
     precision highp int;
     

2. MobileGlues は（V1.2.6 以降）次のマクロをシェーダーに注入します：

   #define MG_MOBILEGLUES                   // MobileGlues 環境であることを示す
   #define MG_MOBILEGLUES_VERSION 2000      // バージョン番号（例：2000 = V2.0.0）
   

   これらのマクロを使って、プラットフォーム固有の処理を書けます：

   #ifdef MG_MOBILEGLUES
       #if MG_MOBILEGLUES_VERSION >= 2000
           // MobileGlues（バージョン >= V2.0.0）向けの処理
       #else
           // MobileGlues（バージョン < V2.0.0）向けの処理
       #endif
   #else
       // ...
   #endif
   

3. 問題が発生した場合：

   • シェーダー/プログラムのエラーを無視 を有効にし、ログ（/sdcard/MG/latest.log）を確認してください。

オープンソースリンク

MobileGlues

MobileGlues-plugin

オープンソースライセンス

MobileGlues とそのプラグイン アプリケーションは、GNU LGPL-2.1 ライセンス に基づくオープン ソースです。

リリースの署名を確認する

この節は、お手元の apk が MobileGlues 開発チームによる公式リリースかどうかを確認するための手引きです。

Android build-tools に含まれる apksigner を見つけ、次のコマンドを実行してください：

apksigner verify --print-certs path/to/MobileGlues-plugin.apk

次のように出力されるはずです：

Signer #1 certificate DN: CN=MGDev, OU=MGDev, O=MGDev, L=Unknown, ST=Unknown, C=CN
Signer #1 certificate SHA-256 digest: 324f4efaff81632373dec9bc714a904b64740249410b551b61805340e42ff5d5
Signer #1 certificate SHA-1 digest: 615bc8b2741c24e7e5847b0c5c1d6816d5b0763a
Signer #1 certificate MD5 digest: 320ede9d22c709fe3792c804d5e00153

certificate DN と certificate digest の部分が上記と完全に一致するか確認してください。

公開鍵ファイルと照合したい場合のために、pub.cer と pub.pem も提供しています。お好みのツールで apk をこれらと照合できます。

コール・トゥ・アクション

私たちは小規模なチームのため、すべての異なるデバイスを所有し、それらで完全なテストを行うことができません。

このプロジェクトに興味がある方は、ぜひ以下の方法でプロジェクトに貢献してください！

Mod Support Matrix や Shader Support Matrix を記入してください！

私たちは、シェーダーや MOD の互換性を確認し、多種多様なデバイスでテストするために、皆さんの協力を必要としています！

[!NOTE]
テーブルの記入方法

以下の方法でテーブルを編集できます：

• 新しいデバイスを追加する場合、新しい行を追加してください。（デバイスのコードネームは adb shell getprop ro.product.name で取得可能）
• 新しい項目を追加する場合、新しい列を追加してください。（すべての行で適切に列を追加してください）
• デバイスでの互換性を示す場合、以下の記号を使用してください：
  • ✅（チェックマーク）：互換性あり
  • ❌（バツ）：完全に非互換（問題を報告/リンクを添付）
  • ？（クエスチョンマーク）：未検証（MOD パックに含まれていない/インストールしていない）
  • *️⃣（アスタリスク）：動作するが、一部の機能が欠落またはグラフィックの不具合あり（問題を報告/リンクを添付）
• 必要に応じて、「Additional Drivers/Plugins in use（使用中の追加ドライバー/プラグイン）」の列に、ベンダー提供以外の追加ドライバーやプラグイン（例: Turnip ドライバー、ANGLE など）を記入してください。
• 必要に応じて *device_codename*.md というファイルを作成し、追加情報を提供し、最後の列にリンクを記載してください。

サードパーティコンポーネント

MobileGlues

SPIRV-Cross by KhronosGroup - Apache License 2.0: github

glslang by KhronosGroup - Various Licenses: github

cJSON by DaveGamble - MIT License: github

FidelityFX-FSR by AMD - MIT License: github

Perfetto by Google - Apache License 2.0: github

xxHash by Yann Collet - BSD 2-Clause License: github

flat_hash_map by Malte Skarupke - Boost Software License 1.0: github（skarupke/flat_hash_map のフォークで、32 ビット環境でもヘッダーを include できるようにする修正を含みます）

MobileGlues-plugin

Miuix by compose-miuix-ui - Apache License 2.0: github

Jetpack Compose by Android Open Source Project (AOSP) - Apache License 2.0: Android Developers

AndroidX by Android Open Source Project (AOSP) - Apache License 2.0: Android Developers

kotlinx.coroutines by JetBrains - Apache License 2.0: github

Gson by Google - Apache License 2.0: github