Add level filter to purge command

[WindsorMacmillan]

Is your feature request related to a problem?

I have I over 600 islands on my server, and 139 of them are necessary for keeping. When cleaning up islands in server, purge protect command requires a massive work. I'm expecting a more intelligent purge function.

Describe the solution you'd like.

Add an optional parameter to purge command when levels addon is installed.

Example:
/bsb purge 30 1000
Clean up islands that below lv.1000 and offline for 30 days.

Describe alternatives you've considered.

Travel to all island in server and set purge protection manually.

Agreements

• I have searched for and ensured there isn't already an open issue regarding this.
• I have ensured the feature I'm requesting isn't already in the latest supported BentoBox build or Addons.

Other

Some owners of high-level islands can be offline a quite long without notifying me.
Meanwhile, 90% of new players simply created islands and never come back again.

So the higher the island level, the longer players are allowed to be offline.
Such as:

/bsb purge 7 100
/bsb purge 14 500
/bsb purge 30 1000
/bsb purge 60 2000

[tastybento]

I recommend you try the new bsb purge regions <days> command to purge instead of the old purge command. This supports the feature you want. It was added in 3.7.0 although I recommend using 3.7.2 as it's the latest.

The command purge regions deletes old islands by removing region files. The advantage of having the region file deleted is that disk space is freed up. This is a beta feature so only use if you have backups. It has been tested. Region purging is very fast.

Purge Logic

Here’s the logic used to determine whether an island can be purged :

High-Level Flow

1. User runs the purge command with a number of days.
2. The plugin scans region files and finds those not modified in the last N days.
3. For each region, it finds all islands overlapping that region.
4. For each island, it checks if the island can be deleted (purged).
5. Only islands passing the deletion check are considered for purging.

Detailed Purge Eligibility Logic

An island and the region file it is in will not be deleted, i.e., is protected from purge if any of the following are true:

• Island is marked as purge protected
• Island is a spawn island
• Island is not owned - this enables you to make ornamental islands and not worry about them being purged
• Island level is too high - the level is set in the BentoBox config.yml and requires the Level addon
  • If the "Level" addon is present, and the level is higher than BentoBox's level in config.yml is then the island is protected. default is is 10.
• Owner or any team member has logged in recently

If none of the above protections apply, the island can be deleted.

In short: An island is eligible for purge if it is not protected, not spawn, is owned, is below the level threshold, and no member has logged in recently - unless it is already marked as deleted, in which case it can always be purged.

What is deleted

If all the islands in a region can be deleted, then the following is deleted:

• Region files (.mca)
• Associated player files in the world folder - this will mean that if they log in they will spawn in the main world
• Entity or POI files related to the region
• Island records in the BentoBox database

So, I think this should give you what you need. And just to remind - please be sure you have backups because the files are deleted from the filesystem.