1.22.0

New in this release

This release changes how islands are deleted to allow Game Modes to be able to use the latest Bukkit custom world generator API that allows various vanilla generation aspects to be used. The approach taken is to have a pristine reference world stored inside the game world folder (in the bentobox folder) that is copied over to the playing world once a reset occurs. The dummy world files act like a cache and should generally never need pruning, but they can be deleted if required because they will be regenerated when required.

Compatibility

✔️ Minecraft 1.18.x to 1.19.3, but optimized with NMS for 1.19.x
✔️ Java 17
✔️ See below for DynMap tips.

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. Restart the server
5. You should be good to go!

Changelog

Legend

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

What's Changed

• Rework SQL database implementation. by @BONNe in #1993
• Register BentoBox World Generator option with MyWorlds by @bergerkiller in #2039
• Mark end portals and gateways as unsafe location. by @BONNe in #2042
• Add and fix tests for end gateway and portal. by @tastybento in #2044
• Fixes #2045. Hides invisible team members from the count. by @tastybento in #2047
• 2046 null player placeholder support by @tastybento in #2048
• Support for 1.19.3 by @tastybento in #2060
• Code cleanup by @tastybento in #2065
• 2049 trees growing outside range by @tastybento in #2050
• Code clean up from Sonar Cloud analysis by @tastybento in #2068
• Remove 1.18.2 from supported version list. by @BONNe in #2074
• Add [owner] in command placeholders #2080 by @tastybento in #2081
• Add variable parsing on reference text by @BONNe in #2073
• Uses seed worlds for deletion purposes by @tastybento in #2084
• 🔡 Update locale of Chinese-Hong Kong (zh-HK) by @JamesMCL44 in #2085
• New version by @tastybento in #2069
• Fixes missing FLAG check on clicking minecart entities (#2031)

New Contributors

• @bergerkiller made their first contribution in #2039
• @JamesMCL44 made their first contribution in #2085

Know issues

During the first run of BentoBox, you will see these worlds being generated and the associated vanilla error:

ERROR]: No key layers in MapLike[{}]

This is expected and not important... Mojang is lazy to fix the message that complains when a "flat" world without any "layers" is created via spigot api. A flat world with empty layers produces that message on first startup even in vanilla Minecraft.

Full Changelog: 1.21.1...1.22.0

DynMap Tips

Dynmap will pick up on the reference worlds that are used for deletion, so to hide them from view, open 'plugins/dynmap/worlds.txt' and add/change the world-section for the world you want to hide. Add the value 'enabled: false' to that world-section, so that you get something like the following:

worlds:
  - name: bskyblock_world_nether-bentobox
    enabled: false
  - name: bskyblock_world_the_end-bentobox
    enabled: false
  - name: bskyblock_world-bentobox
    enabled: false

  - name: acidisland_world-bentobox
    enabled: false
  - name: acidisland_world_the_end-bentobox
    enabled: false
  - name: acidisland_world_nether-bentobox
    enabled: false

  - name: oneblock_world_nether-bentobox
    enabled: false
  - name: oneblock_world_the_end-bentobox
    enabled: false
  - name: oneblock_world-bentobox
    enabled: false

See also this FAQ.

Release 1.21.1

Compatibility

✔️ Minecraft 1.18.x to 1.19.2, but optimized with NMS for 1.19.x
✔️ Java 17

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. Restart the server
5. You should be good to go!

Changelog

Legend

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

What's Changed

• Fixes wrong protection bounding box by @BONNe in #1971
• Fix rare null on invitedPlayer by @HSGamer in #1972
• Support 1.18 negative y by @emmanuelvlad in #1973
• More abstract on World Regenerator by @HSGamer in #1969
• Feat: Filtering spectators from visitors by @emmanuelvlad in #1974
• More abstract on Blueprint Paster by @HSGamer in #1970
• Implement the ability to create ItemStack with Custom Model Data. by @BONNe in #1981
• Move database dependencies to the Spigot Libraries. by @BONNe in #1982
• Fixes Glowing Item frames protection by @BONNe in #1985
• Implement new 1.19 materials and entities by @BONNe in #1990
• Raid abuse fix by @BONNe in #1991
• Fix Actions by @Sliman4 in #1992
• Fixes blueprint pasting messages. by @BONNe in #1979
• Implements adding unknown default island flag values in settings. by @BONNe in #2001
• Check if a unique name contains chars not supported in regex expression by @gmijo47 in #1998
• Proper dimension processing by @BONNe in #2015
• Update Spigot 1.19.2. by @BONNe in #2017
• setBlock & setEntity as CompletableFuture by @HSGamer in #2019
• Rework blueprint and blueprint bundle names. by @BONNe in #2026
• Adds glow berries protection. by @BONNe in #2027
• Use Spigot-only events. by @BONNe in #2029

New Contributors

• @emmanuelvlad made their first contribution in #1973
• @Sliman4 made their first contribution in #1992
• @gmijo47 made their first contribution in #1998

Full Changelog: 1.20.1...1.21.1

Release 1.20.1

Compatibility

✔️ Minecraft 1.17.x to 1.18.1, but optimized with NMS for 1.18.x
✔️ Java 16, runs on Java 17

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. Restart the server
5. You should be good to go!

Changelog

Legend

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

What's Changed

• Address unnecessary PVP reports on each teleport by @BONNe in #1948
• Fixes bug with Safe Spot Teleport by @BONNe in #1951
• Add an option in SafeSpotTeleport to cancel if fail by @BONNe in #1952
• Clearer paster by @tastybento in #1953
• Improve team kick command by @BONNe in #1957
• Solve crashes with Addon#allLoaded call by @BONNe in #1959
• using java 16 syntax by @Invvk in #1958
• Fixes kick command by @BONNe in #1960
• Fixes a bug with blueprint height by @BONNe in #1961
• Fixes Lava Duplication Glitch by @BONNe in #1964
• Fixes failures in obsidian scooping listener. by @BONNe in #1965

New Contributors

• @Invvk made their first contribution in #1958

Full Changelog: 1.20.0...1.20.1

Release 1.20.0

Compatibility

✔️ Minecraft 1.17.x to 1.18.1, but optimized with NMS for 1.18.x
✔️ Java 16, runs on Java 17

Upgrading

If you are on BentoBox 1.19.0 then do this:

1. As always, take backups just in case. (Make a copy of everything!)
2. Stop server
3. Replace the BentoBox jar with this one
4. (OPTIONAL) As there are a number of locale differences, we recommend you delete (or move) the BentoBox/locales folder so that all the files can be regenerated. If you customized any of the files, then you'll need to merge in your changes.
5. Restart the server
6. You should be good to go!

Changelog

Legend

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

What's Changed

New Features

• Add an admin delete homes command by @tastybento #1900 This admin command removes all homes from a specified island.
• ⚙️Optimize safe location searching with configurable range limit #1892 by @HSGamer

Locale Updates

• 🔡Update dates in BentoBox console banner (2e6ef59) by @tastybento
• 🔡German Translation by @gitlocalize-app in #1904
• 🔡Turkish translation by @gitlocalize-app in #1905
• 🔡Dutch translation by @gitlocalize-app in #1906
• 🔡Chinese Translation by @gitlocalize-app in #1907
• 🔡Translate zh-CN.yml via GitLocalize by @gitlocalize-app in #1908
• 🔡Update Vietnamese by @gitlocalize-app in #1910

Bug Fixes

• Fix Biome compatibility on 1.17 by @HSGamer in #1895
• Rework the chunk deletion by @HSGamer in #1897
• fix an exception when cleaning an offline player by @HSGamer in #1898
• ⚙️Flags for Block Explode by @HSGamer in #1899
• Change AbsolutePath to CanonicalPath by @BONNe in #1901
• Fixes a bug that increased all button count by 1 by @BONNe in #1911
• Fixes a bug with on-join commands by @BONNe in #1926
• Implement duplicated actions click type by @BONNe in #1919
• Fixed bug with running onLeave commands by @BONNe in #1929
• Implement multiple panels in single file by @BONNe in #1932
• Fix null in reject invite by @HSGamer in #1933

API Related

• Adds bonus range elements to Island object. by @tastybento in #1921
• Extend ranked commands by @BONNe in #1928
• Templated Panel Title Parameters by @BONNe in #1934
• Implement a flag that rules all flags. by @BONNe in #1927
• Add missing templated panel builder method by @BONNe in #1935
• Implement ACTION defining by ACTION TYPE by @BONNe in #1938

Full Changelog: 1.19.0...1.20.0

Release 1.19.0

This is a bug fix release. See the upcoming BentoBox 1.19.x for Minecraft 1.18.x support.

Compatibility

✔️ Minecraft 1.17.x to 1.18.1, but optimized with NMS for 1.18.x
✔️ Java 16, runs on Java 17

Upgrading

If you are on BentoBox 1.18.1 then do this:

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

Changelog

Legend

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

Change Log

Bug Fixes

• Make BlockEndDragon support custom max world height (#1888) - Use max world height instead of magic 255 value.
• Send PVP toggle messages only to on-island players. (#1885)
• Work with Minecraft 1.18.x

Full Changelog: 1.18.1...1.19.0

Release 1.18.1

This is a bug fix release. See the upcoming BentoBox 1.19.x for Minecraft 1.18.x support.

Compatibility

✔️ Minecraft 1.17.1 (for 1.16.5 compatibility use the 1.16.x release)
✔️ Java 16

This release does mostly work on Minecraft 1.18 except for not being optimized when pasting or deleting islands. Also, the admin range command will cause a bug.

Upgrading

If you are on BentoBox 1.18.1 then do this:

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

Changelog

Legend

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

Change Log

Bug Fixes

• Remove dead paper forks (#1884) (commit: 2d03252)
• Fixes console teleporting. (commit: 6b6ab71)

API

• Added snapshot repo to Maven info. (commit: f3a7ed1)

What's Changed

Full Changelog: 1.18.0...1.18.1

Release 1.16.6 for Minecraft 1.16.5

Compatibility

✔️ Minecraft 1.16.5 - note - this is a release for Minecraft 1.16.5. If you are on 1.17.1 or greater, then use the latest general BentoBox release.
✔️ Java 16

Upgrading

If you are on BentoBox 1.16.5 then this should just be a drop-in replacement, but as always, take backups just in case.

1. Stop server
2. Replace the BentoBox jar with this one
3. Make a backup of your server worlds and the BentoBox folder
4. Restart the server
5. You should be good to go!

Changelog

Legend

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

Change Log

Bug Fixes

• Admin teleport command in console caused an error (Commit: 6b6ab71)
• Sometime island teleport home command did not work. (Commit: 930433b)
• When deleting an island, 1 block around two of the edges could sometimes be left depending on the size of the island. (Commit: 3c65194) #1863
• Island info command was mis-stating the island protection coordinates by 1 (Commit: b5fd992)
• Island range perms could be 2x island distance #1851 (Commit: 3dd9e97) This could allow protection ranges to be much greater than the island range and therefore overflow into adjacent islands.

API

• User.getInstance can no longer be called with a null - this will throw an exception
• You cannot use User#getPlayer if the User is not a player, e.g., the console. Check that it is a player before trying. The same is true with offlinePlayer. Similarly, you cannot ask for a user's location if the user is not a player. #1856
• Deprecated events, like IslandEvents and TeamEvents were removed. If you write your own events then make sure you implement handlers for them!
• Removed the unused WorldEdit hook. (#1853)
• Fix "ugly" enchant name. (#1858)
• Added API to get a translation without color conversion (Commit: af3c0a8) Enables to get the translation without converting colors to Bukkit colors.

Release 1.18.0

This is a bug fix release and also updates and cleans up the BentoBox API.

Compatibility

✔️ Minecraft 1.17.1 (for 1.16.5 compatibility use the 1.16.x release)
✔️ Java 16

Upgrading

If you are on BentoBox 1.17.3 then do this:

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

Changelog

Legend

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

Change Log

Bug Fixes

• Sometime island teleport home command did not work. (Commit: 930433b)
• When deleting an island, 1 block around two of the edges could sometimes be left depending on the size of the island. (Commit: 3c65194) #1863
• Island info command was mis-stating the island protection coordinates by 1 (Commit: b5fd992)
• Island range perms could be 2x island distance #1851 (Commit: 3dd9e97) This could allow protection ranges to be much greater than the island range and therefore overflow into adjacent islands.

API

• User.getInstance can no longer be called with a null - this will throw an exception
• You cannot use User#getPlayer if the User is not a player, e.g., the console. Check that it is a player before trying. The same is true with offlinePlayer. Similarly, you cannot ask for a user's location if the user is not a player. #1856
• Deprecated events, like IslandEvents and TeamEvents were removed. If you write your own events then make sure you implement handlers for them!
• Removed the unused WorldEdit hook. (#1853)
• Fix "ugly" enchant name. (#1858)
• Added API to get a translation without color conversion (Commit: af3c0a8) Enables to get the translation without converting colors to Bukkit colors.

Release 1.17.3

Compatibility

✔️ Minecraft 1.17.1 (for 1.16.5 compatibility use the 1.16.x release
✔️ Java 16

Upgrading

If you are on BentoBox 1.17.2 then do this:

1. As always, take backups just in case. (Make a copy of everything)
2. Stop server
3. Replace the BentoBox jar with this one
4. There are locale changes, so move plugins/BentoBox/locales to plugins/BentoBox/locales.old so the new locales can generate
5. If you customized the locales merge back in your changes.
6. Restart the server
7. You should be good to go!

Changelog

Legend

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

Change Log

New Feature

• 🔺Remove invulnerable visitor protection if island is in PVP mode (commit: 7621677)
• Adds arrow sound when teleporting into a PVP island. (commit: 7d7882c)
• Slimmer trimmer island info for players. (commit: 0f7ca6a)
• 🔡 Implement Flag icon changing via Locales file. (#1829) (commit: fa41abc)
• Hex pr 1820 (#1822) (commit: b906f55)

Bug Fixes

• Fixes a bug when Potion metadata was not applied (#1849) (commit: 6bf3264)
• Fixes Pladdon reloading issue. (#1847) (commit: 23e3554)
• Fixes NPE in admin tp if nether or end worlds don't exist. (commit: 74ded5a)
• Fixes coop and trust invites when team invites are not allowed (commit: 23522a2)
• Prevent home teleport when already home teleporting (commit: 5bb12d5)
• 🔡 Fix German flag banner description. (commit: a9a7673)
• Fix version command to show addon state. (commit: 44f06f2)
• Support glowing ink in blueprints (#1842) (commit: faf351f) (1.17 only)
• Set the default game mode when player makes island. (commit: 876ba91)
• Add Citizens to Softdepend list for NPC support (#1834) (commit: 705693f)

API

• Adds force-shown lines to the template. (#1850) (commit: 9da3293)
• Panel template (#1841) (commit: 2607256)

Release 1.16.5

Compatibility

✔️ Minecraft 1.16.5 - note - this is a release for Minecraft 1.16.5. If you are on 1.17.1 or greater, then use the latest general BentoBox release.
✔️ Java 16

Upgrading

If you are on BentoBox 1.16.2 then this should just be a drop-in replacement, but as always, take backups just in case.

1. Stop server
2. Replace the BentoBox jar with this one
3. Make a backup of your server worlds and the BentoBox folder
4. Restart the server
5. You should be good to go!

Changelog

Legend

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

Change Log

New Feature

• 🔺This brings the 1.16.2 release up to the level of 1.17.3.
• 🔺Remove invulnerable visitor protection if island is in PVP mode (commit: 7621677)
• Adds arrow sound when teleporting into a PVP island. (commit: 7d7882c)
• Slimmer trimmer island info for players. (commit: 0f7ca6a)
• 🔡 Implement Flag icon changing via Locales file. (#1829) (commit: fa41abc)
• Hex pr 1820 (#1822) (commit: b906f55)

Bug Fixes

• Fixes a bug when Potion metadata was not applied (#1849) (commit: 6bf3264)
• Fixes Pladdon reloading issue. (#1847) (commit: 23e3554)
• Fixes NPE in admin tp if nether or end worlds don't exist. (commit: 74ded5a)
• Fixes coop and trust invites when team invites are not allowed (commit: 23522a2)
• Prevent home teleport when already home teleporting (commit: 5bb12d5)
• 🔡 Fix German flag banner description. (commit: a9a7673)
• Fix version command to show addon state. (commit: 44f06f2)
• Support glowing ink in blueprints (#1842) (commit: faf351f) (1.17 only)
• Set the default game mode when player makes island. (commit: 876ba91)
• Add Citizens to Softdepend list for NPC support (#1834) (commit: 705693f)

API

• Adds force-shown lines to the template. (#1850) (commit: 9da3293)
• Panel template (#1841) (commit: 2607256)

Pre 1.17.2

• Prevents repeated portaling when nether is disabled. (#1826) (commit: 32638e7)
• Warns visitors that PVP is active if they teleport to an island (commit: 233c058)
• Prevent bucket duping when scooping obsidian Part 35 (commit: 6b839d9)
• Make spawn protection area square instead of circle. (commit: cf8df9c)
• Quote filename of addon that cannot be loaded. (commit: 3b136f0)
• Implement 3 bar charts: addons, gamemodes, hooks (#1790) (commit: 69f7b49)
• Add world setting flag for island visitors keep inventory (#1785) (commit: 759ba52)
• Parent/sub-flag support, split up and designate CONTAINER flag as parent flag (#1784) (commit: 0f7866a)
• Add Holographic Displays as SoftDepend for AOneBlock (#1794) (commit: 7de6563)
• Custom date time format support for / info (#1783) (commit: f88b8d4)
• Implements better online player counter. (#1791) (commit: 3a1ec0a)
• Add Boxed Gamemode to the list. (#1793) (commit: 4139c5f)
• Add Bank addon (#1792) (commit: 89625a7)
• Add homes command to default player options. (commit: 19ddd73)
• Remove SLIME_SPLIT spawn reason from natural mob spawning flag (#1774) (commit: 7768cc6)
• 🔡 Update es.yml (#1775) (commit: a91203d)