Logo
ESCraft
ModMIT

ESCraft

ESCraft is a Fabric Mod that port Minecraft to OpenGL ES Backend API

294
Downloads
2
Followers
3 months ago
Updated
📦
2
Versions
optimizationfabric
Download Latestv2.0View on Modrinth

📖About ESCraft

ESCraft

Native OpenGL ES Translation Layer for Minecraft

API
Target_API
Platform

ESCraft is a high-performance rendering compatibility mod that translates Minecraft's desktop OpenGL calls into native OpenGL ES commands.

Supported Platforms: Windows x64, Linux x64, and Android.
支持平台： 仅限 Windows x64、Linux x64 以及安卓设备。

🇬🇧 English Description

🛠️ How it Works

Unlike traditional wrappers, ESCraft operates at the engine level to redirect rendering calls:

  • Call Translation: Intercepts desktop OpenGL invocations and translates them into their OpenGL ES equivalents.
  • Shader Transpilation: Utilizes ShaderC and SpirvC to dynamically transpile Minecraft's GLSL shaders into GLES-compatible shader code (ESSL) on the fly.
  • SPIR-V Integration: Leverages intermediate representation to ensure high-fidelity graphics reconstruction on GLES drivers.

🌟 Key Features

  • Performance-Driven: Designed to minimize overhead by utilizing native GLES 3.2+ features directly.
  • Advanced Shader Support: Handles complex core profile shaders by converting them through a robust SPIR-V pipeline.
  • Hardware Bridge: Allows modern Minecraft (OpenGL 3.3+) to run on Android GPUs and GLES-centric environments without heavy translation layers like GL4ES.

🇨🇳 中文介绍

🛠️ 技术原理

ESCraft 是一个深度的渲染兼容层模组，通过在底层修改 Minecraft 的渲染行为来实现跨 API 支持：

  • 调用转换： 将 Minecraft 原生的桌面级 OpenGL 调用动态转换为 OpenGL ES 指令。
  • Shader 转译： 集成了 ShaderC 与 SpirvC，将游戏的 GLSL Shader 实时转译为兼容 GLES 的着色器代码（ESSL）。
  • SPIR-V 流水线： 通过引入 SPIR-V 中间层，确保即便在移动端或嵌入式驱动上也能精准重现游戏的视觉效果。

🌟 核心特性

  • 原生级效率： 针对 GLES 3.2+ 特性优化，直接调用驱动接口，减少性能损耗。
  • 动态着色器处理： 完美处理现代版本 Minecraft 的核心配置文件（Core Profile）着色器。
  • 硬件桥接： 让原本需要 OpenGL 3.3+ 的现代 Minecraft 能够在仅支持 GLES 的安卓或嵌入式设备上原生运行。

📥 Installation / 安装指南

📱 Android (Required / 必须按步骤操作)

  1. Check Requirements: Ensure your device and GPU drivers support OpenGL ES 3.2 or higher.
    检查要求： 确保你的设备硬件及驱动支持 OpenGL ES 3.2 或更高版本。
  2. Custom Launcher: You must use the specific build of ZalithLauncher_ESCraft. Download it from GitHub Actions. Do not choose the "GL4ES" renderer.
    获取启动器： 你必须使用 ZalithLauncher_ESCraft 的定制版本。请前往 GitHub Actions 下载。注意：不要选择 GL4ES 渲染器。
  3. JVM Arguments: Add the following line to your launcher's JVM Arguments (Runtime arguments):
    添加启动参数： 在启动器的 JVM 参数（运行参数）设置中，必须添加以下代码：
    -Dorg.lwjgl.opengles.libname=libGLESv2.so
  4. Install Mod: Install Fabric Loader and place the ESCraft.jar into your mods folder.
    安装模组： 安装 Fabric Loader 并将 ESCraft.jar 放入 mods 文件夹。

💻 Windows x64 / Linux x64

  1. Prerequisites: Ensure your system has a valid EGL and OpenGL ES 3.2+ environment (e.g., via native drivers or ANGLE).
    环境检查： 确保你的系统已具备 EGL 和 OpenGL ES 3.2+ 运行环境。
  2. Install Mod: Install Fabric Loader and place the ESCraft.jar into your mods folder.
    安装模组： 安装 Fabric Loader 并将 ESCraft.jar 放入 mods 文件夹。

🔗 Resources