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 Fabric client-side mod for Minecraft 1.21.11. Zero server changes, zero account, zero network calls. Your data never leaves your machine.
12+ animated cards that reveal in sequence, each with its own visual signature:
- Intro — the month name fades in with a green accent sweep and dropping letters.
- Time Spent — a clock dial spins toward your total play time.
- Longest Session — your single longest play streak, broken down across sessions in the month.
- When You Play — a 24-bar histogram of your peak hours (night owl? lunch raider?).
- Top World — your most-played world or server, with a traced gold frame and share bar.
- Dimensions Explored — Overworld vs Nether vs End, ranked by ticks.
- Social — players met, messages sent, solo-vs-server split bar.
- Distance Covered — total kilometres + breakdown by walking, elytra, boat, horse, swim, fly.
- Top Blocks Mined — top 3 with real block textures.
- Top Mob Killed — spawn-egg of your most-killed enemy, rotating.
- Top Crafted — top 3 items you crafted.
- Death Recap — your deaths and the most embarrassing cause (or Perfect Streak if zero).
- Archetype — drumroll then card flip reveals your personality among 15 archetypes.
- Final — recap tiles + Save Image / Copy / Close buttons.
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.
Hit Save Image 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.
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.
- 100% client-side. No telemetry, no analytics, no remote calls.
- Your data lives in
<game>/wrapped/. Delete it any time.
- Install Fabric Loader for your target Minecraft version (1.21.1 – 1.21.11).
- Drop Fabric API into your
mods/folder. - Grab the matching
minecraft-wrapped-*.jarfrom the latest release (see the version table below) and drop it in the samemods/folder. - Launch the game.
All versions are tested and published — grab the jar matching your Minecraft version from the releases page.
| MC version | Branch | Jar |
|---|---|---|
| 1.21.11 | main |
minecraft-wrapped-1.0.0.jar |
| 1.21.10 | 1.21.10 |
minecraft-wrapped-1.0.0+1.21.10.jar |
| 1.21.8 | 1.21.8 |
minecraft-wrapped-1.0.0+1.21.8.jar |
| 1.21.6 | 1.21.6 |
minecraft-wrapped-1.0.0+1.21.6.jar |
| 1.21.4 | 1.21.4 |
minecraft-wrapped-1.0.0+1.21.4.jar |
| 1.21.1 | 1.21.1 |
minecraft-wrapped-1.0.0+1.21.1.jar |
| Loader | Status | How |
|---|---|---|
| Fabric | ✅ Native | install as above |
| Quilt | ✅ Native | drop the same jar in Quilt's mods/ folder. Quilt loads Fabric mods directly — install QSL (Quilted Fabric API) instead of Fabric API |
| NeoForge | ✅ Via Sinytra Connector | install Sinytra Connector + Forgified Fabric API on NeoForge, then drop the Wrapped jar in mods/. All features work. |
| Forge | ❌ Not supported | NeoForge + Sinytra is the modern path |
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.
| Command | What it does |
|---|---|
/wrapped |
Replay the latest finalized Wrapped |
/wrapped history |
Browse all your past Wrappeds |
- At every game launch, the mod scans
saves/*/stats/<uuid>.json(your singleplayer worlds), pulls server-side vanilla stats via theREQUEST_STATSpacket, and aggregates them into a cumulative monthly snapshot atwrapped/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 toserver-stats.json— full vanilla stats from servers that respond to REQUEST_STATSmultiplayer-data.json— UUIDs of players seen, chat counter, commands countersessions.json— start/end timestamps of every sessionplay-by-hour.json— ticks per hour of day, per monthplay-by-dimension.json— ticks per dimension, per month
./gradlew buildThe jar lands in build/libs/.
./gradlew runClientMIT — see LICENSE.
Made by Zeffut.