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.
Whether someone is a legendary lone wolf, a savior in battle, or a notorious backstabber, the world will remember.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ THE SMART INFERENCE ENGINE
- 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 RESCUE 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.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ EVOLVING REPUTATION & LIVING TAGS
Every action shifts a player's standing. Good deeds add weight, chaotic actions pull it down — and redemption is always possible.■ EVOLVING REPUTATION & LIVING TAGS
- Dynamic Labels: Six reputation tiers that scale with behavior: Legendary ➜ Trusted ➜ Respected ➜ Neutral ➜ Questionable ➜ Infamous
- Earned Titles: Tags like Hero, Dragon Slayer, Explorer, Loyal Ally, Protector, Betrayer, Raider, Outlaw, Warmonger are auto-assigned and auto-revoked as behavior changes.
- True Redemption: Tags are wiped and fully rebuilt on every recalculation — asynchronously, off the main thread. No player is permanently stuck. Actions have consequences, but also a path forward.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ IMMERSIVE TIMELINES & IN-GAME UTILITIES
■ 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
■ 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
■ COMMANDS & PERMISSIONS
Code:
/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)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ PLACEHOLDERAPI SUPPORT
Full PlaceholderAPI integration out of the box — optional, works without it. Drop into any scoreboard, tab list, hologram, or chat plugin instantly.■ PLACEHOLDERAPI SUPPORT
Code:
• %playerledger_reputation% — Reputation score
• %playerledger_kills% — Total player kills
• %playerledger_deaths% — Total deaths
• %playerledger_boss_kills% — Total boss kills━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ KNOWN LIMITATIONS (v1.0.5)
- Theft detection requires a protection plugin (WorldGuard, GriefPrevention, etc.) — disabled by default pending integration.
- Faction join/leave memories require a Factions plugin — stub is present, integration pending.
- Archive browsing GUI is not yet implemented (archiving/creation works, in-game browsing of past archives is a v1.1 feature).
- The "Trusted Merchant" tag requires trade counting — this will be properly tracked in v1.1 with a dedicated trade memory type.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ MAP / ROADMAP
■ MAP / ROADMAP
- v1.1.0 — Dedicated trade memory type (fixes Trusted Merchant tag), archive browsing GUI[/CENTER]
- v1.2.0 — Protection plugin integrations (WorldGuard, GriefPrevention, Towny) for theft detection
- v1.3.0+ — Custom memory scripting API, duel plugin integrations, minigame event support
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ BUG REPORTS & COMMUNITY SUPPORT
This plugin is completely free and actively maintained. If something isn't working as expected or you have an idea that would make this even better for your server, please don't leave a negative review without reaching out first. I genuinely want to fix it.■ BUG REPORTS & COMMUNITY SUPPORT
Response times may vary but every report is read and taken seriously. Most bugs can be patched same day.
Built for Paper/Spigot 1.21+ | Java 21 | SQLite & MySQL | PlaceholderAPI (optional)
Latest reviews
- captain26723
- Version: v1.0.5
One of the most creative plugins I've seen in a long time. Turns boring kill/death stats into actual player history and server lore. The betrayal and revenge detection work flawlessly. Free, well-documented, and actively maintained — what more could you ask for? Solid 5 stars, no question.
