Minecraft Wrapped

Minecraft Wrapped

> Spotify Wrapped, but for Minecraft. Every 1st of the month, a button appears on your title screen — click it to relive your month with a cinematic animated recap.

A Minecraft 1.21.11 for Minecraft 1.21.11. Zero server changes, zero account, zero network calls. Your data never leaves your machine.

Features

A cinematic monthly recap

12+ animated cards that reveal in sequence, each with its own visual signature:

- Final — the month name fades in with a green accent sweep and dropping letters. - Final — a clock dial spins toward your total play time. - Final — your single longest play streak, broken down across sessions in the month. - Final — a 24-bar histogram of your peak hours (night owl? lunch raider?). - Final — your most-played world or server, with a traced gold frame and share bar. - Final — Overworld vs Nether vs End, ranked by ticks. - Final — players met, messages sent, solo-vs-server split bar. - Final — total kilometres + breakdown by walking, elytra, boat, horse, swim, fly. - Final — top 3 with real block textures. - Final — spawn-egg of your most-killed enemy, rotating. - Final — top 3 items you crafted. - Final — your deaths and the most embarrassing cause (or *Perfect Streak* if zero). - Final — drumroll then card flip reveals your personality among 15 archetypes. - Final — recap tiles + Save Image / Copy / Close buttons.

Multiplayer-aware

The mod tracks your time on each server (client-side tick counter + vanilla server stats via REQUEST_STATS), counts unique players you cross paths with, chat messages sent, and servers visited. The recap mixes solo worlds and servers in one timeline — because that's what playing Minecraft actually looks like.

Image export

Hit Copy in the final card and the mod renders a 1080×1920 PNG (story format) into `screenshots/wrapped/`. Or Copy to put it directly on your clipboard.

Smart filtering

The recap only includes cards that are relevant to your data. Played 5 minutes? Just the basics. Spent 100 hours on three servers and crafted 600 items? You get the full ride.

Privacy first

- 100% client-side. No telemetry, no analytics, no remote calls. - Your data lives in `<game>/wrapped/`. Delete it any time.

Install

1. Install %%MD1%% for Minecraft 1.21.11. 2. Drop Minecraft 1.21.11 into your `mods/` folder. 3. Drop the `minecraft-wrapped-*.jar` from the %%MD2%% into the same `mods/` folder. 4. Launch the game.

The mod runs silently in the background. On the first day of every month, when you launch the game, a *Your X Wrapped is ready* button appears on the title screen.

Commands

| Command | What it does | |---|---| | `/wrapped` | Replay the latest finalized Wrapped | | `/wrapped history` | Browse all your past Wrappeds |

How it works

- At every game launch, the mod scans `saves/*/stats/<uuid>.json` (your singleplayer worlds), pulls server-side vanilla stats via the `REQUEST_STATS` packet, and aggregates them into a cumulative monthly snapshot at `wrapped/snapshot-YYYY-MM.json`. - When the calendar rolls over, the mod computes the delta against last month's snapshot and writes a finalized `wrapped-YYYY-MM.json`. - That finalized file drives every card in the sequence.

Side trackers persist in `wrapped/`: - `server-play-time.json` — ticks per server you connect to - `server-stats.json` — full vanilla stats from servers that respond to REQUEST_STATS - `multiplayer-data.json` — UUIDs of players seen, chat counter, commands counter - `sessions.json` — start/end timestamps of every session - `play-by-hour.json` — ticks per hour of day, per month - `play-by-dimension.json` — ticks per dimension, per month

Build from source

```bash ./gradlew build ```

The jar lands in `build/libs/`.

Run in dev

```bash ./gradlew runClient ```

License

MIT — see LICENSE.

---

Made by Zeffut.