Essential Core - Inspect Blocks/Entities/Chunks/Players

Essential Core
Our multi-threaded processing allows you to get the best performance when using the mod.
Choose a dependency when logging into the server by typing '/ecore backup all' and select between MySql and SqLite.

Overview

• Records player actions (block breaking/placement, interactions, containers, etc.)

• Open Inventories, Ender Chests, and offline player ender chests.
• Performs periodic backups of player inventories and chunks
• Allows for rollback/restore of chunks and inventories
• Has an interactive inspector (with pagination) for consulting history
• Uses background processing (multithreaded) to avoid lagging the server
• Stores data in SQLite (config/essential-core/essential-core.db file) and writes logs to disk (config/essential-core/events)

Core Features

• Fast and efficient data logging for various categories (blocks, containers, interactions, chat, commands, etc.).
• Rollbacks and restores (player/chunk) via commands.
• Multi-threaded
• Logs in files by category → player → date: essential-core /logs/<category>/<player>/<dd-MM-yyyy>.log.
Configurable via config.toml (enable/disable logs, command filter, and thread count).
• Inspector with pagination and clickable buttons for navigation.
• Undo to revert the last rollback.

What does it log?

• NEW: inventory — Player inventory log

• NEW: enderchest — Player enderchest log
• The implemented log categories (FileLogger.java file) include — each log goes to essential-core/events/<category>/<player>/<date>.log:• block_break — block breaking by player
• block_place — block placement
• interactions — interactions with blocks/entities (right-click)
• containers — container opening with summarized content
• chat — chat messages
• commands — commands executed by players (filterable)
• sessions — player login/logout
• item_pickups — picking up items from the ground
• item_drops — dropped items (Event: EntityJoinLevel detects ItemEntity)
• item_transactions — (method exists in FileLogger; see note below)
• dimensions — dimension change
• game_mode — gamemode change
• entity_death — entity death (new)
• entity_kills — entity killed by player
• console_commands — commands executed on the console
• server_events — server start/stop
• Observation: some logs are recorded with the player as "SERVER" or "CONSOLE" when applicable (e.g., entity_death records in entity_death/SERVER/<date>.log).

Commands

Alias: essentialcore, ecore and core

• /ecore status — Shows mod status: queues, threads, latest backups, processing time, memory usage.
• /ecore inspect — Toggles inspector mode: toggleInspect.
    * Subcommands (while in /nc inspect mode):
        * /ecore inspect block <x> <y> <z> [page] — Inspects the block's history (actions + interactions).
        * /ecore inspect player <target> [page] — Player's action history.
• /ecore player <player> — Displays the player's last backups.

• /ecore chunk — Shows information about the current chunk (last backup, last players to enter, etc.).
• /ecore backup all | player | chunks — Forces a backup.
• /ecore rollback chunk <radius> <backup_number> — Restores the chunks in an area around the player to the state of the indicated backup number.
• /ecore rollback player <player> <backup_number> — Restores the player's inventory (player must be online).

• /ecore inventory — Open the inventory of an online or offline player.

• /ecore enderchest — Open the enderchest from an online or offline player.
• /ecore reload — Reloads the config.toml configuration.

Future updates

• MySQL support

• Curios inventory support

Mod inspired by coreprotect!

Need help? Access Discord.
https://discord.gg/cQjHxv3mWv
Use Discord to report bugs and problems.

The source code will be provided if the mod is well-received, thank you.