Minecraft
查询指定版本和维度的生物群系列表
GET
/minecraft/seed/biomes公开访问
访问类别：匿名 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
响应
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"
},
"biomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
}
},
"required": [
"id",
"name",
"color"
]
}
}
},
"required": [
"seed",
"accuracy",
"biomes"
]
}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"
]
}响应示例
运行命令前，将环境变量 BASE_URL 设置为站点地址。
成功响应
curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/minecraft/seed/biomes?seed=262&version=1.21.4&dimension=overworld&largeBiomes=false'
HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: public, max-age=3600
{
"seed": "262",
"version": "1.21.4",
"dimension": "overworld",
"largeBiomes": "false",
"accuracy": "原版默认生成规则预测；结构已检查放置规则与生物群系，地形高度、洞穴及方块布局需要游戏验证。模组、数据包和跨版本生成区域可能产生差异。",
"biomes": [
{
"id": 0,
"name": "ocean",
"color": "#000070"
},
{
"id": 1,
"name": "plains",
"color": "#8db360"
},
{
"id": 2,
"name": "desert",
"color": "#fa9418"
},
{
"id": 3,
"name": "windswept_hills",
"color": "#606060"
},
{
"id": 4,
"name": "forest",
"color": "#056621"
},
{
"id": 5,
"name": "taiga",
"color": "#0b6a5f"
},
{
"id": 6,
"name": "swamp",
"color": "#07f9b2"
},
{
"id": 7,
"name": "river",
"color": "#0000ff"
},
{
"id": 10,
"name": "frozen_ocean",
"color": "#7070d6"
},
{
"id": 11,
"name": "frozen_river",
"color": "#a0a0ff"
},
{
"id": 12,
"name": "snowy_plains",
"color": "#ffffff"
},
{
"id": 14,
"name": "mushroom_fields",
"color": "#ff00ff"
},
{
"id": 16,
"name": "beach",
"color": "#fade55"
},
{
"id": 21,
"name": "jungle",
"color": "#507b0a"
},
{
"id": 23,
"name": "sparse_jungle",
"color": "#60930f"
},
{
"id": 24,
"name": "deep_ocean",
"color": "#000030"
},
{
"id": 25,
"name": "stony_shore",
"color": "#a2a284"
},
{
"id": 26,
"name": "snowy_beach",
"color": "#faf0c0"
},
{
"id": 27,
"name": "birch_forest",
"color": "#307444"
},
{
"id": 29,
"name": "dark_forest",
"color": "#40511a"
},
{
"id": 30,
"name": "snowy_taiga",
"color": "#31554a"
},
{
"id": 32,
"name": "old_growth_pine_taiga",
"color": "#596651"
},
{
"id": 34,
"name": "windswept_forest",
"color": "#5b7352"
},
{
"id": 35,
"name": "savanna",
"color": "#bdb25f"
},
{
"id": 36,
"name": "savanna_plateau",
"color": "#a79d64"
},
{
"id": 37,
"name": "badlands",
"color": "#d94515"
},
{
"id": 38,
"name": "wooded_badlands",
"color": "#b09765"
},
{
"id": 44,
"name": "warm_ocean",
"color": "#0000ac"
},
{
"id": 45,
"name": "lukewarm_ocean",
"color": "#000090"
},
{
"id": 46,
"name": "cold_ocean",
"color": "#202070"
},
{
"id": 48,
"name": "deep_lukewarm_ocean",
"color": "#000040"
},
{
"id": 49,
"name": "deep_cold_ocean",
"color": "#202038"
},
{
"id": 50,
"name": "deep_frozen_ocean",
"color": "#404090"
},
{
"id": 129,
"name": "sunflower_plains",
"color": "#b5db88"
},
{
"id": 131,
"name": "windswept_gravelly_hills",
"color": "#888888"
},
{
"id": 132,
"name": "flower_forest",
"color": "#2d8e49"
},
{
"id": 140,
"name": "ice_spikes",
"color": "#b4dcdc"
},
{
"id": 155,
"name": "old_growth_birch_forest",
"color": "#589c6c"
},
{
"id": 160,
"name": "old_growth_spruce_taiga",
"color": "#818e79"
},
{
"id": 163,
"
… 已截断，完整响应 4743 字符错误示例
curl --silent --show-error -H 'User-Agent: simpleWebUtils-example/1.1.0' -H 'Accept: application/json' "$BASE_URL"'/minecraft/seed/biomes?seed=invalid+value&version=1.21.4&dimension=overworld&largeBiomes=false'
HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store
{
"error": {
"code": "INVALID_INPUT",
"message": "参数无效",
"issues": [
{
"location": "query",
"field": "seed",
"code": "custom",
"message": "种子必须为有符号 64 位十进制整数"
}
]
}
}在线调试
调用示例
curl -X GET 'https://oit.sh/minecraft/seed/biomes?seed=262'
响应
等待发送请求
配置上方请求参数后点击「发送请求」查看实时响应
快捷键：Ctrl / ⌘ + Enter