GaelQuinta/minecraft-metal-shaders

这是一个面向 Apple Silicon Mac、Minecraft 26.3 的 alpha 阶段光影/渲染分支。愿意接受 bug、习惯备份存档的玩家值得一试；如果你的模组围绕 Sodium、Iris 搭建，它目前还不是能直接替换的稳定方案。

解决什么问题

在 Mac 上给 Minecraft: Java Edition 加光影，通常要经过 Iris，而 macOS 上的 OpenGL 性能有限。作者给出的例子是 MacBook Pro M4 在原生 3024×1964 下运行 Iris + Complementary Reimagined 只有约 22 FPS，还要维护 Sodium 等一串相互依赖的模组。这个项目改为自带地形渲染，并直接用 Metal 绘制特效，玩家装一个 jar 就能看到阴影、体积云和反射水面，不再绕 OpenGL。换来的是 Retina 全分辨率下可玩的帧率，以及游戏内设置菜单。

有什么不同

它基于 mcopt 分支而来，后者为 Minecraft 26.3 提供 Metal 渲染器，并从 mcopt 0.3 起自带地形渲染。Metal Shaders 在其上叠加用 Metal Shading Language 从零编写的效果：级联阴影、基于物理的天空、god rays、体积云或方块云、屏幕空间反射水面和 HDR，并利用 Apple GPU 的 tile memory、压缩渲染目标和自研时序放大等技术。实际好处是内置约 120 项设置、分 11 页，多数改动可在游戏内即时看到，支持英文和西班牙文界面，不必反复改配置文件再重启。

这种“单个 jar”的便利有明确代价：自 1.2 起模组自己绘制地形，因此不能同时装 Sodium，Iris 以及依赖 Sodium 的模组也不能装。它替代的是 Iris 光影包的工作流，而不是兼容现有光影包。项目明确标注 alpha：作者称在其开发所用的 M4 上运行良好，但会有 bug，并建议备份世界。README 中的帧率对比是作者在同一台机器上录制的游戏内数据，并非独立测试。

谁值得试

适合使用 Apple Silicon Mac、玩 Minecraft 26.3、想要高分辨率光影效果，并且愿意维护一套不含 Sodium 的小型模组组合的玩家。对于 Retina 屏幕上 Iris 太卡的情况，报告的性能数据尤其相关。不合适的情况：现有整合包依赖 Sodium、Iris 或围绕它们的模组；或者你需要一个长期稳定、可放心玩存档的环境，而不是 alpha。不愿排查版本相关模组冲突的玩家可以再等等。

使用条件与边界

需要 Apple Silicon Mac（M1 或更新）、macOS 15 Sequoia 或更高版本、Minecraft: Java Edition 26.3、Fabric Loader 0.19.5 或更新版本，以及 Java 25。先通过 安装器为 26.3 安装 Fabric，再把 Releases 中的模组 jar 放进 mods 文件夹；首次启动就会以平衡预设启用光影。不能安装 Sodium，也不能装需要 Sodium 的模组；有 Sodium 同时存在时游戏无法启动。从 1.0 升级需要移除 Sodium 并替换 jar，设置会保留。

alpha 状态是长期使用的主要约束。修复和兼容性调整通过新版本发布，用户需要跟进，并偶尔调整标注为“需重启”的设置。光影生态里的预设和光影包兼容性不会随之迁移。

HotRepo 点评

HotRepo 首次记录这个仓库时它只有 13 天，2026-10-25 的 Java 新项目榜（不是总榜）显示 103 个总 star、第 18 名。这只是单日快照，无法判断关注度能否持续。安装前请对照项目安装页确认 Minecraft 26.3 与 Fabric 的具体组合，并检查其他模组是否依赖 Sodium。