Minecraft
按种子查询附近自然结构的预测位置
GET
公开访问/minecraft/seed/structures查询中心周围半径 radius 的圆形区域；结构通过放置及生物群系检查，地形条件需要游戏确认。 访问类别：匿名 API，可携带 Token 使用独立额度
请求参数
seedquery必填- 完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807
- string · 完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807
versionquery- string · 默认值："1.21.4" · 可选：1.16.5、1.17.1、1.18.2、1.19.2、1.19.4、1.20.6、1.21.1、1.21.3、1.21.4
dimensionquery- string · 默认值："overworld" · 可选：overworld、nether、end
largeBiomesquery- string · 默认值："false" · 可选：true、false
xquery- integer / null · 默认值：0 · 最小值：-30000000 · 最大值：29999999
zquery- integer / null · 默认值：0 · 最小值：-30000000 · 最大值：29999999
radiusquery- integer · 默认值：1024 · 最小值：16 · 最大值：4096
typequery- string · 默认值："village" · 可选：village、desert_pyramid、jungle_temple、swamp_hut、igloo、ocean_ruin、shipwreck、monument、mansion、outpost、ruined_portal、ancient_city、trail_ruins、trial_chambers、stronghold、fortress、bastion、ruined_portal_nether、end_city
响应
200 Cubiomes 原版 Java 规则预测，缓存 3600 秒
application/json
{
"type": "object",
"properties": {
"seed": {
"type": "string",
"example": "262",
"description": "完整十进制字符串，范围 -9223372036854775808 至 9223372036854775807"
},
"version": {
"type": "string",
"enum": [
"1.16.5",
"1.17.1",
"1.18.2",
"1.19.2",
"1.19.4",
"1.20.6",
"1.21.1",
"1.21.3",
"1.21.4"
],
"default": "1.21.4"
},
"dimension": {
"type": "string",
"enum": [
"overworld",
"nether",
"end"
],
"default": "overworld"
},
"largeBiomes": {
"type": "string",
"enum": [
"true",
"false"
],
"default": "false"
},
"accuracy": {
"type": "string"
},
"type": {
"type": "string"
},
"radius": {
"type": "number"
},
"center": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"z": {
"type": "number"
}
},
"required": [
"x",
"z"
]
},
"positions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "integer"
},
"z": {
"type": "integer"
},
"chunkX": {
"type": "integer"
},
"chunkZ": {
"type": "integer"
},
"distance": {
"type": "number"
}
},
"required": [
"x",
"z",
"chunkX",
"chunkZ",
"distance"
]
}
}
},
"required": [
"seed",
"accuracy",
"type",
"radius",
"center",
"positions"
]
}400 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}401 凭据无效、停用、过期或缺少所需 Token
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}403 需要管理员 Token
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}413 请求体过大
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}415 请求内容类型无效
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}422 请求校验或执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}429 请求过于频繁，Retry-After 为建议等待秒数；匿名额度及认证保护在各 Cloudflare 地点近似计数，Token 业务额度使用 D1 原子计数
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}500 内部执行失败
application/json
{
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"location": {
"type": "string",
"enum": [
"body",
"query",
"path",
"header"
]
},
"field": {
"type": "string"
},
"code": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"location",
"field",
"code",
"message"
]
}
}
},
"required": [
"code",
"message"
]
}
},
"required": [
"error"
]
}在线调试
调用示例
curl -X GET 'https://evax.top/minecraft/seed/structures?seed=262'