Skip to content

ltxhhz/ModBridge

Repository files navigation

ModBridge

GitHub GitHub release (latest by date) GitHub Workflow Status GitHub last commit GitHub All Releases windows C#

ModBridge 是一个用于 迁移不同 Minecraft 游戏版本的 Mod 的工具。 目前支持 HMCLPCL 启动器生成的文件结构,能够自动获取和下载 Mod,帮助玩家快速完成版本间的迁移。


✨ 功能特性

  • 🔍 自动识别游戏版本与加载器选择游戏版本目录后,工具会自动解析其中的版本号和文件名中的加载器信息。

  • 📂 支持 HMCL 和 PCL 文件结构兼容 HMCL 和 PCL 启动器生成的 mods 文件夹结构。

  • 🌐 双源支持:Modrinth + CurseForge

    • 查询 Mod 时会优先使用 Modrinth
    • 如果未找到结果,会自动回退到 CurseForge
    • 提高了搜索的成功率和下载的稳定性
  • 📊 直观的 Mod 管理界面

    • 左侧选择 来源版本,自动获取该版本下的所有 Mod(忽略后缀为 disabledold 的文件)
    • 右侧选择 目标版本,点击 获取所有版本 即可批量搜索可用版本
    • 点击 下载所有 可批量下载目标版本的 Mod
    • 表格中也支持对单个 Mod 进行操作
  • 🔄 状态管理与进度显示每个 Mod 的处理状态会实时显示,避免重复操作,并支持下载进度展示:

    • 已存在
    • 正在下载34% ← 会实时更新进度
    • 已下载
    • 下载失败
    • 正在搜索
    • 搜索失败
    • 等待搜索
    • 搜索完成
    • 没有结果
  • 🔑 可配置 CurseForge API Key 默认 key 可能有限制,如有需要请自行申请并以 CurseForgeApiKey 键配置到 config.ini 或环境变量,以提升搜索和下载的稳定性。


📥 安装与运行

  1. 下载最新的 Release 或自行编译项目
  2. 启动程序后,选择你的 Minecraft 游戏版本目录
  3. 在界面中选择 来源版本目标版本,即可开始迁移

img


🖼 使用流程

  1. 选择游戏版本目录
  2. 左侧选择来源版本 → 自动获取 Mod 列表
  3. 右侧选择目标版本
  4. 点击 获取所有版本 → 搜索可用 Mod(先查 Modrinth,失败再查 CurseForge)
  5. 点击 下载所有 → 批量下载(支持进度显示)
  6. 或者在表格中单独操作某个 Mod

🛠 开发说明

  • 使用 C# 开发,支持 Windows 平台
  • 配置文件存放在 %AppData%/ModBridge/config.ini
  • 我是 C# 新手,代码质量不高,欢迎提 Issue 或 PR 来改进

🤝 贡献

欢迎提交 Issue 或 Pull Request 来改进 ModBridge。 请确保在提交前运行测试并遵循项目的代码规范。


📜 许可证

本项目基于 MIT License 开源。