Ledger Mod (26.1.2, 1.20.1) – Powerful, Server-Side Logging Mod

Ledger Mod is a server-side logging and rollback mod for Minecraft servers running on Fabric or Quilt. It records world interactions and allows administrators to inspect, search, rollback, restore, and manage changes in a structured and reliable way. The mod is written in Kotlin and is designed to overcome limitations found in older logging solutions, providing better performance, extensibility, and accuracy.

Features:

Core Capabilities

• World Activity Logging
  • Tracks block placement and removal
  • Logs item interactions and transfers
  • Records entity-related actions
  • Associates actions with players or sources
• Inspection & Search
  • Inspect blocks in-world to view historical actions using /ledger inspect
  • Advanced log searching with multiple filters via /ledger search
  • Pagination support for large result sets using /ledger page
• Rollback & Restore
  • Preview changes before applying them with /ledger preview
  • Rollback logged actions selectively using /ledger rollback
  • Undo rollbacks and restore original changes with /ledger restore
• Maintenance & Management
  • View mod and database status using /ledger status
  • Purge old log entries to reduce database size with /ledger purge
  • Teleport to logged event locations using /ledger teleport
  • View player-related information with /ledger player

Configuration

• Configuration file located at config/ledger.toml
• Customizable options include:
  • Message colors and output themes
  • Search behavior such as page size
  • Database queue size and timeout settings
  • Action filters based on world, source, object type, or action type

Database & Storage

• Uses SQLite by default
• Supports external databases through extensions:
  • MySQL
  • H2
  • PostgreSQL

Extensions & Networking

• Extension system allows:
  • Additional database backends
  • New commands and configuration options
• Built-in networking layer for:
  • Inspect and search data packets
  • Rollback, restore, and purge requests
  • Server-client synchronization and responses

Key Advantages

• Comprehensive logging of Minecraft world changes
• Powerful and flexible search and filtering system
• Safe rollback and restore workflow with preview support
• Scalable database handling for large servers
• Permission support compatible with permission systems such as LuckPerms
• Extensible architecture through official extensions

Commands:

Commands for Ledger provide comprehensive control over inspection, querying, altering, and managing logged world data on a Minecraft server. Each command is invoked under the root command /ledger (alias lg).

• Root
  • /ledger (alias lg): The central command entry point. Grants access to all subcommands. Permission required: ledger.commands.root.
• Inspect
  • /ledger inspect <x> <y> <z>: Inspect logs at specific world coordinates.
  • /ledger inspect: Toggle inspect mode on/off for the player issuing the command.
  • /ledger inspect on: Force inspect mode on.
  • /ledger inspect off: Force inspect mode off.
  • Alias: i, Permission: ledger.commands.inspect.
• Search
  • /ledger search <params>: Perform advanced database queries with filters (e.g., player, object, action, world). Results support pagination. Alias: s, Permission: ledger.commands.search.
• Page
  • /ledger page <page>: Jump to a specific page in search results. Alias: pg, No permission required.
• Player
  • /ledger player <profiles>: Lookup player record details such as first and last join times. Alias: pl, Permission: ledger.commands.player.
• Preview
  • /ledger preview rollback <params>: Preview world state if matching actions are rolled back. Alias: pv, Permission: ledger.commands.preview.
  • /ledger preview restore <params>: Preview world state if matching rollbacks are restored.
  • /ledger preview apply: Apply the current preview to the world.
  • /ledger preview cancel: Cancel any active preview.
• Rollback
  • /ledger rollback <params>: Undo logged actions matching filters (e.g., block, item, entity). Alias: rb, Permission: ledger.commands.rollback. Recommended to preview before execution.
• Restore
  • /ledger restore <params>: Undo previously applied rollbacks (block, item, entity), restoring world state. Permission: ledger.commands.rollback. Recommended with preview.
• Purge
  • /ledger purge <params>: Remove log entries from the database that match filters (e.g., time range, action type). Permission: ledger.commands.purge.
• Status
  • /ledger status: Display current mod version, queue state (busy/free), and quick links. Permission: ledger.commands.status.
• Teleport
  • /ledger tp <world> <x> <y> <z>: Teleport to a specific world coordinate, often used with search results. Permission: ledger.commands.tp.

Command Parameters such as player:, object:, action:, world:, and others refine filters used in search, rollback, restore, purge, and preview.

Screenshots:

Requirements:

Fabric Loader Required

Ledger Mod Download Links