Schema 定义
分页信息。
| 字段 |
类型 |
说明 |
index |
int32 |
本次返回的起始索引（从 0 开始） |
pageSize |
int32 |
请求的页大小 |
resultCount |
int32 |
本次实际返回数量 |
totalCount |
int64 |
符合条件的总数量 |
File
文件对象。
| 字段 |
类型 |
说明 |
id |
int32 |
文件 ID |
gameId |
int32 |
所属游戏 ID |
modId |
int32 |
所属项目 ID |
isAvailable |
boolean |
是否可下载 |
displayName |
string |
显示名称 |
fileName |
string |
文件名 |
releaseType |
FileReleaseType |
发布类型 |
fileStatus |
FileStatus |
文件状态 |
hashes |
FileHash[] |
文件哈希列表 |
fileDate |
string(date-time) |
文件时间戳 |
fileLength |
int64 |
文件大小（字节） |
downloadCount |
int64 |
下载次数 |
fileSizeOnDisk |
int64 | null |
磁盘占用 |
downloadUrl |
string |
下载地址 |
gameVersions |
string[] |
关联的游戏版本字符串列表 |
sortableGameVersions |
SortableGameVersion[] |
排序用版本信息 |
dependencies |
FileDependency[] |
依赖关系列表 |
exposeAsAlternative |
boolean | null |
是否暴露为替代版本 |
parentProjectFileId |
int32 | null |
父项目文件 ID |
alternateFileId |
int32 | null |
替代文件 ID |
isServerPack |
boolean | null |
是否为服务端包 |
serverPackFileId |
int32 | null |
服务端包文件 ID |
isEarlyAccessContent |
boolean | null |
是否为抢先体验内容 |
earlyAccessEndDate |
string(date-time) | null |
抢先体验结束日期 |
fileFingerprint |
int64 |
文件指纹 |
modules |
FileModule[] |
文件模块列表 |
FileHash
文件哈希。
| 字段 |
类型 |
说明 |
value |
string |
哈希值 |
algo |
HashAlgo |
哈希算法（1=Sha1, 2=Md5） |
HashAlgo
FileDependency
文件依赖关系。
| 字段 |
类型 |
说明 |
modId |
int32 |
依赖的项目 ID |
relationType |
FileRelationType |
关系类型 |
FileRelationType
| 值 |
含义 |
| 1 |
EmbeddedLibrary（嵌入库） |
| 2 |
OptionalDependency（可选依赖） |
| 3 |
RequiredDependency（必需依赖） |
| 4 |
Tool（工具） |
| 5 |
Incompatible（不兼容） |
| 6 |
Include（包含） |
FileModule
文件中的模块。
| 字段 |
类型 |
说明 |
name |
string |
模块名 |
fingerprint |
int64 |
模块指纹 |
FileIndex
文件索引信息（用于最新文件列表）。
| 字段 |
类型 |
说明 |
gameVersion |
string |
游戏版本 |
fileId |
int32 |
文件 ID |
filename |
string |
文件名 |
releaseType |
FileReleaseType |
发布类型 |
gameVersionTypeId |
int32 | null |
游戏版本类型 ID |
modLoader |
ModLoaderType |
Mod Loader 类型 |
SortableGameVersion
用于排序的版本信息。
| 字段 |
类型 |
说明 |
gameVersionName |
string |
原始版本名（如 1.5b） |
gameVersionPadded |
string |
补齐版本号（如 0000000001.0000000005），用于排序 |
gameVersion |
string |
清洗后的版本号（如 1.5） |
gameVersionReleaseDate |
string(date-time) |
版本发布日期 |
gameVersionTypeId |
int32 | null |
游戏版本类型 ID |
Mod
项目对象。data 字段中返回的核心类型。
| 字段 |
类型 |
说明 |
id |
int32 |
项目 ID |
gameId |
int32 |
所属游戏 ID |
name |
string |
项目名称 |
slug |
string |
URL Slug |
links |
ModLinks |
项目相关链接 |
summary |
string |
简要说明 |
status |
ModStatus |
项目状态 |
downloadCount |
int64 |
总下载次数 |
isFeatured |
boolean |
是否精选 |
primaryCategoryId |
int32 |
主分类 ID |
categories |
Category[] |
所属分类列表 |
classId |
int32 | null |
所属 class ID |
authors |
ModAuthor[] |
作者列表 |
logo |
ModAsset |
Logo 资源 |
screenshots |
ModAsset[] |
截图列表 |
mainFileId |
int32 |
主文件 ID |
latestFiles |
File[] |
最新文件列表 |
latestFilesIndexes |
FileIndex[] |
最新文件索引 |
latestEarlyAccessFilesIndexes |
FileIndex[] |
最新抢先体验文件索引 |
dateCreated |
string(date-time) |
创建日期 |
dateModified |
string(date-time) |
最后修改日期 |
dateReleased |
string(date-time) |
发布日期 |
allowModDistribution |
boolean | null |
是否允许分发 |
gamePopularityRank |
int32 |
游戏内排名 |
isAvailable |
boolean |
是否可搜索（实验性/已删除/仅有 alpha 文件时为 false） |
thumbsUpCount |
int32 |
点赞数 |
rating |
number | null |
评分 |
ModLinks
项目相关链接。
| 字段 |
类型 |
说明 |
websiteUrl |
string |
官网 |
wikiUrl |
string |
Wiki |
issuesUrl |
string |
Issue 跟踪 |
sourceUrl |
string |
源码仓库 |
ModAuthor
项目作者。
| 字段 |
类型 |
说明 |
id |
int32 |
作者 ID |
name |
string |
作者名 |
url |
string |
作者主页 |
ModAsset
项目资源（Logo / 截图）。
| 字段 |
类型 |
说明 |
id |
int32 |
资源 ID |
modId |
int32 |
所属项目 ID |
title |
string |
标题 |
description |
string |
描述 |
thumbnailUrl |
string |
缩略图 URL |
url |
string |
原图 URL |
Category
分类。
| 字段 |
类型 |
说明 |
id |
int32 |
分类 ID |
gameId |
int32 |
所属游戏 ID |
name |
string |
分类名称 |
slug |
string |
URL Slug |
url |
string |
分类 URL |
iconUrl |
string |
分类图标 URL |
dateModified |
string(date-time) |
最后修改日期 |
isClass |
boolean | null |
是否为顶层 class |
classId |
int32 | null |
所属 class ID |
parentCategoryId |
int32 | null |
父分类 ID |
displayIndex |
int32 | null |
显示顺序 |
Game
游戏对象。
| 字段 |
类型 |
说明 |
id |
int32 |
游戏 ID |
name |
string |
游戏名 |
slug |
string |
Slug |
dateModified |
string(date-time) |
最后修改日期 |
assets |
GameAssets |
游戏资源 |
status |
CoreStatus |
游戏状态 |
apiStatus |
CoreApiStatus |
API 访问状态 |
GameAssets
| 字段 |
类型 |
说明 |
iconUrl |
string |
图标 URL |
tileUrl |
string |
卡片背景 URL |
coverUrl |
string |
封面 URL |
CoreStatus
| 值 |
含义 |
| 1 |
Draft |
| 2 |
Test |
| 3 |
PendingReview |
| 4 |
Rejected |
| 5 |
Approved |
| 6 |
Live |
CoreApiStatus
GameVersion
游戏版本（V2 接口使用）。
| 字段 |
类型 |
说明 |
id |
int32 |
版本 ID |
slug |
string |
Slug |
name |
string |
版本名 |
GameVersionType
游戏版本类型。
| 字段 |
类型 |
说明 |
id |
int32 |
类型 ID |
gameId |
int32 |
游戏 ID |
name |
string |
类型名 |
slug |
string |
Slug |
isSyncable |
boolean |
是否可同步 |
status |
GameVersionTypeStatus |
状态 |
GameVersionsByType / GameVersionsByType2
按类型分组的版本（V1/V2）。
| 字段 |
类型 |
说明 |
type |
int32 |
版本类型 |
versions |
string[] / GameVersion[] |
该类型下的版本列表（V1 为字符串，V2 为 GameVersion 对象） |
FingerprintsMatchesResult
指纹匹配结果。
| 字段 |
类型 |
说明 |
isCacheBuilt |
boolean |
缓存是否就绪 |
exactMatches |
FingerprintMatch[] |
精确匹配 |
exactFingerprints |
int[] |
精确匹配的指纹列表 |
partialMatches |
FingerprintMatch[] |
部分匹配 |
partialMatchFingerprints |
object(dict) |
部分匹配指纹（指纹 → 文件 ID 列表） |
installedFingerprints |
int[] |
已安装的指纹 |
unmatchedFingerprints |
int[] |
未匹配的指纹 |
FingerprintMatch
单个指纹匹配结果。
| 字段 |
类型 |
说明 |
id |
int32 |
文件 ID |
file |
File |
匹配到的文件 |
latestFiles |
File[] |
该项目的最新文件列表 |
FingerprintFuzzyMatch
模糊指纹匹配结果。
| 字段 |
类型 |
说明 |
id |
int32 |
文件 ID |
file |
File |
匹配到的文件 |
latestFiles |
File[] |
该项目的最新文件列表 |
fingerprints |
int[] |
匹配到的指纹列表 |
FolderFingerprint
按文件夹分组的指纹（用于模糊匹配请求体）。
| 字段 |
类型 |
说明 |
foldername |
string |
文件夹名 |
fingerprints |
int[] |
该文件夹下的指纹列表 |
MinecraftGameVersion
Minecraft 游戏版本信息。
| 字段 |
类型 |
说明 |
id |
int32 |
ID |
gameVersionId |
int32 |
游戏版本 ID |
versionString |
string |
版本字符串 |
jarDownloadUrl |
string |
JAR 下载地址 |
jsonDownloadUrl |
string |
JSON 下载地址 |
approved |
boolean |
是否已批准 |
dateModified |
string(date-time) |
修改日期 |
gameVersionTypeId |
int32 |
版本类型 ID |
gameVersionStatus |
GameVersionStatus |
版本状态 |
gameVersionTypeStatus |
GameVersionTypeStatus |
版本类型状态 |
MinecraftModLoaderIndex
Minecraft ModLoader 索引项。
| 字段 |
类型 |
说明 |
name |
string |
ModLoader 名称 |
gameVersion |
string |
对应的游戏版本 |
latest |
boolean |
是否最新版 |
recommended |
boolean |
是否推荐版 |
dateModified |
string(date-time) |
修改日期 |
type |
ModLoaderType |
ModLoader 类型 |
MinecraftModLoaderVersion
Minecraft ModLoader 版本详情。
| 字段 |
类型 |
说明 |
id |
int32 |
ID |
gameVersionId |
int32 |
游戏版本 ID |
minecraftGameVersionId |
int32 |
MC 游戏版本 ID |
forgeVersion |
string |
Forge 版本号 |
name |
string |
名称 |
type |
ModLoaderType |
ModLoader 类型 |
downloadUrl |
string |
下载地址 |
filename |
string |
文件名 |
installMethod |
ModLoaderInstallMethod |
安装方式 |
latest |
boolean |
是否最新 |
recommended |
boolean |
是否推荐 |
approved |
boolean |
是否已批准 |
dateModified |
string(date-time) |
修改日期 |
mavenVersionString |
string |
Maven 版本字符串 |
versionJson |
string |
版本 JSON |
librariesInstallLocation |
string |
库安装位置 |
minecraftVersion |
string |
MC 版本 |
additionalFilesJson |
string |
额外文件 JSON |
installProfileJson |
string |
安装 Profile JSON |
枚举值完整列表
FileReleaseType
| 值 |
含义 |
| 1 |
Release |
| 2 |
Beta |
| 3 |
Alpha |
FileStatus（完整）
| 值 |
含义 |
| 1 |
Processing |
| 2 |
ChangesRequired |
| 3 |
UnderReview |
| 4 |
Approved |
| 5 |
Rejected |
| 6 |
MalwareDetected |
| 7 |
Deleted |
| 8 |
Archived |
| 9 |
Testing |
| 10 |
Released |
| 11 |
ReadyForReview |
| 12 |
Deprecated |
| 13 |
Baking |
| 14 |
AwaitingPublishing |
| 15 |
FailedPublishing |
| 16 |
Cooking |
| 17 |
Cooked |
| 18 |
UnderManualReview |
| 19 |
ScanningForMalware |
| 20 |
ProcessingFile |
| 21 |
PendingRelease |
| 22 |
ReadyForCooking |
| 23 |
PostProcessing |
ModStatus
| 值 |
含义 |
| 1 |
New |
| 2 |
ChangesRequired |
| 3 |
UnderSoftReview |
| 4 |
Approved |
| 5 |
Rejected |
| 6 |
ChangesMade |
| 7 |
Inactive |
| 8 |
Abandoned |
| 9 |
Deleted |
| 10 |
UnderReview |
ModLoaderType
| 值 |
含义 |
| 0 |
Any |
| 1 |
Forge |
| 2 |
Cauldron |
| 3 |
LiteLoader |
| 4 |
Fabric |
| 5 |
Quilt |
| 6 |
NeoForge |
ModsSearchSortField（搜索排序字段）
| 值 |
含义 |
| 1 |
Featured |
| 2 |
Popularity |
| 3 |
LastUpdated |
| 4 |
Name |
| 5 |
Author |
| 6 |
TotalDownloads |
| 7 |
Category |
| 8 |
GameVersion |
| 9 |
EarlyAccess |
| 10 |
FeaturedReleased |
| 11 |
ReleasedDate |
| 12 |
Rating |
SortOrder
GameVersionStatus
| 值 |
含义 |
| 1 |
Approved |
| 2 |
Deleted |
| 3 |
New |
GameVersionTypeStatus
ModLoaderInstallMethod
| 值 |
含义 |
| 1 |
ForgeInstaller |
| 2 |
ForgeJarInstall |
| 3 |
ForgeInstaller_v2 |
| 4 |
FabricInstaller |
| 5 |
QuiltInstaller |
| 6 |
NeoForgeInstaller |
