ServerWrapped

# ✨ ServerWrapped — Spotify Wrapped for your Minecraft server

Your players already make memories. ServerWrapped turns them into shareable season recaps.

One command. A beautiful, hoverable stat card. An archetype like Cave Goblin or Frequent Flyer, a generated title like Minister of Questionable Mining Decisions, unlockable achievements, and a "top 5% of miners on this server" flex — ready to screenshot, copy into Discord, or post automatically as a rendered PNG image card via webhook.

``` ──────────────────────────────────────────── ✦ Justin'S SERVER WRAPPED ✦ Season: June 2026 ──────────────────────────────────────────── ▸ You played for 42. 3 hours. ▸ You mined 12,442 blocks, mostly Stone. ▸ You died 37 times. The respawn screen knows you personally. ▸ You're in the top 5% of miners on this server. ▸ You unlocked 6 achievements. (hover) ▸ Your personality type: Cave Goblin. ▸ Your server title: Minister of Questionable Mining Decisions. ──────────────────────────────────────────── [ ✦ Share in Chat ] [ Open as Book ] [ Copy for Discord ] ```

## 🎉 Features

• Personal recap cards — framed chat cards with hover details, plus a flip-through book version (`/wrapped book`)
• PNG image cards for Discord — `/wrapped share` posts a real rendered image (player head, big numbers, "TOP 5%" badge, archetype-colored design), not just a text embed. No bot, no image service — paste a webhook URL and done
• The reveal show (`/wrapped reveal`) — your recap as a dramatic slideshow with sounds, a cliffhanger, and a full-screen archetype reveal. Perfect for experiencing Wrapped Day live in a voice call
• Head-to-head compare (`/wrapped compare `) — nine categories, winners marked, verdict line included
• Server milestones — "This server just mined its 1,000,000th block!" broadcast in-game and to Discord as your community crosses big round totals
• 31 unlockable achievements — from Diamond Hands to Ace Pilot to Creeper Magnet
• 17 player archetypes with rotating funny titles, picked from your actual playstyle
• Spotify-style server ranks — "You're in the top 5% of miners"
• "Copy for Discord" button — a ready-to-paste emoji card straight to the clipboard
• Wrapped Day — ending a season freezes everyone's final stats, announces the drop, and gives every player a personal `/wrapped recap` (with join reminder); the server-wide recap is posted to Discord
• Seasons — monthly or SMP-season recaps via baseline snapshots, no stat resets needed
• 14 leaderboards — deaths, playtime, mined, placed, kills, distance, elytra, fish, trades, totems, and more
• Server-wide recap (`/wrapped server`) and roast mode with 6 intensity levels
• Built for production — write-behind data cache, async saves and rendering, offline stat caching; no database, no NMS, no dependencies

## 🚀 Quick start

1. Drop the jar into `plugins/`, restart — done. `/wrapped` works immediately with lifetime stats. 2. Optional: `/wrapped season start june-2026 June 2026` for a season recap. 3. Optional: paste a Discord webhook URL into `config.yml` for automatic Discord posts.

📖 *(https://nicompter.github.io/ServerWrapped/)** — every command, config key, achievement, and archetype explained, for owners and* players.

Requires: Paper 26. 2+ · Java 26 · nothing else.