一款将现实世界天气等情况同步到游戏中的模组
介绍
注:描述功能可能落后,请以Github发布页描述或Readme为准!
注2:不是我Steam个人资料的Readme,是Github项目的
本指南会为您介绍我利用AI开发的两款适用于本游戏的模组,你可以在这里了解模组的功能介绍以及安装使用教程。如果你在安装、使用过程中遇到了任何问题,可以通过评论区进行反馈。如果是BUG反馈,请务必上传日志,这对我的debug很有帮助。功能介绍——环境同步
实时天气同步:通过心知天气API获取真实天气数据,自动调整游戏内环境
多城市支持:支持任意城市的天气查询(拼音或中文)(支持城市受限API提供商)
昼夜循环:根据配置的日出日落时间自动切换白天/黄昏/夜晚场景
自动解锁:自动解锁所有环境和装饰品,可手动关闭,且不影响存档
装饰品免购:允许用户开启配置后无需购买即可使用需要购买的装饰品,不影响原有的货币体系,依旧可以关闭后手动购买
时间显示优化:将中文的12小时制精细到“早晨、傍晚、凌晨”
战力显示:战力只有…5?!在用户界面上直观显示天气数据,搭配【土豆模式】可在设置界面直接修改模组设置。
功能介绍——【土豆模式】:
- 这土豆我吃着不赖:可惜这土豆吃着没味道。允许通过F2将画面渲染分辨率调整为马赛克效果。
- 小小的也很可爱:小小的事物往往让人感觉可爱,你说呢?允许用户通过F3快捷键在无边框小窗(画中画)和上一个窗口模式之间来回切换。
- 魔镜呀魔镜:全连接!允许通过F4进行画面镜像。
- 立了!我说的是屏幕:有时候立着的不一定是大拇指,也可能是……你的屏幕!允许通过F5开启/关闭竖屏优化,让用户可以在特写和广角两个镜头之间进行切换。
- 坚持访问!吗?:你真的要点击删除吗?你真的不会后悔吗?还是说你只是不小心点错了?没事,本模组支持开启删除操作前的二次强提醒,避免一失足成千古恨。
你可以在后续的安装教程中了解如何安装、配置、使用这两款模组。
简介
首先,让我解释一下这个模组的功能。
该模组添加了动态天气和日出/日落系统,可链接到你选择的现实世界位置。它还解锁了所有环境、氛围和可购买物品选项。以上是基本概述。
注意:建议直接从相关资源库阅读安装指南,因为Steam版本可能已过时。从以下两个资源库中选择:Ko_teiru的资源库:更适合中文用户。Robaoro的资源库:面向全球用户,包括中文用户。既然你正在阅读本文,你可能正在寻找英文版本。我建议使用我(Robaoro)的分支版本。本指南的英文部分将重点介绍该版本。建议:安装Ko_teiru的iGPUSavior模组以优化你的游戏。它还添加了一些额外功能。注意:无需担心iGPUSavior的标签为中文。RealTimeWeatherMod的英文版本在集成到iGPUSavior时会对其进行翻译。预览Features Automatically switches between Day/Sunset/Night based on real time.
Optional integration with weather APIs to sync the in-game environment with real weather (Sunny/Cloudy/Rain/Snow/Thunderstorms) in your city.
Option to unlock all environments, decorations and all purchasable items (Can be turned off, although the purchasable items is by default off).
Time sync works even without configuring a weather API. (Now there's a default API key)
For the installation you'd have to scroll down.
安装与使用
天气同步与土豆模式 MOD 整合指南本教程由 deepseek 编写
本教程将指导您同时安装和使用两款功能互补的 MOD:
1. RealTimeWeatherMod - 天气同步
2. iGPUSaviorMod - 土豆模式
📋 前置准备两个 MOD 都需要 BepInEx 5.x 框架才能运行。
🚀 第一步:安装 BepInEx 框架 访问 BepInEx 官方发布页:https://github.com/BepInEx/BepInEx/releases
下载 BepInEx_x64_5.x.x.x.zip(推荐 5.4.23.4 版本)
解压到游戏根目录(游戏主程序 .exe 所在文件夹)
运行一次游戏,进入主界面后退出
此时会自动生成必要的文件夹结构
🌤️ 第二步:安装 RealTimeWeatherMod 前往发布页:https://github.com/Small-tailqwq/RealTimeWeatherMod/releases
下载最新版本的 RealTimeWeatherMod.dll
将 DLL 文件放入:游戏目录/BepInEx/plugins/ 启动游戏一次,退出后生成配置文件
⚙️ RealTimeWeatherMod 配置详解配置文件位置:游戏目录/BepInEx/config/chillwithyou.envsync.cfg
主要配置项:
[Unlock]
UnlockAllEnvironments = true # 自动解锁所有环境场景
UnlockAllDecorations = true # 自动解锁所有装饰品
[WeatherAPI]
EnableWeatherSync = false # 是否启用天气同步
SeniverseKey = # API密钥(v5.1.2+可留空使用内置密钥)
Location = beijing # 城市(拼音/中文,或填"ip"自动定位)
[WeatherSync]
RefreshMinutes = 30 # 天气刷新间隔(分钟)
[UI]
ShowWeatherOnDate = true # 在游戏日期栏显示天气和温度
[Automation]
EnableSeasonalEasterEggs = true # 启用季节性彩蛋
🌍 启用天气同步推荐方案(v5.1.2+版本):
在配置文件中设置:EnableWeatherSync = true 设置城市:Location = 您的城市名 或 Location = ip API密钥留空即可使用内置密钥
可选方案(使用个人API密钥):
访问心知天气官网:https://www.seniverse.com/
注册账号并获取免费API密钥
在配置文件中填入您的密钥
🎮 RealTimeWeatherMod 快捷键 F7 - 强制刷新天气数据
F8 - 查看当前状态(在控制台显示)
F9 - 手动触发场景同步
🖥️ 第三步:安装 iGPUSaviorMod 前往发布页:https://github.com/Small-tailqwq/iGPUSaviorMod/releases
下载最新版本的 iGPU.Savior.dll
将 DLL 文件放入:游戏目录/BepInEx/plugins/ 可与 RealTimeWeatherMod 共存
⚙️ iGPUSaviorMod 配置详解配置文件位置:游戏目录/BepInEx/config/chillwithyou.potatomode.cfg
主要配置项:
[Hotkeys]
PotatoModeKey = F2 # 切换土豆模式(性能优化)
PiPModeKey = F3 # 切换画中画小窗
CameraMirrorKey = F4 # 切换摄像机镜像
PortraitModeKey = F11 # 切换竖屏优化
[Window]
ScaleRatio = OneFourth # 小窗缩放比例
DragMethod = RightClick_Hold # 拖动方式
[Camera]
EnableMirrorOnStart = false # 启动时自动启用摄像机镜像
EnablePortraitMode = false # 启用竖屏优化检测
🎯 两个 MOD 的协同使用 两个 MOD 的设置都可以在游戏内修改:游戏设置 → MOD 选项
修改快捷键时注意避免冲突
推荐同时开启天气同步和小窗模式,提升沉浸感和体验
🔧 故障排除MOD 不生效:
确认 BepInEx 安装正确,各架构是否正常生成,版本是否正确,架构是否和系统匹配
检查 DLL 文件是否放在正确的 plugins 文件夹
查看 BepInEx/LogOutput.log 获取错误信息
快捷键冲突:
在游戏设置界面或配置文件中调整键位
默认快捷键:RealTimeWeatherMod(F7-F9),iGPUSaviorMod(F2-F4)
天气不同步:
确保 EnableWeatherSync = true
按 F7 手动刷新
按 F8 查看控制台状态
📁 文件结构参考游戏根目录/
├── 游戏主程序.exe
├── BepInEx/
│ ├── plugins/
│ │ ├── RealTimeWeatherMod.dll
│ │ └── iGPU.Savior.dll
│ ├── config/
│ │ ├── chillwithyou.envsync.cfg
│ │ └── chillwithyou.potatomode.cfg
│ └── core/
└── doorstop_config.ini
🌦️ 天气与场景对应关系实际天气游戏内场景晴天根据时间显示 白天/黄昏/夜晚多云/阴天Cloudy小雨/阵雨LightRain大雨/暴雨HeavyRain雷阵雨ThunderRain雪Snow
🔄 更新与卸载更新 MOD:
下载新版本 DLL
替换 plugins 文件夹中的旧文件
配置文件通常兼容,建议备份
卸载 MOD:
删除对应的 DLL 文件
如需彻底清理,删除对应的配置文件
两个 MOD 相互独立,可单独卸载
📞 获取帮助官方资源:
RealTimeWeatherMod: GitHub[github.com]
iGPUSaviorMod: GitHub[github.com]
问题反馈:
先查看 BepInEx 日志文件
在 GitHub 提交 Issue(附上日志和详细描述)
两款 MOD 配合使用,既能提升游戏沉浸感,又能优化性能表现,祝您游戏愉快! 🎮✨
(EN) Installation and Use
1. Download the Mod
Get the latest version from GitHub:
https://github.com/Xibuwo/RealTimeWeatherMod-EN/releases
Download just the RealTimeWeatherMod.dll file. That's all you need.
2. Install BepInEx Framework (Prerequisite)
This mod requires BepInEx. If you haven't installed it yet:
Go to the official BepInEx releases page: https://github.com/BepInEx/BepInEx/releases
Download the appropriate version (usually BepInEx_x64_5.x.x.x.zip).
Extract all files into your game's root directory (the folder containing the .exe).
Run the game once. Wait until the main menu loads, then exit.
This will automatically generate the BepInEx/plugins/ and BepInEx/config/ folders.
3. Install the Mod
Place the downloaded RealTimeWeatherMod.dll into:
Game Directory/BepInEx/plugins/
Done.
4. Initialize Configuration File
After installing the mod, launch the game.
Exit the game.
The configuration file will be generated in BepInEx/config/.
Config file name: chillwithyou.envsync.cfg
5. Configuration Details
Open the config file with any text editor. The main sections are:
[TimeConfig]
## Sunrise time (HH:mm)
Sunrise = 06:30
## Sunset time (HH:mm)
Sunset = 18:30
[Unlock]
## Unlock all environments on start
UnlockAllEnvironments = true
## Unlock all decorations on start
UnlockAllDecorations = true
[WeatherSync]
## Weather data refresh interval (minutes)
RefreshMinutes = 15
[WeatherAPI]
## General API (Put the same API key you get from OpenWeather here) (There's a default key)
GeneralAPI =
## Enable real-time weather sync
EnableWeatherSync = true
## API provider: Seniverse or OpenWeather
WeatherProvider = OpenWeather
## Your API Key (There's a default one)
ApiKey =
## Your location (city name or lat,long) (Default is Madrid)
Location =
Key Settings Explained:
Sunrise / Sunset: Customize the time for day/night transitions.
EnableWeatherSync: Set to `true` for weather sync, `false` for time-only sync.
WeatherProvider: Choose `Seniverse` (China-focused) or `OpenWeather` (global).
ApiKey: Your free API key (see next section).
Location: Your city. Use a city name or coordinates for OpenWeather.
6. Get a Free API Key (Optional)
You only need this if you want real weather sync.
OpenWeather: Go to https://openweathermap.org/ and sign up for a free account.
Navigate to your API key[home.openweathermap.org]
Copy the default key or generate a new one.
Paste this key into the `ApiKey` field in the config and also the GeneralAPI section.
Set `WeatherProvider = OpenWeather`.
Note: If you're worried about the API usage on OpenWeather, their free tier limit are 60 calls/minute and 1,000,000 calls/month. So unless you spam it EVERY SECOND then you shouldn't worry.
7. Verify Installation
After launching the game, if successful:
The in-game environment will automatically switch based on your system time.
If weather sync is enabled, it will also match real-world conditions.
Status logs will appear in the BepInEx console (if enabled).
Hotkeys F7 – Force refresh weather (bypasses cache).
F8 – Log current environment status to console.
F9 – Force re-apply environment using cached data.
Troubleshooting* Hotkeys not working? They're functional in the latest fork. Ensure you're using the correct DLL.
* First load takes ~15 seconds. This is normal.
* Game crash on alt-tab? Known issue, being investigated.
* Other problems? Check the BepInEx logs and report issues on GitHub.
开发日志 | Changelogs
更早的不写了,都是泪
RobaOro:
I'll include my work from the English fork here as well. There will be fewer entries, since I won't be transferring everything over, and I might skip some changes. My changelogs are marked with "RobaOro" before the date.
Ko_teiru 2025/11/30:
添加了一个天气显示功能添加了一个时间段描述的优化【12小时制下生效】因为是晚上写的这个,所以12点那会的截图显示的还是下午而不是中午。写了一个新的优化模组,但优化没做好,结果做成一个小窗模组了。小窗效果,我个人还是挺满意的。
哇,Steam这个默认的图片展示效果真差,哪天得弄个边框包装一下,太难看了。
Ko_teiru 2025/12/01 或 02?
今天修复了同步模组的几个漏洞,其中最难修复的就是背景音乐相关的,总是自动开启后无法关闭,无法捕捉它的状态,和窗景不一样。谷歌的那个B开发工具又老是崩溃,Gemini不知道是使用次数太多不让用了还是其他原因,也非常卡顿。没办法只能用回老工具vsc + copilot。好在有惊无险地把几个问题都解决了。
睡前把土豆模组的宣传内容也修改了一下,用了点标题党的手法:【震惊,某模组竟能优化游戏性能60%,操作还如此便捷?!】不过确实是有优化效果的,毕竟渲染大小减小了,占用资源如果没变小反而说不过去了,哈哈。搞点对比图,还是比较直观的。
RobaOro 2025年1月12日
我对该项目进行了分支开发,使其能够适配全球天气数据提供商。我尝试了Open-Meteo、WeatherAPI和AccuWeather,最终选择了OpenWeather。
Ko_teiru 2025年12月2日
下午下班看看有没有新bug,没有的话就研究土豆模式的镜面反转和竖屏适配。
对于小屏设备的专门需求,感觉需要通过钩子程序修改游戏设置,添加一些设置界面,但估计没这么简单,而且游戏更新后可能会失效,反正先试试看,不一定真能成。
下班之后一直在忙土豆模式的UI劫持,想在原有设置中添加MOD设置界面,但一晚上都没搞好,心态崩了。一晚上只睡了两个小时,白天撑不住请假了。
RobaOro 2025年2月12日
我当时...我之前以为OpenWeather的OneCall API是完全免费的。结果发现它需要免费订阅,而订阅又要求提供支付方式,所以我不得不废弃现有的OneCall代码和数据处理逻辑……
Ko_teiru 2025/12/03
如上所述,白天请假睡到下午,下午捣鼓了一下午弄出来一个能用,但和原版不太一样的版本,哎,将就用吧,真不会搞。
UI差不多弄好之后,先从简单的系统开始优化,比如有人说想要镜像模式,研究了一下捣鼓出来了:镜像模式支持一键切换、双声道呼唤、镜像场景交互及UI隔离。
新的竖屏优化以标准1080P分辨率屏幕为开发和测试基准。mod可选择是否开启优化,开启后会检测屏幕分辨率是否符合竖屏条件,符合则调整相机位置和视野,以尽可能显示桌面水杯和主角主体。由于官方竖屏状态下,待机时无法看到完整人物,作业时又为特写画面,因此竖屏优化也支持一键开关。作业时若需要更强的沉浸感,可暂时关闭竖屏优化。目前正在考虑是否添加自动联动番茄钟启停来开启或关闭竖屏优化的功能。
例图中,视野较大的为优化后效果,特写版本为原版效果。无法识别或无法翻译,已删除。开启优化后
官方18号更新游戏,感觉没必要在这个节骨眼去搞待办事项之类的优化,没准到时候官方的优化出来了那就成小丑了。等吧
RobaOro 03/12/2025
编辑了一键呼叫逻辑,使其可与基础天气应用程序接口配合使用。全球天气支持版本已正式发布。
RobaOro 04/12/2025
修复了动态日出/日落时间,并添加了英制单位(华氏度)支持。2025/12/05 Ko_teiru
今天主要是修复土豆模式的bug:
1. 修复了启动时开启镜像功能启动过早,导致场景未被镜像的问题。
2. 修复了mod标签页的竞态问题,现在设置界面不会出现激活两个选项或者激活0个选项的情况。
开发中的部分:将天气同步模组的部分选项对接到游戏设置中。
欧耶,今天居然2点半就能下班,爽到。UI还是存在一些排版上的小问题,但这些都不算大问题。
RobaOro 06/12/2025
更新了英文资源库,使其与原版的计划功能保持一致,同时整合了新的UI元素并提升了兼容性。
RobaOro 08/12/2025
我花了太多时间才把那些下拉菜单弄好。层级问题和下拉菜单高度固定的问题简直要把我逼疯了。最后通过动态画布排序系统解决了这个问题,其实我早该这么做的。另外还添加了输入框,这样大家就不用再手动编辑配置文件了,应该能让所有人都轻松不少。
还有一些关于优化的小改动和中间调整,但都不值一提。现在我要讲讲Ko_teiru的更新内容,因为他已经三天没有更新了:
6日,他修复了标签栏溢出问题,我建议他在iGPUSavior中添加文本输入功能,方法是参考游戏内的帧率限制器进行克隆。
7日,他部分实现了文本输入功能,但仍存在一些小问题。
8日,成功修复了文本输入问题。
目前就这些内容了,我可能漏掉了他的一些更新,但那些都是次要或中间阶段的改动。
Ko_teiru 2025/12/09
补一条之前漏掉的日志。对接了土豆模式,更新此版本与1.7。1的土豆模式可以直接在游戏中编辑部分配置项
支持:开关天气同步、开关天气UI显示、开关时间段细分、开关彩蛋模式、设置当前城市
设置新城市后3秒,系统会尝试刷新天气、日出日落
Ko_teiru 2025/12/15
哎,工作有点忙,生活上也遇到了些事,几天没更新都在忙工作。今天抽空更新了下文章排版,感觉差不多了。
MOD后续更新的方向还是取决于18号官方的更新,所有的一切都要等到那会再说。
另外大家一定要提防诈骗和迷信,特别是家里长辈容易受骗,多的不说了。
希望大家玩得开心。
RobaOro 16/12/2025
新增默认API,并将刷新间隔从10分钟增加到15分钟。注意:如前所述,默认(免费)API密钥限制为每秒60次调用或每月1,000,000次调用。这远高于当前使用量,但存在一种罕见的极端情况:如果两名用户在同一秒激活模组,可能会因速率限制导致其中一个请求被丢弃。
我一直很忙,所以进展有限。
在18日的更新之前,除了 minor optimisations 外,不会有进一步更新。只要模组没有损坏,就无需担心。
与本模组无关但与游戏相关的是,我尝试添加外部音频播放器选项(例如YouTube Live)。我曾尝试通过API提取音频,这其实没有必要。将视频嵌入屏幕外并将播放器界面绑定到视频上会简单得多。Ko_teiru 2025/12/18
下班花了4个多小时修复了所有漏洞,主要是游戏开发者修正了之前写错的单词,所以模组也需要跟着修改。此外,游戏重写了原有的环境(时间)开关方式,导致模组需要重新适配,这部分比较耗时。最后是新增的货币装饰添加了一个解锁功能,其中场景类默认解锁,只有装饰品单独新增了一个配置项进行管理。
周末可能会对土豆模式进行一些修改,添加新功能,或者在番茄钟中加入土豆钟的逻辑切换,将倒计时改为顺计时。这个想法听起来有点意思,但实现起来估计会有难度。RobaOro 18/12/2025
更新了模组的英文版本,以确保与当前游戏版本兼容,并与Ko_teiru的最新版本保持一致。这包括Ko_teiru的一项新功能,可解锁最新的可购买游戏内物品。
Ko_teiru 2025/12/22
今天修复了一个土豆模式的竖屏优化问题,话说这个问题居然以前从来没有人反馈过,看来竖屏优化还算是比较小众啊((
凌晨发现了一个新的bug,竖屏全屏部分按钮可能出现无法点击的情况,目前无法分析问题成因,而且问题经过窗口缩放后自行消失了。只能先记录,后复现了。
又是一周工作日,真的是不想上班啊Ko_teiru 2025/12/28
收到RobaOro反馈的一个BUG:切换语言会导致土豆模式介入的设置提示文本(番茄钟提示音、帧率、某些开关等)重置为克隆前的状态。使用谷歌反重力工具进行修复后,问题很快得到解决。
随后考虑到:触发该BUG需要切换语言,而切换语言意味着用户受众可能并非中文用户,但原本的提示文本均为中文。因此,修复该BUG后,若切换至英文界面,提示仍为中文则不够合理。
为此,为模组的配置项添加了简单的多语言功能,目前暂支持中日英三种语言,其他语言将在后续考虑添加。若要支持更多语言,还需对多项内容进行调整,例如傍晚、午夜相关的设置,尚不清楚国外用户的使用习惯和具体方式。Ko_teiru 2025/12/30(凌晨,按理来说应该是29日)
为土豆模式的镜像模式修复了一个拖拉拽窗口的bug。
为土豆模式默认开启了删除待办清单时的二次提醒。
因为是测试版,所以现在的强提醒没办法关闭,如果不用待办清单的话没必要更新。
好困,睡觉了