🗺️ MipMap

Interactive online map for Minecraft Bedrock servers

🎬 See It In Action

_{🗺️ Real-time rendering • 🎨 Depth shading • 👥 Player tracking}

✨ What is MipMap?

MipMap transforms your Minecraft Bedrock server into a living, breathing web map. As players explore, the world renders itself automatically — no commands, no waiting, just pure real-time magic.

Two parts. One vision:

🎮 Plugin — Captures chunk data as your world loads and streams it to the web
🌐 Web Server — Generates beautiful map tiles and serves an interactive interface

💜 The map that grows with your world.
No manual rendering. No restarts. Just exploration.

🚀 Features

📦 Installation

Step 1️⃣: Install the Plugin

Download the latest plugin file from Releases and place it in your server's plugins folder. Restart the server.

For LeviLamina: You need to have LeviStone installed.

Step 2️⃣: Launch the Web Server

🐳 Option A: Docker (Recommended)

cd webmap
docker build -t mipmap-webmap .
docker run -d --name mipmap-webmap -p 8000:8000 mipmap-webmap

✅ Done! Visit http://localhost:8000

🐍 Option B: Local with Uvicorn

cd webmap
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000

✅ Done! Visit http://localhost:8000

🎮 Usage

Commands

⚙️ Configuration

Plugin Settings

Edit plugins/mipmap/config.toml:

Web Server Settings

Edit webmap/core/config.py:

Example:

MAP_SIZE = 3000  # Larger viewport for bigger screens
MAP_UPDATE_INTERVAL = 3000  # Update players every 3 seconds
MAP_DEFAULT_WORLD = "Nether"  # Start in the Nether

Web Server Data Structure

webmap/data/
├── worlds/              # 🌍 World data organized by dimension
│   ├── Overworld/
│   │   └── tiles/       # 🖼️ Generated PNG tiles
│   │       ├── zoom-0/
│   │       ├── zoom-1/
│   │       └── zoom-2/
│   ├── Nether/
│   │   └── tiles/
│   └── TheEnd/
│       └── tiles/
├── skins/               # 👤 Player skin cache
│   └── default.png
└── failedTextures.json  # 🚫 Failed texture loading log

📡 API Reference

POST /api/chunks

Receives chunk data from the plugin.

Request Body:

{
  "chunk": {
    "dimension": "Overworld",
    "blocks": [
      {
        "name": "minecraft:grass_block",
        "coordinates": [64, 72, -32]
      },
      {
        "name": "minecraft:stone",
        "coordinates": [64, 71, -32]
      }
    ]
  }
}

POST /api/players

Receives player position data.

Request Body:

{
  "players": [
    {
      "name": "Steve",
      "skin": "89504e47...",  // Hex-encoded PNG
      "skinShape": [64, 64, 4],
      "dimension": "Overworld",
      "x": 123.45,
      "y": 64.0,
      "z": -67.89
    }
  ]
}

🛠️ Tech Stack

🗓️ Roadmap

• [x] 🌍 Overworld rendering
• [x] ⚡ Real-time chunk updates
• [x] 👥 Player tracking with skins
• [x] 📦 Batch loading command
• [x] 🐳 Docker deployment
• [x] 🌌 The End dimension support
• [ ] 🔥 Nether dimension support
• [ ] 🎨 Custom dimension API

🤝 Contributing

Contributions are welcome! Fork the repo, make your changes, and open a Pull Request.

📜 License

This project is licensed under the MIT License. See LICENSE for details.

_{✨ MipMap - where each block finds its place. ✨}