Actinium – Vintage Optimization

Actinium

为 Minecraft 1.12.2 带来现代渲染与 Iris 风格光影——同时不破坏你已有的模组。

Actinium 是一个适用于 Minecraft 1.12.2 的模组，能让你的老客户端在外观和体验上现代许多。它将 Iris 风格的光影管线（与较新 Minecraft 光影模组所用的同类技术）带到 1.12.2，让你能在经典版本上运行精美的光影包——同时保持所有你喜爱的 1.12 模组正常运行。

从 0.0.10 版本开始，它仅兼容 cleanroom 0.6.1 或更高版本。

它有什么作用？

• 在 1.12.2 上使用现代光影包——运行 MakeUp、BSL、Complementary、Bliss 等光影包，并完整支持阴影、水面、天气和后处理。
• 更好的地形渲染——基于 Celeritas 重建的区块渲染管线，带来更流畅、更高效的世界渲染。
• 现代 OpenGL 处理——底层状态管理更干净，意味着模组与光影交互时出现奇怪渲染故障的情况更少。
• 与你的模组友好共处——以兼容性为核心构建：经典 1.12 模组、实体渲染、GUI 和模组内容都经过细心处理，确保它们在开启光影时仍能正常工作。

它适合谁？

• 热爱 1.12.2 整合包、但想在此基础上使用现代光影的玩家。
• 希望在不放弃经典模组的前提下获得光影支持的整合包开发者。
• 任何好奇 1.12.2 在全新渲染管线下会是什么样的人。

设备兼容性

台式机与手机有着相同的硬性要求：

• Minecraft 1.12.2
• Cleanroom Loader 0.6.13-alpha 或更旧版本（低于 0.7.0）
• 运行时需要 Java 21 或更新版本；工具链为 Java 25，生成的字节码目标为 Java 21
• 图形环境需提供 OpenGL 3.3+ 核心模式

Actinium 不再支持 Cleanroom Loader 0.7.0-alpha 及更新版本。
从 0.7.0 开始，CRL 用 SDL 3 替换了 GLFW 来处理窗口和输入，并重做了其 LWJGL 模块和类补丁流程；Actinium 未适配这些改动。
请在 0.6.x（推荐 0.6.13-alpha）上运行 Actinium；在 0.7.0 及更新版本上出现的问题不在支持范围内。

每台设备都需要完全满足上述要求；区别仅在于由谁提供该核心模式：

• 台式机（Windows / Linux / macOS）：由 GPU 驱动提供，当前主流驱动默认即会提供；光影包的可用性仍取决于 GPU 性能和驱动行为。
• 移动端（Android）：由启动器中选择的渲染器提供。请选择支持核心模式的渲染器，例如 MobileGlues（MG）；GL4ES 等兼容模式渲染器无法满足此要求——Actinium 在启动时会从 4.6 向下请求至 3.3 的核心模式上下文，因此无法提供该上下文的渲染器会导致游戏启动失败。
  • 实例：使用支持 Cleanroom Loader 的手机启动器创建一个 1.12.2 + Cleanroom 实例，然后将 Actinium 的 jar 放入 mods/。
  • 光影：手机 GPU 和内存有限，因此请先从较低分辨率、较短渲染距离和较轻量的光影包开始，再逐步提升。

如何安装

1. 安装带有 Cleanroom Loader 的 Minecraft 1.12.2（请遵循 Cleanroom 自身的安装指南）。
2. 将 Actinium-<version>.jar 放入你的 mods/ 文件夹。
3. 可选：将光影包放入 shaderpacks/，并在游戏内光影菜单中选择一个。
4. 启动并享受吧！

它稳定吗？

Actinium 目前处于早期 Alpha阶段——它可以运行，也经过了大量测试，但你仍可能遇到一些问题。光影包和模组的表现会因版本、驱动程序和设置而异，因此请把它当作一个“试试看”的项目，而不是保证适用于所有情况的通用解决方案。

目前已验证：MakeUp、BSL、Complementary Reimagined/Unbound、Bliss、iterationT、iterationRP（适用于兼容性矩阵中列出的测试版本）。部分光影包（例如 SEUS PTGI HRR）目前无法启用——我们仍在持续完善光影包支持。

关于 AI 生成代码的说明

本项目几乎所有代码都由 AI 编程代理编写，改动也可能由 AI 参与审查（人在环中）：每项改动在合并前都会经过人类和 AI 的审查、测试与回归验证。如果你希望避免使用 AI 生成的代码，可以考虑其他项目；如果有任何疑虑，欢迎通过 Issues 联系我们。

第三方代码

Actinium 基于多个开源项目构建。这些项目的代码（以及围绕它们开展的兼容性工作）仍遵循各上游项目的原始许可证：

• Celeritas — 区块构建、上传、剔除和地形绘制（作为 Gradle 子项目嵌入）
• GLSM — OpenGL 状态跟踪、重定向和固定功能管线模拟
• GTNHLib — 渲染基础组件、缓冲区、后期处理和旧版渲染工具
• Iris — 本项目改编使用的光影管线结构、光影包解析和 GLSL 转换
• GLSL Transformation Library — GLSL 解析与转换
• Sodium / Embeddium — 面向性能优化的渲染设计和选项框架
• Angelica / GTNH 生态 — 适用于 1.7/1.12 时代光影兼容性和旧版 OpenGL 行为的参考

完整的源码和许可证列表见仓库中的 THIRD_PARTY_NOTICES.md。

链接

• 源代码与问题反馈：github.com/DHJComical/Actinium
• 兼容：Cleanroom Loader、Distant Horizons（部分兼容）等（详见仓库中的兼容性矩阵）