[MD]
# 水墨洗染着色器包
> 将 Minecraft 世界转化为一幅流动的中国水墨画。
## 概述
**水墨洗染着色器包**是一款适用于 Minecraft 的 Iris 光影包，灵感源自中国传统水墨画。它通过后期处理着色技术，将游戏画面实时呈现为水墨画风格：墨色自然浓淡过渡、笔触层次丰富、远山渐隐于留白之中，草木亦会随风摇曳。
这并非简单的去色滤镜，而是对多种传统水墨技法进行了模拟：
- **五墨法**：模拟焦、浓、重、淡、清五种墨色之间的自然过渡。
- **皴法描边**：通过多尺度边缘检测，呈现毛笔勾勒般的纹理与轮廓。
- **留白**：远景与天空会逐渐融入大面积纸白，营造传统山水画空灵悠远的意境。
- **墨晕**：模拟湿墨在宣纸上自然洇开的柔和效果。
- **宣纸纹理**：利用分形噪声还原宣纸纤维质感。
## 核心功能
### 全局水墨色调
所有方块会依据亮度映射为不同墨色。近处景物保留较多纹理细节，如淡墨写意；远处景物则逐步淡化并融入留白。
### 三层笔触描边
| 笔触层级 | 检测方式 | 画面效果 |
| --- | --- | --- |
| **粗笔** | 深度与法线边缘检测（2 倍采样） | 勾勒山体、建筑等主要结构轮廓 |
| **中笔** | 深度、法线与颜色边缘检测（1 倍采样） | 强调方块级边缘 |
| **细笔** | 颜色边缘检测（0.5 倍采样） | 补充细微纹理线条 |
### 风吹草木动画
草与花会通过三层风力系统动态摆动，包括主风、轻拂与细微颤动。树叶方块则会像整片枝叶一样轻柔摇曳。
光影会根据纹理透明度智能识别植被，因此实心地面方块不会产生错误的摆动动画。
### 远景渐隐
基于深度的渐隐系统会使画面呈现由近及远的层次变化：
- **近景**：墨色清晰，细节分明；
- **中景**：色调逐渐变淡；
- **远景**：最终融入宣纸般的留白。
这一效果类似传统山水画中远山隐没于云雾与空白之间的表现方式。
### 墨色洇染
专用后期处理会模拟湿墨渗入纸张的效果：淡墨区域自然扩散，浓墨区域保持清晰，墨迹流动还会受到微弱重力方向的影响。
### 宣纸与装裱效果
- **FBM 宣纸纹理**：通过三层分形布朗运动噪声，并加入横向纤维偏置，模拟传统宣纸的纤维质感。
- **卷轴边框**：可为画面添加传统书画装裱风格的卷轴边框。
- **朱印**：可单独启用传统红色印章效果。
### 时间与维度适配
- 墨色会随 Minecraft 游戏时间自动调整：白天清淡雅致，夜晚则更加深沉浓重。
- 自动识别**下界**，提高整体亮度并加入轻微暖红色调，以适配熔岩环境。
- 细腻的“墨流”动画为整体画面增添呼吸感与手绘感。
## 可配置参数
光影包提供 **18 项设置**，可通过 Iris 光影设置菜单实时调整，并提供完整的中英文选项翻译。
可调整的内容包括：
- 墨色对比度与色彩染色效果，可在近景适度保留原版颜色；
- 夜间暗化程度与下界亮度；
- 三层笔触描边的强度；
- 墨流与风吹草动动画；
- 距离渐隐与墨色洇染效果；
- 宣纸纹理强度；
- 暗角、卷轴边框与朱印的开关。
## 安装方法
1. 安装 **Fabric** 与 **Iris Shaders**，并确保游戏可正常加载光影包。
2. 将下载的 ``.zip`` 文件放入 ``.minecraft/shaderpacks/`` 文件夹。
3. 进入游戏后，依次打开：**选项 → 视频设置 → 光影包**，启用本光影包。
4. 在游戏内按下 ``O`` 打开光影设置菜单，即可按个人偏好调整画面效果。
## 预览
[/MD]
# 水墨洗染着色器包
> 将 Minecraft 世界转化为一幅流动的中国水墨画。
## 概述
**水墨洗染着色器包**是一款适用于 Minecraft 的 Iris 光影包，灵感源自中国传统水墨画。它通过后期处理着色技术，将游戏画面实时呈现为水墨画风格：墨色自然浓淡过渡、笔触层次丰富、远山渐隐于留白之中，草木亦会随风摇曳。
这并非简单的去色滤镜，而是对多种传统水墨技法进行了模拟：
- **五墨法**：模拟焦、浓、重、淡、清五种墨色之间的自然过渡。
- **皴法描边**：通过多尺度边缘检测，呈现毛笔勾勒般的纹理与轮廓。
- **留白**：远景与天空会逐渐融入大面积纸白，营造传统山水画空灵悠远的意境。
- **墨晕**：模拟湿墨在宣纸上自然洇开的柔和效果。
- **宣纸纹理**：利用分形噪声还原宣纸纤维质感。
## 核心功能
### 全局水墨色调
所有方块会依据亮度映射为不同墨色。近处景物保留较多纹理细节，如淡墨写意；远处景物则逐步淡化并融入留白。
### 三层笔触描边
| 笔触层级 | 检测方式 | 画面效果 |
| --- | --- | --- |
| **粗笔** | 深度与法线边缘检测（2 倍采样） | 勾勒山体、建筑等主要结构轮廓 |
| **中笔** | 深度、法线与颜色边缘检测（1 倍采样） | 强调方块级边缘 |
| **细笔** | 颜色边缘检测（0.5 倍采样） | 补充细微纹理线条 |
### 风吹草木动画
草与花会通过三层风力系统动态摆动，包括主风、轻拂与细微颤动。树叶方块则会像整片枝叶一样轻柔摇曳。
光影会根据纹理透明度智能识别植被，因此实心地面方块不会产生错误的摆动动画。
### 远景渐隐
基于深度的渐隐系统会使画面呈现由近及远的层次变化：
- **近景**：墨色清晰，细节分明；
- **中景**：色调逐渐变淡；
- **远景**：最终融入宣纸般的留白。
这一效果类似传统山水画中远山隐没于云雾与空白之间的表现方式。
### 墨色洇染
专用后期处理会模拟湿墨渗入纸张的效果：淡墨区域自然扩散，浓墨区域保持清晰，墨迹流动还会受到微弱重力方向的影响。
### 宣纸与装裱效果
- **FBM 宣纸纹理**：通过三层分形布朗运动噪声，并加入横向纤维偏置，模拟传统宣纸的纤维质感。
- **卷轴边框**：可为画面添加传统书画装裱风格的卷轴边框。
- **朱印**：可单独启用传统红色印章效果。
### 时间与维度适配
- 墨色会随 Minecraft 游戏时间自动调整：白天清淡雅致，夜晚则更加深沉浓重。
- 自动识别**下界**，提高整体亮度并加入轻微暖红色调，以适配熔岩环境。
- 细腻的“墨流”动画为整体画面增添呼吸感与手绘感。
## 可配置参数
光影包提供 **18 项设置**，可通过 Iris 光影设置菜单实时调整，并提供完整的中英文选项翻译。
可调整的内容包括：
- 墨色对比度与色彩染色效果，可在近景适度保留原版颜色；
- 夜间暗化程度与下界亮度；
- 三层笔触描边的强度；
- 墨流与风吹草动动画；
- 距离渐隐与墨色洇染效果；
- 宣纸纹理强度；
- 暗角、卷轴边框与朱印的开关。
## 安装方法
1. 安装 **Fabric** 与 **Iris Shaders**，并确保游戏可正常加载光影包。
2. 将下载的 ``.zip`` 文件放入 ``.minecraft/shaderpacks/`` 文件夹。
3. 进入游戏后，依次打开：**选项 → 视频设置 → 光影包**，启用本光影包。
4. 在游戏内按下 ``O`` 打开光影设置菜单，即可按个人偏好调整画面效果。
## 预览
[/MD]