# PrimeCinematic

专为 Minecraft 26.2 从零开始编写——不是分支，也不是现有基础的换皮。它的目标只有一个：**画面看起来漂亮，但又不至于像另一个游戏。** 原版的颜色保持辨识度。改变的只是光影。

## 它的功能

**柔和的彩色阴影。** 太阳和月亮的阴影贴图，使用旋转的 Vogel 圆盘进行过滤，因此半影呈现出平滑的渐变，而不是低采样数量下重复的环形图案。彩色玻璃和水会为穿过它们的光线染色，因此窗户会在地板上投射颜色。

**体积光束。** 穿过几何体缝隙的真实光线，在低太阳角度时最强，在雨天时减弱。

**屏幕空间环境光遮蔽。** 角落、悬空下方以及洞穴各处的接触阴影。

**看起来像水的水。** 菲涅尔加权的天空反射，根据深度染色的水体颜色，以及在风暴期间会增强的顶点阶段波浪。

**摇曳的植物。** 草、农作物、花、树叶、藤蔓、海带和海草，每一项都由方块 ID 索引，在雨天时都会更强烈地摇曳。

**电影级调色。** ACES 色调映射，经过校准使得中灰色落在电影应有的位置。标准的 ACES 拟合会将 18% 灰度映射得偏亮大约九个点——这就是你在很多光影包上看到的发白、褪色的外观。这个光影修正了这个问题。如果你想要不同的外观，还包含了中性和高对比度曲线。

## 四种预设

| 预设 | 内容 |
|---|---|
| **性能** | 仅阴影。无环境光遮蔽，无泛光。 |
| **平衡** | 全部开启，176 方块阴影。默认预设。 |
| **电影** | 更柔和的阴影边缘，更长的光束。 |
| **极致** | 2048 阴影贴图，224 方块阴影，24 步光束。 |

它们背后的每个值也是一个滑块，分为阴影 / 光照 / 大气 / 后期处理，每个滑块都有一个通俗易懂的提示说明其实际作用。

## 性能

渲染阴影贴图大约占用了**本光影 60% 的 GPU 开销**——世界从太阳的视角被再次绘制了一次。因此如果玩家需要提升帧率：

> **阴影分辨率是关键，而不是阴影距离。**
> 从 2048 降到 1024 通常能换取 **15–40%** 的性能提升，并且阴影畸变使摄像机附近的纹理像素保持密集，因此近景几乎不会改变。相反，削减距离会使远处地形失去立体光照，虽然节省了性能但看起来要糟糕得多。

在 RTX 5070 Ti 笔记本电脑上以 2.5K 分辨率、渲染距离 16 测量：在平衡预设下约为 **200–250 FPS**，而关闭光影时约为 700 FPS。预计在平衡预设下能达到原版帧率的三分之一左右，而在性能预设下会更好。

## 要求

- Minecraft Java **26.2**
- **Iris 1.11.2** 或更高版本
- **Sodium 0.9.1** 或更高版本（Iris 需要它）
- 支持 OpenGL 4.3 的 GPU

## 安装

## 已知限制——在报告这些问题之前请先阅读

坦白说明本光影不会做的事情：

- **无屏幕空间反射。** 水面反射天空，而不是世界。方块和生物不会出现在倒影中。
- **无 PBR。** 不支持 labPBR 或法线/高光贴图——包含这些内容的资源包将视同没有它们一样进行渲染。
- **无 TAA，无动态模糊，无景深。**
- **无彩色方块光。** 红石火把会温暖地照亮周围环境，但不会投射红色光芒。
- **阴影在超出阴影距离后会淡出。** 如果你要拍摄宽广的风景画面，请调高此距离。
- **远处的密集植物可能会在阴影滤镜中显示微弱的采样噪点**。提高阴影采样数可以减少这种情况；但不会完全消失。

## 拍摄注意事项

太阳路径角度也值得一看。默认的 -25° 比原版头顶的太阳能提供更长、更具方向性的阴影，这正是让风景镜头看起来具有电影感的主要原因。

## 制作人员

## 许可证

如果有放链接的空间，恳请大家将人们引导至本页面或频道——这正是本光影能持续获得更新的动力。

请不要将它重新上传到其他地方；请改为在此处链接。欢迎在相同条件下将其用于光影包。完整文本请参见 zip 内的 `LICENSE.txt`。