Player memory ledger

# Player Memory Ledger ### Turn Cold Statistics into Living Server History & Lore A high-performance, asynchronous narrative logging engine for Paper/Spigot 1.21+ | Free & Open. ⭐ **Completely Free.** ⭐ --- ## ■ STOP TRACKING RAW STATS. START TELLING STORIES. Traditional tracker plugins give you cold, uninspired data like `"kills: 47"` or `"deaths: 12"`. **Player Memory Ledger** completely shifts the paradigm. It watches your world in real-time, contextually infers complex social behaviors, and writes a dynamic, persistent historical timeline for every single player on your server. --- ## ■ THE SMART INFERENCE ENGINE The plugin doesn't just watch events — it understands context. Using internal logic filters, it automatically detects high-impact social dynamics that no other plugin tracks: * **Betrayal Detection:** A player completes a villager trade, then murders someone within a 10-minute window ➜ a **BETRAYAL** memory is permanently etched into their history. * **Rescue Detection:** A nearby player drops below 4 hearts. An ally kills the threatening mob in time and the victim survives 10 seconds ➜ a **RESUB** is recorded for both players. > *Note: rescue is detected via mob kills near low-health players. Direct heal-based rescue may not always trigger depending on server conditions.* * **Revenge Matrix:** A player is killed and a 60-minute window opens. If they hunt down their killer and finish the job ➜ a **REVENGE KILL** is officially recorded. * **Kill Streaks:** Chain 5 kills within 30 minutes for *Killing Spree*, chain 10 for *Unstoppable*. * **Legendary Finds & Solo Boss Kills:** Detects rare items (Silence Trims, Enchanted Golden Apples, Elytras, Nether Stars) and flags bosses killed completely alone — Dragon, Wither, or Warden. * **Rare Structure Discovery:** Ancient Cities, Woodland Mansions, End Cities, Strongholds, Trial Chambers — all detected chunk-safely without causing server lag. --- ## ■ IMMERSIVE TIMELINES & IN-GAME UTILITIES * **Graphical Timelines (`/memories`):** A fully paginated 54-slot chest GUI with category filters (Combat, Social, Progression, Special, Negative), exact timestamps, and world coordinates for every memory. * **Public Player Profiles (`/history`):** View any player's kills, deaths, boss kills, reputation score, and earned tags in a clean GUI. * **Story Cards (`/storycard`):** Generate a beautifully formatted ASCII summary in chat or push it directly to your Discord server via built-in webhook support. * **Leaderboards (`/top`):** Server-wide rankings for reputation, kills, deaths, and boss kills with pagination. * **PlaceholderAPI Support:** 12 placeholders ready for scoreboards, tab lists, and holograms (`%playerledger_reputation%`, `%playerledger_tags%`, and more). * **Seasonal Archiving:** Snapshot an entire season's data into compressed local archives, keeping your active database lightweight while preserving history forever. --- ## ■ BUILT FOR PERFORMANCE * **Fully Async:** Every database write, reputation recalculation, and structure detection runs off the main thread. Zero tick impact. * **Dual Database Tuning:** SQLite out of the box (zero setup), or swap to MySQL for networks — same codebase, one config line. * **HikariCP Connection Pooling Gold:** Enterprise-grade connection management for both database modes. * **Modern API Architecture:** MiniMessage throughout, no legacy color codes. Built for Paper/Spigot 1.21+ with Java 21. * **Chunk-Safe Structure Detection:** Structure searches run asynchronously and never force-load chunks on the main thread. --- ## ■ COMMANDS & PERMISSIONS ```text /memories — Browse your personal memory timeline (playerledger.use) /history <player> — View any player's public profile (playerledger.history) /reputation — View reputation score, label, and tags (playerledger.reputation) /storycard — Generate a formatted story card (playerledger.storycard) /top <type> — Server leaderboards: reputation, kills, deaths, bosskills (playerledger.leaderboard) /marry <player> — Propose marriage (two-way acceptance) (playerledger.social) /alliance <player> — Propose alliance (two-way acceptance) (playerledger.social) /ledger inspect <pl> — Deep data inspection (playerledger.admin) /ledger reload — Reload configuration (playerledger.admin) /ledger archive — Archive current season (playerledger.admin) /ledger purge <play> — Remove all player data (playerledger.admin)