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

/memories            — Browse your personal memory timeline (playerledger.use)
/history <player>    — View any player's public profile (playerledger.history)
/reputation [player] — View reputation score, label, and tags (playerledger.reputation)
/storycard [player]  — 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)