ESCraft

ESCraft

Нативный слой трансляции OpenGL ES для Minecraft

ESCraft — это высокопроизводительный мод на совместимость рендеринга, который переводит десктопные вызовы OpenGL из Minecraft в нативные команды OpenGL ES.

Поддерживаемые платформы: Windows x64, Linux x64 и Android.
支持平台： 仅限 Windows x64、Linux x64 以及安卓设备。

🇬🇧 English Description

🛠️ Как это работает

В отличие от традиционных обёрток, ESCraft работает на уровне движка, перенаправляя вызовы рендеринга:

• Трансляция вызовов: Перехватывает десктопные вызовы OpenGL и переводит их в эквиваленты OpenGL ES.
• Транспиляция шейдеров: Использует ShaderC и SpirvC для динамической транспиляции GLSL-шейдеров Minecraft в совместимый с GLES код шейдеров (ESSL) на лету.
• Интеграция SPIR-V: Задействует промежуточное представление для обеспечения высокоточной реконструкции графики на драйверах GLES.

🌟 Ключевые особенности

• Производительность: Спроектирован для минимизации накладных расходов за счёт прямого использования нативных возможностей GLES 3.2+.
• Продвинутая поддержка шейдеров: Обрабатывает сложные шейдеры core-профиля, конвертируя их через надёжный конвейер SPIR-V.
• Аппаратный мост: Позволяет современному Minecraft (OpenGL 3.3+) работать на Android GPU и в средах, ориентированных на GLES, без тяжёлых слоёв трансляции вроде 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

• Source Code: GitHub Repository
• Bug Tracker: Report Issues