星露谷物语模组管理器 (SVMM)

星露谷物语模组管理器 (SVMM)

轻量级深色/浅色桌面模组管理器,适用于星露谷物语,支持按模组包分文件夹,并即时切换junction/符号链接配置文件。

[size=5][b]星露谷物语模组管理器 (SVMM)[/b][/size]

[size=4][b]描述[/b][/size]
[b]星露谷物语模组管理器 (SVMM)[/b] 是一个轻量级、便携的桌面模组管理器,专为 [b]星露谷物语[/b] 设计。

每个整合包/配置都位于其独立的文件夹中 (SVMM_Data/modpacks/<ProfileName>/)。当你切换配置或启动游戏时,SVMM 使用操作系统级别的目录联接(Windows 上的 mklink /J,macOS/Linux 上的符号链接),从而实现模组的 [b]零文件复制的即时切换[/b]。

你还可以随时干净地启动 [b]原版[/b] 游戏——SVMM 会解除当前 Mods 联接的链接,而不会触碰你的模组文件,并安全地将任何已有的、未被管理的 Mods 文件夹备份到 Mods_Backup。

[line]

[size=4][b]主要功能[/b][/size]
[list]
[][b]按整合包隔离文件夹:[/b] 在 SVMM_Data/modpacks/<ProfileName>/ 下保持不同的模组设置完全独立。[/]
[][b]即时零复制配置切换:[/b] 通过 NTFS 目录联接重建配置链接并指向 Stardew Valley/Mods,无需复制数 GB 的模组文件。[/]
[][b]安全的原版启动与自动备份:[/b] 随时启动未安装模组的 Stardew Valley.exe。任何已有的、未被管理的 Mods 文件夹都会自动备份到 Mods_Backup。[/]
[][b]应用内 Nexus Mods 浏览器与安装器:[/b] 浏览 [i]热门[/i]、[i]最近更新[/i] 和 [i]新模组[/i],按关键词搜索,并直接安装(支持 Nexus Premium 的一键安装、自动监视 Downloads 文件夹以处理免费浏览器下载,以及处理 nxm:// 链接)。[/]
[][b]安全的 .zip 模组安装器:[/b] 直接将单个或多个模组的 .zip 压缩包安装到当前活动的整合包中,内置了 zip-slip 路径遍历防护。[/]
[][b]依赖与冲突警告:[/b] 自动检查 SMAPI manifest.json 文件,查找缺失的必需 Dependencies 和重复的 UniqueID(显示 ⚠ 指示器并带有悬停提示),并在启动 SMAPI 前进行提示。[/]
[][b]容错的 SMAPI 清单解析器:[/b] 处理 UTF-8 BOM、// 和 /* */ 注释、尾随逗号以及嵌套的整合包子文件夹。[/]
[][b]后台模组更新检查器:[/b] 在后台检查 Nexus:<id> 和 GitHub:owner/repo 的 UpdateKeys,并带有本地缓存 (SVMM_Data/update_cache.json) 和优雅的离线支持。[/]
[][b]配置管理与界面体验优化:[/b] 以 JSON 格式创建、复制、导入和导出配置;在深色/浅色/系统主题之间切换;搜索/筛选模组;并直接从启动栏打开 SMAPI-latest.txt。[/]
[/list]
[line]

[size=4][b]安装说明[/b][/size]
[b]选项 A:独立 Windows 可执行文件(推荐)[/b]
[list=1]
[]从 [b]Files[/b] 标签页(或 [url=https://github.com/smanedn/stardew_mod_manager/releases/latest]GitHub Releases[/url])下载最新的 SVModManager-vX.Y.Z-windows-x64.zip。[/]
[]将 SVModManager.exe 解压到其专用的文件夹中(例如 C:\Games\SVMM\)。[/]
[]双击 SVModManager.exe 启动。[i](如果因为二进制文件未签名而出现 Windows SmartScreen,请点击 [b]更多信息 → 仍要运行[/b]。)[/i][/]
[]点击顶栏中的 [b]Browse[/b] 并选择你的 [b]星露谷物语[/b] 安装文件夹。[/]
[]点击 [b]Open Modpack Folder[/b](或使用内置的 .zip 安装器 / Nexus 浏览器)添加模组,然后点击 [b]Refresh (F5)[/b]。[/]
[]勾选你想要启用的模组,然后点击 [b]LAUNCH MODDED (SMAPI)[/b] 或 [b]LAUNCH VANILLA (NO MODS)[/b]。[/]
[/list][i]注意:所有数据 (SVMM_Data/) 都便携地存储在 SVModManager.exe 旁边。[/i]

[b]选项 B:从源代码运行 (Python)[/b]
[list=1]
[]从 [url=https://github.com/smanedn/stardew_mod_manager]GitHub[/url] 克隆或下载源代码。[/]
[]创建虚拟环境并安装依赖:pip install -r requirements.txt[/]
[]运行 python main.py(在 Windows 上,双击 main.py 会自动检测并使用 .venv,如果存在的话)。[/]
[/list]
[line]

[size=4][b]系统要求[/b][/size]
[list]
[][b]星露谷物语[/b](本地安装)[/]
[][b][url=https://smapi.io/]SMAPI[/url][/b] 安装在你的星露谷物语目录中(模组启动时需要;原版启动不需要)[/]
[][b]操作系统:[/b] Windows x64(已测试;无需管理员权限即可运行)。macOS 和 Linux 为实验性支持。[/]
[][b]如果从源代码运行:[/b] Python 3.10+、customtkinter 和 pillow>=10.0(独立 .exe 不需要这些)。[/]
[][b]可选:[/b] 一个 Nexus Mods API 密钥(在 SVMM_Data/config.json 中配置或通过应用内 Nexus 浏览器配置),用于从 Nexus Mods 浏览/安装模组以及检查 Nexus:<id> 更新;在 SVMM_Data/config.json 中可选的 github_token,用于提高 GitHub API 速率限制。[/]
[/list]
[line]

[size=4][b]致谢[/b][/size]
[list]
[][b]ConcernedApe[/b] 创造了星露谷物语。[/]
[][b]Pathoschild[/b] 开发了 SMAPI 和星露谷物语模组生态系统。[/]
[][b]Tom Schimansky[/b] 开发了 [url=https://github.com/TomSchimansky/CustomTkinter]CustomTkinter[/url],以及 [b]Pillow[/b] 的维护者们。[/]
[][b]Nexus Mods[/b] 和整个星露谷物语模组社区,感谢他们的灵感、API 和反馈。[/]
[/list]
[line]
[i]在 MIT 许可证下开源——源代码和问题追踪器位于 [url=https://github.com/smanedn/stardew_mod_manager]GitHub[/url]。[/i]