一个用 Modrinth API 制作的 Modrinth 资源下载器
Wpfhw 是一款基于 WPF 构建的 Windows 桌面应用，通过 Modrinth API 帮你搜索、浏览和下载 Minecraft 模组、整合包、资源包和光影包。告别浏览器里来回翻页的繁琐操作，在一个窗口里完成从检索到下载的全部流程。
- 资源搜索 — 关键词检索 Modrinth 全站资源，支持按下载量、关注数、更新时间等维度排序
- 多类型支持 — 模组（mod）、整合包（modpack）、资源包（resourcepack）、光影包（shader）一网打尽
- 精细筛选 — 按游戏版本、加载器（Fabric / Forge / Quilt / NeoForge 等）、分类标签过滤结果
- 版本管理 — 查看每个项目的全部历史版本，按游戏版本和加载器筛选可用文件
- 一键下载 — 选中版本即可直接下载到本地，无需跳转浏览器
- 现代 UI — v26.1.1 全新界面设计与视觉美化，操作流畅直观
- 原生体验 — 纯 WPF 桌面应用，启动快、占用低，离线浏览已缓存的项目信息
v26.1.1 新版界面
- Windows 10 1809 及以上版本（需 .NET10）
- 屏幕分辨率不低于 1280×720
前往 Releases 页面 下载最新发行版：
- 找到标记为「最新」的版本
- 下载附件中的安装包或便携版压缩包
- 安装版双击运行
.exe安装；解压后直接运行Wpfhw.exe
首次打开应用时无需额外配置，程序会自动连接 Modrinth API。如遇网络问题，请检查代理设置是否正确。
在顶部搜索栏输入关键词（如 sodium、fabric api），选择资源类型和筛选条件后点击搜索，结果列表会展示项目名称、简介、下载量和图标。
- 点击搜索结果中的项目卡片，进入详情页
- 在版本列表中按游戏版本和加载器筛选
- 选择目标版本，点击下载按钮
- 文件将保存到应用设定的下载目录中（可在设置中修改默认路径）
| 操作 | 说明 |
|---|---|
| 修改下载路径 | 设置 → 下载目录 |
| 切换资源类型 | 搜索栏旁的下拉菜单 |
| 查看项目主页 | 详情页点击「在 Modrinth 查看」 |
| 层级 | 技术 |
|---|---|
| UI 框架 | WPF（Windows Presentation Foundation） |
| 开发语言 | C# |
| 运行时 | .NET（需安装 .NET Desktop Runtime） |
| API 对接 | Modrinth API v2（https://api.modrinth.com/v2） |
| HTTP 请求 | HttpClient / RESTful 调用 |
| 数据格式 | JSON |
Wpfhw 基于以下核心接口实现功能：
GET /v2/search— 按关键词搜索项目，支持 facets 多维过滤和排序GET /v2/project/{id|slug}— 获取项目详情GET /v2/project/{id|slug}/version— 获取项目的全部版本列表GET /v2/version_file/{hash}— 通过文件哈希查询版本信息
API 要求所有请求携带唯一标识的 User-Agent 头，格式建议为 HW-Community/Wpfhw/版本号。完整文档参见 Modrinth API 文档。
- Visual Studio 2022（含 .NET 桌面开发工作负载）或 JetBrain Rider
- .NET SDK（版本以仓库
.csproj中TargetFramework为准）
# 克隆仓库
git clone https://github.com/HW-Community/Wpfhw.git
cd Wpfhw
# 还原依赖
dotnet restore
# 构建项目
dotnet build
# 运行（调试模式）
dotnet run# 发布 Release 版本
dotnet publish -c Release -r win-x64 --self-contained false生成的文件位于 bin/Release/ 目录下。
欢迎提交 Issue 和 Pull Request。
- Fork 本仓库
- 创建功能分支（
git checkout -b feature/your-feature） - 提交更改（
git commit -m 'feat: 添加某个功能'） - 推送到分支（
git push origin feature/your-feature） - 发起 Pull Request 并描述改动内容
提交信息建议遵循 Conventional Commits 规范。
本项目采用 MIT License 开源。
- Modrinth — 提供 Minecraft 模组分发平台及开放的 REST API
- Modrinth API 文档 — 完整的接口参考
- 所有为本项目提出建议和反馈的用户
Made with ❤️ by HW-Community