StellarProtect

Advanced Action Logger for Minecraft Servers
The ultimate solution for tracking, inspecting, and rolling back player activity with performance in mind.

| | | | | --- | --- | --- |

- **Full player action tracking** – from block changes to chat, PvP, containers and more. - **True multi-threaded engine** – keeps your main server thread untouched, even under pressure. - **Tested on networks with over 200 players online.** - **Version support from 1.8 to 1.21.10.** - **Folia-compatible** for next-gen server performance. - Active support via [Discord](https://discord.com/invite/4R9teKVcbM) - You can translate all items into the language of your choice, from Spanish to Chinese and beyond. - Thanks to **Item Indexing** and **Block Indexing**, storage usage is reduced by up to 60% compared to other competitors. - **ItemsAdder** and **Nexo** support. ### **Optimized for Performance** - Rewrites database queries to handle thousands of logs per second. - Choose between **SQLite or MySQL**. - Rollback without chunk reloads or server lag. ### **Plug & Play Setup** - No config needed to get started. - Multi-world support built-in. - Simple and ready-to-use API for developers. ### **Preview, Restore and Rollback Control** - Target by player, action type, block type, radius, or world. - Preview changes before applying. - Exclude players or block types from any operation. - When you run the restoration for the first time, it will be considered a preview. You need to use **/spt restore confirm** to apply it permanently. ### **Intelligent Inspection Tools** - Visual tool for checking block/entity interaction history. - Click to see who placed, broke, interacted, or modified. - Container inspection support: chests, barrels, hoppers, furnaces, etc. - **Special Inspect Lines for Custom Blocks:** Designed to provide human-readable insights for blocks with custom data. - Shows all 4 lines of sign text directly when inspecting. ### **Suspicious Activity Detection System** - Helps staff detect suspicious player behavior automatically. - Detects when a player uses `/tpaccept` and dies shortly after. - Useful for identifying patterns such as TPA Kill. Example ### **Tested Performance with 200 players on mc.hycraft.us** More images **Timeout 10m** **Timeout 30m**

### **World & Environment** - Player block break. - Player block place. - Lava and water bucket usage by players. - Explosions (TNT, creepers, ghasts). - Piston and entity-based block movement. - Trampled crops. - Leaves decay. - Tree grows. - Chorus flower, vines, sculks, amethyst, and bamboo spread. - Fire burn and ignite blocks. - Portal creation blocks. - Sign edits and place with detailed lines. ### **Player Interaction** - Accessing containers and moving items - Crafting items - Extracting items from furnaces - Enchanting items - Dropping items - Picking up items - Logging in and out - Tracking player deaths - Killing entities - Logging chat and commands - Shooting projectiles - Hitting entities with projectiles - Mounting and dismounting entities - Breaking item frames - Flowing liquids - Log consume items - Teleports and cause - Smithing table use - Gamemode change - Totem ressurrect - XP change - Money variation - Login and logout with session times. - Placing a book on a lectern. - Placing items on a campfire. - Placing a book in a chiseled bookshelf. - Placing a disc in a jukebox. - Filling a cauldron with water. - ArmorStand manipulate. ## **Entities Data** - **Villagers** - Restored with their **level, profession, experience, and custom trades**. - **Pets** - Dogs, cats, parrots, and other tamed creatures now retain their **name, owner, and state**. - **Hostile & passive mobs** - Restored with their **equipment, attributes, and AI data**. ### **Extras** - Automatic log cleanup and expiration. - **Shop GUI** buy and sell actions. - **XPlayerKits** claim or give kits, with player give kit. - **Nexo** custom blocks, furniture place or break and custom ítem names. - **ItemsAdder** custom blocks, furniture place or break and custom ítem names. Preview logs         

### **Intelligent Item Indexing** Avoids redundant data by referencing item definitions instead of saving them repeatedly. This: - Reduces database size drastically. - Speeds up queries and I/O. - Improves backup performance. ### Block Indexing Uses **getAsString()** from BlockData to assign each unique block state an ID. Instead of saving the full data every time, only the ID is referenced. - Reduces database size - Faster queries and I/O - Smaller backups ### **Ultra-Optimized Save Queries** Custom storage layer built for high-volume servers: - Batch writing to reduce disk access. - Transactional safety to avoid locking issues. - Low-latency writes even under stress. ### **Special Inspect Lines for Custom Blocks** Designed to provide **human-readable insights** for blocks with custom data. - Shows **all 4 lines of sign text** directly when inspecting. ### **Suspicious activity detection system** A feature has been added to help staff detect suspicious behavior, such as "TPA Kill". The system will automatically detect when a player uses **/tpaccept** and then dies shortly after, allowing for better automated moderation. Example

**/spt lookup** - The core of your investigation system. - Filter by time (minutes, hours, days). - Filter by action type (placed, broken, container access, etc.). - Paginated results with clean navigation. **Example:** `/spt lookup a:action_break time:24h page:2 user:InsiderAnh` Shows page 2 of block placements from the past 24 hours. Image

**/spt inspect** - Click on any block to instantly see who placed, broke, or modified it. - No need to check logs manually, results appear in chat immediately. - Perfect for tracking grief or edits in a specific location. - Includes **chest inspect** support to see item transfers in containers. - Each interaction is timestamped and tied to the responsible player. - Ability to Right-click (place) a block in a location to see what block was removed there. - Ability to Right-click (place) a block inside water or lava block to see who placed the original block. Image

| | | | | --- | --- | --- |

StellarProtect is an active and growing project. We appreciate your suggestions, bug reports, and reviews. Join the Discord to contribute and help shape the future of this plugin!

**Thank you for supporting StellarProtect!**

**Many servers already trust StellarProtect, and we are truly grateful for that trust.**