UltimateLogs

A high-performance server audit, live inventory inspection, and investigation plugin for Minecraft.

GitHub • Issues • Source Code

Features

Real-Time Live Inspection

• Live 10-Tick Sync: View player inventories and Ender Chests update live in real time as players move, craft, or fight.
• Two-Way Container Control: Staff can take, place, swap, and shift-click items directly between their own inventory and the target player's live inventory.
• Armor Slot Equipping: Equip armor pieces directly into equipment slots (2–5) with native sound effects.
• Instant Reflection: Changes made by staff update on the target player's screen within a single server tick.

Point-in-Time Snapshots

• Automated Event Triggers: Snapshots are automatically recorded on player join, quit, container close, death, and periodic intervals.
• Run-Length Deduplication: Stationary or idle players have their states merged into duration counters to prevent database bloat.
• Time-Machine Inspection: View what an inventory looked like at any exact time in the past using simple time inputs (e.g. 10m, 1h, 1d, or 29/10/2026).
• Snapshot Protection: Placing items into historical snapshots is strictly blocked to maintain audit integrity, while taking items is enabled for victim recovery.

Offline Player Support

• Inspect Offline Players: View and modify inventories and Ender Chests even when the player is offline.
• Autonomous Sync on Rejoin: Staff can remove confiscated items or deposit compensation gear; changes sync automatically the moment the player reconnects.

Coordinates & Movement Trail

• Spatial Tracking: View world, XYZ coordinates, yaw, pitch, health, and latency.
• Interactive Chat Teleport: Click the interactive chat message to instantly teleport to a player's location.
• Breadcrumb Archive: Browse past movement trails with one-click teleportation to historical spots.

Death Investigation

• Comprehensive Death Logs: Records death cause, killer entity/player, weapon used, world, and exact coordinates.
• One-Click Loot Recovery: Inspect the exact inventory and Ender Chest at the moment of death and return lost items with ease.

Anti-Dupe & Security

• Server-Side PDC Tags: GUI buttons, back arrows, close barriers, and glass panes are tagged server-side and cannot be taken, shifted, or hotbar-swapped.
• Auto-Purge System: Cleans client-predicted ghost items on menu click, drag, close, and player disconnect.
• Asynchronous Engine: Database queries and saves run off the main thread with HikariCP connection pooling for zero TPS impact.

The GUI (/logs)

Typing /logs opens the central visual investigation hub:

1. Subsystem Selection: Choose between Inventory, Ender Chest, Position Trail, Death Investigation, Item Transactions, or Sessions.
2. Player Selection: Interactive player list showing online/offline status with custom search.
3. Time Query: Quick time presets (Latest, 10m, 30m, 1h, 1d), snapshot archives, or custom timestamps entered directly in chat.

Commands

Permissions

LuckPerms Quick Setup

/lp group admin permission set ultimatelogs.* true
/lp group mod permission set ultimatelogs.view true
/lp group mod permission set ultimatelogs.invsee true
/lp group mod permission set ultimatelogs.enderchest true
/lp group mod permission set ultimatelogs.position true
/lp group mod permission set ultimatelogs.deaths true
/lp group mod permission set ultimatelogs.restore true

Installation

1. Download UltimateLogs.jar.
2. Place the jar into your server's plugins/ folder.
3. Start or restart the server.
4. (Optional) Configure database settings and timezone in plugins/UltimateLogs/config.yml.

Compatibility

• Server Software: Paper, Purpur, Pufferfish, Leaves (1.21+ / Paper 26.x)
• Minecraft Versions: 1.21.1 through 1.21.11, Paper 26.1 through 26.3
• Java: Java 21, 22, 23, 24, 25
• Cross-Version Support: Fully compatible with ViaVersion and ViaBackwards.