Download File

# BentoBox Changelog ## [3.13.0] — 2026-04-04 ### New Release Highlights * 🔺 **Paper 26.1.1 (Minecraft 26.1.1) support** — BentoBox now recognises Paper's new year-based versioning scheme (`26.x.x`) and no longer shows a compatibility warning. The version parser has been updated to handle the new `getBukkitVersion()` format. BentoBox remains fully compatible with Paper 1.21.5 – 1.21.11 servers. * ⚙️ 🔡 **PAUSE_MOB_GROWTH protection flag** — Minecraft 26.1.1 introduces golden dandelions that can pause or unpause baby mob growth. A new island protection flag lets island owners control who can use this feature. Defaults to members only. Supports both main-hand and off-hand interactions. * 🔡 **MiniMessage locale migration** — All locale files have been migrated from legacy `§`/`&` colour codes to Paper's MiniMessage format (`<green>`, `<bold>`, etc.), with full backward compatibility for existing custom translations. The format of MiniMessage messages can be found [here](https://docs.papermc.io/adventure/minimessage/format/). ### Compatibility ✔️ Paper Minecraft 1.21.5 – 1.21.11 ✔️ Paper Minecraft 26.1.1 ✔️ 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. Restart the server. 5. You should be good to go! > 🔡 **Locale migration note:** All 23 locale files have been migrated to MiniMessage formatting. If you have customised locale files, BentoBox will still handle legacy `§`/`&` codes, but regenerating your locale files is recommended to take advantage of MiniMessage features. ### Legend - 🔡 locale files may need to be regenerated or updated. - ⚙️ config options have been removed, renamed, or added. - 🔺 special attention needed. --- ## New Features ### 🔺 Paper 26.1.1 Support [[PR #2897](https://github.com/BentoBoxWorld/BentoBox/pull/2897)] Paper has adopted a new year-based versioning scheme starting in 2026 (e.g., `26.1.1` instead of `1.21.12`). BentoBox's `ServerCompatibility` version parser has been updated to handle the new `getBukkitVersion()` format (`26.1.1.build.14-alpha`), which includes a `.build.N` suffix that the old parser couldn't strip. `V26_1_1` has been added to the supported versions enum as `COMPATIBLE`. BentoBox continues to compile against the Paper 1.21.11 API and remains compatible with all currently supported 1.21.x versions. ### ⚙️ 🔡 PAUSE_MOB_GROWTH Protection Flag [[PR #2898](https://github.com/BentoBoxWorld/BentoBox/pull/2898)] [[PR #2900](https://github.com/BentoBoxWorld/BentoBox/pull/2900)] Minecraft 26.1.1 added the ability to use a golden dandelion on a baby mob to pause or resume its growth. A new `PAUSE_MOB_GROWTH` island protection flag controls who can do this. The flag defaults to members and above; visitors are blocked. The listener checks `PlayerInteractEntityEvent` for a player holding `GOLDEN_DANDELION` in either hand targeting a baby `Ageable` mob. Uses `Enums.getIfPresent` for the flag icon material so BentoBox remains backward compatible with 1.21.x servers where the item doesn't exist. Translations added to all 23 locale files. ### 🔡 MiniMessage Locale Migration [[PR #2894](https://github.com/BentoBoxWorld/BentoBox/pull/2894)] See: https://docs.papermc.io/adventure/minimessage/format/ All locale files have been migrated from legacy `§`/`&` colour codes and `ChatColor` API usage to Paper's native MiniMessage format. This enables richer formatting (gradients, hover text, click events) and aligns with Paper's direction of deprecating legacy formatting. Backward compatibility is maintained: existing custom locale files using legacy codes will continue to work. Multiple follow-up fixes ensured edge cases were handled correctly: - Mixed MiniMessage/legacy content no longer shows raw tags - Multi-line translations preserve newlines correctly in panel lore - Flag panel rank colours render correctly - Conversation prompts display properly - Rank display maintains backward compatibility with legacy locale files --- ## Bug Fixes ### Fix ItemStack quantity > 99 crash during serialization [[PR #2895](https://github.com/BentoBoxWorld/BentoBox/pull/2895)] Fixed a crash when serialising an `ItemStack` with a quantity greater than 99. The quantity is now clamped to a valid range before serialization. ### Deduplicate lock/ban notification messages [[PR #2892](https://github.com/BentoBoxWorld/BentoBox/pull/2892)] Fixed an issue where players would receive repeated lock/ban notification messages when standing at an island boundary, causing chat spam. ### Fix hex color codes breaking subsequent legacy color codes [[PR #2893](https://github.com/BentoBoxWorld/BentoBox/pull/2893)] Fixed a bug where hex colour codes (e.g., `&#FF0000`) would corrupt subsequent legacy `&` colour codes in the same string. --- ## What's Changed * Fix spam messages on blocked island by deduplicating notifications in LockAndBanListener by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2892 * Fix hex color codes breaking subsequent legacy color codes by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2893 * 🔡 Migrate locale formatting from legacy & codes to MiniMessage by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2894 * Fix ItemStack quantity > 99 crash during serialization by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2895 * 🔺 Add Paper 26.1.1 support by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2897 * ⚙️ 🔡 Add PAUSE_MOB_GROWTH protection flag by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2898 * Enhance PauseMobGrowthListener to support off-hand interactions by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2900 **Full Changelog**: https://github.com/BentoBoxWorld/BentoBox/compare/3.12.0...3.13.0