真实天气和实时同步

[size=6][b]真实天气与真实时间同步[/b][/size]

[size=4][i]为《荒野大镖客 2》提供全球实时天气与 1:1 实时时钟同步[/i][/size]

[b]纯 C++ 原生插件 • 零 .NET 依赖 • 100% 免费零 API 密钥天气 • 22 种 RDR2 天气类型 • 智能会话缓存 • 动态游戏世界观地点自动检测[/b]

---

[size=5][b]概述[/b][/size]

[b]RealWeather.asi[/b] 将《荒野大镖客 2》的鲜活世界与真实世界气象数据和实时时钟流无缝连接。体验真实的暴雨、浓密的山雾、阳光明媚的草原午后以及与真实世界天气实时匹配的暴风雪。

完全使用原生 C++ 为 Kepmehz 的 [b]ScriptHookRDR2 V2[/b] 构建，运行时几乎零 CPU 开销、零帧率影响、零外部运行时依赖（无需 .NET 运行时、CLR 或 ScriptHookRDRDotNet）。

开箱即用，[b]零 API 密钥、零配置！[/b]只需放入游戏文件夹即可畅玩！

---

[size=5][b]主要特性[/b][/size]

[list] [][b]100% 免费、零密钥全球天气（Open-Meteo 与 OpenWeatherMap）[/b] 默认由 Open-Meteo 提供支持，无需账户、注册或 API 密钥。只需在 INI 文件中输入任意边境领地或真实世界城市。如果您拥有 API 密钥，也完全支持 OpenWeatherMap。 [/] [][b]智能 30 分钟游戏会话天气缓存[/b] 无需持续的网络轮询或微小卡顿。模组在游戏会话开始时拉取一次实时天气并缓存到内存中。每 [b]30 真实分钟[/b]自动刷新一次，在长时间游玩过程中保持天气最新，同时将后台网络流量降至最低。每 15 秒在本地重新确认天气锁定，确保原版天气循环不会干扰。 [/] [][b]动态游戏内世界观地点自动检测（[font=Courier New]LORE_LOCATION_NAME = Auto[/font]）[/b] 天气状况和温度反映您配置的气象目标（例如 [i]Valentine, New Hanover[/i]、[i]London, UK[/i] 或 [i]New Orleans, LA[/i]），而屏幕上的提示横幅则实时动态追踪亚瑟在边境的实际位置！ 通过城镇、地区和州查询游戏原生区域引擎（[font=Courier New]ZONE::_GET_MAP_ZONE_AT_COORDS[/font]），并带有坐标几何回退： [list] [] [b]城镇[/b]：Valentine、Saint Denis、Rhodes、Strawberry、Blackwater、Annesburg、Armadillo、Tumbleweed、Emerald Ranch、Van Horn、Wapiti、Lagras、Braithwaite Manor、Caliga Hall 等[/] [][b]地区与荒野[/b]：The Heartlands、Bayou Nwa、Big Valley、Bluewater Marsh、Cumberland Forest、Great Plains、Tall Trees、Grizzlies East & West、Roanoke Ridge、Scarlett Meadows、Cholla Springs 等[/] [/list][/] [][b]1:1 真实世界时间同步[/b] 将游戏内时钟同步为您所选地点的真实世界当地时间。秒数自然地与真实时间 1:1 推进（现实 1 秒 = 游戏内 1 秒）。包含持久时区缓存（[font=Courier New].tzcache[/font]），游戏启动时即可获得即时时钟精度。 [/] [][b]故事任务与过场动画保护[/b] 在故事任务、过场动画和脚本事件期间自动暂停实时天气覆盖和时钟同步，使用去抖动的原生任务标志检测（[font=Courier New]MISC::GET_MISSION_FLAG[/font]）。原版任务光照、氛围和过场动画 100% 保持不变，任务结束后实时天气平滑恢复。 [/] [][b]正宗西部字幕 HUD 与音频[/b] 通过游戏原生 UI 系统（[font=Courier New]UILOG[/font]）渲染简洁的字幕横幅提示，配有正宗的 Red Dead 前端音效。兼容所有小地图/雷达状态（普通、指南针、隐藏或电影模式）。 [/] [][b]映射全部 22 种原生 RDR2 天气类型[/b] 晴朗、高压、转晴、阴天、暗阴、雾、薄雾、毛毛雨、阵雨、雨、雷、雷暴、飓风、冰雹、雨夹雪、小雪、雪、雪转晴、暴风雪、白化、地面暴风雪和沙尘暴。过渡在可自定义的持续时间（默认：15 秒）内平滑混合。 [/] [][b]游戏内实时热重载[/b] 游玩时修改 [font=Courier New]RealWeather.ini[/font] 设置；模组会检测到更改并在 2 秒内热重载，无需重启游戏。[/] [/list]

[size=5][b]RDR2 边境领地预设[/b][/size]

您可以在 [font=Courier New]RealWeather.ini[/font] 中将 [font=Courier New]LOCATION[/font] 设置为真实的边境地区（自动映射到其真实世界气象对应地）或任何真实世界城市：

[table][tr][th]边境领地[/th] [th]真实世界气象对应地[/th] [/tr] [tr][td]Valentine, New Hanover[/td] [td]Valentine, Nebraska（大平原草原）[/td] [/tr] [tr][td]Saint Denis, Lemoyne[/td] [td]New Orleans, Louisiana（亚热带沿海港口）[/td] [/tr] [tr][td]Rhodes, Lemoyne[/td] [td]Savannah, Georgia（南部红土腹地）[/td] [/tr] [tr][td]Blackwater, West Elizabeth[/td] [td]Blackwater, Missouri（边境商业港口）[/td] [/tr] [tr][td]Strawberry, West Elizabeth[/td] [td]Strawberry, California（松树高山丘陵）[/td] [/tr] [tr][td]Annesburg, New Hanover[/td] [td]Scranton, Pennsylvania（煤矿阿巴拉契亚丘陵）[/td] [/tr] [tr][td]Armadillo, New Austin[/td] [td]Tombstone, Arizona（干旱沙漠边境）[/td] [/tr] [tr][td]Tumbleweed, New Austin[/td] [td]El Paso, Texas（奇瓦瓦沙漠峡谷）[/td] [/tr] [tr][td]Colter, Ambarino[/td] [td]Jackson, Wyoming（多雪落基山脉）[/td] [/tr] [tr][td]Wapiti, Ambarino[/td] [td]Wapiti, Wyoming（高海拔高山保留地）[/td] [/tr] [/table] [i]您也可以输入全球任何真实世界地点：例如 Dhaka, BD | Tokyo, JP | Denver, CO | Los Angeles, CA | Chicago, IL[/i]

---

[size=5][b]默认控制与快捷键[/b][/size]

[table][tr][th]按键组合[/th] [th]操作[/th] [th]描述[/th] [/tr] [tr][td][b]Right-Ctrl + W[/b][/td] [td]切换模组[/td] [td]即时启用或禁用实时天气覆盖[/td] [/tr] [tr][td][b]Right-Ctrl + T[/b][/td] [td]切换时钟同步[/td] [td]在 1:1 实时时钟和原版 RDR2 游戏时钟之间切换[/td] [/tr] [tr][td][b]Right-Ctrl + R[/b][/td] [td]强制刷新[/td] [td]立即清空缓存并从互联网获取最新天气和时间[/td] [/tr] [tr][td][b]Right-Ctrl + O[/b][/td] [td]预览通知[/td] [td]立即触发自定义横幅的屏幕预览[/td] [/tr] [/table] [i]所有快捷键均可在 RealWeather.ini 中使用友好名称（例如 F1-F12、R、W、T、Ctrl、Shift）或十六进制虚拟键码进行自定义。[/i]

---

[size=5][b]安装[/b][/size]

[b]要求：[/b] [list] [][url=https://www.nexusmods.com/reddeadredemption2/mods/1472]ScriptHookRDR2 V2[/url]（作者 Kepmehz）（[font=Courier New]ScriptHookRDR2.dll[/font] 与 [font=Courier New]dinput8.dll[/font]）[/] [/list] [b]安装步骤：[/b] []下载并解压压缩包。[/] []将 [font=Courier New]RealWeather.asi[/font] 和 [font=Courier New]RealWeather.ini[/font] 直接复制到您的《荒野大镖客 2》主游戏文件夹中（即 [font=Courier New]RDR2.exe[/font] 所在位置）： [code] <Your RDR2 Directory>\RealWeather.asi <Your RDR2 Directory>\RealWeather.ini[/code][/] [*]启动游戏。模组将自动激活并显示一条西部风格字幕确认！

---

[size=5][b]配置指南（RealWeather.ini）[/b][/size]

[code] [SETTINGS] ; 1 = 游戏加载时自动启用模组，0 = 禁用直到按下快捷键 ENABLED_ON_STARTUP = 1

; 1 = 天气变化时显示通知，0 = 静默过渡 NOTIFY_WHEN_SET_WEATHER = 1

; 通知呈现样式： ; 1 = 简洁西部字幕横幅（正宗的 Red Dead 底部字幕） ; 2 = 丰富双行横幅 ; 3 = 紧凑单行字幕 ; 0 = 静默 / 无通知 NOTIFICATION_STYLE = 1

; 1 = 将游戏内时钟与所选地点的真实当地时间同步（1:1 流动） SYNC_REAL_TIME = 1

; 1 = 在故事任务和过场动画期间暂停天气覆盖和实时时钟同步 RESPECT_GAME_MISSIONS = 1

; 要同步天气的地点： LOCATION = Valentine, New Hanover

; 天气服务提供商： ; Auto = 如果提供了 API_KEY 则使用 OpenWeatherMap；否则无缝使用 Open-Meteo（零密钥要求） PROVIDER = Auto

; 1 = 为游戏会话启用临时天气缓存（推荐） ; 启动时获取一次，并每 CACHE_DURATION_MINUTES 自动刷新 SESSION_CACHE = 1

; 会话缓存在刷新前保持有效的真实世界分钟数（默认：30） CACHE_DURATION_MINUTES = 30

; 通知中的温度显示单位：C（摄氏度）或 F（华氏度） TEMPERATURE_UNIT = C

[PRESENTATION] ; 地点命名模式： ; Lore = 显示虚构的 RDR2 边境世界观友好名称 ; Real = 显示真实世界解析地点（例如 Valentine, US 或 London, UK） LOCATION_DISPLAY_MODE = Lore

; 当 LOCATION_DISPLAY_MODE = Lore 时的世界观友好地点名称： ; Auto（推荐）= 实时自动追踪玩家当前在地图上的位置！ LORE_LOCATION_NAME = Auto[/code]

[size=5][b]兼容性[/b][/size]

[list] [] [b]视觉与 Timecycle 大修（Vestigia、Visual Exchange、Collyrium、Photorealistic Reshades）[/b]：[b]100% 兼容[/b]。RealWeather 控制引擎中[i]哪种[/i]天气类型处于活动状态并处理 1:1 时间同步。视觉模组则为这些天气类型更改色彩分级、光照模型和云纹理。两者完美互补。[/] [][b]Script Hook RDR2 DotNet 模组[/b]：[b]100% 兼容[/b]。RealWeather 是纯原生 C++，不使用也不干扰 .NET CLR。[/] [][b]Lenny's Mod Loader (LML)[/b]：[b]100% 兼容[/b]。RealWeather 是放置在游戏根目录的 ASI 插件，独立于 LML 运行。[/] [][b]Red Dead Online[/b]：[b]不兼容[/b]。Script Hook RDR2 出于保护在线完整性被有意在 RDO 中禁用。仅限单人故事模式。[/] [/list]

[size=5][b]卸载[/b][/size]

要完全卸载模组，请从《荒野大镖客 2》根游戏目录删除以下文件： [code] <Your RDR2 Directory>\RealWeather.asi <Your RDR2 Directory>\RealWeather.ini <Your RDR2 Directory>\RealWeather.log（如果已创建） <Your RDR2 Directory>\RealWeather.tzcache（如果已创建）[/code]

[size=5][b]常见问题（FAQ）[/b][/size]

[b]问：我需要 OpenWeatherMap API 密钥吗？[/b] [b]答：[/b]不需要！默认情况下，模组使用 Open-Meteo，它 100% 免费且无需任何 API 密钥或账户注册。安装即玩。

[b]问：这个模组会破坏故事任务或脚本天气事件吗？[/b] [b]答：[/b]不会。在 [font=Courier New]RESPECT_GAME_MISSIONS = 1[/font]（默认启用）的情况下，模组会自动检测任务、过场动画或电影何时开始，并将天气和光照的完全控制权交给 Rockstar 的脚本。任务完成后，实时天气会平滑恢复。

[b]问：这会导致掉帧或微小卡顿吗？[/b] [b]答：[/b]完全不会。所有网络查询通过 WinHTTP 在隔离的后台工作线程上异步执行。您的游戏循环从不等待互联网。此外，智能 30 分钟会话缓存消除了游戏过程中的重复网络查询。

[b]问：动态地点命名是如何工作的？[/b] [b]答：[/b]当 [font=Courier New]LORE_LOCATION_NAME = Auto[/font] 时，模组使用 RDR2 的原生区域系统和地图坐标来检测亚瑟/约翰当前在世界中的位置（例如 Valentine、Saint Denis、The Heartlands、Cumberland Forest 等），并将其打印在提示横幅中，而天气状况和温度则反映您选择的 [font=Courier New]LOCATION[/font]。

[b]问：我可以将天气同步到我的实际家乡吗？[/b] [b]答：[/b]可以！只需在 [font=Courier New]RealWeather.ini[/font] 中将 [font=Courier New]LOCATION[/font] 编辑为任何城镇、城市或国家（例如 [font=Courier New]LOCATION = Dhaka, BD[/font] 或 [font=Courier New]LOCATION = Denver, CO[/font]）。

[/*]