?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
BentoBox

BentoBox

BentoBox is a plugin for Minecraft servers running the Bukkit API, like Spigot, and Paper with a unique addon system that enables it to be customized and configured how an admin likes. BentoBox focuses on island-based games like SkyBlock, OneBlock, etc.

14.2k
25

Compatibility

Minecraft: Java Edition

1.21.x
1.20.6
1.20–1.20.4
1.19.4

Platforms

Links

Report issues View source Visit wiki Join Discord server
Sponsor on GitHubDonate on PayPal

Creators

BentoBox
BentoBox Organization
fredthedoggy
fredthedoggyMember

Details

Licensed EPL-2.0
Published 3 years ago
Updated last week

BentoBox 3.11.2

Download
Report

Changelog

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

Files

BentoBox-3.11.2.jar(2.18 MiB) Primary
Download

Metadata

Release channel

Release

Version number

3.11.2

Loaders

Paper Purpur

Game versions

1.21.5–1.21.11

Downloads

490

Publication date

March 14, 2026 at 4:03 PM

Version ID