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 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.

■ 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 Plaintext

/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.

Plaintext

• %playerledger_reputation% — Reputation score
• %playerledger_kills%      — Total player kills
• %playerledger_deaths%     — Total deaths
• %playerledger_boss_kills% — Total boss kills

■ KNOWN LIMITATIONS (v1.0.5) Being upfront so you know exactly what you're getting:

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.

■ 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.

Discord Support