MineTracer

MineTracer is a powerful and lightweight block, container, sign, and kill logging mod for Minecraft servers, designed to help server administrators monitor, investigate, and roll back player actions with ease. Built for Fabric, MineTracer provides advanced logging and rollback capabilities while remaining simple to use and highly configurable.

This mod is still under developement so don't expect everything to work flawlessly. Please write an issue report on GitHub if you find a bug, I am happy to recieve feedback!

---

• Block Logging Tracks all block break and placement events, including full NBT data for accurate restoration. Supports all block types, including those with complex states or tile entities.

• Container Logging Monitors interactions with chests, furnaces, hoppers, shulker boxes, and other containers. Logs both item withdrawals and deposits, including item counts and types.

• Sign Editing Records all sign text changes, storing both the previous and new text for each edit, allowing for easy investigation and restoration.

• Kill Logging Logs all player and mob kills, including killer and victim names, locations, and timestamps.

• Advanced Query System Search logs using flexible filters such as player name, time range, radius, action type, and specific item or block IDs. Combine multiple filters for precise lookups.

• Rollback Functionality Instantly undo player actions within a specified area, time frame, or by specific users. Rollbacks are safe and only affect the filtered actions, minimizing risk of unwanted changes.

• Inspector Mode Toggle inspector mode to view block history in real time. Right-click or break blocks to see a detailed log of recent actions at that location.

• Permission-Based Access All commands and features are protected by permissions, allowing fine-grained control over who can view logs, perform rollbacks, or use inspector mode.

---

/minetracer lookup <filters>

Search through logs using any combination of filters.

/minetracer rollback <filters>

Roll back player actions matching the specified filters.

/minetracer page <number>

Navigate through paginated lookup results.

/minetracer inspector

Toggle inspector mode for real-time block history.

/minetracer save

Force save all log data to disk

---

Filters

• user:<player> – Filter by player name
• time:<duration> – Filter by time (e.g., 1h, 30m, 2d)
• range:<blocks> – Filter by radius in blocks from your current position
• action:<type> – Filter by action type (broke, placed, withdrew, deposited, kill)
• include:<item> – Filter by specific item or block ID

---

Permissions

• minetracer.command.lookup – Access to lookup command
• minetracer.command.rollback – Access to rollback command
• minetracer.command.inspector – Access to inspector mode
• minetracer.command.page – Access to pagination

---

Use Cases

• Grief Investigation Quickly identify who broke or placed blocks, edited signs, or accessed containers in a given area.

• Rollback Griefing Instantly undo unwanted changes by filtering actions by user, time, and range.

• Theft Detection See exactly what items were taken or deposited in containers, and by whom.

• PvP and Mob Kill Tracking Monitor player and mob deaths for moderation or event purposes.

• Server Auditing Maintain a complete history of important actions for server security and peace of mind.

---

Images

---

Installation

1. Download the latest JAR from the releases page.
2. Place it in your server's mods folder.
3. Restart your server.
4. Configure permissions as needed for your moderation team.

---

Requirements

• Minecraft 1.20.1
• Fabric Loader 0.15.7+
• Fabric API 0.92.0+1.20.1
• fabric-permissions-api

---