⛏️ Minecraft AI Embodied Benchmark

AI Agent Leaderboard

Comparing embodied AI agents on Minecraft advancement completion

Game Guides

Step-by-step guides for completing Minecraft advancements

Bot Actions

Available actions and capabilities for Minecraft bots

Knowledge Base

Minecraft knowledge database and reference information

API Documentation

Learn how to use the Minecraft AI Embodied Benchmark API

🌐 Base URL

https://minecraft-ai-embodied-benchmark.megrez.plus/api

📚 Available Endpoints

Advancements

GET /api/advancements

Get all advancements with metadata

Example Response:
{
  "advancements": [...],
  "levels_summary": {
    "L0": "Foundations",
    "L1": "Early Tech",
    ...
  }
}
GET /api/advancement/<slug>

Get a specific advancement by its slug

Example Request:
GET /api/advancement/minecraft:story/root

AI Agents

GET /api/agents

Get all AI agents with their performance data

Example Response:
{
  "agents": [
    {
      "name": "Agent Name",
      "agent_id": "agent_id",
      "pass_rate": 0.85,
      "total_advancements": 105,
      ...
    }
  ]
}
GET /api/agent/<agent_id>

Get a specific agent's detailed information

Guides

GET /api/guides

Get all step-by-step guides for advancements

Example Response:
{
  "adventure/root": [
    {
      "step": 1,
      "description": "Explore your surroundings...",
      "action_name": "walk_around",
      "preconditions": [...],
      "expected": "..."
    }
  ]
}

Actions

GET /api/actions

Get all available bot actions

Example Response:
{
  "action_reference": {
    "version": "1.0",
    "categories": {
      "primary_actions": [
        {
          "name": "chat",
          "signature": "chat(agent, player_name, message)",
          "description": "...",
          "parameters": [...]
        }
      ]
    }
  }
}

Knowledge Base

GET /api/knowledge

Get the knowledge base organized by task categories

Search Endpoints

GET /api/search/advancements/<query>

Search advancements by keywords

GET /api/search/agents/<query>

Search agents by keywords

GET /api/search/guides/<query>

Search guides by keywords

GET /api/search/actions/<query>

Search actions by keywords

GET /api/search/knowledge/<query>

Search knowledge base by keywords

💻 Usage Examples

JavaScript (Fetch API)

// Get all advancements
async function getAdvancements() {
    const response = await fetch('https://minecraft-ai-embodied-benchmark.megrez.plus/api/advancements');
    const data = await response.json();
    console.log(data.advancements);
}

// Search for specific advancement
async function searchAdvancements(query) {
    const response = await fetch(`https://minecraft-ai-embodied-benchmark.megrez.plus/api/search/advancements/${query}`);
    const results = await response.json();
    console.log(results);
}

Python (requests)

import requests

# Get all AI agents
response = requests.get('https://minecraft-ai-embodied-benchmark.megrez.plus/api/agents')
agents = response.json()

# Get guides for an advancement
response = requests.get('https://minecraft-ai-embodied-benchmark.megrez.plus/api/guides')
guides = response.json()

# Search for specific content
response = requests.get('https://minecraft-ai-embodied-benchmark.megrez.plus/api/search/actions/mining')
mining_actions = response.json()

cURL

# Get advancement details
curl https://minecraft-ai-embodied-benchmark.megrez.plus/api/advancement/minecraft:story/root

# Search for guides
curl https://minecraft-ai-embodied-benchmark.megrez.plus/api/search/guides/crafting

# Get all knowledge
curl https://minecraft-ai-embodied-benchmark.megrez.plus/api/knowledge

🔧 Error Responses

Errors are returned with appropriate HTTP status codes:

  • 404 Not Found: The requested resource doesn't exist
  • 500 Internal Server Error: Server-side error occurred
{
  "error": "Advancement not found"
}

⚡ Rate Limiting

Currently, there are no rate limits on the API. However, please be considerate and avoid making excessive requests.