Island Level & Leaderboards

🎁 What's new

Level 2.27.0 introduces an opt-in donations-only mode that skips the island block scan entirely and computes the island level only from blocks donated via /island donate — a major CPU saving on busy servers that prefer a donation-driven economy. The release also adds the new /island donate inv command for one-shot inventory donations, and brings first-class support for custom blocks across the value, detail, and donate menus, so blocks from Oraxen, Nexo, ItemsAdder, and CraftEngine now render with their real icon and display name and can be valued, detailed, and donated like vanilla blocks. A long-standing bug producing negative progression values when using a non-linear level-calc formula is also fixed.

🔺 Level 2.27.0 requires BentoBox 3.16.0 or later.

✨ Highlights

⚙️ Donations-only mode (#432, #433)

• New donations-only option in config.yml (default false). When true, the per-recalculation chunk scan is skipped entirely; the island level is computed from donated points alone using the configured level-calc formula
• /island level, /island top, /island value, and /island donate continue to work; /island detail is not registered (no scanned blocks to break down) and the top-ten panel's viewer button no longer shows "Click to view" or opens the detail panel
• The zero-island scan that runs on island creation/reset still runs under donations-only when zero-new-island-levels: true, so the starter-island handicap is recorded into initialCount and applied correctly if an admin later turns donations-only off
• While donations-only is on, the stored initialCount is ignored at /island level time, so flipping the mode on for a server with existing islands does not push players to wildly negative levels

💎 /island donate inv — donate everything from inventory (#422)

• New confirmable inv subcommand: lists every donatable block in the player's inventory with per-material values and a running total, then on confirm donates them all and runs a level recalc
• Items with no configured value and non-blocks stay in the inventory after donation
• Tab-complete now suggests hand / inv for the first arg, and the held-item count after hand — the previous tab-complete branch never fired in real use
• Help text updated to parameters: "[hand [amount]] [inv]"

🧱 Custom block support across value, detail, and donate menus (#425, #427, #429)

• Oraxen, Nexo, ItemsAdder, and CraftEngine custom blocks are no longer filtered out of /level value or rendered as nameless PAPER icons in /level detail
• The value panel and details panel both look up the real custom-block ItemStack from each plugin's registry, so the configured texture / model data and display name are preserved
• /island value hand on a held custom item now reports the configured value and display name instead of "no value" or the prettified namespaced key
• Donation paths (/island donate hand, /island donate inv, and the donation panel) accept custom-block items, recording donations under the custom ID
• CraftEngine items are now resolved via the new BentoBox CraftEngineHook.getItemId / getItemStack helpers, so they appear with the correct icon and name throughout

🐛 Fixes

• Negative values in island progression when level-calc is a non-linear function (e.g. 3 * sqrt(blocks / level_cost)) — progression no longer dips below zero between levels (#423, thanks @msmith-codes!)

⚡ Performance

• tidyUp() no longer walks up to 10M points linearly on the primary thread when com✨g point boundaries — the forward and backward scans now use binary search (~23 iterations instead of millions), each saving a calculateLevel() string parse + eval per step

⚙️ Compatibility

✔️ BentoBox API 3.16.0 🔺 ✔️ Minecraft 1.21.x and 26.1.x ✔️ Java 21

🔺 Updating — important notes

🔺 BentoBox 3.16.0+ required. This release bumps the api-version in addon.yml to 3.16.0 and depends on the new CraftEngineHook.getItemId / getItemStack helpers. Older BentoBox versions will refuse to load the addon.

⚙️ New donations-only config key. Default is false, so existing servers behave exactly as before. Enable it only if you want a pure-donation economy — read the highlight above for what changes (no detail command, no top-panel viewer click, level driven only by /island donate).

🔡 Locales updated. All 18 shipped locales gained new island.donate.inv.* keys (keyword, confirm-header, confirm-line, confirm-total). If you have customised locale files in plugins/BentoBox/addons/Level/locales/, copy the new donate.inv block into them or the new /island donate inv flow will show raw keys.

📥 How to update

1. Stop the server
2. Back up your BentoBox folder
3. Update BentoBox to 3.16.0 or later
4. Drop the new Level-2.27.0.jar into your addons folder and remove the old one
5. If you have customised locale files, merge in the new island.donate.inv.* keys
6. 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

• 💎 feat: /island donate inv — donate everything from inventory by @tastybento in https://github.com/BentoBoxWorld/Level/pull/422
• 🐛 Fixed: Negative values in progression while using a non-linear function by @msmith-codes in https://github.com/BentoBoxWorld/Level/pull/423
• 🧱 Add custom block support (Oraxen/Nexo/ItemsAdder/CraftEngine) in value, detail, and donate menus by @Copilot in https://github.com/BentoBoxWorld/Level/pull/425
• 🧱 Fix custom-block icon and display name in value panel by @tastybento in https://github.com/BentoBoxWorld/Level/pull/427
• 🧱 fix: recognize CraftEngine items in value lookups by @tastybento in https://github.com/BentoBoxWorld/Level/pull/429
• ⚙️ feat: donations-only mode — skip block scan by @tastybento in https://github.com/BentoBoxWorld/Level/pull/432
• ⚙️ fix: donations-only follow-ups (ignore stored initialCount, still run zero-island scan, gate top-panel viewer) by @tastybento in https://github.com/BentoBoxWorld/Level/pull/433
• ⚡ perf: replace O(N) linear walks with binary search in tidyUp() by @tastybento
• 🔡 i18n: add donate.inv translations across all locales by @tastybento
• 🔺 chore: bump api-version to 3.16.0 / require BentoBox 3.15.1-SNAPSHOT by @tastybento

New Contributors

• @msmith-codes made their first contribution in https://github.com/BentoBoxWorld/Level/pull/423

Full Changelog: https://github.com/BentoBoxWorld/Level/compare/2.26.0...2.27.0