Clearlite

Updated

The version number text

Notes

This update focuses on fixing a small, but big deal bug

Updated

- Updated WorldGuard - Updated Towny - Updated java to Version 25 - Updated papermc to 26.1 - Dropped support for 1.21.X and below - Plugin has been updated to 1.3 Release

Notes

- This update focuses on compatibility and maintenance to ensure continued stability on the latest server versions.

Updated

- Updated plugin version to 1.2. - Updated support for Minecraft 1.21.11. - Updated plugin.yml to reflect new versioning changes. - Updated WorldGuard integration to the latest version. - Updated WorldEdit integration to the latest version. - Updated Slabbo integration to version 1.1.3.

Added

- Added a .gitignore file for improved project maintenance.

Notes

- This update focuses on compatibility and maintenance to ensure continued stability on the latest server versions.

- Updated Towny Version Compat. - Updated Paper API to the latest Version. - More changes to come...

No big changes made just some minor edits - 1.0 Snapshot released into 1.0-Release - minor text changes

New Commands

- /cl status – Shows TPS, last run, entities cleared, breakdown, and next run ETA. - /cl debug [world] [limit] – Debug tool to list dropped items and explain why they’re skipped (grace, skips, rules, etc.). - /cl items [material|*] [minAge] [world] [radius] [force] [simulate] – Targeted item-only clears. - force=true bypasses all skip rules (admin nuke). - simulate=true shows counts without removing.

Permissions

- clearlite.status – View plugin status. - clearlite.member – Manage per-member skip & grace rules. - clearlite.debug – Use the new debug command. - (Existing: clearlite.simulate, clearlite.now, clearlite.reload.)

Improvements

- Entity Type Update: Fixed compatibility with Minecraft 1.21 – dropped items now use ITEM instead of the old DROPPED_ITEM. - Config Handling: Plugin now merges new default keys into config.yml automatically on reload, so you won’t miss new options. - Status Info: /cl status now includes breakdown summaries and next-run estimates. - Debug & Targeting Internals: Added clear reasons, item inspection, and targeted removal utilities.

Upgrade Notes

- Update your config.yml → change DROPPED_ITEM to ITEM in clear-types.

Fixes & Improvements

- Config merging – New keys from the default config.yml are now merged into the server file on startup or /cl reload without overwriting user settings. - Command wiring – All subcommands now go through /clearlite (or /cl), with proper tab completion for worlds, radius values, and member commands. - Reload command – /cl reload now updates defaults correctly instead of leaving configs outdated. - Task reuse – A single ClearTask instance is used across the plugin, making /cl status and run tracking accurate. - Startup safety – More robust command registration and interval handling for low-TPS auto-clears.

What’s New

- Per-player settings – Players can now keep their own items or projectiles safe, and even set personal item grace times. Manage it easily with /cl member. - World-specific rules – Turn Clearlite on/off per world, and give each world its own item grace time. - Item filters – Use a denylist or allowlist to control exactly which items get cleared. - Projectile controls – Skip all projectiles at once or fine-tune specific ones (like XP bottles or tridents). - /cl status command – Check TPS, last clear run, how many entities were removed, a quick breakdown, and when the next clear is coming.

Better Safety

- Region/Towny protection now only applies to important entities (like villagers and armor stands). Dropped items and projectiles get cleared as expected. - Named items no longer block clears (fixes dropped items not being removed).

Other Tweaks

- Config updated to version 3. - Added a broadcast option so you can choose whether /cl now messages go to everyone or just you. - Simulate/now commands can now target a specific world or a radius around you.

New Commands - /cl simulate – Preview how many entities would be removed without actually clearing them. - /cl now – Instantly clear entities across the server. - /cl reload – Reload Clearlite’s configuration without restarting. Permissions - clearlite.simulate - clearlite.now - clearlite.reload Entity Clearing Fixes Trash entities like XP orbs, arrows, snowballs, pearls, tridents, falling blocks, etc., now behave consistently and are no longer cleared you can turn them back onto being cleared via changing the permission from projectiles = true -> projectiles = false and add them to the clear list. WorldGuard/Towny Improvements Region and Towny protections now only apply to valuable entities (villagers, pets, vehicles, stands, frames, paintings). Expendable entities (items, XP, projectiles) are no longer blocked by regions. Code Cleanup Refactored clear task for better readability. Added helper methods like requiresRegionProtection() to separate valuable vs. expendable entities.

Initial release Core entity clearing system implemented. Configurable clear-types list to control which entities get removed. Basic safety checks to skip important entities (players, pets, villagers, armor stands, item frames, etc.). Optional WorldGuard and Towny protection (region-safe, towny-safe).