Ironized Zink

Ironized Zink packages the Zink Gallium driver from the Mesa 3-D Graphics Library — the mature OpenGL-on-Vulkan translator — together with the Kopper window-system layer, and exposes it as a standard renderer plugin APK.

Install the APK, then simply pick “Ironized Zink” from your launcher’s renderer list. Because Zink renders desktop OpenGL through your device’s Vulkan driver, it is well suited to modern Minecraft — including the Vulkan-era 1.21.x and 26.x releases — as well as Sodium/Iris and shader packs.

Ironized Zink is a repackaging + configuration project. All rendering is done by Mesa/Zink/Kopper — see CREDITS.md.

• ⚡ OpenGL 4.6 (GLSL 460) presented to Minecraft, translated to Vulkan by Zink.
• 🧩 Plugin, not a fork — works alongside your launcher’s other renderers.
• 🎚️ Four presets that genuinely apply — Potato, Performance, Default, Max Compatibility.
• 🔧 Real, live tuning — GL version (3.3–4.6), threaded GL, big-core affinity, refresh-rate-synced frame cap, no-error fast path (opt-in, clearly labelled), shader disk cache, single-file cache, relaxed GLSL and software fallback. Settings actually change the game, not just the screen.
• 🩹 Hand-through-GUI bug fixed — Potato/Performance no longer combine the no-error fast path with out-of-order drawing, the confirmed cause (per Mesa's own docs) of that glitch; it's now an explicit opt-in with an in-app warning.
• 🖥️ Potato caps to your display's real refresh rate (60/90/120/144 Hz, detected live) instead of running uncapped — there's no Mesa/Zink numeric FPS-limit variable, so this uses the real VSync mechanism honestly rather than a fake slider.
• 🔔 In-app update checker — checks GitHub Releases on launch; shows the full changelog and downloads + installs updates in-app, no browser needed.
• 📤 Env export — copy the exact environment for your launcher’s custom-env field.
• 🏷️ F3 shows IronizedZink | OpenGL <version> — set through Mesa's force_gl_renderer (like MobileGlues), so the debug screen shows Ironized Zink instead of the raw Zink string.
• 📦 All 4 ABIs — arm64-v8a, armeabi-v7a, x86, x86_64.
• 🪶 Modern UI — Jetpack Compose + Material 3 (Material You dynamic colour, Lexend).

Each preset maps to a concrete set of Mesa/Zink environment variables; open the app to see and fine-tune them.

1. Download Ironized-Zink.apk from the Releases page.
2. Install it (you may need to allow “install from unknown sources”).
3. Open your launcher → Settings → Renderer and select Ironized Zink.
4. (Optional) Open the Ironized Zink app to choose a preset or fine-tune settings.

The launcher discovers renderer plugins by scanning installed apps for specific <meta-data> in their manifest. Ironized Zink declares:

<meta-data android:name="fclPlugin" android:value="true"/>
<meta-data android:name="zalithRendererPlugin" android:value="true"/>
<meta-data android:name="renderer" android:value="Ironized Zink:libglxshim.so:libEGL_mesa.so"/>
<meta-data android:name="pojavEnv"  android:value="POJAV_RENDERER=opengles3_desktopgl_zink_kopper:…"/>

At launch the launcher loads the plugin’s native libraries from its nativeLibraryDir and injects the declared environment. Mesa then loads libzink_dri.so via MESA_LOADER_DRIVER_OVERRIDE=zink and renders OpenGL through Vulkan.

The manifest ships a solid baseline. When you pick a preset or change an option and tap Save, Ironized Zink writes a small KEY=VALUE config to /sdcard/IronizedZink/ironized.env. The plugin also declares DLOPEN=libironized_zink.so — the launcher loads this tiny native shim into the game process during startup, and its constructor applies your saved settings with setenv() before Mesa initialises. That’s why changing the preset or the OpenGL version genuinely changes how the game renders. Applying settings needs All files access (the same approach MobileGlues uses for /sdcard/MG); without it, the manifest baseline is used.

Builds run entirely on GitHub Actions (see .github/workflows/build.yml) — no local Android SDK required. To build the debug APK:

./gradlew assembleDebug

Requirements: JDK 21, Android SDK (compileSdk 36). The output APK is uploaded as a CI artifact on every push.

Zink, Kopper and the entire renderer come from the Mesa 3-D Graphics Library (MIT). The plugin interface comes from Fold Craft Launcher / ZalithLauncher 2 (GPL-3.0). Full attribution and licenses: CREDITS.md.

Ironized Zink’s integration code is licensed under the GNU General Public License v3.0 — see LICENSE. Bundled Mesa/Zink binaries are MIT-licensed; see app/src/main/assets/licenses/.

Not affiliated with Mojang, the Mesa project, the FCL team, or the ZalithLauncher team. Minecraft is a trademark of Mojang Synergies AB.