StellarProtect - CoreProtect Alternative

Support: - Support to 26.3 Fixed: - Fixed NPE in Brew Event with Jobs.

If you're using this plugin in production, it's recommended to join our [Discord](https://discord.com/invite/4R9teKVcbM) community for fast support and access to Dev Builds.

Breaking Changes

- Indexed `log_entries` schema: Added indexed columns (block_id, old_block_id, item_id, amount, entity_type, chunk_key). Database migration is fully automatic and backward-compatible, keeping extra_json intact. - New tables: Automated creation of inv_snapshots and inv_txns tables on startup. - `BlockRestore` refactor: Converted to a concrete class with multi-tiered fallback reflection calls. - Version tolerance: Unrecognized sub-versions now resolve dynamically via resolveClosest(), defaulting to v26_1_R2 instead of disabling the plugin. - Deprecated commands: /sp invrollback and /sp irs are now legacy aliases pointing directly to /sp restore #containers. - New query filters: Added support for b:, ench:, biome:, ch:, tool:, lore:, display:, within:, sort:, agg:, and format:.

New Features

- Advanced restoration engine: Captures previous block data (oldData) to properly revert fluid and state transitions (water/lava, sculk). Complete NBT capture and restoration on tile entities (chests, signs, spawners, shulkers, lecterns) via internal NbtUtils. - Unified `/sp restore`: Modular scope support using flags: #blocks, #containers, #items (drop/pickup/craft/consume/enchant), #kills (killed entities), and #entities (composite scope). Omitting flags restores all actions within range. - Dedicated inventory restore: Added /sp restore-items (supports #undo to return dropped items). Unfit items drop safely at player feet if the inventory is full. - Expanded event logging: Re-enabled BlockFadeEvent (ice, snow, fire, coral). Added logging for raids, brewing stands, dispensers, workstation blocks, and explosion-damaged sculk. - Automated inventory snapshots: Snapshots are recorded every 5 minutes, on container close, and upon player disconnect. - Data export & analytics: Added /sp export to save filtered logs to JSON/CSV on disk, and /sp stats to view top active players, blocks, and actions over time.

Improvements & Fixes

- Critical fluid restoration fix: Fixed state rollbacks when fluids solidify or melt by restoring previous block states accurately. - Double chest delta fix: ChestRollbackSessionManager now synchronizes inventory deltas across both chest halves. - NBT persistence fix: Ensured tile entities retain full custom metadata upon rollback via complete NBT-API integration. - Block placement rollback fix: Place actions now pass oldData to reliably restore whatever block occupied the space previously. - Removed duplicate listeners: PickUpDropListener no longer creates redundant drop entries covered by CraftListener. - Legacy 1.8 model hash fix: Fixed modelDataHashCode returning static 0 values on custom items. - Empty event listeners resolved: Raid, brewing, dispenser, and workstation handlers now process and log valid action data. - 5x to 50x faster queries: Filter lookups are massively accelerated on large databases through composite SQL indexing. - Optimized caching & zero extra dependencies: BlocksCache and ItemsCache run on amortized O(1) time via hint cursors, backed by custom internal collections (IntSet) without external libraries. Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM) If you want to support the project: [Patreon](https://www.patreon.com/c/insideranh)

Hotfix: - 26.1 version detection.

Support

- Support to 26.1 and 26.1.2

Fixed

- Fixed Purpur incompatibilities that caused the log file to grow excessively due to incorrect property detection. - Fixed incompatibilities with Minecraft 1.21.11 that caused incorrect restorations. From this update onward, everything will be properly registered.

If you're using this plugin in production, it's recommended to join our [Discord](https://discord.com/invite/4R9teKVcbM) community for fast support and access to Dev Builds.

Improvements & Fixes

- Customizable `<location>` format: Added support to customize the <location> format, as requested by BigBeacon. - Improved HIDE_ENCHANTS item flag detection: Improved detection of the hideItemFlag to properly hide enchantments when HIDE_ENCHANTS is applied. - Critical fix for XEntityType TNT logging: Fixed an important issue with XEntityType that could cause TNT logs to not be recorded. Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM) If you want to support the project: [Patreon](https://www.patreon.com/c/insideranh)

If you're using this plugin in production, it's recommended to join our [Discord](https://discord.com/invite/4R9teKVcbM) community for fast support and access to Dev Builds.

Improvements & Fixes

- Optimized WorldEdit queue system: Improved the WorldEdit queue handling to prevent excessive memory usage, resulting in up to a 50% performance improvement. - Improved storage usage for new logs: Storage handling has been optimized. This improvement only applies to newly generated logs and is not retroactive. - Fix for XP log disabling: Resolved an issue where XP logs could not be properly disabled. - New placeholder for inspector mode status: Added %spt_inspect_enabled% placeholder to check whether Inspector mode is currently enabled. - Enhanced `/spt inspect` command support: The /spt inspect command can now be executed from console when specifying a target player. In-game usage now supports inspecting other players with the permission stellarprotect.inspect.others. - Improved `/spt inspect` response time on large databases: Significantly improved response times when working with hundreds of millions of logs. Further optimizations are still planned. - Fixed several minor issues related to log registration. - Added support 1.21.11. Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM) If you want to support the project: [Patreon](https://www.patreon.com/c/insideranh)

If you're using this plugin in production, it's recommended to join our [Discord](https://discord.com/invite/4R9teKVcbM) community for fast support and access to Dev Builds.

Improvements & Fixes

- New support for i: filter with entities: You can now use filters such as i:cow or i:allay when searching logs. - Fix for Minecraft 1.21.4: Resolved a compatibility issue affecting this version. - Improved entity restoration for legacy versions: The restoration system has been refined for more accurate results on Minecraft 1.8–1.12. - Added support for CopperChest 1.21.10: Interactions and block changes are now properly logged for Copper Chests. - New block scanners for propagated explosions: Added special scanners to ensure chain-explosions are properly registered. - Critical fix when reading restore and lookup logs: Fixed an issue where non-player entities such as TNT did not appear in logs, even though they were recorded in the database. If you experienced incorrect restorations or incomplete lookups, updating to this version will automatically fix log reading. - Beta support for WorldEdit on 1.21.X: This new system logs blocks removed by WorldEdit. For FAWE/Async WorldEdit, you must enable the corresponding option in the config. io.github.insideranh.stellarprotect.nms.v1_21.worldedit.StellarLogger <details> <summary>FastAsyncWorldEdit</summary>  </details> - Partial compatibility with TreeCutter. Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM) If you want to support the project: [Patreon](https://www.patreon.com/c/insideranh)

If you're using the plugin in production, it's recommended to join our community on [Discord](https://discord.com/invite/4R9teKVcbM) for fast support and access to Dev Builds of the plugin.

Improvements & Fixes

Fixed Mount and Dismount Logs

Resolved an issue where entity mount and dismount actions were not being logged correctly.

New Leash and Unleash Logging

Actions involving attaching or removing a leash from entities are now fully logged.

New Command to Revert an Accidental `/spt undo`

A new command was introduced to undo accidental uses of /spt restore, preventing unwanted restorations.

Inventory Restoration Commands

Added /spt invrestore to restore only inventory-based containers such as chests and shulkers. This command works alongside /spt irs, which enables a mode that lets you click containers to restore them. Use with caution: This is a new command intended as a last-resort tool, similar to /spt undo. Use it only when normal rollback or entity restoration systems cannot resolve the issue.

Folia 1.21.8 Compatibility Fix

Resolved teleport and task compatibility issues on Folia 1.21.8.

Fallback Serializer for Legacy Versions

Added an auxiliary serializer for old Minecraft versions to correctly handle legacy NBT formats.

Entity Restoration for Older Versions

The entity restoration system is now supported on: - Minecraft 1.8.8 - Minecraft 1.12 - Minecraft 1.13

Entity Fix for 1.21 Explosions

Fixed inconsistent entity data produced by explosions on Minecraft 1.21.

Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM)

Support the project: [Patreon](https://www.patreon.com/c/insideranh)

Improvements & Fixes

- Added an optimization to detect when none or all is used inside the disable_types method. - Added the ability to disable water or lava tracking individually by using WATER and LAVA inside the disable_types section. - Fixed and restored compatibility with Minecraft 1.21 R0. - Added proper support for blocks when using the i: argument, fixing incorrect behavior with certain block inputs. - Improved filter detection when using multiple blocks or items, ensuring more accurate parsing and command suggestions.

If you’re using the plugin in production, it’s recommended that you join our community on [Discord](https://discord.com/invite/4R9teKVcbM) to get quick support and access to Dev Builds of the plugin.

Storage Fix

- Removed certain logs that caused excessive storage usage. These will be reimplemented in a more efficient way in future updates.

Folia & Paper Teleport Fix

- Fixed an issue affecting teleportation on Folia and recent Paper versions. - Added a =piston filter for Block Break and Block Place logs, allowing you to ignore actions triggered by pistons. Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM) If you like my project and want to support me: [Patreon](https://www.patreon.com/c/insideranh)

Hot Fix

- Fixed: ConcurrentModificationException in BlockSourceCache.

Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM)

Support the project: [Patreon](https://www.patreon.com/c/insideranh)

Added

- Introduced the new Entity Restoration System (BETA). StellarProtect can now fully restore entities with all their original data and attributes, preserving unique behaviors and relationships. This includes: - 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. This system has been completely rewritten from scratch to achieve a far more accurate and faithful restoration of entity states. As it’s still in BETA, feedback and bug reports are highly appreciated on the [official Discord server](https://discord.com/invite/4R9teKVcbM). - Added the new `#entities` hashtag Allows selectively including or excluding entities from rollback operations, giving more precise control between block and entity recovery.

Improvements

- Enhanced block data string handling to prevent collisions between complex NBT structures (e.g., custom heads, banners, decorated pots, etc.). - Optimized mixed rollback performance, improving stability and processing time when restoring both blocks and entities together.

Fixed

- Fixed a long-standing issue with container item logging (including chests, shulkers, furnaces, hoppers, droppers, barrels, and more). The internal pool counters were not properly resetting after multiple operations, which could result in inconsistent or duplicated logs. - Adjusted block data handling to minimize conflicts during fast or concurrent restorations. <details> <summary>Entity Restoration (BETA) — Click to preview</summary>  </details>

Join the community

- Discord: [Join here](https://discord.com/invite/4R9teKVcbM) - Support on Patreon: [Become a patron](https://www.patreon.com/c/insideranh)

Improved:

- Improved block indexing to prevent collisions on servers with hundreds of records per second, providing better overall optimization.

Removed:

- Removed unused NMS classes.

Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM)

If you like my project and want to support me: [Patreon](https://www.patreon.com/c/insideranh)

Hot Fix:

- Fixed startup error with Spigot 1.21.10

Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM)

If you like my project and want to support me: [Patreon](https://www.patreon.com/c/insideranh)

Added

- Hashtag filters to customize rollback actions: - #verbose → shows extra information when restoring. - #silent → displays minimal messages. - #preview → previews what the plugin will do before applying changes. - Rollback sessions (BETA), allowing more controlled restorations. Example: pause, preview, and continue a rollback step by step. - #we filter (BETA) to regenerate or lookup inside a WorldEdit selection. (Future updates will expand its usage).

Improvements

- Improved entity name detection. - Improved radius filters, now supporting world-based filtering: - r:#world → affects the whole world. - r:#world,10,10,10 → affects a 10-block radius around specific coords. - r:10 → affects X/Y/Z radius. - r:10,20 → affects X/Z radius with height Y=20. - Improved time filters, supporting new formats with commas and dots: - 1m30s - 2.50h - 1h-2h - 1d,7h

Fixed

- Fixed the /spt memory command. - Fixed several NullPointerException (NPE) issues. - Restored support for Minecraft 1.19.3. 

Join the community on: [Discord](https://discord.com/invite/4R9teKVcbM)

If you like my project and want to support me: [Patreon](https://www.patreon.com/c/insideranh)

Added:

Added growth logs* for multiple blocks: trees, chorus flower, vines, sculks, amethyst, and bamboo. Added Armor Stand Manipulate* to the logging system. New lookup menu* to view items you place or remove from an armor stand. Added the ability to Right-click (place) a block* in a location to see what block was removed there. Added the ability to Right-click (place) a block inside another block* (e.g., dirt in water) to see who placed the original block.

Improvements:

Improved fire rollback logging* to detect all cases and restore them correctly. Changed the BlockTracker to use bitwise operations, just like AdjacentType. This makes operations run in O(1) instead of O(n)\length()**, providing incredible optimizations compared to competitors.

Fixed:

Fixed tab complete* for actions, which wasn’t detecting correctly and caused lookup to fail when using 2 actions. Fixed an issue where the startswith* condition wasn’t being detected properly, allowing unwanted logs to bypass the filter.

Added

- Added an automatic preview when performing a rollback. You must now use /spt restore confirm to apply the changes after reviewing the preview. - Added translations to the restoration process. - Added experimental compatibility with ItemsAdder. If you notice any errors or missing features, please report them on our Discord.

Improvements

- Improved the Vault hook detection to avoid errors when counting currency. - Improved detection of water and lava, solving cases where they were not restored correctly.

Fixed

- Fixed several detection issues on Minecraft 1.8.8. - Fixed entity detections on Minecraft 1.8.8. - Fixed an issue with detecting model data in Nexo.

New Features

- Added Simplified Chinese (zh-CN) language support and renamed existing Traditional Chinese to the standard name zh-TW. Thanks to virgil698. Pull [#2](https://github.com/InsiderAnh/StellarProtect/pull/2) - Added the ability to translate and edit the /spt help command. Thanks to LeCraft2Ouf. Commit [#c2a845f](https://github.com/InsiderAnh/StellarProtect/commit/c2a84… - Improved the item tracker in chests by differentiating items with different custom model data. - Added compatibility with Nexo items, now showing the correct item names in transactions and inspections (instead of displaying “Paper”).

Fixes

- Fixed an issue where breaking a furniture was not being registered correctly. - Fixed a false economy log triggered on login during the first Vault check.

New Logs:

- Added compatibility with Nexo custom blocks to log when a nexo block is placed or removed. - Added compatibility with Nexo furniture to detect when a furniture is placed or removed. - Added a hook with XPlayerKits to log when a kit is claimed or given through the /xkits give, /xkits claim, or inventory claim.

Improvements:

- Added a fallback for the radius argument in the /restore command to prevent errors. - Added the hooks.yml file to enable or disable these and future hooks. We are open to suggestions!

Fixed:

- Fixed a NullPointerException when saving item templates in some cases.

Hotfix

- Fixed auto-commit error in some cases.

New Features

- Now logs not only directly broken blocks by players, but also blocks affected when breaking the ones below them (cactus, sugar cane, bamboo, etc.). - Added a menu to view items in more detail, as well as inventory transactions with exactly the same items. - Added grouping for pickup and drops. Minecraft sometimes fires pickup events one by one, which could generate up to 64 logs for a single stack. - Now identical items being picked up are grouped, reducing log count and storage usage. - Added a new filter. Often you need to search for an item by displayname to go directly; now you can with the argument `mi` and its variations. - Added the `me` argument to exclude items you don’t want. - New permission to use inventory view stellarprotect.view.

Fixed

- Fixed an issue with displaying some commands or chat messages caused by a parser running when it wasn’t needed. <details> <summary>Examples</summary> mi:[display:&aAmazing sword] mi:[lore:&7The best sword] mi:diamond_sword me:[display:&aAmazing sword] me:[lore:&7The best sword] me:diamond_sword </details> <details> <summary>Images</summary>     </details>

Fixed:

- Fixed Folia startup tasks.

New Feature

- Introducing Block Indexing: block references are now stored in the database similar to items, avoiding repeated data and reducing storage usage by an average of 60%. - Economy logs: values are now limited to 2 decimals to further reduce disk usage.

Improvements

- Optimized name search in teleport commands, reducing resource consumption. - Updated MongoDB indexes to ensure faster access and queries.

Fixed

- Fixed the /restore command not correctly detecting break actions. - Removed two minor debug messages in console.

Note:

StellarProtect, tested with 200 players, has virtually no impact on server performance.

However, I believe there is always room for improvement.

That’s why I constantly look for better optimization techniques: so that even 10ms can become 1ms.

When you see "Optimization" in my titles, it doesn’t mean the plugin is poorly optimized,

it just means there are always things to refine and test further.

Improvements:

- Improvement: /spt inspect now distinguishes left-click (block logs) and right-click (interactions such as removed items). - Optimized interaction detection and resource usage in item serialization, keeping consumption minimal even with hundreds of players.

Fixed:

- Resolved an item indexing issue that prevented several items from being detected, potentially causing incorrect records. Updating is important. <div align="center">

<span style="color:#ff4d4d">We’re getting closer to version 1.0.0!</span>

Version after version, I’ve been constantly improving the plugin. In the coming days, significant improvements will arrive to further reduce storage usage and enhance searches for even better performance. Thank you very much for trusting <span style="color:#ff4d4d">StellarProtect</span>. </div>

New Features

- Added the ability to translate items displayed in spt lookup or spt inspect. In the configuration, you can set the default language (en for English, es for Spanish, and zh for Chinese). The default is English. - Added transaction logs for droppers. StellarProtect now detects when a player inserts or removes items from them.

Technical Improvements

- Minor optimizations to the item serialization system (Item Serializer).

Logged Interactions

StellarProtect now supports all interactions, including: - 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.

features:
  translations:
    # Language to use for translations, available languages: es, zh
    items_lang: "en"

StellarProtect opens its code for everyone to view, learn from, and contribute.

We want this decision to be an opportunity to improve together and take the project further than ever before.

Important about the license

The new license allows: - View the code - Compile it for personal use - Contribute with improvements, optimizations, and new features Not allowed: - Commercial use without permission - Repackaging the plugin and selling it as your own - Forks intended for commercial activities

Additional changes in this update

- Added support to ShopGUI Plus to log buy and sell actions. - Minor optimizations to some things. Join the community on [Discord](https://discord.com/invite/4R9teKVcbM)

Improvements

- Added optimized indexes for the inspect command when handling millions of records. These will be created in the background if you already have too much data. - Added a money logger that checks every X time (configurable) and only records when there is a balance change. - Added session times to login and leave events, allowing the creation of a player activity map. - Added an internal command to improve the detection of "Click to teleport" when the log comes from another world. - Added an XP log for players.

Fixes

- Fixed an issue in the Sign Logger that caused lines to be saved with a delay. On the second edit, the lines from the first edit were displayed. <details> <summary>Economy Logger</summary>  </details> <details> <summary>Session times Logger</summary>  </details> <details> <summary>XP Logger</summary>  </details>

Improvements

- Improved detection in lookup commands when radius and time arguments are not specified. Now, all available pages are checked. (This does not affect performance as it only changes the count query).

New Logs

- Added a log when a player revives using a totem. - Added a log when a player consumes an item (food, golden apple, etc.). - Added a log when a player teleports, including the cause. - Added a log when a player uses the smithing table. - Added a log when a player changes their game mode.

Fixes

- Fixed action suggestions that were not being detected correctly in some versions.

Improvements

- Improved pagination and structure of the lookup and inspect commands.

New Logs

- Added a log for projectiles shot by players, including the projectile type. - Added a log for projectiles that hit an entity, showing the name of the entity or player hit. - Added death cause information to the death logs. - Added logs for mounting and dismounting entities. - Added a log when a player breaks an item frame.

Fixes

- Fixed an issue that caused the language file to reset to its default state. <details> <summary>New Lookup</summary>  </details> <details> <summary>New Inspect</summary>  </details>

Fixes

- An error in the SQL connection that was preventing the plugin from starting properly has been fixed. <center>

Tomorrow, version 0.3.0 will be released with lots of new features.

</center>

Improvements

- Added the ability to change the names of tables or collections. - Added the /spt alias, since /sp is being used by FastAsyncWorldEdit. - Slightly changed the structure of the lookup command by removing unnecessary and repeated parts. - Greatly improved argument parsing: suggestions are now clearer with commas (,) and duplicate arguments are prevented.

Fixes

- Fixed version detection for 1.21.8, which was incorrectly recognized as 1.8. - Fixed a NullPointerException (NPE) when using lookup if a player was removed from the cache at that moment. - Fixed an issue where the database type was not detected correctly, always defaulting to H2. - Fixed the data parser for the lookup command in version 1.8. - Fixed an issue with the PortalCreateEvent in version 1.21.5+. - Fixed a MySQL connection issue when no password was set. (Don't forget to create your database!)

Improvements

- Detailed lines have been added to the /sp lookup command to display inventory transactions, providing greater clarity on performed actions. (See image at the end)

Fixed

- Fixed an issue that prevented the plugin from starting on Minecraft versions 1.21.7 and 1.21.8. - Fixed compatibility with Folia, resolving issues related to blocks, restoration, and inventory interaction. <details> <summary>Detailed Transaction</summary>   </details>

New

- Suspicious activity detection system: A new 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. - Special inspect lines for blocks with custom data. (Exclusive to StellarProtect) - Signs now display their 4 lines of text when inspected. - Added Enchant Item Logger to track enchanted item events. - Added filter support for: user:UserName,UserName2 or user:=decay - Added support for filtering multiple actions at the same time in lookup. <details> <summary>Example</summary>  </details> <details> <summary>Signs Details</summary>   </details>

Improvements

- Lookup command delay handling improved: The default delay of 10 seconds is now correctly reduced to 0.5 seconds after receiving any response, even when the result is "no logs." This helps prevent spam while ensuring responsiveness when appropriate. - Improved `/purge` command arguments: The /purge command now supports additional arguments such as user, radius, and actions, not just days. This allows for more precise and flexible log cleanup. - Interaction cooldown added to prevent excessive logs: A 0.25-second cooldown has been added to usage interactions to prevent excessive logging caused by auto-clickers or hacks. While Spigot already imposes some limits, this extra protection helps prevent potential future CPU leaks. - Improved lookup messages to support detailed signs.

Fixes

- Fixed NPE on sign actions without text lines: Resolved a NullPointerException that occurred when a sign action had no text lines defined.

First Version of this plugin, please report posible bugs in discord. https://discord.com/invite/4R9teKVcbM