🎮 MCJPG 服务器列表

开源的 Minecraft 服务器数据 API

MIT License GitHub stars PRs Welcome

⚡ 快速开始

MCJPG 是一个致力于促进 Minecraft 服务器交流的组织。本仓库提供标准化的 JSON API,让服务器展示更加便捷和统一。

🌐 MCJPG CDN(推荐)

https://serverlist.mcjpg.org/servers.json

📦 GitHub Raw

https://raw.githubusercontent.com/MineJPGcraft/Serverlist/main/servers.json

📊 数据格式说明

完整 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 服务器图标,支持字符串或对象格式

💻 代码示例

JavaScript
Vue 3
React
JavaScript
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))
Vue 3
<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>
React
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>
  )
}

📝 提交服务器指南

欢迎提交优质的 Minecraft 服务器! 在提交前,请确保你的服务器已通过 MCJPG 组织的审核。

✅ 提交要求

通过组织的服务器审核
服务器稳定运行
遵守 Minecraft EULA
无恶意内容
信息真实准确
图标清晰(64x64+)

🚀 提交步骤

  1. Fork 本仓库 点击 GitHub 页面右上角的 "Fork" 按钮,将仓库复制到你的账号下
  2. 编辑 servers.json 在你的 Fork 中找到 servers.json 文件,点击编辑按钮(铅笔图标)
  3. 添加服务器信息 在 servers 数组末尾添加你的服务器数据,确保 ID 唯一(使用最大 ID + 1)
  4. 验证 JSON 格式 使用 JSONLint 验证格式是否正确
  5. 提交 Pull Request 回到原仓库,点击 "New Pull Request",填写标题和说明
  6. 等待审核 维护团队会在 24-48 小时内审核你的提交
⚠️ 注意事项:
  • 请将新服务器添加到 servers 数组的末尾
  • 如果类型不在 types 列表中,请同时添加到列表
  • 描述建议 2-3 行,不要过长
  • 确保所有链接可以正常访问

📋 添加示例

{
  "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 角色扮演服务器 魔法世界、任务冒险
🏝️ 空岛 空岛生存类型 传统空岛、科技空岛
🛏️ 起床战争 起床战争玩法 标准起床、变种起床
💡 提示:如需添加新类型,请在 PR 或 Issue 中说明。