YapYap Graphics Enhancer

A comprehensive graphics enhancement MOD for YapYap, featuring deep visual customization and performance optimizations. 一款为 YapYap 打造的全面画质增强 MOD，提供深度的视觉自定义与性能优化功能。

Features / 功能特性

Visual Enhancements / 画面增强

• Deep Brightness & Contrast (V7): Say goodbye to dark maps. Includes contrast compensation to maintain visual depth while brightening the scene.

• 深度亮度与对比度 (V7): 彻底告别黑暗地图。包含对比度补偿，在拉升亮度的同时保持画面层次感。

• Ultra Clarity & Sharpening: Multi-level sharpening to remove blur, especially effective for distant objects.

• 极致清晰度与锐化: 多级锐化调节，有效消除画面发虚，远景更清晰。

• Optimized VHS Effect: Restores the classic "VHS" feel with improved font legibility and adjusted noise levels.

• 优化版 VHS 效果: 找回经典的录像带感，同时提升了文字的可读性并调整了噪点强度。

• Fog & Volumetric Lighting Control: Inverted logic (Low=Off) to give you full control over the atmosphere.

• 雾气与体积光控制: 符合直觉的逻辑（低=关闭），让你完全掌控场景氛围。

Performance Optimizations / 性能优化

• Additional Light Shadow Toggle: Specifically designed to fix GPU spikes in house-heavy areas.

• 附加光源阴影开关: 专门解决“看房子卡顿”问题，可独立关闭或降低室内灯光阴影。

• Shadow Resolution & Distance: Fine-grained control over shadow quality and rendering distance.

• 阴影分辨率与距离: 细粒度控制阴影质量与渲染距离，平衡画质与帧率。

• Efficient Background Logic: Low CPU overhead with smart refresh intervals.

• 高效后台逻辑: 智能刷新频率，极低的 CPU 占用。

Quality Levels Detail / 画质档位详述

Shadow Quality / 阴影质量

• Low: 1024 Res, 50m Distance, 1 Cascade. (Optimized) / 低: 1024 分辨率, 50米距离 (性能优先)
• Medium: 2048 Res, 100m Distance, 2 Cascades. (Balanced) / 中: 2048 分辨率, 100米距离 (平衡)
• High: 4096 Res, 180m Distance, 4 Cascades. (Ultra) / 高: 4096 分辨率, 180米距离 (极致)

Additional Shadows / 附加阴影

• Off: Disable shadows for additional lights. (Best for GPU) / 关闭: 禁用附加光源阴影 (解决卡顿)
• Medium: 512 Res. / 中: 512 分辨率
• High: 1024 Res. / 高: 1024 分辨率

Fog Quality / 雾气质量

• Low: Completely Off. (Clear view) / 低: 彻底关闭 (视野极佳)
• Medium: Standard Fog On. / 中: 开启标准雾气
• High: Fog + Volumetric Lighting. / 高: 雾气 + 体积光 (增强视觉)

Image Clarity / 画面清晰度

• Low: Base Sharpening (10%). / 低: 基础锐化 (10%)
• Medium: Balanced Sharpening (80%). / 中: 平衡锐化 (80%)
• High: Ultra Sharpening (250%). / 高: 极致锐化 (250%)

Installation / 安装方法

1. Ensure BepInEx 5.4.2304 or newer is installed.

2. Download and extract the ZIP.

3. Place GraphicsEnhancerMod.dll into the BepInEx/plugins folder.

4. Launch the game and find the "Graphics+" tab in the Settings menu.

5. 确保已安装 BepInEx 5.4.2304 或更高版本。

6. 下载并解压发布包。

7. 将 GraphicsEnhancerMod.dll 放入 BepInEx/plugins 文件夹。

8. 运行游戏，在设置菜单中寻找 “画质优化” 页签。

Credits / 鸣谢

• Powered by Harmony & Beautify.
• Developed with ❤️ for the YapYap community.

Changelog / 更新日志

1.0.1 (Major Update / 重大更新)

Performance & Optimization / 性能与优化

• Additional Light Shadows: Added separate control for shadows from additional lights. Lower this to fix GPU spikes when looking at houses.

  • Off: Completely disable additional shadows.
  • Medium: 512 resolution (Optimized).
  • High: 1024 resolution (Quality).

• 附加光源阴影控制: 专门针对“看房子 GPU 飙升”问题添加的独立选项。可关闭或降低室内小灯泡产生的阴影分辨率，大幅提升性能。

  • 关闭: 彻底禁用附加光源阴影，性能最强。
  • 中: 512 分辨率（推荐，性能平衡）。
  • 高: 1024 分辨率（质量优先）。

• Background Logic Optimization: Reduced update frequency from every frame to every 300 frames to further save CPU resources.

• 后台逻辑优化: 将刷新频率从每帧降至每 300 帧，进一步释放 CPU 性能，提升运行效率。

Visuals & Clarity / 画面与清晰度

• Brightness & Contrast Control: Added deep brightness adjustment with contrast compensation (Brightness V7).

  • High dynamic range adjustment to fix dark map issues.
  • Automatically removes Vignette and Film Grain for a cleaner look.

• 深度亮度调节: 新增亮度调节选项（V7 版本），并配合高动态对比度补偿。

  • 解决了地图部分区域过暗的问题，实现“黑夜转白天”的效果。
  • 自动移除暗角和颗粒感，画面更通透。

• Font & Image Clarity: Improved font clarity in VHS mode and added extra sharpening compensation.

  • Low/Medium/High: Scales from base sharpening to ultra-clear (250 intensity).
  • Smart Sharp: +20% extra sharpening when VHS is disabled to ensure pixel-perfect clarity.

• 画面清晰度 & 字体优化: 提升了 VHS 开启时的字体清晰度，修复发虚。

  • 低/中/高: 阶梯式增强，最高支持 250% 极致锐化。
  • 智能补偿: 关闭 VHS 时额外增加 20% 锐度，确保无 VHS 时的极致画面表现。

• Fog & Shadows Overhaul / 雾气与阴影重构

  • Inverted Fog Logic: Low = Completely Off, Medium = Fog On, High = Fog + Volumetric Lighting.
  • Enhanced Shadows:
    • Low: 1024 Res, 50m Distance.
    • Medium: 2048 Res, 100m Distance.
    • High: 4096 Res, 180m Distance (Ultra).

• 雾气与阴影逻辑优化

  • 雾气逻辑: 低 = 彻底关闭，中 = 仅雾气，高 = 雾气 + 体积光（还原并增强原版效果）。
  • 阴影增强:
    • 低: 1024 分辨率, 50米距离。
    • 中: 2048 分辨率, 100米距离。
    • 高: 4096 极致分辨率, 180米距离。

UI & Experience / 界面与体验

• UI State Sync: Fixed issue where UI toggles wouldn't update their labels (e.g., showing "Disabled" when enabled).

• UI 状态同步: 修复了选项开关状态不更新的问题（如：启用显示为禁用），确保界面显示与实际状态一致。

• Localization Improvements: Added automatic system language detection for all labels and fixed English-only text issues.

• 本地化完善: 支持根据系统语言自动识别中英文显示，修复了部分选项强制显示英文的问题。

1.0.0

• Initial release / 初始版本发布
• Added VHS blur toggle with 1:1 render scale support. / 新增 VHS 模糊开关，支持 1:1 像素渲染。
• Added FSR sharpening compensation. / 新增 FSR 锐化补偿，提升画面清晰度。
• Added Shadow quality settings (Resolution & Additional Lights). / 新增阴影质量设置（分辨率与额外光源开关）。
• Added SSAO quality settings. / 新增环境光遮蔽 (SSAO) quality settings.
• Added Decal quality settings. / 新增贴花 (Decal) 特效质量设置.
• Added Fog and Volumetric lighting settings. / 新增雾效与体积光质量设置.
• Added Bloom intensity adjustment. / 新增泛光 (Bloom) 强度调节.
• Added Motion Blur toggle. / 新增运动模糊开关.
• Built-in UI tab in settings menu with localization. / 在设置菜单中深度集成 MOD 调节页签，支持中英文.