Stardew Valley Launcher

一站式星露谷物语启动器 · Mod 管理器 · Modpack 工具

---

关于

SVL (Stardew Valley Launcher) 是一个功能完整的星露谷物语启动器和 Mod 管理器。它提供现代化的 Windows 桌面体验，让你轻松管理游戏实例、安装和组织 Mod、集成 NexusMods 下载，以及创建和分享 Modpack。

功能亮点

🎮 游戏启动

• 自动检测 Stardew Valley 安装路径（Steam / GOG）
• 多游戏实例管理与隔离
• SMAPI 自动检测、安装与版本管理
• 支持原版与 Mod 模式启动
• 自定义窗口标题与启动参数

📦 Mod 管理

• 从 ZIP 文件或文件夹安装 Mod
• 一键启用 / 禁用 / 卸载
• 智能依赖解析（拓扑排序 + 循环检测）
• 冲突检测（ID 重复、文件冲突、依赖冲突）
• Mod 详情查看（版本、作者、描述、依赖关系）

🌐 NexusMods 集成

• NexusMods 搜索与浏览
• OAuth / SSO 登录认证
• 一键下载并安装 Mod
• nxm:// 协议支持（浏览器一键安装）
• NexusMods Collections 支持
• API 请求频率限制与缓存管理

📋 Modpack 管理

• 创建自定义 Modpack（选择 Mod 打包导出为 .zip）
• 导入 SVL Modpack（.zip 格式，包含 modpack.json）
• CurseForge Modpack 格式兼容（.zip / .cfmodpack）
• Nexus Collection 格式兼容（.7z/包含 collection.json）
• 拖放安装支持

⬇️ 下载管理

• 内置多任务下载管理器
• 断点续传支持
• 多来源下载（NexusMods / CurseForge / 直链）
• 下载队列与进度追踪

🎨 界面与主题

• Windows 11 风格现代化 UI
• 深色 / 浅色主题切换
• 可自定义主题配色
• 响应式布局设计

快速开始

系统要求

• 操作系统: Windows 10 / 11
• 运行时: .NET Framework 4.8（Windows 10+ 已内置）
• 游戏: Stardew Valley（Steam 或 GOG 版本）

安装

从 Releases 页面下载最新版本，解压后运行 SVL.Desktop.exe 即可。

从源码构建

# 克隆仓库
git clone https://github.com/panda-lsy/SVL.git
cd SVL

# Debug 构建
dotnet build SVL.sln --configuration Debug

# Release 构建
dotnet build SVL.sln --configuration Release

# 运行
dotnet run --project SVL.Desktop

构建需要 .NET SDK（支持 .NET Framework 4.8 目标）以及 Windows 环境。

项目结构

SVL/
├── SVL.Core/                 # 核心功能库
│   ├── App/                  #   应用核心与生命周期管理
│   ├── Config/               #   配置系统
│   ├── Download/             #   下载管理器
│   ├── IO/                   #   文件服务
│   ├── Logging/              #   日志系统
│   ├── Modpack/              #   Modpack 格式解析
│   ├── Security/             #   安全工具
│   ├── Stardew/              #   星露谷核心
│   │   ├── Instance/         #     实例管理与隔离
│   │   ├── Launch/           #     游戏启动编排
│   │   ├── Mod/              #     Mod 管理与依赖解析
│   │   └── ResourceProject/  #     NexusMods / Modpack 集成
│   └── Utils/                #   工具类
├── SVL.Desktop/              # WPF 桌面应用
│   ├── ViewModels/           #   MVVM ViewModels
│   ├── Views/                #   XAML 页面
│   ├── Controls/             #   自定义控件
│   ├── Resources/            #   主题与样式资源
│   └── Images/               #   图标与图片
├── SVL.Tests/                # 单元测试
└── SVL.sln

技术栈

层级	技术
运行时	.NET Framework 4.8
UI 框架	WPF (Windows Presentation Foundation)
MVVM	CommunityToolkit.Mvvm
配置	YamlDotNet / System.Text.Json
压缩	SharpZipLib / SharpCompress
嵌入依赖	Costura.Fody

配置文件

文件	位置	格式
全局配置	%LocalAppData%\SVL\config.yaml	YAML
实例配置	%LocalAppData%\SVL\instances\{id}\instance.json	JSON
NexusMods 缓存	%LocalAppData%\SVL\cache\nexusmods\	-

贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建功能分支 (git checkout -b feature/my-feature)
3. 提交更改 (git commit -m 'feat: add my feature')
4. 推送分支 (git push origin feature/my-feature)
5. 发起 Pull Request

致谢

• PCL2-CE — 架构设计参考
• SMAPI — Stardew Valley Modding API
• CommunityToolkit.Mvvm — MVVM 框架
• NexusMods — Mod 资源平台
• Vortex — Mod 管理器设计参考
• Mod Organizer 2 — Mod 管理器设计参考
• Stardrop — 星露谷 Mod 管理与依赖交互设计参考
• CurseForge — Mod 资源平台

许可证

Apache License 2.0