EntityClearer | A ClearLagg Alternative icon

EntityClearer | A ClearLagg Alternative -----

Remove certain entities every x minutes with extreme customization!




Changes:
  • Added support for title and subtitle messages
    • These can be seen with the entityclearer.removalnotifs.title permissions
  • Simplified some code
  • Removed legacy coloring
    • If you used & color codes in any of your messages, please update them to follow the MiniMessage formatting
  • Updated some links in the config
  • Updated and sorted entity names in the config examples
  • Updated some comments in the config
The config changes can be found here
----------, Dec 31, 2024

Changes:
  • Fixed an issue where the plugin would begin the entity clearing tasks before all 3rd-party worlds were loaded
  • Added more debug info
----------, Nov 21, 2024

Changes:
  • Fixed a method not found error on Spigot servers
----------, Nov 1, 2024

Changes:
  • Added the ability to only run the tasks when a minimum amount of players are online
  • Updated dependencies
  • Added more info to the debug dump
  • Updated some of the comments in the config to help new users a bit better
The config changes can be found here
----------, Oct 24, 2024

Changes:
  • Fixed the checksum checks not working on Spigot servers (oops!)
----------, Aug 6, 2024

Changes:
  • Added a checksum checker to detect if the plugin has possibly been affected by malware
    • I highly recommend updating to this version as there seems to be a bad actor distributing a lot of malware on Spigot lately (including this plugin)
----------, Aug 6, 2024

Changes:
  • Updated the plugin's Discord invite
----------, Jul 22, 2024

Changes:
  • Added permissions for receiving actionbar/chat/sounds when the clear task runs
    • entityclearer.removalnotifs.[actionbar/chat/sound] (default: true)
  • Simplified the message formatting in the config
  • Added log messages for the clear tasks
The config changes can be found here
----------, Jul 6, 2024

Changes:
  • Bumped the link for the Paper javadocs to 1.21
  • Updated dependencies
The config changes can be found here
----------, Jul 6, 2024

Changes:
  • Changed the append-s option to be customizable
  • Fixed the plugin sending "minutes" even if there was only 1 minute
  • Fixed the plugin sending "60 seconds" instead of "1 minute" or similar
  • Switched the dump link from paste.gg to pastes.dev
  • Added an FAQs link to the config and moved the bStats disclaimer to the bottom
The config changes can be found here and here
----------, May 5, 2024

Changes:
  • Added the ability to customize "minutes" and "seconds" when counting down using the TIME placeholder
The config changes can be found here
----------, Apr 25, 2024

Changes:
  • Added an update checker
    • Players with the permission entityclearer.updatenotifs will be messaged with new updates
----------, Apr 15, 2024

Changes:
  • Updated the Discord links to point to the MOSS Discord server for support
  • Debug dumps will now automatically upload to paste.gg
  • The plugin will now throw an error message if no entities are defined in the config to be removed
----------, Apr 10, 2024

Changes:
  • Fixed a major bug in previous 3.0.x versions that caused "ALL" worlds to not track the timer properly
    • It is highly recommended to update to this version if you were previously on any 3.0.x version
  • Improved the clarity of a comment in the config (see below)
  • (3.0.0) All PAPI placeholders now require you to specify the world name
    • %entityclearer_remaining_minutes_<world>%
    • %entityclearer_remaining_seconds_<world>%
    • %entityclearer_remaining_seconds_left_<world>%
  • Slightly improved the debug output
The config changes can be found here
----------, Mar 18, 2024

Changes:
  • Fixed a bug where the debug file wouldn't save the world names
----------, Mar 17, 2024

Changes:
  • Fixed a bug where Mythic Mobs were either being removed when they shouldn't or weren't being removed when they should
  • The timer intervals are now per-world instead of on a global level, meaning one world can remove entities every 5 minutes whereas another world can be set to 15 minutes
    • The countdown-on-command option was removed due to the complexity of this new system and will now default to skipping the countdowns
    • It's possible I missed something in testing, so please submit an issue on GitHub if you come across any bugs
The config changes can be found here and here
----------, Mar 17, 2024

Changes:
  • Updated dependencies, such as Adventure and MythicMobs
    • This should fix broken action bars in 1.20.4
----------, Feb 12, 2024

Changes:
  • Removed cleared entity count metrics
  • Refactored a lot of code
  • Removed the /clearentities command (replaced by /ecl clearnow)
  • Added the entityclearer.basecommand permission
  • Added support for not removing occupied vehicle entities
  • Improved the interval metrics
  • Moved debug dumps into their own folder
  • Bumped minimum server version to 1.18.2
  • Greatly improved the way in which the clear task works
The config changes can be found here
----------, Oct 21, 2023

Changes:
  • Updated the Adventure API - this should fix actionbar messages not working on 1.20.2
  • Updated the MythicMobs API to version 5.4.1
----------, Oct 15, 2023

Changes:
  • Instead of having a global setting for removing named entities, this update makes it so entity types with -NAMED at the end will be removed
  • Improved the debug logs
  • Removed the option to print stack traces (this is now enabled)
The config changes can be found here
----------, Aug 1, 2023

Changes:
  • Added 3 PlaceholderAPI placeholders (see below)
  • Updated the logic for determining when the entity removal task should be run. Previously, an interval set to 1 would wait 1 minute, then start the countdown task, then remove the entities. If you had a warning set to 30 seconds, the entity removal gap was effectively 1.5 minutes. With this update, an interval of 1 and warning set to 30 seconds will continue to run the task every 1 actual minute.
  • Updated the MythicMobs dependency
  • World names will now be included in the debug dump

PlaceholderAPI placeholders:
  • %entityclearer_remaining_minutes% | The time in minutes until the next clear task is run
  • %entityclearer_remaining_seconds% | The time in seconds until the next clear task is run
  • %entityclearer_remaining_seconds_left% | The time in seconds until the next clear task is run, minus the time the minutes placeholder already accounted for
----------, Jul 22, 2023

Changes:
  • This version simply bumps the MythicMobs API version to 5.3.1
----------, Jun 23, 2023

Changes:
  • Updated the documentation links to 1.20
The config changes can be found here
----------, Jun 14, 2023

Changes:
  • Fixed a bug where the countdown would fail and throw errors if the warning-messages list didn't contain 1 second
----------, Jan 25, 2023

Changes:
  • Added MythicMobs support (requested by AllayBreeze)
  • Split many methods into their own classes
  • Added MythicMobs info to bStats
  • Updated the Discord invite in the dump message
The config changes can be found here and here.
----------, Oct 2, 2022

Changes:
  • The countdown timer now allows you to specify however much time you'd like
  • Improved some code
  • Changed the placeholders available for the time remaining messages and cleared entities messages
  • Bumped minimum Java requirement to 17
The config changes can be found here (breaking changes, please update your config before updating the plugin).
----------, Jul 19, 2022

Changes:
  • Refactored and cleaned up some code
  • Refactored and cleaned up the config.yml file
  • Dropped 1.16 support
  • The debug command will now dump the config to the debug file
  • Debug files are now in the .yml format
  • Fixed a problem where the entity spawn reason check was causing an error and clearing loop
  • The entity spawn reason check now requires Paper to work (since its method isn't in the Spigot API)
The updated config can be found here
----------, Jun 12, 2022

Changes:
  • Added placeholder info to the config
The config changes can be found here
----------, May 17, 2022

Changes:
  • Bumped internal versions
  • Updated some code
  • Removed the debug config option
  • Added the command /ecl debug
  • Added the permission entityclearer.debug
  • Debug will now output to its own text file to make getting support easier
----------, May 6, 2022

Changes:
  • Fixed a bug where the plugin would fail to send a message if a world couldn't be found
  • Added pitch controls for the sounds
The config changes can be found here
----------, Feb 6, 2022

Changes:
  • Players with the permission entityclearer.notify (default: OP) will now get messages when the plugin fails to find worlds or clear entities
----------, Jan 25, 2022

Changes:
  • Fixed support for 1.17.1 servers and lower
----------, Jan 15, 2022

Changes:
  • There is no longer an option to enable/disable chat/action bar messages - you can now just set them to be individually blank
  • Optimized some code
  • Removed the option to ignore worlds with the mob spawning gamerule disabled
  • Added an option to only count nearby entities if their type is also on the removal list
  • Updated what stats are sent via bStats
The config changes can be found here
----------, Jan 15, 2022

Changes:
  • Fixed a bug where a debug message would send to console when the TPS was low even if the debug was turned off
----------, Dec 20, 2021

Changes:
  • Fixed a bug where action bar messages wouldn't send on 1.18+ server versions
  • Fixed a bug where console would tell you the config might be outdated where in reality a world name was invalid
----------, Dec 15, 2021

Changes:
  • The DROPPED_ITEM entity will now be ignored by the nearby entities and spawn reasons check - however, it is still advised to use Paper's alternate item despawn rates instead
----------, Dec 13, 2021

Changes:
  • Fixed a bug where using ALL as the world wouldn't work properly with the spawn reason options (thanks LeftReaver)
----------, Dec 10, 2021

Changes:
  • The plugin will now work on MC versions 1.16+. However, the server must be on Java 16 or later
  • Fixed a bug causing named entities to occasionally be removed, even if they shouldn't be
  • Updated the link provided with a specific error
  • Other internal changes that I can't remember
----------, Dec 9, 2021

Changes:
  • Fixed a bug where the plugin would say your config was possibly outdated when in reality it couldn't find the right world
  • The plugin will now only work on 1.18 - see the Version History tab for older versions
The updated config can be found here (sorry no changes list, git was giving me troubles).
----------, Dec 7, 2021

Changes:
  • You can now use the world name ALL in the config to apply the entity list to all worlds (Note: Using ALL will override any other worlds in the list)
  • Updated some debug stuff
  • Bumped the API version to 1.17
The config changes can be found here
----------, Nov 26, 2021

Changes:
  • The removal timer can now be disabled
  • Added a note in the config regarding dropped items
  • countdown-on-command in the config will now default to false
  • Added different removal messages for when entities are removed due to low TPS
  • Removed the remove-instantly option in the config under the low TPS section - it will now be always enabled
  • Added a section for having different entities be removed in the low TPS section
  • Removed 1.8-1.16 support
  • Updated to Java 16
The config changes can be found here
----------, Nov 26, 2021

Changes:
The config changes can be found here
----------, Aug 11, 2021

Changes:
  • Changed a few config comments
  • Now open source
  • Now built with Maven
  • The low TPS check will now be enabled by default
The updated config can be found here
----------, Aug 10, 2021

Changes:
  • Fixed a bug where there would be blank console messages sent when the clearing task finished
----------, Aug 6, 2021

Changes:
  • Added a config option to enable debug (it's pretty spammy!)
  • Support for the plugin will now be given in our Discord server.
The config changes can be found here.
----------, Aug 6, 2021

Changes:
  • Added an option to run commands after the clear task completes (requested by @Sparxez)
The config changes can be found here
----------, Jun 20, 2021

Changes:
  • Removed the spawn-reason code from the bStats metrics - the performance impact to this update should be negligible so updating doesn't really need to be a priority if you're lazy like me
----------, Jun 18, 2021

Changes:
  • Moved the spawn-reasons config option to work separately for each world
The config changes can be found here
----------, Jun 18, 2021

Changes:
  • Removed the show-if-zero option because it added extra unnecessary complexity to the clearing task (may re-add this in the future - if you really liked the feature, please create a feature request on GitHub about it if one doesn't exist already)
  • Optimized the code and made it better
The config changes can be found here
----------, May 31, 2021

Changes:
  • Added a warning when the server is reloaded
  • Added warnings when something goes wrong when clearing entities or sending messages
  • Added a config option to print stack traces when something goes wrong
  • Fixed the plugin not loading at all on versions 1.13-1.15
The config changes can be found here
----------, May 28, 2021

Changes:
  • Fixed a bug where the low TPS check was running asynchronously when it shouldn't
----------, May 11, 2021

Changes:
  • Added an option to only remove entities with others nearby if the mob spawning gamerule is enabled
  • Added per-world entity removal lists
  • Changed some of the default config values
  • Changed the website link in the version message
  • Some other changes I probably can't remember
The config changes can be found here
----------, May 3, 2021

Changes:
  • Fixed a bug causing RGB colors to not work on action bar messages
----------, Apr 22, 2021

Changes:
  • Fixed a bug that may occur on Spigot with actionbar messages
  • Added an option to disable sending warning messages if 0 entities will be cleared
  • Sorted some options in the config
  • Added some more statistics
The config changes can be found here
----------, Apr 22, 2021

Changes:
  • Updated a few comments in the config to make more sense
  • Added ARMOR_STAND to the default entity list
  • Changed the order in which low TPS messages are sent
  • Added new bStats graphs
  • Compiled using the 1.16 API
  • Tested on 1.8.8+
The config changes can be found here
----------, Apr 17, 2021

Changes:
  • Fixed a potential issue with the action bar messages
  • Added spawn reasons to the config
  • Added nearby entities to the config
  • The TPS checker is now less sensitive
  • Other config changes
----------, Apr 17, 2021

This is a small update that simply adds extra stats to the bStats page.
----------, Apr 15, 2021

Fixed a potential bug that could cause entities to be removed even when the TPS was stable.
----------, Apr 13, 2021

The previous method for grabbing the server's current TPS was often too sensitive and would trigger if the TPS dropped below the threshold for even a second. This new update will now get the average TPS from the past 5 seconds, to ensure that the server is actually lagging.

Config changes:
Code (YAML):
low-tps :
  # Should the entity removal task be triggered when the TPS is low?
  enabled
: false
  # Below what TPS should the plugin remove the entities?
  threshold
: 17
  # Should the plugin remove the entities instantly or trigger the countdown?
  # Warning: If the TPS is too low and remove-instantly is false, the plugin may
  # not be able to remove the entities before the server crashes
  remove-instantly
: true
  # Should there be a chat message sent to players with the `entityclearer.lowtps`
  # permission stating that the TPS is low?
  chat
: true
  chat-message
: "&c&lWarning: TPS low &8&l(&7&l{TPS}&8&l)&c&l! Removing entities..."
----------, Apr 13, 2021

This update completely remade the TPS monitoring system, so it will now work on all server versions instead of only Paper and its forks.

Config changes:
Code (YAML):
low-tps :
  # Should the entity removal task be triggered when the TPS is low?
  enabled
: false
  # How often in seconds should the plugin check the TPS of the server?
  check-rate
: 5
  # Below what TPS should the plugin remove the entities?
  threshold
: 17
  # Should the plugin remove the entities instantly or trigger the countdown?
  # Warning: If the TPS is too low and remove-instantly is false, the plugin may
  # not be able to remove the entities before the server crashes
  remove-instantly
: true
  # Should there be a chat message sent to players with the `entityclearer.lowtps`
  # permission stating that the TPS is low?
  chat
: true
  chat-message
: "&c&lWarning: TPS low &8&l(&7&l{TPS}&8&l)&c&l! Removing entities..."
----------, Apr 12, 2021

This update simply changes a few things with bStats and makes the code a bit nicer
----------, Apr 6, 2021

Changes:
  • Added a new statistic to bStats
  • Compiled the plugin using the 1.13.2 API
  • Updated some code

If this plugin has helped you please be sure to leave a review :)
----------, Apr 4, 2021

Changes:
  • Added an option to clear entities when the server's TPS is too low (requires Paper to function)
  • Added bStats
  • Added the permission entityclearer.lowtps

Config additions:
Code (YAML):
# This plugin uses bStats metrics
# https://bstats.org/plugin/bukkit/EntityClearer/10915
# Metrics can be disabled in the bStats config.yml
Code (YAML):
low-tps :
  # Should the entity removal task be triggered when the TPS is low?
  # This feature requires Paper (https://papermc.io/)
  enabled
: false
  # How often in seconds should the plugin check the TPS of the server?
  check-rate
: 10
  # Below what TPS should the plugin remove the entities?
  threshold
: 17.00
  # Should the plugin remove the entities instantly or trigger the countdown?
  # Warning: If the TPS is too low and remove-instantly is true, the plugin may
  # not be able to remove the entities before the server crashes
  remove-instantly
: true
  # Should there be a chat message sent to players with the `entityclearer.lowtps`
  # permission stating that the TPS is low?
  chat
: true
  chat-message
: "&c&lWarning: TPS low &8&l(&7&l{TPS}&8&l)&c&l! Removing entities..."
----------, Apr 4, 2021

Resource Information
Author:
----------
Total Downloads: 41,156
First Release: Apr 1, 2021
Last Update: Dec 31, 2024
Category: ---------------
All-Time Rating:
20 ratings
Find more info at bstats.org...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings