Release 2.24.0

🎁 What's new

Donate your way to the top of the leaderboard. Level 2.24.0 introduces the long-awaited block donation system — players can now permanently contribute blocks to their island's level without having to place them. Drop a stack into the new /island donate GUI, hit confirm, and those points are yours to keep, surviving every future recalculation. Prefer the fast lane? /island donate hand [amount] donates straight from whatever you're holding.

Under the hood, 2.24.0 also brings a major BentoBox platform bump, MiniMessage support across every locale, a brand-new Russian translation, and a handful of correctness fixes that make the top ten leaderboard and several block icons behave properly again.

✨ Highlights

💎 Block donation (#412, #220)

• New /island donate chest-style GUI — drag blocks in, see a live points preview, confirm to donate
• /island donate hand [amount] for one-click donations from the held stack
• New ISLAND_BLOCK_DONATION protection flag gates who can donate. Default is owner-only; configurable down to Member rank (lower ranks are blocked at the flag UI level)
• Donated points are persisted per-island and automatically re-added after every /island level recalculation — no more losing your contribution to a level rebuild
• New DONATED tab in the island detail panel showing donation history
• Admin level report now includes a donated-blocks breakdown
• Legacy islands with no donation data load cleanly — all new fields are null-safe

📊 Smarter level formulas

• New island_members placeholder for the level-cost equation so you can handicap larger teams (#411)
• New {gamemode}_points_to_next_level placeholder for scoreboards and HUDs (#405)

🌐 Localization overhaul

• All locale files migrated to MiniMessage formatting via the BentoBox 3.14.0 bump
• 🆕 Russian (ru.yml) locale added
• Czech, Dutch, French, German, Hungarian, Indonesian, Korean, Latvian, Polish, Portuguese, Simplified Chinese, Spanish, Turkish, Ukrainian, and Vietnamese locales brought up to date with en-US

🐛 Fixes

• Top ten ordering no longer drifts under concurrent writes — replaced LinkedHashMap with ConcurrentHashMap and invalidate the cache on update (#403)
• Block icons for hanging signs, vines, and cave vines now render correctly in value and detail panels (#404)
• Donation panel lore no longer leaks colors across lines, and default italic is stripped from item names

⚙️ Compatibility

✔️ BentoBox API 3.14.0
✔️ Minecraft 1.21.x — if you need older versions, use an older Level release
✔️ Java 21

🔺 Updating — important notes

🔡 Locales. Locale files have been migrated to MiniMessage. Regenerate any customised locale files if you have them, or port your customisations over manually.

🔺 Detail panel template. The DONATED tab is a new entry in panels/detail_panel.yml. Panel templates are not overwritten on upgrade, so existing servers must delete plugins/BentoBox/addons/Level/panels/detail_panel.yml to regenerate it — otherwise the new donation tab will not appear.

⚙️ New flag. ISLAND_BLOCK_DONATION is registered on first start and defaults to owner-only. Adjust in your protection flag panel if you want members to be able to donate.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Drop the new jar into the addons folder and remove the old one
4. Delete plugins/BentoBox/addons/Level/panels/detail_panel.yml so the template regenerates
5. Start the server

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 top ten ordering: replace LinkedHashMap with ConcurrentHashMap for thread safety by @copilot-swe-agent in #403
• Fix incorrect icons for hanging signs, vines, and cave vines in panels by @copilot-swe-agent in #404
• Add {gamemode}_points_to_next_level placeholder by @copilot-swe-agent in #405
• Add Russian (ru) locale with MiniMessage formatting by @copilot-swe-agent in #407
• Add island_members variable to level formula for team-size handicap support by @copilot-swe-agent in #411
• Add block donation feature by @tastybento in #412

Full Changelog: 2.23.0...2.24.0

Release 2.23.0

What's new

• This adds support for Oraxen furniture blocks and Nexo blocks. These are still in beta but this is being released for those who have these plugins to try.

Compatibility

✔️ BentoBox API 3.10.2
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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

• Mockito5 by @tastybento in #393
• Add block limit count placeholder by @tastybento in #394
• Update Paper API to 1.21.11 to match MockBukkit by @tastybento in #399
• Add Oraxen furniture mechanic support for island levelling by @tastybento in #397
• Add Nexo custom block and furniture support for island levelling by @tastybento in #398
• Fix custom block count/value/limit placeholders for Oraxen, Nexo, ItemsAdder #391 by @tastybento in #400
• Release 2.22.1 by @tastybento in #401

Full Changelog: 2.22.0...2.23.0

Release 2.22.0

What's new

• This adds support for Oraxen blocks and items in chests. Requires the latest BentoBox (3.7.4) to run.

Compatibility

✔️ BentoBox API 3.7.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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

• 385 oraxen custom item and block support by @tastybento in #386
• Added value support #385 by @tastybento in #387
• Version 2.22.0 by @tastybento in #388

Full Changelog: 2.21.5...2.22.0

Release 2.21.5

What's new

• This fixes a bug with sorting of blocks in the details panel.

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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 sorting by value in details panel by @PapiCapi in #383
• Release 2.21.5 by @tastybento in #384

Full Changelog: 2.21.4...2.21.5

Release 2.21.4

What's new

• This fixes a bug where if air had a value it was not counted. This mainly affects CaveBlock were air has a value of 1 by default.

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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

• Allow air to be valued by @tastybento in #382
• Version 2.21.4 by @tastybento in #381

Full Changelog: 2.21.3...2.21.4

Release 2.21.3

What's new

• This puts in code to prevent level calculations from hanging if for some reason one fails.

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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

• Release 2.21.3 by @tastybento in #379

Full Changelog: 2.21.2...2.21.3

2.21.2

Bug fix Release

• Bug fix - block limits were not working so blocks above the limit were still counted. With this fix levels may go down when recalculated.

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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

• Limits not working with level addon by @tastybento in #377
• Release 2.21.2 by @tastybento in #378

Full Changelog: 2.21.1...2.21.2

Release 2.21.1

Bug fix Release 2.21.1

• Bug fix - chest and container contents were not counted even if the config had that set.

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. Restart the server
5. 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

• Fixes #373 chest contents not being counted by @tastybento in #374
• Version 2.21.1 by @tastybento in #375

Full Changelog: 2.21.0...2.21.1

Release 2.21.0

New In Release 2.21.0

• New command to view the island detail - this was previously only available via the Top Ten command, but now can be accessed directly.
• Bug fixes for placeholders
• Updated locale files

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. (Optional) Delete or move the old German locale file - plugins/BentoBox/locales/Level/de.yml
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

• 🔡 Update cs.yml by @tastybento in #363
• Fix placeholders not detecting spawner type correctly + close #138 by @Zarkness2 in #364
• Added detail command to access directly #365 by @tastybento in #366
• 🔺Adjust versions to allow backward compatibility by @tastybento in #367
• ⚙️Added config option to disable ItemsAdder support by @tastybento in #368
• Release 2.21.0 by @tastybento in #369

Full Changelog: 2.20.0...2.21.0

Release 2.20.0

New In Release 2.20.0

New Placeholders

The new available placeholders are:

%level_bskyblock_island_value_<Block Name>%
%level_bskyblock_island_value_looking%
%level_bskyblock_island_value_mainhand%
%level_bskyblock_island_count_<Block Name>%
%level_bskyblock_island_count_looking%
%level_bskyblock_island_count_mainhand%

The new count placeholder will provide how many blocks of a specific type you have, counting only the blocks of the same type as the value. It’s important to note that the value returned by the count placeholder is updated only after using the level command. In other words, if you add a new block, it won't show in the count placeholder until you run the command.

New island zeroing approach

The previous approach would zero the level, but could give the user some head start to level 1 because although the level was zeroed, the remaining blocks were not. For example, if the island had a score of 157 and each level cost 100 then the user would start at level 0 but with 57 blocks in hand. This change zeros the remainder as well. It will only affect new islands if zeroing is used.

Compatibility

✔️ BentoBox API 3.2.4
✔️ Minecraft 1.21.x - if you need support for earlier versions, use an older version of Level
✔️ Java 21

Updating

1. Stop server
2. Make a backup of the BentoBox Folder for safety
3. Copy this jar into the Addons folder and remove the old jar
4. (Optional) Delete or move the old German locale file - plugins/BentoBox/locales/Level/de.yml
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

• 🔺More accurate island zeroing by @tastybento in #359
• Add new placeholders by @Zarkness in #357
• 🔡 Fix formatting errors in german locale by @kronnox in #355
• 2.20.0 release by @tastybento in #362

New Contributors

• @Zarkness made their first contribution in #357
• @kronnox made their first contribution in #355

Full Changelog: 2.19.3...2.20.0