🎮 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 中说明。