UltimateLogs

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

Command · Aliases · Description
/logs · /ulogs, /auditlogs · Opens the main visual investigation hub
/logs · — · Opens inventory inspection for a target player
/inv · /invsee, /uinv · Opens live inspection (online) or latest snapshot (offline)
/inv live · — · Forces live active inventory inspection
/inv history · — · Opens paginated archive of all recorded snapshots
/inv · — · Opens snapshot nearest to timestamp (e.g. 10m, 1h, 1d)
/ec [player] · /enderchest, /uec · Opens personal Ender Chest or inspects target's Ender Chest
/ec history · — · Opens paginated Ender Chest snapshot archive
/pos · /position, /where · Shows coordinates with an interactive teleport button
/pos history · — · Opens past coordinate trails and breadcrumbs
/deaths · /deathlogs, /udeaths · Opens complete death history with loot restore
/logs flush · — · Force-flushes queued database records to disk
/logs reload · — · Reloads config.yml configuration

Permissions

Permission Node · Default · Description
ultimatelogs.* · op · Master permission for all commands and GUIs
ultimatelogs.admin · op · Access to /logs flush and /logs reload
ultimatelogs.view · op · Access to open /logs GUI and query audit subsystems
ultimatelogs.invsee · op · Access to /inv live inspection and snapshot archives
ultimatelogs.enderchest · op · Access to /ec inspection
ultimatelogs.position · op · Access to /pos tracking and teleportation
ultimatelogs.deaths · op · Access to /deaths investigation archive
ultimatelogs.restore · op · Permission to recover items from snapshots

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.