File size: 1,774 Bytes
36c2499 722781c 36c2499 722781c 36c2499 722781c | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 | ---
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](https://playit.gg) so anyone can join from anywhere.
---
## 🚀 How to Connect
1. Open the Space — wait for the **TUNNEL IS LIVE** message in the logs
2. Copy the `*.playit.gg` address shown
3. 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](https://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_KEY` publicly
|