[AUSM] Actually Usable Shader Mod

Actually Usable Shader Mod

AUSM 是一款适用于 Minecraft 1.12.2 的光影管线，支持 Forge 和 Cleanroom。它旨在让现代光影包能够在 Minecraft 1.12.2 上使用，同时广泛兼容 OptiFine/Iris 光影包语法。

运行要求

• Minecraft 1.12.2
• Forge 14.23.5.2860 或 Cleanroom 0.5.12-alpha
• Forge 运行时需要 Java 8。
• Cleanroom 运行时需要 Java 25。
• 开发版本：Gradle 使用 JDK 25；发布流程会将生产类降级并打包着色，以兼容 Java 8。

模组兼容性

AUSM 不能与 OptiFine 同时安装。这两个模组作用于同一光影/渲染接口，因此除非你有意调试冲突，否则应视为不支持同时运行。

不过，你可以安装以下模组（列表不完整）：

• Celeritas
• Nothirium
• LoliASM
• Naughtirium
• Lumenized
• Efficient Entities
• 实体剔除
• Render Lib
• Better Portals

在条件允许时，AUSM 会使用这些模组的优化路径。请注意，是否支持取决于所安装模组的版本。

其他功能

AUSM 不只是光影管线，还包含完全自定义的光影列表和光影选项菜单，优先考虑玩家体验，同时沿用其他模组加载设置时使用的原有逻辑。

该模组不仅支持现有光影，还提供了一些新的 API 接口，包括：

• 功能完整的 LOD 系统，可动态关闭远处地形的光影渲染。光影包制作者也可以自行指定各个 LOD 等级下的效果。
• 改进的天空处理，支持 Astral Sorcery 和植物魔法的虚空世界天空盒渲染，并允许光影完全覆盖这些效果。

安装 AUSM 后，部分光影包（尤其是 Complementary Unbound / Reimagined）会获得一些补丁，以便更好地适配 1.12.2 环境：

• 自定义 Astral Sorcery 星座渲染，并提供使用仪式颜色渲染星座的设置。（例如 Aevitas 会显示为绿色等）
• 为部分模组专属方块提供彩色光源支持，例如神秘时代的 Nitor 或 ProjectRed Illumination 的方块。
• 为原版和模组方块提供彩色动态光源支持。

如果这些功能还不足以吸引你，即使不开启光影，该模组也提供了一些改进：

• 动态光源支持，包括游戏内编辑器。（仅限无光影时使用；光影包可能有自己的动态光源逻辑）
• 广泛的泛光效果支持，既可以通过像素亮度自动提取，也支持 Lumenized 风格的光影包。（不需要安装 Lumenized，但安装后可能会提升性能）
• 多项可能提升客户端性能的优化。

安装

1. 下载最新的 AUSM 版本：
   • AUSM-<version>-Java8.jar适用于 Forge。
   • AUSM-<version>-Java25.jar适用于 Cleanroom。
2. 将 jar 文件放入实例的 mods/ 文件夹。
3. 启动游戏一次，让 AUSM 在文件尚不存在时创建 shaderpacks/ 和 config/ausm/。
4. 将光影包 zip 文件或文件夹放入 shaderpacks/。如果启动器支持自动将光影包下载到该文件夹，也可以通过启动器安装。
5. 在游戏中打开 AUSM 光影界面并选择光影包。你可以通过快捷键（见下文）打开，也可以进入暂停菜单 > 选项 > 光影设置。

构建版本：
https://github.com/MtcLuna05/AUSM/releases

兼容范围

虽然理想情况下，这个模组应该是 Iris 在 1.12.2 上的事实标准移植版，并加入额外功能，但该版本与现代版本之间的差异使得实现完全一致成为不可能。

即便如此，AUSM 仍致力于让许多现代光影包能在 1.12.2 上使用，同时尽可能减少视觉效果上的妥协。

控制

默认按键绑定位于 AUSM Shaders 分类下：

可以在 Minecraft 的常规控制菜单中更改这些按键。

开发

使用以下命令构建模组：

./gradlew --no-daemon build

可分发的 Java X 版 jar 文件会写入 build/libs/AUSM-<version>-JavaX.jar，其中 X 根据目标模组版本为 8 或 25。构建过程还会生成用于调试的中间开发版和重映射版 jar 文件。