Description
## What it does
Ever wondered who actually plays on your Realm and what they do all day? RealmStats answers it every midnight with a Discord report:
- β±οΈ playtime per player (ranked, with medals)
- βοΈ blocks broken / π§± blocks placed (totals + per-block-type)
- βοΈ mob kills Β· π deaths Β· π sessions Β· π dimension changes
- Daily + lifetime stats, day boundaries in your timezone
**Bonus:** the companion app downloads your world daily, so you also get automatic dated `.mcworld` backups β better retention than the built-in Realm backups.
## How it works
1. Install this behavior pack on your Realm (no experiments needed, stable Script API only)
2. It silently collects stats β read-only, zero lag, never touches blocks/inventories/entities
3. A small companion app (you host it β ~30 min one-time setup) pulls the world nightly, extracts the stats, and posts the report to your Discord
π¦ **Companion app + full setup guide: [https://github.com/syazarilasyraf/realmstats]**
π¬ Example report screenshot below β that's what lands in your Discord every night.
## Safety
- 100% read-only: never modifies terrain, entities, inventories, game rules, or permissions
- Writes only its own `realmstats:*` data β cannot conflict with other addons
- Removing the pack leaves your world completely untouched
- Designed for live, existing Realms with real players and progress
## Requirements / honest notes
- You must be the **Realm owner** (the companion app logs in with the owner's Microsoft account β one time)
- The companion app needs any small always-on Node.js host (a free-tier VPS or app host is fine)
- Uses the community Realms API (prismarine-realms); if Mojang changes endpoints, pulls may need a library update β your stats stay safe in the world either way
- Item pickup/drop/crafting stats are not included because Bedrock's stable API can't measure them reliably β we don't fake numbers
## FAQ
**Lag?** No β counts in memory, writes a few KB per minute. No tick loops, no entity scans.
**Multiplayer-safe with other packs?** Yes β fully namespaced, read-only.
**Cost?** The addon and app are free and open source (MIT). You only need somewhere to run the small app.




