Essential Core

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

• 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.