Actinium - Vintage Optimization

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.

How to install

1. Install Minecraft 1.12.2 with Cleanroom Loader (follow Cleanroom's own setup guide).
2. Drop the Actinium-<version>.jar into your mods/ folder.
3. Optional: put shader packs in shaderpacks/ and pick one in the in-game shader menu.
4. 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)