Actinium
Modern rendering and Iris-style shaders for Minecraft 1.12.2 — without breaking the mods you already run.
Actinium is a mod for Minecraft 1.12.2 that makes your old client look and feel a lot more modern. It brings an Iris-style shader pipeline (the same kind of tech used by newer Minecraft shader mods) to 1.12.2, so you can run beautiful shader packs on a classic version — while keeping all your favorite 1.12 mods working alongside them.

Starting from version 0.0.10, it is compatible only with cleanroom version 0.6.1 or higher.
What does it do?
- Modern shader packs on 1.12.2 — Run shader packs like MakeUp, BSL, Complementary, Bliss and more, with proper shadow, water, weather and post-processing support.
- Better terrain rendering — A rebuilt chunk rendering pipeline based on Celeritas for smoother, more efficient world rendering.
- Modern OpenGL handling — Cleaner state management under the hood, which means fewer weird rendering glitches when mods and shaders interact.
- Plays nice with your mods — Built around compatibility: classic 1.12 mods, entity rendering, GUI, and modded content are handled with care so they keep working with shaders on.
Who is this for?
- Players who love 1.12.2 modpacks but want modern shaders on top.
- Pack developers who want shader support without dropping classic mods.
- Anyone curious about what 1.12.2 can look like with a fresh rendering pipeline.
Device Compatibility
Desktops and phones share the same hard requirements:
- Minecraft 1.12.2
- Cleanroom Loader 0.6.13-alpha or older (below 0.7.0)
- Java 21 or newer at runtime; the toolchain is Java 25 and the produced bytecode targets Java 21
- A graphics environment exposing an OpenGL 3.3+ core profile
Actinium no longer supports Cleanroom Loader 0.7.0-alpha and newer. Starting with 0.7.0, CRL replaced GLFW with SDL 3 for windowing and input, and reworked its LWJGL modules and class-patching flow; Actinium is not adapted to those changes. Run Actinium on 0.6.x (0.6.13-alpha recommended); issues seen on 0.7.0 and newer are outside the support scope.
Every device needs exactly the requirements above; they differ only in who provides that core profile:
- Desktop (Windows / Linux / macOS): the GPU driver does, and current mainstream drivers do so by default; shader pack usability still depends on GPU performance and driver behavior.
- Mobile (Android): the renderer selected in the launcher does. Pick a core-profile-capable renderer such as MobileGlues (MG); compatibility-profile renderers such as GL4ES cannot satisfy this requirement - Actinium requests a core profile context from 4.6 down to 3.3 at startup, so a renderer that cannot provide one makes the game fail to launch.
- Instance: create a 1.12.2 + Cleanroom instance with a phone launcher that supports Cleanroom Loader, then drop the Actinium jar into
mods/. - Shaders: phone GPUs and memory are limited, so start with a lower resolution, a shorter render distance, and a lighter shader pack before scaling up.
- Instance: create a 1.12.2 + Cleanroom instance with a phone launcher that supports Cleanroom Loader, then drop the Actinium jar into
How to install
- Install Minecraft 1.12.2 with Cleanroom Loader (follow Cleanroom's own setup guide).
- Drop the
Actinium-<version>.jarinto yourmods/folder. - Optional: put shader packs in
shaderpacks/and pick one in the in-game shader menu. - Launch and enjoy!
Is it stable?
Actinium is in early alpha — it works, and a lot of testing has gone into it, but you may still hit rough edges. Shader packs and mods behave differently depending on versions, drivers and settings, so treat it as a "try it and see" project rather than a guaranteed one-size-fits-all solution.
Verified so far: MakeUp, BSL, Complementary Reimagined/Unbound, Bliss, iterationT, iterationRP (on the tested versions listed in the compatibility matrix). Some packs (e.g. SEUS PTGI HRR) currently fail to enable — pack support is an ongoing effort.
Note on AI-generated code
Nearly all code in this project is produced with AI coding agents, and changes may also be reviewed by AI (human-in-the-loop): every change is reviewed, tested and regression-verified by humans and AI before it is merged. If you prefer to avoid AI-generated code, feel free to look for alternative projects; if you have any concerns, reach out via issues.
Third-party code
Actinium is built on top of several open-source projects. Code from these projects (and the compatibility work around it) remains under each upstream project's original license:
- Celeritas — chunk building, uploading, culling and terrain drawing (embedded as a Gradle subproject)
- GLSM — OpenGL state tracking, redirection and fixed-function pipeline simulation
- GTNHLib — rendering primitives, buffers, post-processing and legacy rendering utilities
- Iris — the shader pipeline structure, pack parsing and GLSL transformation this project adapts
- GLSL Transformation Library — GLSL parsing and transformation
- Sodium / Embeddium — performance-oriented rendering design and the option framework
- Angelica / GTNH ecosystem — references for 1.7/1.12-era shader compatibility and legacy OpenGL behavior
A full list of sources and licenses lives in THIRD_PARTY_NOTICES.md in the repository.
Links
- Source code & issues: github.com/DHJComical/Actinium
- Compatible with: Cleanroom Loader, Distant Horizons (partial), and many more (see the compatibility matrix in the repo)