
BentoBox
SkyBlock, OneBlock, Boxed, SkyGrid, AcidIsland, CaveBlock, Poseidon, StrangerRealms - and more! These are just some of the island-based game modes that BentoBox powers. From the author of the original ASkyBlock.
3.15.0
release27 апреля 2026 г.Release Highlights
- ⚙️🔺 Island Delete & Purge Overhaul — The system has been completely redesigned: for game modes that are not void worlds, island reset/delete now soft-deletes islands instead of immediately removing blocks, region file cleanup is deferred and batched, and a new
HousekeepingManagerhandles automated cleanup on a configurable schedule. - 🔺 Simplified Purge Commands —
/purge <days>now handles everything in one step (region file deletion included). The old subcommands/purge regions,/purge status, and/purge stophave been removed. - Custom Blueprint Bundle Icons — Blueprint bundles now support custom item model keys (e.g.
myserver:island_tropical) and vanilla namespaced materials (e.g.minecraft:diamond) as icons, enabling resource-pack-driven island selection GUIs. - InvincibleVisitors XP Fix — XP orbs were incorrectly blocked from tracking visitors by the mob-targeting protection; they now properly home in on visitors while the
EXPERIENCE_PICKUPflag still controls whether pickup is allowed.
Compatibility
✔️ Paper Minecraft 1.21.5 – 1.21.12 ✔️ Paper Minecraft 26.1.1 – 26.1.2 ✔️ Java 21+
Upgrading
- Take backups. (Make a copy of everything!)
- Stop the server.
- Replace the BentoBox jar with this one.
- Restart the server.
- The
keep-previous-island-on-resetconfig setting has been removed — all resets now soft-delete. Remove it from your game mode configs to avoid warnings. - You should be good to go!
🔺 Purge command changes:
/purge regions,/purge status, and/purge stopno longer exist. The top-level/purge <days>command now identifies stale islands and deletes their region files in one pass. Update any scripts or documentation that reference the old subcommands.
⚙️ Config removal:
keep-previous-island-on-resethas been removed. All island resets now soft-delete (equivalent to the oldfalsebehaviour, but with deferred disk cleanup). If you previously relied onkeep-previous-island-on-reset: trueto preserve old islands, use/purge protecton islands you want to keep.
🔡 Locale changes: Several purge-related locale keys have been removed, renamed, or updated. New keys for the
deletedsubcommand have been added. Regenerate or update your locale files.
Legend
- 🔡 locale files may need to be regenerated or updated.
- ⚙️ config options have been removed, renamed, or added.
- 🔺 special attention needed.
New Features
⚙️🔺 Island Delete System Overhaul
The system has been fundamentally redesigned for reliability and safety. Island resets in non-void worlds now always soft-delete (setting a deletable flag) rather than immediately destroying chunks. A new HousekeepingManager runs on a configurable schedule to sweep region files for soft-deleted islands and free disk space asynchronously.
IMPORTANT: The server can store a lot of the world chunks in RAM and so the Housekeeping or Purging will not appear to do anything until you restart the server. Please do not report that an island is not deleting until you have restarted the server.
The new /purge <days> command now identifies and deletes region files in one step — the previous behaviour only set the deletable flag in the database, leaving region files on disk until a separate /purge regions run. The new /purge deleted subcommand reaps region files for any island already flagged as deletable, regardless of age. /purge unowned now flags orphaned islands and prompts the admin to run /purge deleted afterwards. Again, the changes will not be seen in-game until server restart.
For game modes that use non-void world generation (Boxed, AcidIsland, CaveBlock, etc.), AdminDeleteCommand now soft-deletes and defers physical cleanup; simple void/overworld game modes (AOneBlock, BSkyBlock, etc.) keep the existing DeleteIslandChunks path. Island database rows are removed at server shutdown after region files are confirmed gone, ensuring crash-safe recovery.
The keep-previous-island-on-reset config setting has been removed — all resets now soft-delete by default.
💎 Custom Blueprint Bundle Icons
The "icon" field in blueprint bundle JSON files now accepts three formats:
- Plain material name (existing):
"icon": "DIAMOND" - Vanilla namespaced material (new):
"icon": "minecraft:diamond" - Custom item model key (new):
"icon": "myserver:island_tropical"
Custom model keys are applied to a PAPER base item using ItemMeta.setItemModel(), allowing resource-pack-defined icons to appear on island selection panels. A new getIconItemStack() API method returns the full ItemStack with model data applied; the existing getIcon() method returning Material remains unchanged for addon compatibility.
Bug Fixes
InvincibleVisitors: XP Orbs Blocked from Tracking Visitors
[PR #2948]
InvincibleVisitorsListener cancelled EntityTargetLivingEntityEvent for any entity targeting a visitor — including XP orbs. Since XP orbs use this event to home in on players, visitors could never pick up XP even when the EXPERIENCE_PICKUP flag allowed it. The fix skips cancellation when the entity is an ExperienceOrb; the flag listener remains responsible for controlling whether pickup is actually granted.
BungeeCord Hex Colour Not Recognised in Legacy Conversion
BungeeCords &#RRGGBB hex colour format was not being recognised in legacyToMiniMessage, causing hex colours from BungeeCord-formatted strings to fall through as literal text. The parser now handles this format correctly.
Spurious defaultRank Warnings for PVP Setting Flags
PVP-related setting flags were triggering incorrect defaultRank warning log messages on startup. These warnings were harmless but noisy; the condition is now correctly filtered.
Other Improvements
- 🔡 Accept underscore locale filenames by auto-renaming to BCP-47 hyphen form on startup (e.g.
pt_BR.yml→pt-BR.yml) — carries forward from 3.14.2 [PR note] - 🔡 Fix typo in Japanese locale file for block count message
- Add
PURGEDevent reason; fireIslandDeleteEventimmediately on soft-delete so addons receive timely notification - Add warning logs when island grid is null to aid debugging of rare world-unload edge cases
- Extract
AbstractPurgeCommandbase class to remove duplication across purge subcommands - Remove accidentally committed
.paper-nms/build artifact and add to.gitignore[PR #2942]
FAQ: Island Delete & Purge for Admins
Island Delete
Q: I ran /bbox admin delete <player> but the island is still visible. Why?
It depends on your game mode. For game modes that use custom chunk generation — Boxed, AcidIsland, CaveBlock, and similar — the island is soft-deleted: it is marked as deletable in the database but its chunks remain on disk. The actual .mca region files are cleaned up later by the HousekeepingManager (if enabled) or when you run /purge deleted. Even after the files are deleted, Papers in-memory chunk cache means the island may still appear in-game until the next server restart. This is normal — do not report the island as not deleting until you have restarted.
Q: Why soft-delete instead of immediately removing chunks?
For worlds with non-trivial terrain (AcidIslands ocean, Boxeds generated box, CaveBlocks cave world), chunk regeneration is slow and expensive. Soft-delete defers the work safely: the island is immediately invisible to the gameplay systems (it can no longer be claimed or teleported to), and disk cleanup happens when the server has breathing room. It also means a crash before cleanup leaves data intact — the island stays deletable and is picked up by the next purge cycle.
Q: My game mode (BSkyBlock, AOneBlock) deletes island chunks immediately. Why is it different?
Void-world game modes use the DeleteIslandChunks / WorldRegenerator path, which regenerates the island area back to void immediately. Since there is no complex terrain to preserve, this is fast and safe. Soft-delete was not needed.
Q: Can I recover a soft-deleted island before the region files are reaped?
Yes — if the region files have not yet been deleted, you can clear the deletable flag via the database or an admin command and the island will be restored. Once the region files are gone, however, only a backup can save it. Take backups before mass deletes.
Purge
Q: What does /purge <days> do exactly?
It scans every .mca region file in the current game modes world (overworld, and nether/end if island-nether/end is enabled) that is older than <days> days. It then filters out:
- regions containing the spawn island
- regions containing purge-protected islands (
/purge protect) - regions containing islands whose owner logged in within
<days>days - regions containing islands above the configured Level addon threshold (if installed)
The remaining regions are shown in the server log with a summary, and you are asked to type confirm before anything is deleted.
Q: What is the difference between /purge <days> and /purge deleted?
| Command | Filter | What it deletes |
|---|---|---|
/purge <days> | Region files older than N days, minus active/protected islands | .mca files (plus player data for absent players) |
/purge deleted | Islands flagged deletable in the DB (from resets, soft-deletes) | .mca files for those islands regions |
Use /purge <days> for periodic housekeeping of abandoned islands. Use /purge deleted to immediately reap region files for islands that have already been marked for deletion (e.g. after a batch of /is reset or /admin delete operations).
Q: How do I delete orphaned (unowned) islands?
Run /purge unowned. This flags every unowned, non-protected, non-spawn island in the world as deletable (with confirmation). Then run /purge deleted to reap their region files. Restart the server to see the changes.
Q: I ran the purge but the island chunks are still visible in-game. What happened?
Paper caches chunk data in RAM. The .mca files have been deleted from disk, but the cache still has them until the server shuts down cleanly. Restart the server — on the next start, Paper will find no region file and treat those chunks as empty/void. This is expected behaviour, not a bug.
Q: What is the HousekeepingManager and how do I configure it?
HousekeepingManager is an automated background task that runs the purge on a schedule without admin intervention. It has two independent cycles:
- Age sweep — runs every
interval-daysdays and behaves like/purge <days>using the configuredregion-age-daysvalue. - Deleted sweep — runs every
deleted-interval-hourshours and behaves like/purge deleted, reaping region files for any island already flaggeddeletable.
Both cycles are disabled by default (housekeeping.enabled: false). Enable and configure them in your BentoBox config.yml under the housekeeping section.
Q: What does /purge protect do, and when should I use it?
It marks an island as purge-protected, permanently exempting it from all purge operations regardless of owner activity or region file age. Use it for community builds, showcase islands, or any island you never want auto-cleaned.
Q: What is /purge age-regions?
This is a developer/testing utility that artificially ages the per-chunk timestamps inside .mca files so they become candidates for /purge <days> without waiting real time. It is not intended for production use — it exists to make testing the purge pipeline practical.
Whats Changed
- feat: support item model keys and namespaced materials for blueprint bundle icon by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2941
- chore: remove accidentally committed
.paper-nms/directory and add to.gitignoreby @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2942 - ⚙️🔺 Purge region files for soft-deleted islands by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2933
- 🔺 Merge /purge regions into /purge; drop status/stop; simplify /purge unowned by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2949
- 💎 feat: support item model keys and namespaced materials for blueprint bundle icon by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2941
- Fix: InvincibleVisitors mob-targeting protection incorrectly blocks XP orbs from tracking visitors by @app/copilot-swe-agent in https://github.com/BentoBoxWorld/BentoBox/pull/2948
- chore: remove accidentally committed
.paper-nms/directory and add to.gitignoreby @app/copilot-swe-agent in https://github.com/BentoBoxWorld/BentoBox/pull/2942
Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.14.2...3.15.0
3.14.2
release15 апреля 2026 г.A small bug-fix release for 3.14.0. If you're upgrading from 3.13.x or earlier, see the 3.14.0 changes below — they all apply to this release.
Compatibility
✔️ Paper Minecraft 1.21.5 – 1.21.12 ✔️ Paper Minecraft 26.1.1 – 26.1.2 ✔️ Java 21+
Upgrading
- Take backups. (Make a copy of everything!)
- Stop the server.
- Replace the BentoBox jar with this one.
- Restart the server.
🔡 Locale file rename: If your server has locale files named with underscores (e.g.
pt_BR.yml), BentoBox will automatically rename them to the BCP-47 hyphen form (pt-BR.yml) on first startup. No manual action needed — check your logs for the rename notice.
3.14.2 Bug Fixes
Fix hex colour codes broken by BungeeCord round-trip
The &#RRGGBB hex colour format stopped working in 3.14.1. The root cause was a double-conversion: translateColorCodes serialises hex colours to the BungeeCord §x§R§R§G§G§B§B repeated-character format, but legacyToMiniMessage (called when rendering the message) didn't recognise that format — so &x was silently dropped and each following &R digit was misread as a named colour code (&2 → dark green, &3 → dark aqua, …), producing completely wrong colours. Fixed by normalising the BungeeCord format back to &#RRGGBB before processing.
🔡 Accept underscore locale filenames instead of ignoring them
[d2dd28e2]
Locale files named with underscores (e.g. pt_BR.yml, en_US.yml) are not valid BCP-47 language tags and were silently ignored since 3.14.0, causing those translations to go missing. BentoBox now automatically renames them to the correct hyphen form (pt-BR.yml) on startup and logs a warning. If a correctly-named file already exists, the underscore copy is reported as a duplicate and skipped.
Fix spurious "defaultRank below minimumRank" warnings
[bdc20675]
SETTING and WORLD_SETTING flags (such as the PVP flag) were incorrectly triggering a startup warning about defaultRank being below minimumRank. These flag types legitimately use -1 as a disabled state (Island.isAllowed treats >= 0 as enabled), so the rank-clamping check now only applies to PROTECTION flags.
3.14.2 Other Changes
- Add Paper Minecraft 26.1.2 (1.21.12) to the compatibility list.
Legend
- 🔡 locale files may need to be regenerated or updated.
What's Changed
- Fix hex colour codes broken by BungeeCord round-trip by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2944
- 🔡 Accept underscore locale filenames instead of ignoring them by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2944
- Fix spurious "defaultRank below minimumRank" warnings by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2944
- Add Minecraft 26.1.2 / 1.21.12 compatibility by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2944
Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.14.1...3.14.2
3.14.1
release12 апреля 2026 г.A small bug-fix release for 3.14.0. If you're upgrading from 3.13.x or earlier, see the 3.14.0 changes below — they all apply to this release.
Compatibility
✔️ Paper Minecraft 1.21.5 – 1.21.11 ✔️ Paper Minecraft 26.1.1 ✔️ Java 21+
Upgrading
- Take backups. (Make a copy of everything!)
- Stop the server.
- Replace the BentoBox jar with this one.
- Restart the server.
📄 Coming from 3.13.x? Existing
.blublueprint files will continue to load alongside the new.blueprintJSON format introduced in 3.14.0 — no migration step required.
🔡 Coming from 3.13.x? All 22 non-English locale files were corrected in 3.14.0. If you use customised locale files, regenerating them is recommended.
3.14.1 Bug Fixes
Fix </green> leaking as literal text in flag setting tooltips
[594aaf04]
User.convertToLegacy was splitting mixed MiniMessage/legacy strings on \n before parsing, so a multi-line tag span like <green>foo\nbar</green> was processed as two independent lines — the second line had a closing tag with no opening, and MiniMessage rendered </green> as literal text in the lore. The whole string is now parsed as a single unit so the tag span stays balanced. The now-unnecessary <green>...</green> wrapper around [description] in the flag description/menu/setting layouts has also been dropped from every bundled locale file.
Fix lava-tip hologram showing raw <orange> MiniMessage tags
[2bba02bb]
The 3.14.0 obsidian-scooping lava-tip locale entry used <orange>, which is not a valid MiniMessage named colour — Minecraft's named-colour set tops out at <gold>. MiniMessage left the unknown tag as literal text, so the hologram rendered <orange>Scoop this up with a bucket</orange> verbatim. Switched to <gold> to match the Minecraft colour palette and the rest of the locale conventions.
3.14.1 Other Changes
Flag.Builder minimumRank API
[PR #2936]
New Flag.Builder.minimumRank(int) lets addons declare the lowest rank that may be selected for a PROTECTION flag (defaults to VISITOR_RANK, fully backwards-compatible). The auto-assigned CycleClick listener is constructed with the configured minimum so the settings-panel click-cycle won't let players select ranks below it. build() clamps defaultRank up to minimumRank (with a logged warning) so a misconfigured flag still has a selectable default. Adds Flag.getMinimumRank() and Flag.getClickHandler() getters. Binary-compatible — additive only.
Internal: expanded test coverage
Several internal subsystems received substantial test-coverage improvements (no behaviour change):
IslandsManager(51% → 64.6%)LocalesManager(40% → 49.2%)YamlDatabaseHandler(13% → 72%)AddonsManager(26% → 46%)BlueprintsManager,BlueprintClipboard,SafeSpotTeleport,WebManager,Util,ItemParser
Documentation: CLAUDE.md now documents the MiniMessage ↔ legacy round-trip pitfalls that produced the two bugs above.
3.14.0 changes
The full 3.14.0 changelog is reproduced below for anyone upgrading from 3.13.x or earlier.
Release Highlights
- ⚙️ Island Defaults tab in Admin Settings — A new GUI tab lets admins view and edit default island protection flags directly from the settings panel — no config editing required.
- 🔡 Message delivery type tags — Locale strings now support
[actionbar],[title],[subtitle], and[sound:name:volume:pitch]tags, letting you control exactly how messages are displayed to players. - ⚡ Chunk pre-generation — A new background chunk pre-generation system warms island chunks ahead of time, eliminating lag spikes on first visit. Disabled by default.
- 💡 Obsidian scooping lava tip — A floating hologram appears above newly formed scoopable obsidian, teaching players they can scoop it. Disappears when scooped or after a configurable timeout.
- 🔡 Flag state placeholders — New placeholders expose every flag's enabled/disabled state for use with PlaceholderAPI (e.g.,
%bskyblock_flag_PVP_OVERWORLD%). - 📄 Plain JSON blueprints — Blueprints are now stored as human-readable
.blueprintJSON files instead of zipped.blubinaries. Existing.blufiles are loaded automatically with full backward compatibility. - 🔺 Minecraft 26.1.1 region purge support — Island deletion now handles Minecraft 26.1.1's updated world file structure.
Legend
- 🔡 locale files may need to be regenerated or updated.
- ⚙️ config options have been removed, renamed, or added.
- 🔺 special attention needed.
New Features (3.14.0)
📄 Plain JSON Blueprint Format — PR #2911
Blueprints have been switched from a zipped binary .blu format to plain JSON .blueprint files. This makes blueprints human-readable, diffable, and easy to edit in any text editor. Existing .blu files are detected and loaded automatically — no migration step required.
⚙️ Island Defaults Tab in Admin Settings GUI — PR #2912
A new "Island Defaults" tab has been added to the Admin Settings panel, letting admins view and modify default protection flags for new islands directly through the GUI.
🔡 Message Delivery Type Tags — PR #2910
Locale strings now support [actionbar], [title], [subtitle], and [sound:name:volume:pitch] tags placed at the start of locale values to control how messages are shown to players.
⚡ Chunk Pre-Generation Manager — PR #2916
A new chunk pre-generation system can warm island area chunks in the background, eliminating lag when players first visit. Disabled by default in config.yml.
💡 Obsidian Scooping Lava Tip Hologram — PR #2915
When scoopable obsidian forms (lava + water on an island), a small floating hologram now appears above the block to teach players they can pick it up. Removed when scooped or after a configurable duration. (See 3.14.1 fix above for the <orange> tag bug.)
🔡 Flag State Placeholders — PR #2913
New PlaceholderAPI placeholders expose the enabled/disabled state of every protection, setting, and world setting flag.
⚙️ MythicMobs Hook: Configurable Delay & Callback — PR #2929
The MythicMobs integration now supports a configurable delay for mob spawning and a callback that fires once the mob has been spawned.
🔺 Minecraft 26.1.1 Region Purge Support — PR #2902
Island deletion's region file purge now handles Minecraft 26.1.1's updated world file structure.
Bug Fixes (3.14.0)
- Fix MiniMessage formatting on panel items — PR #2903 — default italic and cross-nested tag handling in the legacy-to-MiniMessage converter.
- Fix bold and decoration leaking across legacy round-trip — PR #2918 (fixes #2917) — bold/italic/underlined/strikethrough/obfuscated leaking into subsequent text segments.
- Fix bold formatting leaking past prefix substitution — PR #2907
- Fix extra blank line in confirmation prompts — PR #2927 (fixes #2919)
- Preserve addon placeholders across
/bbox reload— PR #2931, PR #2932 (fixes #2930) - Skip locale files with invalid BCP-47 tags — PR #2928
- Hide tooltip clutter in all panels — PR #2924 — banner patterns, potion effects, etc. hidden via the modern
TooltipDisplaydata component API. - Fix locale corrections across 22 languages — PR #2905
- Preserve mid-text spaces in legacy/MiniMessage round-trip
- Support MiniMessage in welcome sign locale entries
- Defer island saves while settings panel is open — PR #2926
Other Improvements (3.14.0)
- Improved warning messages for incompatible addons in AddonsManager
- Updated Russian locale translations — PR #2925
- Added test coverage for
visited_island_rankplaceholder — PR #2909 - Extended decoration leak tests to cover all five decoration types — PR #2920
Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.14.0...3.14.1
3.14.0
release10 апреля 2026 г.BentoBox Changelog
[3.14.0] — 2026-04-10
Release Highlights
- ⚙️ Island Defaults tab in Admin Settings — A new GUI tab lets admins view and edit default island protection flags directly from the settings panel — no config editing required.
- 🔡 Message delivery type tags — Locale strings now support
[actionbar],[title],[subtitle], and[sound:name:volume:pitch]tags, letting you control exactly how messages are displayed to players. - ⚡ Chunk pre-generation — A new background chunk pre-generation system warms island chunks ahead of time, eliminating lag spikes on first visit. Disabled by default.
- 💡 Obsidian scooping lava tip — A floating hologram appears above newly formed scoopable obsidian, teaching players they can scoop it. Disappears when scooped or after a configurable timeout.
- 🔡 Flag state placeholders — New placeholders expose every flag's enabled/disabled state for use with PlaceholderAPI (e.g.,
%bskyblock_flag_PVP_OVERWORLD%). - 📄 Plain JSON blueprints — Blueprints are now stored as human-readable
.blueprintJSON files instead of zipped.blubinaries. Existing.blufiles are loaded automatically with full backward compatibility. - 🔺 Minecraft 26.1.1 region purge support — Island deletion now handles Minecraft 26.1.1's updated world file structure.
Compatibility
✔️ Paper Minecraft 1.21.5 – 1.21.11
✔️ Paper Minecraft 26.1.1
✔️ Java 21+
Upgrading
- As always, take backups just in case. (Make a copy of everything!)
- Stop the server.
- Replace the BentoBox jar with this one.
- Restart the server.
- Existing
.blublueprint files will continue to work — they are loaded transparently alongside the new.blueprintformat. - You should be good to go!
📄 Blueprint migration note: Blueprints are now saved in plain JSON
.blueprintformat. Your existing.blufiles will continue to load, but new saves will use the new format. This makes blueprints easy to inspect, version-control, and share.
🔡 Locale note: All 22 non-English locale files received corrections for mistranslations, broken tags, and untranslated strings. If you use customised locale files, regenerating them is recommended.
Legend
- 🔡 locale files may need to be regenerated or updated.
- ⚙️ config options have been removed, renamed, or added.
- 🔺 special attention needed.
New Features
📄 Plain JSON Blueprint Format
[PR #2911]
Blueprints have been switched from a zipped binary .blu format to plain JSON .blueprint files. This makes blueprints human-readable, diffable, and easy to edit in any text editor. Existing .blu files are detected and loaded automatically — no migration step required. New blueprint saves use the .blueprint extension.
Includes filename length validation to guard against excessively long blueprint names on disk.
⚙️ Island Defaults Tab in Admin Settings GUI
[PR #2912]
A new "Island Defaults" tab has been added to the Admin Settings panel. This lets admins view and modify the default protection flag settings for new islands directly through the GUI, without needing to edit configuration files manually.
🔡 Message Delivery Type Tags
[PR #2910]
Locale strings now support delivery type tags that control how messages are shown to players:
[actionbar]— display as an action bar message[title]— display as a title[subtitle]— display as a subtitle[sound:name:volume:pitch]— play a sound alongside the message
Tags are placed at the start of locale values and are stripped before rendering the text content.
⚡ Chunk Pre-Generation Manager
[Commits]
A new chunk pre-generation system can warm island area chunks in the background, eliminating lag when players first visit. The system defers work until after server load and runs asynchronously to avoid main-thread stalls. Disabled by default in config.yml — enable it if your server has the resources.
💡 Obsidian Scooping Lava Tip Hologram
[PR #2915]
When scoopable obsidian forms (lava + water on an island), a small floating hologram now appears above the block to teach players they can pick it up. The hologram is removed immediately when the obsidian is scooped, or after a configurable duration.
🔡 Flag State Placeholders
[PR #2913]
New PlaceholderAPI placeholders expose the enabled/disabled state of every protection, setting, and world setting flag. Useful for scoreboards, tab lists, and addon integrations.
⚙️ MythicMobs Hook: Configurable Delay & Callback
[PR #2929]
The MythicMobs integration now supports a configurable delay for mob spawning and a callback that fires once the mob has been spawned, enabling addons to interact with spawned MythicMobs entities.
🔺 Minecraft 26.1.1 Region Purge Support
[PR #2902]
Island deletion's region file purge now handles Minecraft 26.1.1's updated world file structure, ensuring island chunks are properly cleaned up on the newer Paper builds.
Bug Fixes
Fix MiniMessage formatting on panel items
[PR #2903]
Fixed default italic being applied to panel items and corrected cross-nested tag handling in the legacy-to-MiniMessage converter.
Fix bold and decoration leaking across legacy round-trip
Fixed bold, italic, underlined, strikethrough, and obfuscated decorations leaking into subsequent text segments when MiniMessage content is round-tripped through legacy colour codes. A custom component walker now emits §r resets where Adventure's built-in serializer does not.
Fix bold formatting leaking past prefix substitution
[PR #2907]
Fixed bold text from [prefix] substitutions continuing into the message body by appending a §r reset after the prefix.
Fix extra blank line in confirmation prompts
Fixed an unwanted blank line appearing in conversation-style confirmation prompts.
Preserve addon placeholders across /bbox reload
[PR #2931] [PR #2932] Fixes #2930
Addon-owned and game-mode placeholders are no longer lost when running /bbox reload.
Skip locale files with invalid BCP-47 tags
[PR #2928]
Locale files with names that aren't valid BCP-47 language tags are now silently skipped instead of causing errors or blank entries in the locale selection panel.
Hide tooltip clutter in all panels
[PR #2924]
Banner patterns, potion effects, and other item-specific tooltip data are now hidden in all BentoBox GUI panels using the modern TooltipDisplay data component API.
Fix locale corrections across 22 languages
[PR #2905]
Mistranslations, broken colour/formatting tags, untranslated strings, and typos corrected across all 22 non-English locale files.
Preserve mid-text spaces in legacy/MiniMessage round-trip
Fixed spaces being collapsed when converting between legacy and MiniMessage formatting, preserving intended whitespace in translated strings.
Support MiniMessage in welcome sign locale entries
Welcome signs on island creation now correctly render MiniMessage-formatted locale strings.
Defer island saves while settings panel is open
[PR #2926]
Island data is no longer saved on every settings click. Saves are deferred until the settings panel is closed, and a click cooldown prevents accidental rapid toggling.
Other Improvements
- Improved warning messages for incompatible addons in AddonsManager
- Updated Russian locale translations [PR #2925]
- Added test coverage for
visited_island_rankplaceholder [PR #2909] - Extended decoration leak tests to cover all five decoration types [PR #2920]
What's Changed
- Support Minecraft 26.1.1 world file structure in region purge by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2902
- Fix MiniMessage formatting: default italic on panel items and tag nesting by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2903
- 🔡 Fix all 22 locale files: mistranslations, broken tags, untranslated strings by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2905
- Fix bold formatting leaking past prefix substitution by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2907
- Add test coverage for
visited_island_rankplaceholder by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2909 - 🔡 Add message delivery type tags (actionbar, title, subtitle, sound) by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2910
- 📄 Switch blueprints from zipped .blu to plain JSON .blueprint format by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2911
- ⚙️ Add Island Defaults tab to Admin Settings GUI by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2912
- 🔡 Add flag state placeholders for game mode addons by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2913
- 💡 Add lava tip hologram when scoopable obsidian forms by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2915
- Fix bold (and other decorations) leaking across legacy round-trip by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2918
- Extend decoration leak tests by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2920
- Hide additional item tooltips in panels via TooltipDisplay API by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2924
- Update Russian text by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2925
- Defer island saves while settings panel is open; click cooldown by @Copilot in https://github.com/BentoBoxWorld/BentoBox/pull/2926
- Fix #2919: extra blank line in confirmation prompts by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2927
- Skip locale files with invalid BCP-47 tags by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2928
- ⚙️ Make MythicMobs spawn delay configurable by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2929
- Preserve addon placeholders across /bbox reload by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2931
- Don't clear gamemode addon placeholders on reload by @tastybento in https://github.com/BentoBoxWorld/BentoBox/pull/2932
Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.13.0...3.14.0
3.13.0
release4 апреля 2026 г.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 newgetBukkitVersion()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.
Compatibility
✔️ Paper Minecraft 1.21.5 – 1.21.11
✔️ Paper Minecraft 26.1.1
✔️ Java 21+
Upgrading
- As always, take backups just in case. (Make a copy of everything!)
- Stop the server.
- Replace the BentoBox jar with this one.
- Restart the server.
- 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]
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
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] 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]
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]
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]
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