Minecraft plugin CoreProtect

🔌 About CoreProtect

CoreProtect is a Minecraft plugin that records block and entity changes to provide searchable history and undo/repair tools for griefing, accidental damage, and debugging. It focuses on reliable data logging and administrative tools so server operators can inspect player actions, perform targeted rollbacks or restores, and manage stored data.

🎯 Purpose

CoreProtect's core purpose is server-side data logging and anti-griefing: capture who changed what and when, let staff inspect recent changes in-game, search historical changes by player/time/area, and revert or restore those changes when needed.

⚙️ Features

• Persistent logging of block and entity changes (block placement, block break, entity changes) as confirmed by official documentation.
• In-game inspector mode to view logged changes while interacting with the world.
• Lookup commands to query historical changes by player, time, radius, or area.
• Rollback and restore commands to revert or reapply logged changes.
• Purge command to remove old data based on retention rules and reclaim space via optimization flags.
• Database migration support to move between SQLite and MySQL backends.
• Per-world configuration files to alter logging behavior on a per-world basis.
• Public API for other plugins to read/write CoreProtect data as provided in official documentation.

🧩 Who It Is For

• Server administrators and moderators who need forensic logs of player activity.
• Survival and SMP servers that want to recover from grief or accidental damage.
• Large or small servers that require searchable historical data and controlled rollbacks.

🏗️ Example Use Cases

• An admin uses the inspector to identify who removed blocks from a base and performs a targeted rollback of those changes.
• A moderator runs a lookup for a player's actions during a time window to investigate a report.
• A server operator migrates the CoreProtect database from SQLite to MySQL to move to a networked backend.

⌨️ Commands

Notes: command names and descriptions are taken from the official CoreProtect documentation. The migrate-db command is documented as part of database migration functionality; explicit permission nodes for every command are listed in the official permissions documentation.

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official CoreProtect JAR for your Minecraft version and place it into your server's plugins/ directory.
• Restart the server and verify CoreProtect loads in the server console.
• Use /co reload after configuration changes to apply them without restarting.

📦 Dependencies

• No required third-party plugin dependencies are listed in the official documentation for CoreProtect itself. (Some third-party tools and integrations are documented as compatible; list specific integrations only when enabled explicitly.)

🧾 Configuration

• CoreProtect creates a config.yml in its plugin folder.
• Per-world configuration files can be created by copying config.yml to a file named after the world (for example world_nether.yml) to override logging settings for that world.
• Database migration steps and safe migration practices are documented in the official documentation.

🧠 Technical Notes

• CoreProtect provides an API for other plugins to interact with logged data (documented in the official API docs).
• CoreProtect supports migrating data between SQLite and MySQL backends using documented migration commands.
• The project is published under the Artistic-2.0 license.

🤝 When This Plugin Is Useful

If you need searchable server-side logging and reliable rollback/restore tools to investigate player actions or repair grief, CoreProtect provides a focused logging and remediation toolset suitable for server administrators and moderation teams.