Release 2.7.0

Summary of changes

• Support for 1.21.3
• Fixes the use of hex color codes in chat, which were broken in the last release, e.g., "&#ff00ff magenta!"
• Improves the admin Purge command operation (see below)
• Changes the homes command to show a clickable GUI of the player's island homes instead of just a text list.
• Improves the Island cache so that islands do not have to be loaded from the database if not required - especially important for larger servers (> 10,000 islands)
• Improved the customizable Panel API

Improvements to Admin Purge command

Purge is an admin command that will delete islands that have owners/teams that have not logged in for a while. You specify the number of days, and the purge command will let you know how many islands are older than without a login. You can then confirm and they will be deleted. The default purge command will delete one island at a time, so if you have a lot of them, it will take a while.

The old Purge command relied on Bukkit's API to find out when the player last logged in, however, this data can often be lost on the server, due to upgrades, backups, etc., and so was unreliable. This version of BentoBox will use that data if it is available, but also store the player's last login time in BentoBox's database. To get the ball rolling you must run the Purge command at least once - you do not have to actually purge anything because that will set the player data as much as possible.

If you have a lot of islands, like you haven't purged in a while, and your world files are large, then it may be better to use a plugin like Regionerator which when set up correctly, will actually delete unused regions, thus reducing disk space. BentoBox is compatible with this plugin. To find out more read our docs on Regionerator.

Compatibility

✔️ Minecraft 1.21.3, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
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

• 2534 new island scaling by @tastybento in #2536
• 2531 command button panel by @tastybento in #2535
• Fix hex codes color conversion - by @tastybento in #2540
• Better purging by @tastybento in #2541
• Release 2.7.0 by @tastybento in #2537

Full Changelog: 2.6.0...2.7.0

Release 2.6.0

Summary of changes

• New admin command - resethome - this will reset a player's default home to the overworld default, or close to it. Useful if a player mistakenly sets their home in the nether or end, even after all the warnings!
• New admin command - setmaxhomes which sets the maximum number of homes for the island.
• Enabled Ops to access Oraxen items, like sitting on chairs, etc. Previously, only island members or owners could do this.
• Minor improvements to teleporting, such as better notifications.
• Option to add clickable text and hover text to locale output. See below.

Clickable text and hover text

You can now make any chat text sent to the user clickable or provide hover text. To use it you add commands to the text in the locale file. Recognized commands are:

• [run_command: <command>] - Runs the specified command when the message is clicked.
• [suggest_command: <command>] - Suggests the specified command in the chat input.
• [copy_to_clipboard: <text>] - Copies the specified text to the player's clipboard.
• [open_url: <url>] - Opens the specified URL when the message is clicked.
• [hover: <text>] - Shows the specified text when the message is hovered over.

The commands can be placed anywhere in the message and will apply to the entire message component. If multiple commands of the same type are provided, only the first one encountered will be applied. Unrecognized or invalid commands enclosed in square brackets will be preserved in the output text.

Example usage:

message: "Hello [run_command: /help] World! [hover: This is a hover text!]"

The above message will display:

Hello World!

• Clicking: Runs the /help command when clicked.
• Hover: Shows "This is a hover text!" when hovered.

Clicking and hovering only applies to text shown in chat.

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
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

• Fix for #2515 by @tastybento in #2516
• Implements admin command to set an island's max homes #2517 by @tastybento in #2518
• Add AdminResetHome command #2522 by @tastybento in #2523
• Oraxen by @tastybento in #2526
• 🔡 Improve teleporting #2524 - this commit has debug. by @tastybento in #2525
• 🔡 Add clickable text and hover text by @tastybento in #2529
• Fix tests, optimize tests, reord imports. by @tastybento in #2530
• Release 2.6.0 by @tastybento in #2527

Full Changelog: 2.5.4...2.6.0

Release 2.5.4

Summary of fixes

• Blueprints and mobs saving
• Purging improvements
• Performance improvements when users log out
• The Command Rank GUI in settings now have locale text that can be customized for each command in the list.
• Creeper damage flag - previously this flag prevented all block damage and damage to the user. Now creepers can still hurt users but will not remove blocks if this flag is on. Note, Creeper Griefing (where a visitor causes a Creeper to explode) still causes no damage.
• Add a BentoBox config option to allow the plugin to run even if island distances are different to the config settings. Previously this would disable BentoBox to avoid weirdness, but it can be overridden. Do not use it unless you know what you are doing.
• Other minor bug fixes

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
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

• Fix bug with saving mobs in blueprints #2497 by @tastybento in #2498
• Protect against null to locations. #2496 by @tastybento in #2499
• Prevent null island worlds from blocking purging. #2500 by @tastybento in #2501
• 🔡Improve command rank GUI with helpful text descriptions #2502 by @tastybento in #2503
• Make the rank clearing async to avoid lag. #2504 by @tastybento in #2505
• 🔺Change how creeper damage flag works. #2507 by @tastybento in #2508
• ⚙️🔺Do not fix island centers by @tastybento in #2510
• NPE fix for #2512 by @tastybento in #2513
• Release 2.5.4 by @tastybento in #2514

Full Changelog: 2.5.3...2.5.4

Release 2.5.3

This release includes a number of bug fixes and optimizations.

• A Major Bug was fixed where the island spawn (made by running the admin command setspawn) was not surviving a server restart.
• [friendly_name] and [gamemode] were not being substituted in locale text as expected. The friendly name is the name of the Game Mode.
• Since the wandering trader arrived on the scene a few years ago, he has been treated as any other villager, but after requests from admins, the wandering trader is now freely available for anyone to trade with on any island
• Players could be invited by accident if a player ran the team invite command with no name. The last invited player would be invited. Other changes were made to clean up invites and make them work better.
• A memory leak bug was fixed with the caching done in the Head Getter, which would be run any time a panel was requested with heads in it.

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. Restart the server
6. You should be good to go!

What's Changed

• Placeholder translation by @tastybento in #2481
• German translation by @gitlocalize-app in #2483
• Allow wandering trader interaction at any time #2484 by @tastybento in #2485
• Fixes #2486 where spawn island was not being saved by @tastybento in #2487
• 2488 team invite bug by @tastybento in #2491
• 2490 head getter memory leak by @tastybento in #2492
• Use a temporary cache for players of 2 hours by @tastybento in #2494
• Release 2.5.3 by @tastybento in #2493

Full Changelog: 2.5.2...2.5.3

Release 2.5.2

Bug fix release. See the below for changes. (Same as 2.5.1 but with a console debug removed)

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. Restart the server
6. You should be good to go!

What's Changed

• Expand crop harvesting #2472 by @tastybento in #2473
• Update RemoveMobsListener.java by @DinoFengz in #2474
• Fix for Boxed Ender Pearl throwing. Fix NPE when setting the protection center (commit: fdbb248)
• Release 2.5.1 by @tastybento in #2477

New Contributors

• @DinoFengz made their first contribution in #2474

Full Changelog: 2.5.0...2.5.1

Release 2.5.1

Bug fix release. See the below for changes.

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. Restart the server
6. You should be good to go!

What's Changed

• Expand crop harvesting #2472 by @tastybento in #2473
• Update RemoveMobsListener.java by @DinoFengz in #2474
• Fix for Boxed Ender Pearl throwing. Fix NPE when setting the protection center (commit: fdbb248)
• Release 2.5.1 by @tastybento in #2477

New Contributors

• @DinoFengz made their first contribution in #2474

Full Changelog: 2.5.0...2.5.1

Release 2.5.0

This release adds support for 1.21.1.

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. Restart the server
6. You should be good to go!

What's Changed

• Provides an API to hide sub-flags #2437 by @tastybento in #2450
• feat: further api improvements to hideWhen by @TreemanKing in #2451
• Handle nulls if they happen by @tastybento in #2457
• More code to clean up when an island is deleted. #2456 by @tastybento in #2458
• Added placeholder to show if a player is on an island or not by @tastybento in #2454
• Add a try around the new API for glow and fallback to old way #2459 by @tastybento in #2461
• Use valueOf as the class is no longer an Enum by @tastybento in #2465
• 1 21 1 updates by @tastybento in #2466
• Version 2.5.0 by @tastybento in #2467

Full Changelog: 2.4.2...2.5.0

Release 2.4.2

This version fixes bugs and features:

• Improved performance when playing games like Boxed (seed world chunk generation should be truly async).
• New placeholders to show lists of trusted and coop players on islands (see https://docs.bentobox.world/en/latest/BentoBox/Placeholders/) for list.
• Added protection against Wind Charge damage or effect on doors, trapdoor, buttons, etc. Note; decorative pots do not appear to be protectable yet from wind charge damage.
• Added CANDLES and BELL_RINGING protection flags.
• Fixed issue with villagers in 1.21 blueprints.
• Adjusted code to be more compatible with StackableItems plugin.

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. Restart the server
6. You should be good to go!

What's Changed

• Prevents Creative players from getting player heads. by @tastybento in #2428
• Update Island.java by @Hephaisto-dev in #2427
• Flags for 1.21 by @tastybento in #2432
• Shift InventoryClickEvent listener to LOW priority #2433 by @tastybento in #2435
• #2442 Fixes issue with loading blueprints with villagers on 1.21 by @tastybento in #2443
• Add try/catch around potioneffects for older servers by @tastybento in #2444
• Fix for #2446 that showed console error when player joined. by @tastybento in #2447
• Add placeholders for trusted and coop island members #2445 by @tastybento in #2448
• Release 2.4.2 by @tastybento in #2449

New Contributors

• @Hephaisto-dev made their first contribution in #2427

Full Changelog: 2.4.1...2.4.2

Release 2.4.1

Bug fix release for 2.4.0 - see that release for the main release notes. If you receive errors in the console on server shutdown with Addons then you should update to the latest release of the Addon, e.g., Level, or AOneBlock.

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
6. Restart the server
7. You should be good to go!

What's Changed

• Adds more island cache methods. Adds tests. by @tastybento in #2415
• Add onDisable override method to Pladdon by @tastybento in #2418
• fix: typo for the nameable entities protection flag by @TreemanKing in #2419
• Fix for name lookup from UUID takes too long by @tastybento in #2425
• Added support for serializing Pairs by @tastybento in #2421
• Release 2.4.1 by @tastybento in #2426

Full Changelog: 2.4.0...2.4.1

Release 2.4.0

This release is for the latest versions of Minecraft, and also brings in experimental support for Multipaper, a fork of Paper that enables multiple servers to run the same worlds. If you plan on using Multipaper, join our Discord server and let us know because addons will also need to be adjusted and it'll be good to know which ones to do.

Other new features:

• BentoBox no longer loads all islands into RAM so for servers with a lot of islands, the memory footprint should be lower. As players join, their islands will be cached until the next server reboot, so plan to do that every so often.
• Purging of islands now includes team islands - it didn't before.
• NPC's can now hit players and won't be prevented by PVP rules.
• Updates to Chinese language files.
• Added %[gamemode]_visited_island_rank% placeholder.
• New flag - handle tamed animals by @TreemanKing

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe.
✔️ Java 17, but recommend to run on Java 21
✔️ Addons may need to be updated to their latest version to work with this version of BentoBox
❌ Note that Multiverse is not compatible with the Boxed game mode addon

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: https://download.bentobox.world.

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. Download the latest versions of all your addons and put them in the Addons folder
5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
6. Restart the server
7. You should be good to go!

What's Changed

• Write the Blueprint bundle meta data to admin info by @tastybento in #2349
• 1.20.6 compatibility by @tastybento in #2348
• Multipaper by @tastybento in #2343
• Add a hook for Multipaper by @tastybento in #2354
• Fixes #2352 obsidian scooping NPE by @tastybento in #2358
• Implement new API for ItemsAdder item deletion by @tastybento in #2353
• Remove an unused Map in cache. by @tastybento in #2361
• Purges based on team members all being offline for too long by @tastybento in #2362
• 2356 better deletion by @tastybento in #2364
• Admin command updates by @tastybento in #2367
• Allow NPC's to hit players by @tastybento in #2368
• Reduces storage of Island objects in the cache #2360 by @tastybento in #2369
• Uses Bukkit version method instead of class names by @tastybento in #2370
• Fixes breaking rooted dirt exploit by @tastybento in #2371
• Avoids loading islands into cache unless they are needed. by @tastybento in #2373
• Fixes creeper ignation by visitors by @BONNe in #2375
• Fixes #2378 where an unknown UUID was yielding null instead of "" by @tastybento in #2379
• Fixes #2377, was not accounting for unknown UUIDs by @tastybento in #2380
• Fixes a bunch of items related to making the cache smaller by @tastybento in #2383
• Update zh-CN.yml by @tastybento in #2386
• Update en-US.yml by @tastybento in #2387
• Protect pumpkins from being sheared by @tastybento in #2388
• Sends messages only once to all players on the island by @tastybento in #2389
• Adds more options around getting islands and caching by @tastybento in #2394
• Added %[gamemode]_visited_island_rank% #2390 by @tastybento in #2395
• Corrected translation errors by @huguyt in #2391
• Shift to using ConcurrentHashMap by @tastybento in #2397
• Added API methods for direct database loads and saves #2396 by @tastybento in #2398
• Add command to teleport users. by @tastybento in #2399
• Fix for #2402 player record was deleted on quit by @tastybento in #2403
• Support nms pasting by @tastybento in #2406
• Rework tests to not break so much with constant definitions by @tastybento in #2407
• Better migration of databases relates to #2404 by @tastybento in #2411
• feat: new flag - handle tamed animals by @TreemanKing in #2412
• Release 2.4.0 by @tastybento in #2414

New Contributors

• @huguyt made their first contribution in #2391
• @TreemanKing made their first contribution in #2412

Full Changelog: 2.3.0...2.4.0