Skip to content

Release 3.7.0

Compare
Choose a tag to compare
@tastybento tastybento released this 19 Jul 05:30
· 10 commits to master since this release
d6f7b95

New In This Release

This adds compatibility for Paper 1.21.8.

Adds a new beta admin command purge regions that deletes old islands by removing regions. This can also be used instead of having islands deleted. Set the BentoBox config.yml setting keep-previous-island-on-reset: true and then run purge every so often. The advantage of having the region file delete is that they will be regenerated completely when revisited. 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 cannot be deleted (i.e., is protected from purge) if any of the following are true:

  1. Island is marked as purge protected
  2. Island is a spawn island
  3. Island is not owned
  4. Island level is too high
    • 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.
  5. Owner or any team member has logged in recently

Islands That Can Be Deleted

  • If none of the above protections apply, the island can be deleted.
  • Exception: If the island is already marked as deleted it can always be deleted regardless of other checks.

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)
  • World player files in the world - 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

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8
✔️ Java 21

Upgrading

  1. As always, take backups just in case. (Make a copy of everything!)
  2. Stop the server
  3. Replace the BentoBox jar with this one
  4. Move or delete locale files
  5. Restart the server
  6. You should be good to go!

Legend

  • 🔡 locale files may need to be regenerated or updated.
  • ⚙️ config options have been removed, renamed or added.
  • 🔺 special attention needed.

What's Changed

Full Changelog: 3.6.0...3.7.0