metadata
title: Alpha MC
emoji: ⛏️
colorFrom: green
colorTo: gray
sdk: docker
pinned: false
app_port: 7860
datasets: []
⛏️ Alpha MC — Minecraft Bedrock Server on HuggingFace
A fully automated Minecraft Bedrock Dedicated Server running on HuggingFace Spaces, tunneled via playit.gg so anyone can join from anywhere.
🚀 How to Connect
- Open the Space — wait for the TUNNEL IS LIVE message in the logs
- Copy the
*.playit.ggaddress shown - In Minecraft Bedrock → Add Server → paste the address → Join!
⚙️ Setup (First Time)
1. Add your playit Secret Key
- Go to Space Settings → Repository Secrets
- Add a secret named
SECRET_KEY - Get your key from playit.gg/account/agents
2. Restart the Space
- The server will build, download Minecraft, and start automatically.
📁 Persistent Storage
World data is saved under /data/bedrock-server/worlds and persists across restarts as long as the Space is not deleted.
Automatic backups run every 6 hours to /data/bedrock-server/backups (last 10 kept).
🖥️ Status Page
Visit the Space URL in your browser to see a live status dashboard showing:
- Server online / offline
- Tunnel address
- Player count (from logs)
- System resource usage
- Recent server logs
📝 Server Info
| Setting | Value |
|---|---|
| Mode | Survival |
| Difficulty | Hard |
| Max Players | 20 |
| View Distance | 10 |
| Online Mode | true |
⚠️ Notes
- This uses HuggingFace free tier — uptime is best-effort
- Minecraft Bedrock uses UDP which HF doesn't expose directly — that's why playit.gg is used as the tunnel
- Never share your
SECRET_KEYpublicly