MCmod-info-mirror

为各平台的 Mod 的缓存加速，由 MCLF-CN #3 提议，由 Pysio 提供 CDN 支持

基于 BMCLAPI 使用网盘缓存的先例，当前文件缓存在 Mr.yang 和 八蓝米 支持下试运行！

以 Curseforge 和 Modrinth 为镜像源

• API
• Docs
• Status

接入

本镜像有 UA 白名单，请在使用前提交启动器的 UA 启动器信息

使用

以下所有内容均建立在已经能够成功从官方源下载数据的基础上，不了解的话请前往 CFCore 和 Modrinth Docs 参考。

MCIM 的目标是 100% 兼容官方的 API 结构，可以直接替换，方便迁移，可以直接替换，具体可以比对 Docs，你可以直接在里面尝试。

Modrinth

• api.modrinth.com or staging-api.modrinth.com -> mod.mcimirror.top/modrinth
• cdn.modrinth.com -> mod.mcimirror.top

Curseforge

• api.curseforge.com -> mod.mcimirror.top/curseforge
• edge.forgecdn.net or mediafilez.forgecdn.net -> mod.mcimirror.top

简介翻译

translate-mod-summary 提供已缓存的 Mod 的简介的 GPT 翻译，定期更新

• Modrinth description -> translated_description
• Curseforge summary -> translated_summary

示例

Modrinth

 
  {
    id: 'AANobbMI',
    description: 'The fastest and most compatible rendering optimization mod for Minecraft',
    ...
    found: true,
    slug: 'sodium',
    sync_at: '2024-07-22T08:30:37Z',
    translated_description: '一个为《我的世界》打造的现代渲染引擎，极大地提升了性能。'
  }

Curseforge

 
  {
    id: 975558,
    slug: 'progetto-multiverso-ultra-adventure',
    ...
    summary: 'This mod adds many new RPG features to the game',
    sync_at: '2024-06-06T01:23:21Z',
    translated_summary: '此模组为游戏添加了许多新的角色扮演特性。'
  }
  

缓存思路

由于除了搜索接口是反代，其他都是通过数据库缓存，无法保证一定已缓存，也可能过期。

基本思路为 忽视数据是否过期，以及 忽略数据是否不全，无条件返回已有数据，在过期、未找到等情况下先返回数据，然后后台拉取源站。

不可信的响应将在 headers 内提供 Trustable 参数，提供 sync_at 缓存时间

关于文件缓存，不会缓存除 Mod 外的整合包、资源包、材质包、地图等，以及文件大小大于 20M 的文件，curseforge 的类型限制为 classId=6，该限制会被可能更改。

已缓存符合条件的所有 Modrinth 上的 Mod，Curseforge 技术受限正在缓慢添加。

注意事项

文件下载可能存在一定的不稳定性，当前缺少多节点网盘的分流，建议启动器在未能成功下载的情况下才尝试使用镜像源。

未缓存部分接口，如果有 API 需要更新或新增请联系。

关于 Mod 开发者收益问题，由于 CDN 下载量并不计入 curseforge 收益，因此无论从启动器官方源下载还是镜像源下载都是无法为 Mod 开发者提供收益的，不接受影响 Mod 开发者收益的指责。详情见 MCLF-CN #3 的讨论。

本镜像可能会在滥用的情况下切换到 Cloudflare CDN 或开启 URL 鉴权，或者暂时关闭。

部署

先安装 docker，clone 到本地后直接 docker-compose up -d 即可，记得修改 docker-compose.yml 里面的 config 挂载目录，以及 config 内容。

鸣谢

• Mr.yang
• 八蓝米
• Pysio

联系

• Eamil: z0z0r4@outlook.com
• QQ: 3531890582

协议

1. MCIM 下的所有文件，除 MCIM 本身的源码之外，归源站点所有
2. MCIM 会尽量保证文件的完整性、有效性和实时性，对于使用 MCIM 带来的一切纠纷，与 MCIM 无关。
3. 所有使用 MCIM 的程序必需在下载界面或其他可视部分标明来源
4. 禁止在 MCIM 上二次封装其他协议