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.
- Your Wrapped data lives in
<game>/wrapped/. Delete it any time. - Anonymous usage telemetry helps improve the mod. It's opt-out — see below.
- 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 |
/wrapped telemetry on|off|status |
Turn anonymous telemetry on/off, or check its state |
Minecraft Wrapped sends anonymous usage telemetry to help improve the mod (which cards people watch, which features get used, errors). It is enabled by default and you can turn it off at any time:
- In-game:
/wrapped telemetry off - Config screen (ModMenu → Minecraft Wrapped → Privacy): the Telemetry toggle
What is sent: mod / Minecraft / Fabric versions, OS, language, which cards you view and for
how long, feature usage (export / save / copy / commands / config changes), coarse gameplay
buckets (e.g. playtime 10-50h, not exact numbers), your archetype, and mod errors.
What is never sent: your username, world names, server addresses, file paths, chat, or exact stat values. IP addresses are anonymized. Telemetry is processed via PostHog.
- 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.