📦 ChestLogger (Fabric Mod) v2.6.4

Notice for Fabric Server & Client Users Upgrading from v2.1.0:
This release is a massive cumulative upgrade introducing native client GUI screens, Mod Menu integration, smart theft & raid heuristics, item provenance tracking, container claiming, and complete 54-slot double chest parity. Your existing .clog binary logs and configuration files remain 100% backward compatible.

🌟 Major New Systems & Features (Since v2.1.0)

🖥️ Native Client GUIs & Mod Menu Integration

• In-Game Configuration Screen (/chestlog config): Sleek, dark-carbon in-game configuration screen (ChestLogConfigScreen) with interactive sliders, toggle buttons, and text fields across 4 categories (General, Alerts, Tracked Items, Web).
• Live Hot-Reloading: Changes made in the client configuration screen sync to the server via custom Fabric network packets (ChestLogConfigPayload) and apply instantly without restarting the server or client.
• Official Mod Menu Support: Full integration with Mod Menu. You can now configure ChestLogger directly from the Mod Menu screen in-game. Includes embedded high-resolution brand icon (icon.png).
• Clean Classpath Resolution: Switched to compileOnly Mod Menu resolution, eliminating class conflicts and launch crashes when Mod Menu is present.

🔍 Item Provenance & Chain-of-Custody Screen

• In-Game Provenance Visualizer (ChestLogProvenanceScreen): Run /chestlog trace [hand] or /chestlog trace <X> <Y> <Z> [slot] to open a visual node-link timeline detailing an item’s full custody history from origin to current owner.
• Cycle-Safe DAG Traversal: Traces items across player trades, container deposits, withdrawals, and automated hopper transfers.
• 64-Bit Component Fingerprinting: Accurately tracks custom-enchanted, renamed, and modified gear.

🛡️ Smart Theft & Raid Detection Engine

• Context-Aware Presence Heuristics: Sub-20ms theft analysis distinguishing legitimate cooperation from malicious looting. Detects 🔴 Offline Theft, 🟡 Absent Owner Looting, and suppresses alerts during 🟢 Consensual Proximity (owner nearby).
• Sliding-Window Raid Velocity Tracking: Detects rapid looting across multiple container coordinates within a 300s configurable window, triggering CRITICAL_RAID incidents.
• Directional Player Trust System: Added /chestlog trust <player>, /chestlog untrust <player>, and /chestlog trustlist. Trusted friends can access your containers without setting off security alarms.
• Wilderness & Natural Container Classification: World-gen containers (dungeons, mineshafts, shipwrecks) default to UNCLAIMED_NATURAL to prevent alert spam while exploring.

🔐 Container Claiming & Anti-Sniping Protection

• Single & Mass Claiming: Secure containers using /chestlog claim or claim an entire cluster of nearby containers using /chestlog claim [radius] (up to 16 blocks).
• Anti-Sniping History Defense: Prevents players from claiming containers they did not place if recent audit history shows prior ownership.
• Container Transfer: Safely transfer ownership to teammates via /chestlog transfer <newOwner>.

🔔 Multi-Channel Alerting & Admin HUD

• Action-Bar HUD & Clickable Chat Cards: Online Operators receive real-time Action-Bar warnings and interactive chat alert cards with clickable [Teleport] and [Inspect] buttons.
• Discord Security Webhooks: Asynchronous alert dispatcher sending rich embeds with player presence status, coordinates, items extracted, and incident severity.

🛠️ Fixes, Mixin Hardening & Stability Improvements

• Double Chest (54-Slot) Linked Container Parity: Updated ServerPlayerMixin and CompoundContainer context resolution to track all 54 slots across both primary and secondary block halves.
• Hopper Automation Dual-Coordinate Recording: Updated HopperBlockEntityMixin so that hopper extractions and insertions on double chests emit transaction records for both linked positions.
• Inspection "Air" Display Bug Fix: Resolved an issue where empty slots or double chest slot boundaries could inadvertently render as "Air" placeholders in query logs.
• Rollback Chunk Persistence: FabricRollbackExecutor now ensures inventory compensation writes directly to live world block entities and marks chunks dirty, preventing rollback reversion on server crashes.
• Ground-Truth Ownership Tracking (BlockItemMixin): Automatically hooks CONTAINER_PLACE on block placement to record initial container owners.
• Strict Permission Segregation: Regular players have access to trust, claim, trace, and help; administrative commands (inspect, rollback, config, stats, purge) are strictly gated behind Operator Level 2+.
• Command Help & Brigadier Tab-Completion: Added permission-aware /chestlog help and full auto-complete across all subcommands.

📋 Requirements & Dependencies

• Minecraft Version: 26.2 (~26.2)
• Fabric Loader: 0.19.3 or newer
• Fabric API: Required (>=0.157.0+26.2)
• Java Runtime: Java 25 (>= 25)
• Mod Menu: Optional (Supported for in-game configuration)

Found a bug or have feedback? Open an issue on our GitHub Issue Tracker.