开源的 Minecraft 服务器数据 API
MCJPG 是一个致力于促进 Minecraft 服务器交流的组织。本仓库提供标准化的 JSON API,让服务器展示更加便捷和统一。
https://serverlist.mcjpg.org/servers.json
https://raw.githubusercontent.com/MineJPGcraft/Serverlist/main/servers.json
{
"types": ["生存", "创造", "小游戏", "RPG", "空岛", "起床战争"],
"versions": ["1.21.4", "1.20.1", "1.19.4", "1.18.2", "1.16.5"],
"servers": [
{
"id": 1,
"name": "示例服务器",
"description": "一个优质的 Minecraft 服务器\\n支持多行描述",
"type": "生存",
"version": "1.20.1",
"ip": "play.example.com",
"link": "https://example.com",
"icon": "https://serverlist.mcjpg.org/icons/icon.png"
}
]
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
id |
number | ✅ | 服务器唯一标识符,自增整数 |
name |
string | ✅ | 服务器名称,建议不超过 20 字符 |
description |
string | ✅ | 服务器描述,使用 \n 换行 |
type |
string | ✅ | 服务器类型,必须在 types 列表中 |
version |
string | ✅ | Minecraft 版本,格式如 1.20.1 |
ip |
string | ⚪ | 服务器地址,填写后将显示在线状态 |
link |
string | ✅ | 服务器官网或详情页 URL |
icon |
string|object | ✅ | 服务器图标,支持字符串或对象格式 |
fetch('https://serverlist.mcjpg.org/servers.json')
.then(response => response.json())
.then(data => {
console.log(`共有 ${data.servers.length} 个服务器`)
console.log('服务器类型:', data.types)
console.log('支持版本:', data.versions)
// 遍历服务器列表
data.servers.forEach(server => {
console.log(`${server.name} - ${server.type} - ${server.version}`)
})
})
.catch(error => console.error('获取失败:', error))
<script setup>
import { ref, onMounted } from 'vue'
const servers = ref([])
const types = ref([])
const versions = ref([])
const loading = ref(true)
onMounted(async () => {
try {
const response = await fetch('https://serverlist.mcjpg.org/servers.json')
const data = await response.json()
servers.value = data.servers
types.value = data.types
versions.value = data.versions
} catch (error) {
console.error('获取失败:', error)
} finally {
loading.value = false
}
})
</script>
<template>
<div v-if="loading">加载中...</div>
<div v-else>
<h2>共有 {{ servers.length }} 个服务器</h2>
<div v-for="server in servers" :key="server.id">
{{ server.name }}
</div>
</div>
</template>
import { useState, useEffect } from 'react'
function ServerList() {
const [data, setData] = useState({
servers: [],
types: [],
versions: []
})
const [loading, setLoading] = useState(true)
useEffect(() => {
fetch('https://serverlist.mcjpg.org/servers.json')
.then(res => res.json())
.then(data => {
setData(data)
setLoading(false)
})
.catch(err => console.error(err))
}, [])
if (loading) return <div>加载中...</div>
return (
<div>
<h1>服务器列表</h1>
<p>共有 {data.servers.length} 个服务器</p>
{data.servers.map(server => (
<div key={server.id}>{server.name}</div>
))}
</div>
)
}
{
"id": 999,
"name": "我的服务器",
"description": "一个充满创意的生存服务器\\n拥有独特的游戏玩法和友好的社区",
"type": "生存",
"version": "1.20.1",
"ip": "play.myserver.com",
"link": "https://myserver.com",
"icon": "https://myserver.com/icon.png"
}
为保证列表质量,我们会审核所有提交。以下内容将被拒绝:
| 拒绝类型 | 说明 |
|---|---|
| ❌ 虚假信息 | 服务器信息不真实或夸大宣传 |
| ❌ 恶意服务器 | 包含病毒、钓鱼、盗号等恶意内容 |
| ❌ 违规内容 | 违反 Minecraft EULA 或含不当内容 |
| ❌ 重复提交 | 同一服务器多次提交 |
| ❌ 低质量服务器 | 长期离线、无人管理或体验极差 |
| ❌ 格式错误 | JSON 格式错误或字段缺失 |
| 类型 | 说明 | 示例 |
|---|---|---|
| 🌱 生存 | 原版或模组生存玩法 | 纯净生存、工业生存 |
| 🏗️ 创造 | 创造模式建筑服务器 | 建筑展示、创造世界 |
| 🎮 小游戏 | 各类小游戏服务器 | 跑酷、PVP 竞技 |
| ⚔️ RPG | 角色扮演服务器 | 魔法世界、任务冒险 |
| 🏝️ 空岛 | 空岛生存类型 | 传统空岛、科技空岛 |
| 🛏️ 起床战争 | 起床战争玩法 | 标准起床、变种起床 |