SDV-Radiance

[center]# SDV-Radiance

一个模组，为星露谷物语提供完整的光照与后处理套件。

[img]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784551432-500055663.png[/img][/center]

大多数电影化配置需要堆叠半打模组才能实现阴影、倒影、上帝光与更丰富的照明。而 SDV-Radiance 一个模组即可搞定：仅需一个GPU后处理层，读取屏幕上实际渲染的内容，因此它能自动与你的精灵图、改色及地图模组兼容。 每个效果都有独立的开关与滑块，可通过游戏内的调谐器实时预览。

[center]🚧 积极开发中 本模组正在积极开发中。它稳定且使用安全（不会触及存档数据，你可随时开启或卸载任何功能），但在某些场景、模组组合或硬件下，你可能会遇到一些不完善之处。新功能与修复会定期推出。 若发现异常，请在“漏洞”标签页附上截图 + SMAPI日志快速报告，这能切实帮助确定后续开发方向。感谢你提前体验。💛[/center]

⚠️ 已知问题

• 海岸线与高度自定义地图的水体检测 虽接近精确但尚不完全准确。Radiance 通过地块数据和颜色判断水体位置，海滩或模组地图仍可能出现效果略微溢出水体的情况。1.2.2 修复了可见版本（沙子不再受该效果影响），根治方案正在进行中：我正在对热门地图模组逐像素手动标记水体、熔岩和瀑布，以便模组读取真实地图而非猜测。液体优先。在此期间，室内与按房间水体的开关可让你在所需位置精确关闭水体效果。
• 基于 SpriteMaster 的模组（Clear Glasses、Clear Monocle）：不兼容，且没有可靠的解决方法。当前请二选一。

🔭 开发中

• 基于手动标记真实数据的高精度像素级水体检测，使效果仅影响真实开放水域。此项工作正在进行中，液体优先，覆盖玩家实际游玩的地图模组。
• 基于该标记的水体子类型：结冰倒影无涟漪、流动水体与瀑布、发光的熔岩，以及夜间温暖的窗光。
• 除水体外的反射表面：湿地板和玻璃或镜子（巴士车窗、商店橱窗）。
• 尊重 SVE 和 RSV 等地图模组的建筑阴影，附带用户可编辑的数据文件。

✨ 功能概述

照明与阴影

• 方向性阴影：角色、动物、树木、物体、作物与地图道具的真实精灵轮廓阴影，随太阳在一天中的倾斜与拉长，在黄昏时淡出。
• 月光阴影：夜间根据月相与季节缩放。
• 每光源室内阴影：每盏灯、火把与壁炉投射其自身柔和的阴影。
• 遮挡感知的全局光照：平坦过亮的室内获得深度感；温暖的光线汇聚在真实光源周围，并被墙壁遮挡。

水体

• 像素级精确倒影：水面之上的场景沿真实绘制的海岸线镜像，而非方形地块边缘。河岸、树木、桥梁与码头均正确反射。
• 涉水自反射：踏入浅水区，你自己的倒影将紧随你。
• 涟漪、闪光与表面微光：池塘与海洋行为不同，适应天气与季节。小池塘轻柔涟漪，开阔海洋保持活跃，根据水域面积判断。
• 精确检测：从游戏实际绘制的内容中识别水体，因此自定义地图水体与其他模组添加的水体能正确对齐。洞穴、矿井、下水道、温泉等真实水平面水体始终保留，而房屋或室内模组中的装饰性水体可全局或按房间关闭。

氛围与色彩

• 上帝光：来自世界中的真实光源。
• 云影：轻柔飘过地面，控制参数包括共享天空的云层数量、覆盖度、大小与速度。
• 日间薄雾与夜间雾气：两种独立效果，呈现为轻柔飘移的缕缕雾气，各有自己的数量、强度与飘移速度。
• 辉光、移轴景深模糊、暗角与微妙的色差。
• 电影化色彩分级：情绪与调色板随一天中的时间、天气和季节自动变化，伴有计量的自动曝光。
• 蓝光滤镜：可选的暖眼舒适模式，叠加在色彩分级之上或单独使用。

[center][img width=275]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784552062-1397391653.png[/img] [img width=275]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784552034-1606604367.png[/img]

[img width=275]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784551877-584950861.png[/img] [img width=275]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784551858-959437301.png[/img][/center]

[center][img width=275]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784551573-1137622386.png[/img] [img width=275]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784551582-774586989.png[/img][/center]

[center]原版（左） vs. SDV-Radiance（右）[/center]

🎛️ 完全可配置 游戏中按 F6 打开实时调谐器，现已按类别（色彩、辉光、阴影、照明、上帝光、云、雾、水体、镜头）分标签页组织：拖拽任意滑块即可即时观察世界变化，保存你命名的外观，或选择一个预设（微妙 / 电影化 / 鲜艳）。所有设置也集成在 Generic Mod Config Menu 中。每个独立效果均可单独关闭，因此你可根据电脑配置和个人喜好进行调节。

[center][img width=365]https://staticdelivery.nexusmods.com/mods/1303/images/49397/49397-1784552176-1384135743.png[/img][/center]

📦 安装方法

1. 安装 SMAPI（4.0.0 或更新版本）。
2. 安装 Generic Mod Config Menu（可选，推荐用于设置菜单）。
3. 下载本模组并将其解压到你的 Stardew Valley/Mods 文件夹。
4. 通过 SMAPI 运行游戏。按 F6 打开调谐器，按 F7 切换整个效果堆栈。

⚙️ 性能 这是一个多通道 GPU 管线：一次捕获，一个着色器链，烘焙结果在帧之间缓存。它作用于渲染后的图像，因此你的其他模组数量对其影响甚微。1.2.0 增加了重要的优化：水体和阴影系统不再每帧扫描整个地图，贴图艺术资源改为每张贴图只读取一次而非每个地块读取一次，之前靠近水体时的卡顿已消除。每个效果仍有开关，因此若场景负担过重，你可以关闭不必要效果（泛光照明、方向性阴影和上帝光最消耗性能）。

🧩 兼容性

• 自动兼容外观模组：阴影和倒影基于实际渲染内容生成，因此自定义精灵图、Fashion Sense 服装与改色模组可直接使用。
• 在大规模模组配置（包括 SVE 和 80+ 模组）下测试通过。
• Global God Rays：多位用户确认可一起工作。Radiance 拥抱世界中的光源，而 GGR 处理日光光束，因此它们能很好地叠加。自 1.2.1 起，当 Radiance 隐藏原版飘动云朵时，它会完全清除它们，因此 GGR 不再在你不可见的阴影下淡出光束。
• 单人模式。 多人模式：效果为客户端侧（每位玩家看到自己的效果）。
• 安卓：不支持。
• 其他后处理 / 光照模组（例如 Dynamic Shader、ReShade）可能重叠。请一次只运行一个以获得可预测的外观。
• 与 SpriteMaster 不兼容（也以 "Clear Glasses" 形式分发）。两者都深度挂载渲染管线；同时安装时，世界在加载时会渲染为纯橙色/黑色，直到你打开并关闭菜单。请禁用其中一个。（计划内置高质量放大功能，届时将无需此模组。）

❓ 常见问题解答

• 卸载安全吗？ 是的，不影响任何存档数据。随时移除文件夹。
• 它会发送数据回家吗？ 无网络请求，无遥测。
• 为什么 X 与模组 Y 一起使用时看起来异常？ 请在“漏洞”标签页发布 SMAPI 日志（smapi.io/log）+ 截图。请参考置顶模板。

🐛 报告漏洞 请包含：（1）一个 SMAPI 日志链接，（2）截图/片段，（3）你的缩放级别 + 分辨率，（4）哪些效果已开启，（5）地点/时间/天气。图形错误是视觉性的：一张图片胜过三段文字。

🙏 致谢 基于 SMAPI、MonoGame 与 Generic Mod Config Menu 构建。本模组从头实现其效果；详见下载文件中的 CREDITS。感谢星露谷物语模组社区。已有许多优秀的光照模组，而本模组采用一套完整套件、读取渲染内容的方案。

☕ 支持 免费且永远免费。如果它让你的农场更美好，一杯咖啡的捐赠将不胜感激，但绝非必需：

• Ko-fi：ko-fi.com/phuicmt

🌏 语言 内置：英语、泰语、简体中文（由 rime961 提供，自 1.2.2 开始包含）。意大利语正在筹备中。 此外，Nexus 上还有 jjongleee 的韩语翻译和 Rubbish404 的中文翻译，列于上方“翻译”部分。 衷心感谢所有翻译本模组的人。但需要提醒：本模组仍在快速演进，因此文本键和设置名称可能在更新之间发生变化，你的翻译可能需要后续的小更新。我知道这增加了工作量，非常感谢你的耐心。我会在每次更新日志中列出文本更改，以便你更容易跟进。♥