MDT File Mindustry Manifest API 说明

文件站所提供的 Mindustry 版本清单 API，用于获取文件站当前收录的 mdt 版本及相关数据。
适用于启动器、机器人、自动更新工具及其他第三方程序。

接口地址

https://file.mdtbbs.cn/api/v1/mindustry/manifest.json

可以直接通过浏览器访问，也可以由程序请求。

主要用途

该接口主要面向需要读取 MDT 版本数据的程序，例如：

• Mindustry 第三方启动器

• 自动下载 / 自动更新工具

• QQ、Discord 等机器人

• 版本查询工具

• 自动化部署脚本

• MDTBBS 相关客户端

• 其他需要获取 Mindustry 版本信息的第三方项目

• 欢迎各位使用并发布在论坛中

建议：
如果程序需要读取 MDT File 的版本信息，请优先使用 API，不要直接解析文件站网页（相信你不会这么做的对吧？）。

网页结构可能会随着前端更新而改变，而 /api/v1/ 接口会尽量保持兼容。

JavaScript 示例

Node.js 18 及以上版本可以直接使用 fetch：

const response = await fetch(
  "https://file.mdtbbs.cn/api/v1/mindustry/manifest.json"
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const manifest = await response.json();

console.log(manifest);

Python 示例

import requests

url = "https://file.mdtbbs.cn/api/v1/mindustry/manifest.json"

response = requests.get(url, timeout=10)
response.raise_for_status()

manifest = response.json()

print(manifest)

关于 API 版本

当前接口路径为：

/api/v1/

这里的 v1 表示 API Version 1，此处的版本是API的版本 可不是mdt的版本

采用版本化接口的主要目的是保证第三方程序的兼容性。

例如文件站后续可能调整：

• 页面结构

• 前端框架

• 文件存储方式

• 数据库结构

• 内部下载逻辑

这些变化原则上不应该影响已经接入 /api/v1/ 的程序。

如果以后出现无法保持兼容的大规模接口调整，则会通过新的 API 版本提供。（应该不会调整了。。）

因此，第三方程序建议直接使用 API 返回的数据，不要自行根据文件名、网页路径等内容推测版本信息。

调用建议

第三方程序在接入时，建议至少处理以下情况：

网络异常

包括：

• 请求超时

• DNS 解析失败

• HTTP 请求失败

• 服务暂时不可用

建议设置合理的请求超时时间。

例如：

requests.get(url, timeout=10)

HTTP 状态码

不要直接假定请求一定成功。

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

JSON 解析异常

Manifest 返回的是 JSON 数据，但程序仍应处理返回内容异常或解析失败的情况。

字段兼容

后续 Manifest 可能增加新的字段。

第三方程序不应因为出现未知字段而直接报错。

建议：

读取需要的字段
忽略未知字段

而不是严格要求返回结构必须与当前版本完全一致。

缓存建议

Manifest 属于版本清单数据，一般没有必要进行非常高频的请求。

例如启动器可以：

1. 启动时读取本地缓存

2. 请求最新 Manifest

3. 请求成功后更新缓存

4. 请求失败时继续使用已有缓存

这样即使文件站的api暂时无法访问，也不会导致整个程序无法使用。

对于普通版本查询场景，没有必要每几秒刷新一次 Manifest，因为我们的服务器吃不消并且自动程序会把用户的ip拉入黑名单

推荐调用流程

获取 Manifest
      │
      ▼
读取版本信息
      │
      ▼
生成版本列表
      │
      ▼
用户选择版本
      │
      ▼
获取对应文件信息
      │
      ▼
下载文件

如果用于自动更新程序，则可以根据 Manifest 中的数据与本地版本进行比较。

我们不建议使用以下方式使用服务

不要直接解析 HTML

不建议通过下面的方式获取版本数据：

因为网页主要面向用户浏览，HTML 结构可能随时因为页面更新发生变化。

不要自行拼接下载地址

如果 Manifest 已经提供相关文件信息，应直接使用接口返回的数据。

不要根据当前文件目录结构自行生成地址。

不要高频轮询

不建议短时间内大量重复请求 Manifest。

对于大多数程序，按需刷新或进行短时间缓存即可。

相关地址

像素工厂文件站（MDT File）

https://file.mdtbbs.cn/

Mindustry Manifest API

https://file.mdtbbs.cn/api/v1/mindustry/manifest.json

Mindustry 版本文件分类

https://file.mdtbbs.cn/category/Mindustry

问题反馈

如果在使用过程中遇到以下问题：

• Manifest 数据异常

• 游戏版本缺失

• 文件信息错误

• 下载链接失效

• API 返回异常

• 第三方程序接入存在兼容问题

可以在 论坛运营反馈 发帖 。

API 仍会继续根据实际需求继续完善改进，如果你有好的想法或者是想加入我们欢迎联系

此文档最后编辑日期 2026/9/23