Why
- It looks like the game. Hearts, hunger, XP, the inventory screen, advancement frames and toasts are drawn with Minecraft's own sprites, pixel-exact at any display scaling.
- It's live without polling. Viewers keep one WebSocket open and every update is pushed to them, so a tab left open all day costs about as much as one page load.
- It costs nothing. GitHub Pages and Cloudflare's free plan. Past a limit, requests just fail until midnight UTC; nothing is ever billed.
- Nothing reaches into your PC. The agent only pushes out, so it works behind any router or captive portal.
- It's private by default. Invite key only, at most 10 viewers at once, and every published field is on an explicit allowlist.
What it shows
While you play
The newest HUD-free frame of your world, with your vitals where the game draws them and the toast for an advancement you just earned. Chat never appears in it, because the frame is taken before the HUD is drawn.
Your progress
Also: advancement progress per tab, recently earned and almost done; statistics and favourites (most mined, most crafted, most hunted, and what killed you most).
After you log out
- A 360° view of where you left, which visitors can drag around. The mod renders it while the pause menu is open, so you never see it happen.
- A 3D map of the area around your logout (BlueMap), marked with where you were last seen and where you last died.
- What you logged out with, and your stats as of that session.
On someone else's server
Only that you're playing, your vitals and your inventory. No coordinates, frames, map markers or curses, and the server's address is never written anywhere.
Cursed mode (optional)
The machine reaches into your world: a hot GPU sets the ground on fire, low RAM makes you slow, 12 hours of uptime tells you to go to bed. Plain commands with conditions and cooldowns, off by default. How it works →
Every card also works on a phone. Full tour of the page →
Get your own
About 15 minutes, all on free plans. You need a GitHub account, a Cloudflare account, Python 3.11+, Node.js 20+, and Minecraft Java with Fabric.
# 1. press "Use this template" on GitHub, then clone what it made:
git clone https://github.com/<you>/<your-repo>.git
cd <your-repo>
# 2. in your repository: Actions -> Release mod -> Run workflow.
# It builds the jar and attaches it to a release, which the wizard downloads from.
# 3. the wizard deploys the Worker, creates the keys, installs the agent and prints your invite link
python setup.py
Then set two repository variables, turn on GitHub Pages and push. Full setup guide →
Server tool
The same mod jar, dropped into a Fabric server, publishes every player on it: a moderation view for you, and a page of their own for each player.
- Admin page: the server's TPS and tick time, and every player online or offline, with health, position, ping and advancement progress. Open anyone for their inventory, statistics and checklists.
- Actions and console: with a separate control key, heal, feed, change game mode, message, kick, ban and whitelist players, or run any command and see the output. Every action is logged.
- Player links: a link that shows one player only their own page.
- Their view (off by default): what a player is looking at, for players who have the mod and turned sharing on themselves. Vanilla clients can't be shown, and nothing is captured unless someone has that player's page open.
- In game:
/mcstatus admin sends an op a clickable admin link, /mcstatus control the one that can act; /mcstatus link sends a player theirs.
Optional, and inactive until you run python setup.py server. Server tool guide →
How it works
flowchart LR
subgraph PC["Your PC"]
MOD["Fabric mod<br/>state, frame, panorama"]
AGENT["Python agent<br/>machine load, curses"]
MOD -- files --> AGENT
AGENT -- commands --> MOD
end
SRV["Fabric server<br/>(optional server tool)"]
subgraph CF["Cloudflare (free)"]
W["Worker +<br/>Durable Object"]
end
subgraph GH["GitHub Pages"]
PAGE["status page"]
MAP["3D map"]
end
AGENT -- "HTTPS push" --> W
SRV -- "HTTPS push" --> W
W -- "WebSocket" --> PAGE
W -- "WebSocket" --> MAP
AGENT -- "on logout: render,<br/>push map branch" --> MAP
Architecture →
Documentation
| Guide | What's in it |
|---|
| Setup | Start your own and deploy, your own domain, installing by hand, updating, troubleshooting |
| Features | Every card on the page, the logout panorama and map, multiplayer, cursed mode |
| Server tool | Admin page, player links, /mcstatus commands, setup on a server |
| Configuration | agent/config.toml, the mod's settings, secrets and repository variables |
| Privacy and security | What's published and what never is, who can watch, staying on free tiers |
| Architecture | How the mod, agent, Worker, page and map fit together |
| Development | Tests, running locally, releasing, updating to a new Minecraft version |
License
MIT, see LICENSE. Trademark and asset notes are in NOTICE.
NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT. Minecraft is a trademark of Mojang. The screenshots in this README show made-up demo data.
