方块插件库
BentoBox 图标

Minecraft 服务端插件

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.

游戏机制小游戏paperpurpurspigot
版本范围
1.19.4–26.2
下载量
2.9 万

插件介绍

SkyBlock, OneBlock, AcidIsland, and more — all in one plugin

BentoBox powers island-style game modes for Paper servers. Pick the game modes you want, drop them in, and you're running. No forks, no outdated code — one actively maintained platform that stays current with every Minecraft release.

Game modes available:

  • BSkyBlock — classic SkyBlock, successor to the original ASkyBlock
  • AOneBlock — the popular OneBlock experience
  • AcidIsland — survive in a sea of acid
  • Boxed — expand your world by completing advancements
  • CaveBlock — underground survival
  • SkyGrid — scattered blocks, maximum adventure
  • Poseidon — underwater island challenge
  • And more community-created game modes

Why server admins choose BentoBox:

  • Run multiple game modes on one server with shared features (challenges, warps, levels, leaderboards)
  • 20+ addons let you customize exactly the experience you want
  • Actively maintained and always up to date with the latest Minecraft version
  • Free and open source — used on 1,100+ servers worldwide
  • Rich API for developers who want to build custom addons

Browse all BentoBox Addons | Full Documentation

Installation

  1. Place the BentoBox jar in your plugins folder
  2. Start the server
  3. Download the game mode and feature addons you want from this site or download.bentobox.world and place them in the plugins/BentoBox/addons folder
  4. Restart the server — you're good to go

NOTE: Older versions supported Spigot, but now we can only support Paper.

OneBlock
OneBlock
SkyBlock
SkyBlock
SkyGrid
SkyGrid
SkyBlock
SkyBlock
SkyBlock
SkyBlock

版本与下载

推荐下载

BentoBox-3.20.0.jar版本 3.20.0 · 2.4 MBSHA-1 aab9881e0b2bc6605d8f55bd5079f063e3ad9cd9下载 BentoBox-3.20.0.jar

3.20.0

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1 · 26.1.2 · 26.2
BentoBox-3.20.0.jar2.4 MBSHA-1 aab9881e0b2bc6605d8f55bd5079f063e3ad9cd9获取文件 BentoBox-3.20.0.jar
展开更新日志

BentoBox 3.20.0

A quality-of-life release. Players who mistype a command now get a clickable "did you mean…?" suggestion instead of a wall of help text, every game-mode world can suppress vanilla structures from core (fixing the long-standing /locate freeze), and BentoBox gains hooks for Nexo and richer Oraxen custom-block placement.

Compatibility

✔️ Paper Minecraft 1.21.5 – 26.2 ✔️ Java 25+

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. Start the server.
  5. ⚙️ Two new config areas are added on first run — general.did-you-mean (both toggles default on) and world.disabled-structures (empty by default, so structure generation is unchanged unless you opt in). Review them if you want to change the defaults.
  6. 🔡 Three new general.did-you-mean locale keys were added to every bundled language. If you maintain custom locale files, regenerate or add these keys.

Highlights

  • 🔡 ⚙️ Did-you-mean command suggestions — a mistyped command like /teams or /island invit now offers the closest matching BentoBox command, clickable or accept-by-typing-yes, instead of an unknown-command error.
  • ⚙️ Core vanilla-structure suppression — any game mode can now disable vanilla structures from a single core config list, ending the /locate main-thread freeze and near-spawn structure leaks per-addon fixes used to require.
  • Nexo hook — BentoBox can now place and detect Nexo custom blocks and items.
  • Oraxen block placement — OraxenHook.placeBlock exposes Oraxen custom-block placement to addons.

New Features

🔡 ⚙️ Did-you-mean command suggestions

[PR #3029] — Fixes #3027

When a player mistypes a command, BentoBox now suggests the closest match instead of dumping help:

Player typesThey get
/teamsDid you mean /oneblock team? Click here or type yes to run it.
/team invite FlorisDid you mean /oneblock team invite Floris? — arguments survive
/oneblock invit FlorisDid you mean /oneblock team invite Floris? — instead of the unknown-command error
gibberishvanilla behavior, no false positives

Suggestions match against the labels and aliases of every node in the command trees (players type subcommands as if they were whole commands), rank exact > prefix > edit-distance, are permission-filtered, and use the game-mode world the player is standing in to disambiguate. Accepting is a click ([run_command:] inline tag) or typing yes/y within 30 seconds; pending suggestions clear when the player runs any other command or quits. The listener hooks UnknownCommandEvent, which fires only when no plugin owns the command, so BentoBox never shadows another plugin.

⚙️ Config note: two new toggles under general.did-you-mean — unknown-commands and subcommands — both default on. 🔡 Locale note: three new general.did-you-mean keys were translated into all 22 bundled locales, and the pre-existing missing key commands.admin.team.setowner.specify-island was filled in every non-English file at the same time.

⚙️ Core structure suppression for all game modes

[PR #3019] — Addresses CaveBlock #116 / #117 / #118

Disabling a vanilla structure used to be a per-addon job. This moves it into core so every game mode gets it for free, fixing two problems any world that delegates to vanilla generation could hit:

  • /locate freeze. Cancelling structure placement left the world's placement rules intact, so every structure search — /locate, Eyes of Ender, explorer/treasure maps, dolphins, villager cartographer trades — kept proposing candidates that all got cancelled, scanning to the radius cap and freezing the main thread (Paper Watchdog territory).
  • Near-spawn leak. A disabled structure could still generate near spawn because spawn chunks are generated during createWorlds(), before any onEnable() listener existed.

Two config layers control it: the global world.disabled-structures list in config.yml (applied to every BentoBox game-mode overworld/nether/end), and a binary-compatible per-world WorldSettings.getStructureSettings() override that lets a game mode disable extra structures or force-enable one the global list disables. Keys are case- and separator-insensitive (trial_chambers, ancient-city). The global list is empty by default, so upgrading changes nothing until you opt in.

Nexo hook

[PR #3028]

A new NexoHook lets BentoBox place and detect Nexo custom blocks and items, registered through BentoBoxHookRegistrar alongside the other custom-item integrations.

Oraxen custom-block placement

[PR #3026]

OraxenHook.placeBlock exposes Oraxen custom-block placement to addons, matching the placement API the other custom-block hooks provide.

Legend

  • 🔡 Locale files may need regenerating or updating.
  • ⚙️ Config options have been added, renamed, or removed.
  • 🔺 Special attention needed.

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.19.0...3.20.0

3.19.0

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1 · 26.1.2 · 26.2
BentoBox-3.19.0.jar2.4 MBSHA-1 1a68ccefc8d64ab47aeae55736f8add4b6926372获取文件 BentoBox-3.19.0.jar
展开更新日志

Release Highlights

  • 🔡 New FISHING protection flag — Admins and island owners can now stop players fishing into protected areas from outside the island. Defaults to visitor rank, so nothing changes until you raise it.
  • 🔺 Bed & respawn-anchor spawns are now honored — Dying on an island respawns you at your bed or charged respawn anchor when it's on an island you're a member of. Controlled by the new BED_ANCHOR_RESPAWN world setting (enabled by default).
  • 🐛 End exit portal no longer dumps you at world spawn — Jumping through the end exit portal now routes you to your safe island home on multi-gamemode servers.
  • 🐛 Item frames and paintings survive blueprints — Frames keep their facing and contents, and paintings restore their artwork, instead of popping off or facing the wrong way.
  • 🔡 Recover islands pending deletion — New /admin undelete, a stand-on /admin delete, and /admin register can now rescue soft-deleted islands before their region files are purged.
  • ⚙️ BlueMap island layer survives reloads — Owner pins and area boxes no longer vanish after /bluemap reload, plus new config toggles and marker customization.
  • ⚡ Settings-GUI click spam no longer spikes MSPT — Spam-clicking /is settings dropped from ~30–40 MSPT to negligible via in-place panel refresh and a translation cache.

Compatibility

✔️ Paper Minecraft 1.21.5 – 26.2 ✔️ Java 25+

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. Regenerate/merge any customized locale, config.yml, and panel templates so the new keys appear (see the notes below).
  6. You should be good to go!

🔺 Respawn behaviour change: Bed and respawn-anchor spawns are now honored on islands the player is a member of. This is on by default (BED_ANCHOR_RESPAWN world setting). Economy-sensitive servers that want the old "always respawn at island home" behaviour should disable this setting.

⚙️ Config note: A new bluemap section (island-markers, island-areas, and marker customization) is added to config.yml, both toggles default true. The team_panel.yml and team_invite_panel.yml templates gain configurable button icons and name/description keys. Existing configs keep the previous behaviour.

🔡 Locale note: New keys were added for the FISHING flag, the BED_ANCHOR_RESPAWN setting, /admin undelete, admin team setowner, and the team-panel member/prospect name & description. All 22 bundled locales were updated in this release.

Legend

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

New Features

🔡 FISHING protection flag

[PR #3004] Fixes #1687

A new FISHING protection flag lets admins and island owners prevent fishing outside island boundaries — originally needed for Boxed. A FishingListener checks the hook's location, so casting into a protected area from outside is blocked and a blocked cast removes the bobber. Hooking entities is intentionally left to the existing hurting/PVP flags. The flag defaults to visitor rank, so existing servers are unchanged until the required rank is raised.

🔺 Bed and respawn-anchor spawns honored

[PR #3005] Fixes #1632

On death (ISLAND_RESPAWN) and on end-portal return, a vanilla-resolved bed or charged respawn anchor is now honored when it sits on an island the player is at least a member of, in the same game mode. Beds placed while visiting someone else's island, obstructed/broken beds, uncharged anchors, and reset/transferred islands all fall back to the normal island respawn by construction. A new world setting BED_ANCHOR_RESPAWN (default enabled) lets economy-sensitive servers disable the feature entirely. A new public API method IslandsManager#getSafeRespawnLocation(World, UUID) (@since 3.19.0) backs both respawn paths.

🔡 Recover islands pending deletion

[PR #3017]

Islands that are soft-deleted (marked deletable, owner cleared, awaiting the region-file purge) can now be rescued before they're gone:

  • /admin register <player> on an island pending deletion now shows a confirmation prompt instead of hard-refusing — confirming registers the island to the player and cancels its deletion.
  • /admin undelete (new) clears the pending-deletion status of the island you're standing on and leaves it unowned.
  • /admin delete with no player argument (new) soft-deletes the island you're standing on after confirmation, refusing if it still has a team.

Shared restore logic lives in a new IslandsManager.undeleteIsland(Island), symmetric with deleteIsland.

⚙️ BlueMap: survive reloads, config toggles, and marker customization

[PR #3014]

Three improvements to the BlueMap integration:

  • Markers now survive /bluemap reload. BentoBox now registers with BlueMap's own lifecycle (onEnable/onDisable) instead of grabbing the API once at boot, so owner pins and protected-area rectangles are re-populated on every reload and are no longer racy at startup.
  • New config toggles bluemap.island-markers and bluemap.island-areas (both default true) mirror the Dynmap toggles added in 3.17.1, letting admins who run their own markers turn BentoBox's layer off. The marker set is also client-side toggleable in BlueMap's UI.
  • Marker customization exposes the POIMarker / ShapeMarker options (icon, max distance, area style) for admins who want to restyle the layer.

⚙️ Configurable team panel button icons

[PR #3010] Fixes #3008

The STATUS, RANK filter, and INVITE buttons in the team management panel previously hardcoded their icons and ignored any icon: set in team_panel.yml. They now honour the template icon, falling back to the previous material when none is set, so admins can (for example) change the rank filter to a HOPPER. Shipped template values match the old icons, so existing installs look identical.

🔡 Customizable member & prospect name/description

[PR #3011] [PR #3013] Fixes #3009

The team-panel member button and invite-prospect button name and description were built entirely in code and referenced locale keys that didn't exist. New keys commands.island.team.gui.buttons.member.{name,description,last-seen} and commands.island.team.invite.gui.buttons.member.{name,description} now drive both the online and offline member names (with a [last_seen] placeholder for offline status) and the rank line, so admins can restyle them. Default values reproduce the previous output exactly.

🔡 Console-friendly admin team setowner

[PR #3003]

admin team setowner gains an optional second argument naming the island's current owner: /[gamemode] admin team setowner <newOwner> [islandOwner]. The named form is location-independent and runs from the console (skipping the confirmation prompt), making it drivable from automation such as Skript — e.g. a "capture the island by killing the owner" game mode. The one-argument in-game form is unchanged, and the concurrent-island cap still applies.

Bug Fixes

End exit portal respawn wrongly used world spawn

[PR #3005] Fixes #1632

Players jumping into the end exit portal were dumped at the server's global spawn on multi-gamemode servers. The listener now triggers on PlayerRespawnEvent's authoritative END_PORTAL reason instead of a stale in-memory tracking map, and routes to the player's safe home using the same resolution as ISLAND_RESPAWN.

Item frames and paintings broken in blueprints

[PR #3006] [PR #3007] Fixes #1752

Item frames survived a blueprint copy but not the round trip: facing direction was never stored, a self-assignment bug meant isFixed was never applied, and paintings lost both their facing and their artwork. Blueprints now store and re-apply the BlockFace facing for any hanging entity, restore the painting Art (skipping unknown keys from newer servers safely), paste paintings at their anchor block with the art pre-applied, and no longer silently drop the rest of a block's entities when one fails to attach. Both new blueprint fields are nullable additions, so existing blueprint files load unchanged.

Performance

⚡ Settings-GUI click spam no longer raises MSPT

[PR #3015] [PR #3016]

Spam-clicking /is settings was costing ~30–40 MSPT. Two rounds of fixes bring it down to negligible:

  • In-place tabbed-panel refresh rebuilds the panel contents instead of re-opening the inventory on every click.
  • Rejected clicks are now cheap — the cooldown check runs first (only map lookups), the plain-text panel title is cached, and the "slow down" notice is translated at most once per cooldown window.
  • User#getTranslation caches the expensive MiniMessage → Component → legacy conversion, keyed purely on the input string (measured ~143× faster warm, ~37× faster on a full panel rebuild). The cache is bounded by size (10,000) and idle time (30 min), needs no reload invalidation, and can't go stale because placeholders are substituted before conversion.

Other Improvements

  • Bumped the pinned publish-platforms.yml reusable workflow to ca2dcd1 / fe4b1f0 [PR #3002]
  • Refreshed stale facts in CLAUDE.md

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.18.1...3.19.0

3.18.1

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1 · 26.1.2 · 26.2
BentoBox-3.18.1.jar2.3 MBSHA-1 0ad0ccbd9a721ef33adfec367c7390152557de7f获取文件 BentoBox-3.18.1.jar
展开更新日志

Release Highlights

BentoBox 3.18.1 is a maintenance release. The headline fix restores multi-line colour in GUIs; the rest hardens the build and release pipeline.

  • 🐛 Multi-line lore & names keep their colour — text after the first line of a tooltip no longer falls back to the default purple. Fixes GUI tooltips across all addons (reported on Challenges).

Compatibility

✔️ Paper Minecraft 1.21.5 – 26.2 ✔️ Java 25+

Upgrading

  1. As always, take backups just in case. (Make a copy of everything!)
  2. Ensure your server is running on a Java 25-capable Paper build for the Minecraft 26.x line.
  3. Stop the server.
  4. Replace the BentoBox jar with this one.
  5. Restart the server.
  6. You should be good to go!

Bug Fixes

Multi-line lore and text lose colour after the first line

[PR #2999]

Multi-line names and lore lost their formatting after the first line — the second and subsequent lines rendered in the default (purple) colour even when each source line specified one, affecting GUI tooltips across all addons. Util.componentToLegacy emitted a colour/format code only before the first line of a multi-line text node; after lore was split on newlines, every line after the first had no colour code left. The serializer now re-emits the active colour (and any decorations, in the correct order) after each newline, so each tooltip line keeps its colour.

Other Improvements

Build: scope vendor repositories to fix flaky dependency resolution

[PR #3000]

CI intermittently failed to resolve us.dynmap, net.momirealms, de.oliver (FancyNpcs/FancyHolograms) and MultiLib: Gradle queries repositories in declaration order, and a flaky host returning HTTP 520 aborted resolution before the authoritative repo was reached. Each vendor group is now scoped to its authoritative repository with exclusiveContent, the FancyPlugins repo was updated to its new repo.fancyinnovations.com home, and MultiLib now resolves from Clojars — so one host's outage can no longer cascade into unrelated groups.

Release publishing pipeline

Modrinth and CurseForge publishing now reuse the built release asset instead of rebuilding, CurseForge game versions include MC 1.21.5 and 26.2, and Hangar publishing is enabled. Internal CI only — no effect on the plugin itself.

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.18.0...3.18.1

3.18.0

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1 · 26.1.2 · 26.2
BentoBox-3.18.0.jar2.3 MBSHA-1 eebf296f8bf4351104b8c439cae3850fdb2dcbdc获取文件 BentoBox-3.18.0.jar

3.16.2

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.16.2.jar2.3 MBSHA-1 3c3252510841297538ffaa13bec6718edd10d976获取文件 BentoBox-3.16.2.jar
展开更新日志

New in this release

A small follow-up patch with one defensive hardening, one inventory-loss fix, and CraftEngine API compatibility.

  • 🔺 Island.setRange no longer silently corrupts island data. A misbehaving third-party addon was calling setRange with a value that disagreed with the game mode's configured distance-between-islands. On the next restart, BentoBox refused to load the affected islands and panic-disabled with Island distance mismatch, taking the whole island system offline. setRange now refuses any value that disagrees with the configured distance (and logs the calling stack frame), unless the game mode opts out via GameModeAddon.isEnforceEqualRanges() == false — the supported path for claim-resizing game modes like StrangerRealms.
  • 🐛 Team-accept no longer eats inventories under InvSwitcher. Players who accepted a team invite while standing in a non-BentoBox world (with island.reset.on-join.inventory: true — Boxed and AOneBlock ship with this) could return to that world to find their items gone. The on-join inventory/XP/health/hunger/money resets now run after the teleport into the island world completes, so InvSwitcher (and similar plugins) save the player's real inventory under the old world before the reset fires. Fixes the case reported against AOneBlock 1.25.0 / Boxed 3.3.0 / InvSwitcher 1.17.1.
  • 🐛 CraftEngine 26.5+ compatibility. CraftEngineHook.getItemStack(id) was using the pre-rewrite CustomItem<ItemStack> API and broke on recent CraftEngine releases. The hook now uses BukkitItemDefinition#buildBukkitItem() and works against CraftEngine 26.5.

Compatibility

✔️ Paper Minecraft 1.21.5 – 1.21.12 ✔️ Java 21+

Upgrading

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

🔺 Island.setRange contract change. setRange was previously a plain setter. It now refuses values that would put the stored range out of sync with the game mode's configured distance (which would cause Island distance mismatch on the next load) and logs a warning naming the caller. Game modes that legitimately resize claims continue to work — they already override GameModeAddon.isEnforceEqualRanges() to return false. If you're maintaining an addon and you see warnings like Refusing Island.setRange(...) in the log, the warning identifies the exact caller — that's the call you need to look at.

Legend

  • 🔺 special attention needed.

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.16.1...3.16.2

3.16.1

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.16.1.jar2.3 MBSHA-1 18597f56ce1392afa2850fb580c9ed35f25fbf33获取文件 BentoBox-3.16.1.jar
展开更新日志

New in this release

A targeted patch for /bbox admin delete.

  • 🔺 Admin delete actually deletes the island now. Not instantly, but when the plugin runs its housekeeping or pure runs. Note that if there are live islands in the same region file, then it will remain in the deleted state until the region is clear. If you really need to delete the blocks, then use WorldEdit or manually remove them. In the next full release we'll add a cut to the Blueprint command to remove blocks.
  • 🔺 Seed worlds (<world>/bentobox) are no longer created. The seed-world infrastructure (createSeedWorlds, removeSeedWorlds, the in-memory copies, the on-disk folders) is gone. Any stale <world>/bentobox folders left over from earlier versions are safe to delete manually. These were not doing anything recently except taking up space.
  • 🔺 API: GameModeAddon#isUsesNewChunkGeneration() is deprecated for removal. Existing addons that override it keep working (the value is simply ignored) but will see a deprecation warning. Remove the override at your convenience.

Internal cleanup that ships with the fix:

  • Removed DeleteIslandChunks, IslandChunkDeletionManager, CopyWorldRegenerator, the bentobox-deleteIsland MultiLib subscriber, and the IslandDeletion DB recovery loader.
  • WorldRegenerator slimmed to just regenerateChunk(Chunk); WorldRegeneratorImpl is now a small Bukkit-only delegate to World#regenerateChunk(int, int) used by CleanSuperFlatListener.
  • IslandDeletionManager#inDeletion(Location) now queries live island state (Island#isDeletable()) instead of a side-channel HashSet, so it can never drift out of sync.

Compatibility

✔️ Paper Minecraft 1.21.5 – 26.1.2 ✔️ Java 21+

Upgrading

  1. As always, take backups just in case.
  2. Stop the server.
  3. Replace the BentoBox jar with this one.
  4. Restart the server.
  5. (Optional) Delete any stale <world>/bentobox folders in your world container — they are no longer used.
  6. You should be good to go!

🔺 Reap timing. When /bbox admin delete finishes, the player's blocks are still on disk; the island is just marked deletad. The actual region files come out on the next housekeeping sweep (default: 24 h). If you need immediate cleanup, run /bbox admin purge deleted after the delete. But again, it will only be removed if the region files are clear.

Legend

  • 🔺 special attention needed.

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.16.0...3.16.1

3.16.0

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.16.0.jar2.3 MBSHA-1 3873ffe0238fac50f3dcb7310fe7d6031ac42da7获取文件 BentoBox-3.16.0.jar
展开更新日志

Release Highlights

  • ⚙️🔡🔺 Per-world team disable + admin team disbandall — Game modes can now opt out of the team subsystem entirely. Trust and coop remain available as the supported alternative, and a new admin command strips pre-existing members from every island in one pass.
  • 🔺 Setowner cap enforcement — Transferring island ownership now respects the recipient's concurrent-islands cap and island.number.<n> permission, closing a clean bypass that previously allowed admins (and team setowner) to push players over their limit.
  • 🐛 Safe respawn fallback — ISLAND_RESPAWN no longer drops players at world spawn (0,0) when their home block has been removed; it now walks a fallback chain ending in SafeSpotTeleport to find a real safe spot on the island.
  • 🐛 Offline growth: vines & trees — OFFLINE_GROWTH now correctly blocks every spreading plant (vines, weeping vines, etc.) and every tree growing from a sapling — not just kelp and bamboo.
  • 🐛 Dynmap marker Y range — Area/polygon markers now use the world's full min/max height instead of always rendering at y=64.
  • CraftEngine hook helpers — getItemStack(id) and getItemId(item) let addons render and recognise CraftEngine custom items without depending on CraftEngine directly.

Compatibility

✔️ Paper Minecraft 1.21.5 – 1.21.12 ✔️ 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. If you intend to enable isTeamsDisabled in a game mode, run /[admin] team disbandall once after the upgrade to clean up pre-existing teams (see the callout below).
  6. You should be good to go!

⚙️🔺 Teams-disabled is opt-in per game mode. A new WorldSettings#isTeamsDisabled() method (default false) lets a game mode disable team commands in its world. Existing servers see no behaviour change unless a game mode adopts the setting. Trust and coop relationships are intentionally unaffected — they're the supported alternative when teams are off.

🔺 Setowner cap is now enforced. Both /island team setowner and /[admin] team setowner refuse the transfer if the recipient is already at their concurrent-islands cap. Previously, admin setowner only emitted a warning after the bypass and /island team setowner had no check at all. Adjust the recipient's permission first if you really intend to allow more islands.

🔡 Locale changes: New keys for commands.admin.team.disbandall.{description,confirmation,success}, commands.island.team.errors.teams-disabled, commands.admin.team.setowner.errors.at-max, and an updated commands.admin.team.kick.cannot-kick-owner message that points admins to setowner/disband. The dead commands.admin.team.kick.success-all key has been removed. All 22 bundled translations are in sync.

Legend

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

New Features

⚙️🔡🔺 Per-world Team Disable + admin team disbandall

[PR #2975] Closes #2965

A new WorldSettings#isTeamsDisabled() (default false) lets a game mode opt out of the team subsystem on a per-world basis. When enabled, the action commands that add, remove or reorganise team members refuse to run with commands.island.team.errors.teams-disabled:

  • /island team invite and invite accept (TEAM invitations only — COOP and TRUST invitations remain accepted)
  • /island team kick, leave, promote, demote, setowner
  • /[admin] team add

Read-only commands (/island team panel, info, invites, invite reject), trust/coop relationships (trust, coop, untrust, uncoop), and admin commands that operate on existing teams (kick, disband, disbandall, setowner, fix, maxsize) all remain available.

A new admin command /[admin] team disbandall strips every member and sub-owner from every island in the current world in one confirmable pass. Trusted and coop players are intentionally untouched. Use it once after flipping isTeamsDisabled on to clean up pre-existing teams.

🔌 CraftEngine Hook Helpers

[PR #2970] [PR #2973]

Two new helpers on CraftEngineHook, mirroring the equivalents on OraxenHook and ItemsAdderHook:

  • getItemStack(String id) returns an Optional<ItemStack> for the registered CraftEngine custom item — useful for rendering the correct icon and display name in panels and GUIs.
  • getItemId(ItemStack item) returns the namespaced ID of a CraftEngine custom item (or null) — useful for command handlers (e.g. Level addon's /is value hand) that need to recognise a held custom item.

Both helpers let addons interoperate with CraftEngine without compiling against it directly.

Bug Fixes

🔺 Setowner Bypassed concurrent-islands Cap

[PR #2966] Fixes #2908

AdminTeamSetownerCommand previously allowed transfers to a player who already owned their maximum allowed concurrent islands and only emitted a warning afterwards; IslandTeamSetownerCommand had no check at all. Both now compute the recipient's current concurrent-islands count and permission-aware cap in canExecute and refuse the transfer when at or above the limit. The user path uses the existing commands.island.team.setowner.errors.at-max locale entry; the admin path uses a new commands.admin.team.setowner.errors.at-max that includes the count and limit.

ISLAND_RESPAWN Sent Players to 0,0 When Home Was Unsafe

[PR #2962]

When ISLAND_RESPAWN was enabled and the player's home block had been removed, isSafeLocation() returned false and the respawn fell through to world spawn. IslandRespawnListener now walks a fallback chain — try one block above the home (covers slabs/stairs), then a quick sync check around the island protection center, then anchor the respawn at the protection center and schedule SafeSpotTeleport on the next tick to find a real safe spot. cancelIfFail(true) ensures the player isn't yanked elsewhere if the comprehensive scan also fails.

OFFLINE_GROWTH: Vines and Trees from Saplings Were Ignored

[PR #2968]

OFFLINE_GROWTH previously only blocked kelp, bamboo and bamboo saplings on BlockSpreadEvent — vines, cave vines, twisting/weeping vines and any other spreading plant slipped through. Trees and mushrooms growing from a sapling didn't fire BlockGrowEvent at all, so they were never blocked. The listener now uses the source block location for BlockSpreadEvent (so plants growing outward from an island are correctly attributed) and adds a StructureGrowEvent handler for trees/mushrooms.

Admin team kick on Multi-island Players

[PR #2967]

AdminTeamKickCommand previously iterated every team island the target was on and silently kicked them from each. With concurrent islands enabled, that's a footgun. The command now defaults to the single team island the target is on and, when there are several, requires an explicit x,y,z coordinate (with tab completion suggesting the candidates). Owner-islands are also excluded from kick targets — if the target only owns the matched island(s), the command refuses with commands.admin.team.kick.cannot-kick-owner and points the admin to setowner or disband instead.

Dynmap Area Markers Always Rendered at y=64

[PR #2972]

DynmapHook was creating area markers without a configured Y range, so Dynmap rendered them at the default y=64 regardless of the actual world height. Both setMarker and the public addPolygonMarker now call area.setRangeY(world.getMaxHeight(), world.getMinHeight()) so markers cover the full vertical extent of the world.

Other Improvements

  • Regression test for the island home location bug fix from 3.15.0 [PR #2969]
  • WorldSettings#isTeamsDisabled() Javadoc rewritten with explicit lists of which commands are blocked vs. unaffected
  • Locale sync across all 22 bundled translations for new keys + the updated cannot-kick-owner message; removed the dead success-all key

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.15.0...3.16.0

3.15.0

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.15.0.jar2.3 MBSHA-1 36cfecbe0ffd123484ee563690b37446509d2ad4获取文件 BentoBox-3.15.0.jar
展开更新日志

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 HousekeepingManager handles 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 stop have 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_PICKUP flag 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

  1. Take backups. (Make a copy of everything!)
  2. Stop the server.
  3. Replace the BentoBox jar with this one.
  4. Restart the server.
  5. The keep-previous-island-on-reset config setting has been removed — all resets now soft-delete. Remove it from your game mode configs to avoid warnings.
  6. You should be good to go!

🔺 Purge command changes: /purge regions, /purge status, and /purge stop no 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-reset has been removed. All island resets now soft-delete (equivalent to the old false behaviour, but with deferred disk cleanup). If you previously relied on keep-previous-island-on-reset: true to preserve old islands, use /purge protect on islands you want to keep.

🔡 Locale changes: Several purge-related locale keys have been removed, renamed, or updated. New keys for the deleted subcommand 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

[PR #2933] [PR #2949]

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

[PR #2941] Closes #2940

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 PURGED event reason; fire IslandDeleteEvent immediately 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 AbstractPurgeCommand base 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?

CommandFilterWhat it deletes
/purge <days>Region files older than N days, minus active/protected islands.mca files (plus player data for absent players)
/purge deletedIslands 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-days days and behaves like /purge <days> using the configured region-age-days value.
  • Deleted sweep — runs every deleted-interval-hours hours and behaves like /purge deleted, reaping region files for any island already flagged deletable.

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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.14.2...3.15.0

3.14.2

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1 · 26.1.2
BentoBox-3.14.2.jar2.3 MBSHA-1 aa32ef7a24f36376e41494e488c46f92dcb3b045获取文件 BentoBox-3.14.2.jar
展开更新日志

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

  1. Take backups. (Make a copy of everything!)
  2. Stop the server.
  3. Replace the BentoBox jar with this one.
  4. 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

[d3a04e25] Fixes #2943

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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.14.1...3.14.2

3.14.1

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.14.1.jar2.3 MBSHA-1 0a3c47aee50387f5253352b751d7a567d9c9be8c获取文件 BentoBox-3.14.1.jar
展开更新日志

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

  1. Take backups. (Make a copy of everything!)
  2. Stop the server.
  3. Replace the BentoBox jar with this one.
  4. Restart the server.

📄 Coming from 3.13.x? Existing .blu blueprint files will continue to load alongside the new .blueprint JSON 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 .blueprint JSON files instead of zipped .blu binaries. Existing .blu files 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 TooltipDisplay data 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_rank placeholder — 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

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.14.0.jar2.3 MBSHA-1 89fd62977e20dc07da983e4e4295c0764eb957a0获取文件 BentoBox-3.14.0.jar
展开更新日志

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 .blueprint JSON files instead of zipped .blu binaries. Existing .blu files 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

  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. Existing .blu blueprint files will continue to work — they are loaded transparently alongside the new .blueprint format.
  6. You should be good to go!

📄 Blueprint migration note: Blueprints are now saved in plain JSON .blueprint format. Your existing .blu files 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

[PR #2918] Fixes #2917

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

[PR #2927] Fixes #2919

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_rank placeholder [PR #2909]
  • Extended decoration leak tests to cover all five decoration types [PR #2920]

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.13.0...3.14.0

3.13.0

正式版推荐
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.13.0.jar2.3 MBSHA-1 57483ed579ee76df7cf59cab40cdbb1cb57c644b获取文件 BentoBox-3.13.0.jar
展开更新日志

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.

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]

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] [PR #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] 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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.12.0...3.13.0

3.12.0

正式版
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11 · 26.1 · 26.1.1
BentoBox-3.12.0 (1).jar2.2 MBSHA-1 084d1b41e538e6469fef7f26d58211cbe07325fc获取文件 BentoBox-3.12.0 (1).jar
展开更新日志

BentoBox Changelog

[3.12.0] — 2026-03-28

New Release Highlights

  • 🗺️ ⚙️ Web-map integrations — BentoBox now ships with built-in BlueMap and Dynmap hooks that display island markers and area overlays on your web map automatically. A public Map API lets addon authors target any web-map plugin.
  • ⚙️ 🔡 SPAWN_PROTECTION world flag — Prevents players from dying to the void at spawn. Configurable per game-mode via the world settings panel.
  • ⚙️ 🔡 WIND_CHARGE protection flag — Controls whether visitors can fire wind charges on islands. Defaults to blocked for visitors.
  • ⚙️ 🔡 Expel fallback command — A new expelCommand config key (default: spawn) specifies the command run when an expelled player has no island or spawn point to fall back to.
  • ⚙️ 🔡 Blueprint paste commands — Blueprint bundles can define a list of commands that run when the blueprint is pasted, enabling automation on island creation.
  • 🔡 Blueprint GUI pagination — The blueprint management panel now paginates so large blueprint libraries are no longer cramped onto a single screen.
  • ⚙️ 🔡 Admin max team-size command — A new /bbox admin setmaxteamsize <player> <size> command lets you override the maximum team size on a per-island basis without editing config files.
  • 🔡 Clickable home list — The /is homes list is now clickable; selecting a home name in chat runs the go-home command automatically.
  • ⚙️ 🔡 Force-field fling — Players are now flung away from island force-fields when they walk into them, rather than just being teleported (improves feel on flying game modes).
  • ⚙️ Obsidian-scooping abuse fix — Two new config knobs (obsidianScoopingCooldown and obsidianScoopingRadius) prevent rapid lava/obsidian duplication exploits.

Compatibility

✔️ Paper Minecraft 1.21.5 – 1.21.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!

⚙️ Config migration note: Three new keys are added to config.yml (expelCommand, obsidianScoopingRadius, obsidianScoopingCooldown). BentoBox will add them automatically on first start.

Legend

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

New Features

⚙️ BlueMap & Dynmap Web-Map Integration

[PR #2861] [PR #2883] [PR #2884] [PR #2885]

BentoBox now ships with hooks for BlueMap and Dynmap. When either plugin is installed, island markers and (for BlueMap) coloured area overlays are added to the live web map automatically, without any configuration required.

A new generic Map API (world.bentobox.bentobox.api.map) lets addon authors register their own web-map implementations, so any mapping plugin can be supported in the future.

Additional Map API polish after initial merge:

  • Map hooks now register before addons enable, so addons can create markers during onEnable(). Island population is deferred to BentoBoxReadyEvent when islands are fully loaded.
  • addPointMarker() now accepts an iconName parameter; Dynmap maps this to its icon registry (with fallback to "default") and all 85 built-in Dynmap icon names are documented in MapManager Javadoc.
  • Dynmap point marker labels support HTML markup (e.g. coloured owner names) via isMarkupLabel=true.

⚙️ 🔡 SPAWN_PROTECTION World Setting Flag

[PR #2865]

A new SPAWN_PROTECTION world setting flag prevents players at spawn from falling into the void. When enabled, the spawn area is treated as protected ground and void-death is suppressed. Useful for game modes where the spawn platform is exposed.

⚙️ 🔡 WIND_CHARGE Protection Flag

[PR #2855]

A new WIND_CHARGE island protection flag controls who can use wind charge items on an island. By default visitors are blocked, preventing griefing through knockback.

⚙️ 🔡 Expel Fallback Command

[PR #2846]

A new expelCommand setting in config.yml (default: spawn) specifies the console command run when an expelled player has no home island and no known spawn point. Previously such players would be stuck.

⚙️ Blueprint Paste Commands

[PR #2852]

Blueprint bundles now support an optional commands list. Each command is run (as the server console) when the bundle's blueprint is pasted, making it easy to trigger automation or economy actions on island creation.

🔡 Blueprint GUI Pagination

[PR #2867]

The blueprint management GUI now paginates. Servers with large numbers of blueprints will see next/previous page navigation buttons instead of a single overflowing panel.

⚙️ 🔡 Admin Max Team-Size Command

[PR #2851] [PR #2854]

A new /bbox admin setmaxteamsize <player> <size> command lets server admins override the maximum team size for a specific island at runtime, without touching config files.

🔡 Clickable Home List in Chat

[PR #2879]

The /is homes listing in chat is now clickable. Clicking a home name runs the go-home command for that home automatically, saving players from typing.

🔡 Force-Field Fling

[PR #2122] [PR #2880]

Players who walk into an island force-field (locked island boundary) are now physically flung back rather than teleported, giving a more natural feel, especially on flying game modes.

🔡 Bypass Lock Notification

[PR #2869]

Admins and players with the bypass permission now receive a notification message when they enter a locked island, so it is clear that the lock has been overridden.

Geo-Limit Projectiles

[PR #2863]

Projectiles (arrows, tridents, etc.) are now included in the geo-limit settings panel, giving island owners granular control over which projectile types visitors are allowed to fire.

Paginated Help Command

[PR #2859]

/is help now supports a page number argument (/is help 2) so large command lists do not flood chat.

/island lock Command

[PR #2858]

A new /island lock shortcut command lets island owners toggle the island lock without opening the settings panel.

Bug Fixes

Lava Bucket / Obsidian Duplication

[PR #2842] [PR #2856] [PR #2860]

Fixed an exploit where players could rapidly scoop buckets of lava from obsidian to duplicate it. A per-player cooldown (obsidianScoopingCooldown, default: 1 minute) and a proximity radius check (obsidianScoopingRadius, default: 5 blocks) now prevent abuse. Both values are configurable in config.yml.

Player XP Not Resetting

[PR #2866]

Fixed a bug where player XP was not being reset when joining a team or creating a new island via the no-teleport code path.

Sugar Cane, Cocoa Beans & Nether Wart Protection Flags

[PR #2870]

Sugar cane was not registered under the HARVEST flag and was not protected against premature breaking. Sugar cane, cocoa beans, and nether wart were also missing from CROP_PLANTING protection. They now all respect the correct flag settings.

Purge Unowned Islands NPE

[PR #2843]

Fixed a NullPointerException in the purge-unowned-islands command that occurred when an island's world was null.

End/Nether Explosion Crash

[PR #2844]

Fixed a NullPointerException in StandardSpawnProtectionListener that occurred when an explosion happened in a standard End or Nether world that was not managed by BentoBox.

Island Settings Comparator

[PR #2864]

Fixed an inconsistent comparator in the island settings panel that could throw a IllegalArgumentException under certain flag ordering conditions.

Color Codes in Multi-Line Translated Strings

[PR #2877]

Fixed color/formatting codes being stripped from the second and subsequent lines of multi-line locale strings.

Players Falling into the Void on New Island Creation

[PR #2890]

Fixed a bug where players could fall into the void immediately after a new island was created if the teleport destination hadn't solidified yet. homeTeleportAsync now performs a safe-spot check before teleporting and retries with exception handling if the location lookup fails, preventing void deaths on fresh islands.

Configuration Changes

Three new settings in config.yml:

KeyDefaultDescription
expelCommandspawnConsole command run when an expelled player has no destination
obsidianScoopingRadius5Block radius (0–15) checked for nearby obsidian during bucket use
obsidianScoopingCooldown1Minutes before a player can scoop obsidian again (minimum: 1)

Internal / Developer Changes

  • Added a generic Map API (api/map) so addon authors can integrate with any web-map plugin.
  • Extensive SonarCloud quality pass: sealed classes, ChatColor removal, lambda/@Override style, variable-shadowing fixes, cognitive-complexity reductions (see PR #2875).
  • Removed unnecessary public modifiers from JUnit 5 test classes and methods (PR #2849).
  • Added CLAUDE.md project guidance file for AI-assisted development (PR #2848).
  • Resolved all previously failing and skipped tests; test suite is now fully green (PR #2872).
  • Added public API method for reading Why-debug flag messages from FlagListener (PR #2857).

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.11.2...3.12.0

3.11.2

正式版
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
BentoBox-3.11.2.jar2.2 MBSHA-1 f120eb68305b96e7d8652bb555c301ce28d21105获取文件 BentoBox-3.11.2.jar
展开更新日志

New Release Highlights

  • Visitors cannot steal items from copper golems by hitting them
  • ⚙️ 🔡 🔺 New RAID_TRIGGER island protection flag replaces the old VISITOR_TRIGGER_RAID world setting, giving island owners granular control over who can trigger raids
  • ⚙️ 🔡 Economy/Vault integration for blueprint bundle costs — admins can now charge players to choose a blueprint when creating or resetting islands
  • New /bbox placeholders (alias ph) GUI and /bbox dump-placeholders command for browsing and documenting all registered placeholders
  • Automatic update notification banner on startup when a newer BentoBox version is available
  • 🔺 Performance: island loading is now dramatically faster on servers with many islands (spatial hash replaces nested TreeMap — addresses servers that hung at "Loading islands from database...")
  • Fixed NETHER_PORTAL / END_PORTAL protection flags being bypassed when Paper had misc.enable-nether: false
  • Fixed /bbox purge regions not deleting nether/end region files, and corrected login-check logic and scan reporting
  • BentoBox teleports now use TeleportCause.PLUGIN instead of UNKNOWN, fixing compatibility with Essentials /back

Compatibility

✔️ Paper Minecraft 1.21.5 - 1.21.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!

🔺 Config migration note: The VISITOR_TRIGGER_RAID world setting has been removed. It is replaced by the new per-island RAID_TRIGGER protection flag. Review your game mode configs after upgrading.

Legend

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

New Features

⚙️ 🔡 🔺 RAID_TRIGGER Protection Flag (replaces VISITOR_TRIGGER_RAID)

[PR #2801](https://github.com/BentoBoxWorld/BentoBox/pull/2801)

The VISITOR_TRIGGER_RAID world setting has been converted into a proper island protection flag called RAID_TRIGGER. Island owners can now configure the minimum rank required to trigger a raid on their island (visitor, member, trusted, owner, etc.) via the island settings panel. Players attempting to trigger a raid below the configured rank will have their action blocked without consuming their Bad Omen effect. By default, only members and above can trigger raids — matching previous behaviour.

⚙️ 🔡 Economy Integration for Blueprint Bundle Costs

[PR #2806](https://github.com/BentoBoxWorld/BentoBox/pull/2806)

Admins can now assign a Vault economy cost to blueprint bundles. A cost editor is available in the admin GUI. When economy is enabled and multiple bundles are available, players will see costs displayed and must be able to afford a bundle before selecting it. A new config option charge-for-blueprint-on-reset (default: false) controls whether the cost also applies when resetting an island. Costs are silently skipped when Vault/economy is not installed.

Placeholder Browser GUI and Dump Command

[PR #2803](https://github.com/BentoBoxWorld/BentoBox/pull/2803)

Two new admin tools for managing placeholders:

  • /bbox placeholders (alias ph) — opens an interactive GUI showing all registered placeholders organised by addon, with resolved values.
  • /bbox dump-placeholders — generates a Markdown file documenting every registered placeholder, useful for documentation and the BentoBoxWorld docs site.

Panel appearance can be customised via BentoBox/panels/placeholder_panel.yml and placeholder_list_panel.yml.

Automatic Update Notifications

[PR #2834](https://github.com/BentoBoxWorld/BentoBox/pull/2834)

BentoBox now checks for newer releases on startup and prints a coloured banner to the console if an update is available. The check runs asynchronously and fails silently on network errors. Development builds skip the check entirely.

Performance

🔺 Faster Island Loading — Spatial Hash for IslandGrid

[PR #2840](https://github.com/BentoBoxWorld/BentoBox/pull/2840)

The internal island grid has been rewritten to use a spatial hash map instead of nested TreeMaps. This reduces island loading from O(n²) to O(n) average-case, directly fixing the issue where servers with large numbers of islands would hang at "Loading islands from database...". Also corrects a bug that could cause large islands to be missed by coordinate lookups (relevant to plugins like Stranger Realms).

Bug Fixes

🔺 Addon Binary Compatibility and Class Loading Fix

[PR #2836](https://github.com/BentoBoxWorld/BentoBox/pull/2836)

Restores the ImmutableSet<UUID> return type on Island.getMemberSet(), which had been changed to Set<UUID> and was causing NoSuchMethodError at runtime for addons compiled against earlier BentoBox versions. Also fixes an IllegalStateException: Recursive update in AddonClassLoader that caused startup failures for addons with cross-addon dependencies (e.g. DimensionalTrees).

Fix NETHER_PORTAL / END_PORTAL Flag Bypass

[PR #2802](https://github.com/BentoBoxWorld/BentoBox/pull/2802)

When Paper's misc.enable-nether (or enable-end) was set to false, BentoBox's portal handling bypassed the Bukkit event bus entirely, allowing visitors to use portals regardless of the protection flag. Events are now properly routed through Bukkit.getPluginManager().callEvent() so flag checks fire correctly.

Fix Purge Regions

[PR #2841](https://github.com/BentoBoxWorld/BentoBox/pull/2841) [PR #2804](https://github.com/BentoBoxWorld/BentoBox/pull/2804) [PR #2805](https://github.com/BentoBoxWorld/BentoBox/pull/2805)

Several fixes to the /bbox purge regions command:

  • Nether/end worlds were not being detected correctly due to early evaluation before addon worlds loaded
  • The recent-login protection check had inverted logic and only checked the island owner rather than all team members
  • Region files in nether and end worlds were not being deleted
  • Scan reports now show how many islands are blocked by level thresholds vs. protection flags

Fix Copper Golem Item Theft by Visitors

[PR #2799](https://github.com/BentoBoxWorld/BentoBox/pull/2799)

Visitors could steal items held by Copper Golems by hitting them. This has been fixed.

Fix TeleportCause for Plugin-Initiated Teleports

[PR #2800](https://github.com/BentoBoxWorld/BentoBox/pull/2800)

BentoBox teleports (home, safe-spot etc.) now correctly use TeleportCause.PLUGIN instead of TeleportCause.UNKNOWN. This fixes compatibility with plugins like Essentials where /back would not work after a BentoBox teleport.

Fix force-shown Integer in Panel Configuration

[PR #2832](https://github.com/BentoBoxWorld/BentoBox/pull/2832)

Setting force-shown: N in a panel YAML now correctly forces all rows 1 through N to be visible, rather than only the last row. The list form force-shown: [2, 4] is unaffected.

Internal / Developer Changes

A large batch of code quality improvements driven by SonarCloud analysis: sealed classes, removal of deprecated ChatColor API, lambda and @Override style fixes, variable shadowing, cognitive complexity reduction in TemplateReader, production code quality improvements, and replacement of deprecated EntityDamageByEntityEvent and LingeringPotion test APIs. Extensive new JUnit 5 test suites added for ClosestSafeSpotTeleport, SQLDatabaseHandler, BlueprintPaster, IslandTeamInviteGUI, DefaultPasteUtil, and others. Placeholder panel pagination deduplicated into AbstractPanel.

What's Changed

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.11.1...3.11.2

3.11.1

正式版
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
BentoBox-3.11.1.jar2.1 MBSHA-1 082c3588589768e143be2ca8ecfae6d83bec4b00获取文件 BentoBox-3.11.1.jar
展开更新日志

This is a bug fix release.

Compatibility

  • ✔️ Paper Minecraft 1.21.5 - 1.21.11
  • ✔️ 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!

Legend

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

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.11.0...3.11.1

3.11.0

正式版
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
BentoBox-3.11.0.jar2.1 MBSHA-1 903aa2c7281b972f7a4ad06f915bf860deedf9f6获取文件 BentoBox-3.11.0.jar
展开更新日志

This release adds support for Paper 1.21.11 and fixes some bugs. There are no feature differences from the previous version.

Compatibility

✔️ Paper Minecraft 1.21.5 - 1.21.11 ✔️ 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!

Legend

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

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.10.1...3.11.0

3.10.1

正式版
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10
BentoBox-3.10.1.jar1.9 MBSHA-1 737bea6dc3456bd9aa7fa751479100586021cef0获取文件 BentoBox-3.10.1.jar
展开更新日志

Compatibility

✔️ Minecraft 1.21.5 - 1.21.10 ✔️ 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!

Legend

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

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.10.0...3.10.1

3.10.0

正式版
加载器
paper · purpur
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10
BentoBox-3.10.0.jar1.9 MBSHA-1 5035dc880811f74b0418077e0e605a2118b4904f获取文件 BentoBox-3.10.0.jar
展开更新日志

New In This Release

  • Support for new Stranger Realms game mode - A scary new survival experience where the overworld is shadowed by a terrifying, inverted dimension called the Upside Down. Inspired by the TV Show.
  • Updated Ukrainian locale
  • Bug fixes

Compatibility

✔️ Minecraft 1.21.5 - 1.21.10 ✔️ 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!

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 Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.9.2...3.10.0

3.9.2

正式版
加载器
paper
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10
BentoBox-3.9.2.jar1.9 MBSHA-1 89f3091c387c584fbd2abc668dd62a64ab8083bc获取文件 BentoBox-3.9.2.jar
展开更新日志

New In This Release

  • Adds more backward compatibility for servers before 1.21.10

Compatibility

✔️ Minecraft 1.21.5 - 1.21.10 ✔️ 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!

Legend

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

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.9.1...3.9.2

3.9.1

正式版
加载器
paper
MC 版本
1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10
BentoBox-3.9.1.jar1.9 MBSHA-1 aaed29aaa987170f3668c77415c69babaf1b7d71获取文件 BentoBox-3.9.1.jar
展开更新日志

New In This Release

  • Adds backward compatibility to 1.21.5+
  • Fixes protection flag for Trial Spawners

Compatibility

✔️ Minecraft 1.21.5 - 1.21.10 ✔️ 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!

Legend

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

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.9.0...3.9.1

3.9.0

正式版
加载器
paper
MC 版本
1.21.10
BentoBox-3.9.0.jar1.9 MBSHA-1 190b799da9fa9c94e5beec766037bd64a7356c8c获取文件 BentoBox-3.9.0.jar
展开更新日志

New In This Release

  • Adds protections for copper chests and golems
  • API added for ExpiringSets
  • API added to allow islands to be off grid coordinates

Compatibility

✔️ Minecraft 1.21.10 ✔️ 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!

Legend

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

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.8.1...3.9.0

3.8.1

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10
BentoBox-3.8.1.jar1.9 MBSHA-1 22625631c5016ab784d21130399eeba1206f6359获取文件 BentoBox-3.8.1.jar
展开更新日志

New In This Release

  • Bug fix - admin command to copy blocks for blueprint was throwing an error and not copying.
  • Bug fix - added color codes to some of the setting flags where they were missing

Compatibility

✔️ Minecraft 1.21.4 to 1.21.10 ✔️ 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. (Optional) Move or delete the English locale files so they are updated
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.8.0...3.8.1

3.8.0

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8 · 1.21.9 · 1.21.10
BentoBox-3.8.0.jar1.9 MBSHA-1 bc2c169a82165fcc76be333c9533f8e16b50632d获取文件 BentoBox-3.8.0.jar
展开更新日志

New In This Release

  • Added support from 1.21.10

Compatibility

✔️ Minecraft 1.21.4 to 1.21.10 ✔️ 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. Move or delete locale files
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.7.4...3.8.0

3.7.4

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
BentoBox-3.7.4.jar1.9 MBSHA-1 99134dc64f808a97ff8dd2e36bd9dd07e40397ff获取文件 BentoBox-3.7.4.jar
展开更新日志

New In This Release

  • Oraxen support (supports Level addon, which will also be updated)
  • Bug fixes

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 ✔️ 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. Move or delete locale files
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.7.3...3.7.4

3.7.3

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
BentoBox-3.7.3.jar1.9 MBSHA-1 2aef0e9028d6fdb39f04dfb4ef33ad1fc094443e获取文件 BentoBox-3.7.3.jar
展开更新日志

New In This Release

This is a bug fix release:

  • Some databases had "junk" deleted island data in them and the recent change related to the purge regions beta feature loaded them. These legacy island "stomped" on some real islands, which results in some player's "losing" their islands. The islands are still there but the old junk island was overwriting the island. This release reverts that change. As such, the purge regions beta feature may not work optimally. We plan to optimize it in a future release.

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 ✔️ 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. Move or delete locale files
  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

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.7.2...3.7.3

3.7.1

正式版
加载器
paper · purpur
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
BentoBox-3.7.1.jar1.9 MBSHA-1 ffa45ac173865976bf5d758876e3cfca4882f013获取文件 BentoBox-3.7.1.jar
展开更新日志

New In This Release

  • Hungarian language fix
  • Added code support for Boxed
  • Improves purge region operation by deleting totally unused and old regions.

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 ✔️ 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. Move or delete locale files
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.7.0...3.7.1

3.7.0

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7 · 1.21.8
BentoBox-3.7.0.jar1.9 MBSHA-1 572bf747acfdbd99a0fdad70cfcadebcada03250获取文件 BentoBox-3.7.0.jar
展开更新日志

New In This Release

This adds compatibility for Paper 1.21.8.

Adds a new beta admin command purge regions that deletes old islands by removing regions. This can also be used instead of having islands deleted. Set the BentoBox config.yml setting keep-previous-island-on-reset: true and then run purge every so often. The advantage of having the region file delete is that they will be regenerated completely when revisited. This is a beta feature so only use if you have backups. It has been tested. Region purging is very fast.

Purge Logic

Here’s the logic used to determine whether an island can be purged :

High-Level Flow

  1. User runs the purge command with a number of days.
  2. The plugin scans region files and finds those not modified in the last N days.
  3. For each region, it finds all islands overlapping that region.
  4. For each island, it checks if the island can be deleted (purged).
  5. Only islands passing the deletion check are considered for purging.

Detailed Purge Eligibility Logic

An island cannot be deleted (i.e., is protected from purge) if any of the following are true:

  1. Island is marked as purge protected
  2. Island is a spawn island
  3. Island is not owned
  4. Island level is too high
    • If the "Level" addon is present, and the level is higher than BentoBox's level in config.yml is then the island is protected. default is is 10.
  5. Owner or any team member has logged in recently

Islands That Can Be Deleted

  • If none of the above protections apply, the island can be deleted.
  • Exception: If the island is already marked as deleted it can always be deleted regardless of other checks.

In short: An island is eligible for purge if it is not protected, not spawn, is owned, is below the level threshold, and no member has logged in recently - unless it is already marked as deleted, in which case it can always be purged.

What is deleted

  • Region files (.mca)
  • World player files in the world - this will mean that if they log in they will spawn in the main world
  • Entity or POI files related to the region
  • Island records in the BentoBox database

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8 ✔️ 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. Move or delete locale files
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.6.0...3.7.0

3.6.0

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6 · 1.21.7
BentoBox-3.6.0.jar1.9 MBSHA-1 0f698d6faaedace1a876ff6b8646b13c9fc067de获取文件 BentoBox-3.6.0.jar
展开更新日志

New In This Release

This adds compatibility for Paper 1.21.7.

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6, 1.21.7 ✔️ Java 21

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.5.0...3.6.0

3.5.0

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5 · 1.21.6
BentoBox-3.5.0.jar1.8 MBSHA-1 303e176a91e947a066fd285ccfa141ba2f0a9d9c获取文件 BentoBox-3.5.0.jar
展开更新日志

New In This Release

This adds compatibility for Paper 1.21.6. Note that this version of the server may still be unstable.

Compatibility

✔️ Minecraft 1.21.4, 1.21.5, 1.21.6. Earlier 1.21.x versions may work, but are not supported and do not have Blueprint or regeneration optimization. ✔️ Java 21

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.4.1...3.5.0

3.4.1

正式版
加载器
paper
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5
BentoBox-3.4.1.jar1.8 MBSHA-1 ac6f8a4dd8bc5a5ac0b31ed4901f04fedc485794获取文件 BentoBox-3.4.1.jar
展开更新日志

New In This Release

Bug fixes to improve backward compatibility with 1.21.4. See the What's Changed section.

Compatibility

✔️ Minecraft 1.21.4 or 1.21.5. Earlier 1.21.x versions may work, but are not supported and do not have Blueprint or regeneration optimization. ✔️ Java 21

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.4.0...3.4.1

3.4.0

正式版
加载器
paper
MC 版本
1.21 · 1.21.1 · 1.21.2 · 1.21.3 · 1.21.4 · 1.21.5
BentoBox-3.4.0.jar1.8 MBSHA-1 d48ee63d883c6c32a0f44cc3598670e57691a7e2获取文件 BentoBox-3.4.0.jar
展开更新日志

New In This Release

This is mainly a bug fix and optimization release. See the What's Changed section.

Compatibility

✔️ Minecraft 1.21.4 or 1.21.5. Earlier 1.21.x versions may work, but are not supported and do not have Blueprint or regeneration optimization. ✔️ Java 21 ✔️ Multiverse 4 and 5

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.3.5...3.4.0

3.3.5

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5
BentoBox-3.3.5.jar1.8 MBSHA-1 8cf16fb6b72ddf800d4584e2b2829ca1bc00401a获取文件 BentoBox-3.3.5.jar
展开更新日志

New In This Release

  • Rework of MultiverseCore hook - Boxed and other addons should work now even if MV is running. Big thanks to Ben the author.
  • GitHub API rewrite - the old code had severe bitrot and needed rewriting. If you see errors, file a ticket and we'll try to refine. They are mostly not major and usually around rate limiting.

Compatibility

✔️ Minecraft 1.21.4 or 1.21.5. Earlier 1.21.x versions may work, but are not supported and do not have Blueprint or regeneration optimization. ✔️ Java 21 ✔️ Multiverse 4 and 5

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.3.4...3.3.5

3.3.4

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5
BentoBox-3.3.4.jar1.9 MBSHA-1 c54e705e5870a6ebb5f9a47258dafd0f5417f86e获取文件 BentoBox-3.3.4.jar
展开更新日志

New In This Release

  • Bug fix to enable FancyNPC's to work again in Blueprints. Old blueprints may not work and will need to be redone because the skin API changed

Compatibility

✔️ Minecraft 1.21.4 or 1.21.5. Earlier 1.21.x versions may work, but are not supported and do not have Blueprint or regeneration optimization. ✔️ Java 21 ⚠️ Note: Multiverse is not compatible for Boxed, AcidIsland, Poseidon!

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.3.3...3.3.4

3.3.3

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5
BentoBox-3.3.3.jar1.9 MBSHA-1 9c410a7732a65f141da1a636ae03357da365cc7b获取文件 BentoBox-3.3.3.jar
展开更新日志

New In This Release

  • Paper 1.21.5 support has been added
  • Other features are same as 3.3.2.

Compatibility

✔️ Minecraft 1.21.4 or 1.21.5. Earlier 1.21.x versions may work, but are not supported and do not have Blueprint or regeneration optimization. ✔️ Java 21 ⚠️ Note: Multiverse is not compatible for Boxed, AcidIsland, Poseidon!

Upgrading

  1. Use MC 1.21.5 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.3.2...3.3.3

3.3.2

正式版
加载器
paper
MC 版本
1.21.4 · 1.21.5
BentoBox-3.3.2.jar1.9 MBSHA-1 d4b73fb9795f73045b7846f61b79908862c2a1dc获取文件 BentoBox-3.3.2.jar
展开更新日志

New In This Release

  • Protection for island settings reset by users - the TNT button will require a chat entry of "confirm" or the equivalent in the language of the player to reset all settings
  • Loads of updates to locales to translate from English. Let us know if we made a mistake!
  • Improvements for PAPI support - this release is recommended if you use PAPI
  • Bug fixes

Compatibility

✔️ Minecraft 1.21.4. For older versions, use BentoBox 2.7.0, or earlier. 1.21.5 works but has no optimization for blueprint pasting or island deletion. ✔️ Java 21 ✔️ Addons will need to be updated to work on 1.21.3+ ❌ Note that Multiverse is not compatible with the Boxed game mode addon

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. (Optional) Download the latest versions of all your addons and put them in the Addons folder
  6. (Optional, but recommended) Move the old locale files so they can be regenerated
  7. Restart the server
  8. 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

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.3.1...3.3.2

3.3.1

正式版
加载器
paper
MC 版本
1.21.3 · 1.21.4
BentoBox-3.3.1.jar1.8 MBSHA-1 a99c73280e195928016ae1890ddf484afc69cbd8获取文件 BentoBox-3.3.1.jar
展开更新日志

New In This Release

  • Bug fix for the creeper griefing flag (see below)

Compatibility

✔️ Minecraft 1.21.4. For older versions, use BentoBox 2.7.0, or earlier. Not tested on 1.21.5 yet. ✔️ Java 21 ✔️ Addons will need to be updated to work on 1.21.3+ ❌ Note that Multiverse is not compatible with the Boxed game mode addon

Upgrading

  1. Use MC 1.21.4 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. Download the latest versions of all your addons and put them in the Addons folder
  6. Restart the server
  7. 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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.3.0...3.3.1

3.2.5

正式版
加载器
paper
MC 版本
1.21.3 · 1.21.4
BentoBox-3.2.5.jar1.8 MBSHA-1 73cf384174bf57e9471949b1ad35064deda81a21获取文件 BentoBox-3.2.5.jar
展开更新日志

New In This Release

  • Added more support for ItemsAdder. Look out for the new Level addon that will be able to score IA blocks!
  • Bug fixes

Compatibility

✔️ Minecraft 1.21.3+. For older versions, use BentoBox 2.7.0, or earlier ✔️ Java 21 ✔️ Addons will need to be updated to work on 1.21.3+ ❌ Note that Multiverse is not compatible with the Boxed game mode addon

Upgrading

  1. Use MC 1.21.3 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. Download the latest versions of all your addons and put them in the Addons folder
  6. (Optional) remove / move old BentoBox/locales folder so new locales will be generated.
  7. Restart the server
  8. 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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.2.4...3.2.5

3.2.4

正式版
加载器
paper
MC 版本
1.21.3 · 1.21.4
BentoBox-3.2.4.jar1.8 MBSHA-1 31da23bdeacf15e029cc9eb43f34957ddd22028a获取文件 BentoBox-3.2.4.jar
展开更新日志

New In This Release

  • Podzol generation from growing trees is disabled by default to prevent exploitation. New settings flag added to allow it if you wish.
  • New placeholder: %[gamemode]_island_rank%
  • Blueprint improvements:
    • New option to ignore water blocks when copying blocks for a blueprint. Waterlogged blocks will stay waterlogged, but pure water blocks will be skipped. Good for Blueprints designed to be pasted underwater.
    • Trial spawners, and their configuration are now saved in Blueprints
    • ItemsAdder blocks and items are saved (beta) and pasted
    • Blueprints can be set to "sink" to the bottom of the ocean, or until the bedrock block hits a block.
  • Language flag banners have been updated and corrected to look much better!
  • Bugs fixed

Compatibility

✔️ Paper Minecraft 1.21.3+. For older versions, use BentoBox 2.6.0, or earlier ✔️ Java 21 ✔️ Addons will need to be updated to work on 1.21.3+ ❌ Note that Multiverse is not compatible with the Boxed game mode addon

Upgrading

  1. Use MC 1.21.3 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. Download the latest versions of all your addons and put them in the Addons folder
  6. (Optional) remove / move old BentoBox/locales folder so new locales will be generated.
  7. Restart the server
  8. 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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.2.3...3.2.4

3.2.3

正式版
加载器
paper · spigot
MC 版本
1.21.3 · 1.21.4
BentoBox-3.2.3.jar1.8 MBSHA-1 8135dd70f4242ed42a1a658a0c0b6a4fa313d391获取文件 BentoBox-3.2.3.jar
展开更新日志

This add Romanian translations. Also includes a bug fix release to address a critical crash issue when playing Boxed (due to chunk loading). The feature set is the the same as 3.2.0

Compatibility

  • ✔️ Minecraft 1.21.3+. For older versions, use BentoBox 2.6.0, or earlier
  • ✔️ Java 21
  • ✔️ Addons will need to be updated to work on 1.21.3+
  • ❌ Note that Multiverse is not compatible with the Boxed game mode addon

Upgrading

  1. Use MC 1.21.3 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. Download the latest versions of all your addons and put them in the Addons folder
  6. Restart the server
  7. 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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.2.1...3.2.3

3.2.1

正式版
加载器
paper · purpur · spigot
MC 版本
1.21.3 · 1.21.4
BentoBox-3.2.1.jar1.8 MBSHA-1 d5df308bf8e66005c82428dde6b1a71fc33955d4获取文件 BentoBox-3.2.1.jar
展开更新日志

This release adds some cool new features, and fixes an hot issue with Paper removing support for PaperLib. Note - this will be the last version that supports native Spigot. We are going to shift to support only Paper from the next version.

New features

  • Support for ZNPCsPlus in Blueprints - you will need the latest version (2.0.0 or later) for this to work
  • FancyNPCs is already supported but now more supported
  • Experimental Support for vanilla block, item, and text holograms in Blueprints. You can make these using the /summon command or command blocks. Sites like https://mcstacker.net are useful. When pasted, players can destroy the text and item holograms by right licking on them. The block holograms currently do not break.

Compatibility

  • ✔️ Minecraft 1.21.3+. For older versions, use BentoBox 2.6.0, or earlier
  • ✔️ Java 21
  • ✔️ Addons will need to be updated to the latest to work on 1.21.3+
  • ❌ Note: Multiverse is not compatible with the Boxed game mode addon

Upgrading

  1. Use MC 1.21.3 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. Download the latest versions of all your addons and put them in the Addons folder
  6. Restart the server
  7. 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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/3.2.0...3.2.1

3.0.1

正式版
加载器
paper · spigot
MC 版本
1.21.3 · 1.21.4
BentoBox-3.0.1.jar1.8 MBSHA-1 30a3b875105ff5b0fd163622c5718aea9ff37263获取文件 BentoBox-3.0.1.jar
展开更新日志

This is a release for 1.21.3 and beyond.

Compatibility

  • ✔️ Minecraft 1.21.3 only. For older versions, use BentoBox 2.6.0, or earlier
  • ✔️ Java 21
  • ✔️ Addons will need to be updated to work on 1.21.3
  • ❌ Note that Multiverse is not compatible with the Boxed game mode addon

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. Use MC 1.21.3 or later
  2. As always, take backups just in case. (Make a copy of everything!)
  3. Stop the server
  4. Replace the BentoBox jar with this one
  5. Download the latest versions of all your addons and put them in the Addons folder
  6. Restart the server
  7. 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

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/2.7.0...3.0.1

2.4.0

正式版
加载器
paper · spigot
MC 版本
1.20.1 · 1.20.4 · 1.20.6 · 1.21
BentoBox-2.4.0.jar1.8 MBSHA-1 26a3ea2cf3920d273e1a1f343b8baf7e9fb13ab2获取文件 BentoBox-2.4.0.jar
展开更新日志

This release is for the latest versions of Minecraft, and also brings in experimental support for Multipaper, a fork of Paper that enables multiple servers to run the same worlds. If you plan on using Multipaper, join our Discord server and let us know because addons will also need to be adjusted and it'll be good to know which ones to do.

Other new features:

  • BentoBox no longer loads all islands into RAM so for servers with a lot of islands, the memory footprint should be lower. As players join, their islands will be cached until the next server reboot, so plan to do that every so often.
  • Purging of islands now includes team islands - it didn't before.
  • NPC's can now hit players and won't be prevented by PVP rules.
  • Updates to Chinese language files.
  • Added %[gamemode]_visited_island_rank% placeholder.
  • New flag - handle tamed animals by @TreemanKing

Compatibility

✔️ Minecraft 1.21, 1.20.6, earlier versions maybe. ✔️ Java 17, but recommend to run on Java 21 ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox ❌ Note that Multiverse is not compatible with the Boxed game mode addon

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. Download the latest versions of all your addons and put them in the Addons folder
  5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
  6. Restart the server
  7. You should be good to go!

What's Changed

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/2.3.0...2.4.0

2.3.0

正式版
加载器
paper · purpur · spigot
MC 版本
1.20 · 1.20.1 · 1.20.2 · 1.20.3 · 1.20.4
BentoBox-2.3.0.jar1.7 MBSHA-1 0e4afc2ca2b58045139c42fca19fa42dff5454a4获取文件 BentoBox-2.3.0.jar
展开更新日志

This release fixes a major bug where mobs were not being pasted from blueprints (MythicMobs were, but hey, not normal mobs!) and also adds some new features:

  • Team members can now have multiple islands too - it's a setting in BentoBox config.yml if you wish to enable it.
  • Blueprints can now be given a max-usage setting. This is only enabled when players are allowed to make multiple island. So, for example, it's possible to limit players to only one of each type of island. There is also an option to hide any island blueprints if they have been used up. Don't forget that permissions can also be used to hide or show island blueprint options.

Compatibility

  • ✔️ Minecraft 1.20.x
  • ✔️ Java 17
  • ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

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. Download the latest versions of all your addons and put them in the Addons folder
  5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
  6. Restart the server
  7. You should be good to go!

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/2.2.0...2.3.0

2.2.0

正式版
加载器
paper · spigot
MC 版本
1.20 · 1.20.1 · 1.20.2 · 1.20.3 · 1.20.4
BentoBox-2.2.0.jar1.7 MBSHA-1 cc4eecf54bba5f47a55d9e6bc28329edbea90517获取文件 BentoBox-2.2.0.jar
展开更新日志

This release adds support for MythicMobs to be included in island blueprints. It also fixes bugs and adds features with a lot of improvements around Teams and team management:

  • All the team will be shown in the GUI, along with Trusted and Coop members.
  • When kicking players through the GUI, you no long have to perform the action twice to confirm.
  • Admin commands to manage teams have been rewritten to be multi-island aware. Disbanding teams, Setting the owner, etc. now work much better. Team fix command has been retired.
  • An exploit was fixed where non-island members could be made members without them accepting invites.

Other changes:

  • The maximum number of homes a player can have is now applied per island.
  • If players prevented use of crafting tables, then visitors were not able to access their own inventory (because it has a tiny crafting part to it)

SkyBlock team

Compatibility

✔️ Minecraft 1.20.x ✔️ Java 17 ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

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. Download the latest versions of all your addons and put them in the Addons folder
  5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
  6. Restart the server
  7. You should be good to go!

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/2.1.1...2.2.0

2.1.1

正式版
加载器
spigot
MC 版本
1.20.1 · 1.20.2 · 1.20.3 · 1.20.4
BentoBox-2.1.1.jar1.7 MBSHA-1 8a2123a8d0f00f05760870af0ffcff6e99182838获取文件 BentoBox-2.1.1.jar
展开更新日志

This is a hot fix release to fix a bug with accepting team invites using the team GUI.

Compatibility

  • ✔️ Minecraft 1.20.x
  • ✔️ Java 17
  • ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

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. Download the latest versions of all your addons and put them in the Addons folder
  5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
  6. Restart the server
  7. You should be good to go!

What's Changed

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/2.1.0...2.1.1

2.1.0

正式版
加载器
paper · spigot
MC 版本
1.20.1 · 1.20.2 · 1.20.3 · 1.20.4
BentoBox-2.1.0.jar1.7 MBSHA-1 b1b101148b05ae2473ae0f3c90ea2bd13d0d63f6获取文件 BentoBox-2.1.0.jar
展开更新日志

Compatibility

  • ✔️ Minecraft 1.20.x
  • ✔️ Java 17
  • ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

Downloading

Use this file, or go to 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. Download the latest versions of all your addons and put them in the Addons folder
  5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
  6. Restart the server
  7. You should be good to go!

What's Changed

  • New placeholder to provide counts of team members by @tastybento in #2300
  • Adds multi-island support for the Admin Register and Unregister commands by @tastybento in #2302
  • Fix for other admin commands to avoid removing players from more than one island when used. Also removed the Admin team fix command because it was not multi-island aware and could cause issues. (commit: 0a9da71)
  • Bukkit paste for Admin Blueprint pasting and if the player is near the island to be pasted by @tastybento in #2304
  • Better disbanding of teams via admin command by @tastybento in #2306
  • Change respawn point to the default home on the island. #2305 by @tastybento in #2307
  • Temporarily removed support for the deletion of ItemsAdder CustomBlocks because it was causing lag when deleting. #2297 (commit: 01f51f4)
  • Version 2.1.0 by @tastybento in #2291

API:

  • Remove deprecated methods from IslandsManager and IslandCache (commit: 631a155)

2.0.0

正式版
加载器
paper · spigot
MC 版本
1.20.4
BentoBox-2.0.0.jar1.7 MBSHA-1 cbac3aa8945ede0125a228b3b51671606b913704获取文件 BentoBox-2.0.0.jar
展开更新日志

This is a major release with big changes to the plugin! The top new feature is that players can now have more than one island in a world!

BentoBox for Minecraft

Players can create additional islands by running the create command, for example /island create. To teleport to different islands, they can use the island go command. If the island has a name, then they can use that, otherwise BentoBox will randomly assign a number to the island, e.g., "BoxManager's island 2".

By default players have only have one island, but you can enable more in the BentoBox config.yml, for example:

island:
  # The default number of concurrent islands a player may have.
  # This may be overridden by individual game mode config settings.
  concurrent-islands: 10
Players can also be given the permission [gamemode].island.number.[number] where [gamemode] is the name of the game mode being played, and [number] is how many islands the user is allowed, e.g., bskyblock.island.number.10.

Game modes may in the future allow island number setting directly in their configs, but for now it's mostly global or via perms.

Other changes:

  • New Team Management GUI - use the teams command to view and manage your teams, invites, etc.
  • Loads of language translation updates
  • Customizable GUI panels:
  • Team Panel
  • Team Invite Panel
  • New Island Panel
  • Language Panel
  • You can find them in plugins/BentoBox/panels. The files have comments in them.

Compatibility

  • ✔️ Minecraft 1.20.4
  • ✔️ Java 17
  • ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

Downloading

It's a good idea to use our download site where you can pick and choose add-ons: Download Site for Packs.

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. Download the latest versions of all your addons and put them in the Addons folder
  5. (Optional) Move or delete the BentoBox/locales folder to have the plugin save updated language files.
  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.

What's Changed

  • ⚙️ Adds a config section in BentoBox to run commands when it is loaded by @tastybento in #2167
  • Fixes a bug with incorrectly indexed pages +1 by @BONNe in #2178
  • 🔡 Update ru.yml by @tastybento in #2181
  • 🔡 Few RU translations by @gitlocalize-app in #2182
  • 🔡 Japanese update by @gitlocalize-app in #2183
  • 🔡 Indonesian translation by @gitlocalize-app in #2184
  • 2 0 0 multi island by @tastybento in #2185
  • Add checking for enchantment table inventory by @tastybento in #2191
  • ⚙️ Enables permissions to set how many islands a play can create. by @tastybento in #2201
  • 🔡 Hungarian translation by @gitlocalize-app in #2205
  • 🔡 Chinese translation by @gitlocalize-app in #2206
  • 🔡 Japanese translation by @gitlocalize-app in #2207
  • 🔡 Czech translation by @gitlocalize-app in #2208
  • 🔡 Portuguese translation by @gitlocalize-app in #2209
  • 🔡 German Translation WIP by @gitlocalize-app in #2210
  • 🔡 French translation WIP by @gitlocalize-app in #2211
  • 🔡 Croatian translation WIP by @gitlocalize-app in #2212
  • Remove the deprecated classes for 2.0 by @tastybento in #2216
  • This changes the loading to not be on STARTUP by @tastybento in #2214
  • Fixes a bug that removed old owner from island by @BONNe in #2218
  • Fixes a bug with EntityTeleportListener by @BONNe in #2222
  • Rank Management by @tastybento in #2220
  • Multi island api update by @tastybento in #2224
  • Fixes an issue with entity teleportation if nether/end worlds are disabled by @BONNe in #2227
  • 🔡 Better French, maybe... by @tastybento in #2228
  • Switch to Spigot's PlayerProfile on HeadGetter by @HSGamer in #2231
  • Separators, AddonClassLoader fixes and uni tests fixes by @Baterka in #2233
  • Adds a method that can return a different default value than 0 by @tastybento in #2234
  • 🔡 Add Ukrainian locale by @gitlocalize-app in #2236
  • 🔡 Add Ukrainian locale by @gitlocalize-app in #2235
  • Fixes end portal finding issue when entering from side by @BONNe in #2238
  • No tabs by @tastybento in #2243
  • Improves obsidian platform generation by @BONNe in #2246
  • Delete slimefun chunks/blocks when island is deleted. by @tastybento in #2247
  • Adds an ItemAdder hook to delete any blocks when island is deleted. by @tastybento in #2250
  • Material Type adapter by @tastybento in #2253
  • ⚙️ Customizable Language Selection Panel by @BONNe in #2254
  • ⚙️ Customizable Island Creation Panel by @BONNe in #2255
  • Fixes issue with file exporting in Windows system. by @BONNe in #2256
  • Fixes ItemParser. by @BONNe in #2257
  • Fixes warning about already existing file saving. by @BONNe in #2260
  • Add island object to Panel for context. by @tastybento in #2263
  • Add minor optimizations for chunk copying by @rchomczyk in #2261
  • Team gui by @tastybento in #2251
  • Faster teleports by @tastybento in #2267
  • Enable template to determine what is shown/clickable. by @tastybento in #2269
  • World context settings by @tastybento in #2271
  • Use a different method to grab the DataObject classes. by @tastybento in #2277
  • Fixes #2274 hanging signs protection by @tastybento in #2278
  • Fix for #2279 on-island placeholder for nether and end by @tastybento in #2280
  • Fix for #2281 by @tastybento in #2282
  • Center default home by @tastybento in #2287
  • Fixes EXP reset for players onJoin and onLeave by @BONNe in #2286
  • Release 2.0.0 by @tastybento in #2204

New Contributors

  • @Baterka made their first contribution in #2233
  • @rchomczyk made their first contribution in #2261

1.24.1

正式版
加载器
paper · spigot
MC 版本
1.20.1
BentoBox-1.24.1.jar1.5 MBSHA-1 6a37c01ca0e63aab95f37638423e35661e3f343d获取文件 BentoBox-1.24.1.jar
展开更新日志

This is a bug fix release. The main fix is for an exploit where players could cause projectile damage on an adjacent island if it was allowed on the island they were in. Now damage checks are done on where the damage occurs and not where the shooter is.

Compatibility

✔️ Minecraft 1.20.1 ✔️ Java 17 ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

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. Download the latest versions of all your addons and put them in the Addons folder
  5. Restart the server
  6. You should be good to go!

What's Changed

  • Exploit fix - Judge location of damage by location of entity not user (commit: 170c31f)
  • Various code refactoring to reduce complexity, improve maintenance
  • Improve or added automated tests for compilation

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/1.24.0...1.24.1

Notes from 1.24.0

New in this release

Support for Minecraft 1.20.1. This includes adding protection for:

  • Chiseled Bookshelves - adding or removing books
  • Brushing of suspicious sand and gravel
  • Calibrated sculk sensors are protected as well as sculls sensors
  • Editing of signs, front and back. If sign is waxed then they are not editable by anyone.
  • Boats and rafts
  • Other new materials in 1.20.x

Other changes:

  • Bug fix: Multiverse supported again. It stopped working after a server reboot causing super-flat.
  • BentoBox bbox perms command added to show effective perms as registered by addons. This is only shown in the console.
  • API: Adjust priority of PlayerInteraction event listener to NORMAL
  • API: Add API to enable gamemodes to register ownership over additional worlds
  • API: New IslandInfoEvent that gets called when a player runs the info command. Enables addons to show additional info.
  • API: New IslandNameEvent that gets called when a player names or renames their island.

Compatibility

✔️ Minecraft 1.20.1 ✔️ Java 17 ✔️ Addons may need to be updated to their latest version to work with this version of BentoBox

What's Changed

New Contributors

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/1.23.2...1.24.0

1.23.1

正式版
加载器
paper · spigot
MC 版本
1.19.4
BentoBox-1.23.1.jar1.5 MBSHA-1 8de8154975d4fcc7b76e92d714b84a15639ae89f获取文件 BentoBox-1.23.1.jar
展开更新日志

New in this release

🔺With 1.19.4 comes changes to the underlying API that affects how BentoBox can load Addons that forced a number of changes to BentoBox. Now, more than ever, Addons are like Plugins and will be visible in the /plugins command. Therefore, make sure you update your Addons to the latest version compatible with 1.23.0 of BentoBox to ensure they load and work correctly.

Other changes:

  • New flags for island protection HARVEST and CROP_PLANTING - enable players to allow visitors (or coop/trusted) to do farming
  • Support for 1.19.4
  • Adds API to enable translations to be set and specific API for flags #2109
  • Uses NMS to paste islands
  • New flags SHULKER_TELEPORT and ENDERMAN_TELEPORT that can prevent a shulker or enderman from teleporting on an island setting basis.
  • Locale files can now use the placeholder [display_name] instead of [name] to show the display (colorful) name of a player
  • Adds API to enable a GameModeAddon to declare whether it will use the legacy chunk deletion approach or the new one. The legacy is enough for void worlds. #2096 It also means the backup worlds will not be generated.
  • Enables banned commands to be more than one word. #2092

Compatibility

✔️ Minecraft 1.18.x to 1.19.4, but optimized with NMS for 1.19.4 ✔️ Java 17 ✔️ Adonis should be updated to their latest version to work with this version of BentoBox

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. Download the latest versions of all your addons and put them in the Addons folder
  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

Full Changelog: https://github.com/BentoBoxWorld/BentoBox/compare/1.23.0...1.23.1

依赖关系