535 lines
13 KiB
Markdown
535 lines
13 KiB
Markdown
## Schema 定义
|
||
|
||
### Pagination
|
||
|
||
分页信息。
|
||
|
||
| 字段 | 类型 | 说明 |
|
||
|------|------|------|
|
||
| `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
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| 1 | Sha1 |
|
||
| 2 | Md5 |
|
||
|
||
---
|
||
|
||
### 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
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| 1 | Private |
|
||
| 2 | Public |
|
||
|
||
---
|
||
|
||
### 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
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| asc | 升序 |
|
||
| desc | 降序 |
|
||
|
||
### GameVersionStatus
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| 1 | Approved |
|
||
| 2 | Deleted |
|
||
| 3 | New |
|
||
|
||
### GameVersionTypeStatus
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| 1 | Normal |
|
||
| 2 | Deleted |
|
||
|
||
### ModLoaderInstallMethod
|
||
|
||
| 值 | 含义 |
|
||
|----|------|
|
||
| 1 | ForgeInstaller |
|
||
| 2 | ForgeJarInstall |
|
||
| 3 | ForgeInstaller_v2 |
|
||
| 4 | FabricInstaller |
|
||
| 5 | QuiltInstaller |
|
||
| 6 | NeoForgeInstaller |
|