Level#

Allows to specify in which GameModeAddons Level addon should not operate.

Level will NOT hook into these game mode addons.

Default: []

Allows to see a level report if command is executed from console.

Default: true

Allows to specify how many island level calculations can be happening at once.

If your CPU can handle it, you can run parallel island calcs if there are more than one in the queue.

Default: 1

Allows to specify the amount of minutes when level calculation should be stopped.

Generally, calculation should only take a few seconds, so if this ever triggers then something is not right.

Default: 5

Allows to specify if starting blocks should be included in island level.

If true, Level will calculate the starter island's level and remove it from any future level calculations. Player level may go into negative values if all starting blocks are removed.

If this is false, the player's starter island blocks will count towards their level.

Default: true

If true, the island block scan is skipped entirely and the island level is computed only from blocks donated via /island donate. This removes the per-recalculation CPU cost of scanning the island.

/island level, /island top, /island value, and /island donate continue to work. /island detail is not registered in this mode, since there are no scanned blocks to break down. The top-ten panel's viewer button no longer shows "Click to view" or opens the detail panel.

The zero-island scan that runs on island creation/reset still runs when zero-new-island-levels: true, so the starter-island handicap is recorded into initialCount and applied correctly if an admin later turns donations-only off. While donations-only is on, the stored initialCount is ignored at /island level time, so flipping the mode on for a server with existing islands does not push players to wildly negative levels.

Requires BentoBox 3.16.0 or later.

Default: false

Allows to set that island level is calculated on player login.

This silently calculates the player's island level when they login.

Default: false

Allows to include nether island in level calculation.

Warning: Enabling this mid-game will give players with an island a jump island level. New islands will be correctly zeroed.

Default: false

Allows to include the end island in level calculation.

Warning: Enabling this mid-game will give players with an island a jump island level. New islands will be correctly zeroed.

Default: false

Allows to include chest content in level calculation.

Warning: level calculation will be longer and server performance may be affected.

Default: false

Allows to specify underwater block multiplier.

If blocks are below sea-level, they can have a higher value. e.g. 2x. Promotes under-water development if there is a sea. Value can be fractional.

Default: 1.0

Allows to specify value of one island level.

Default: 100

Minimum: 1

Allows to specify the formula for level calculation.

• blocks - the sum total of all block values, less any death penalty
• level_cost - in a linear equation, the value of one level

This formula can include +,=,*,/,sqrt,^,sin,cos,tan,log (natural log). Result will always be rounded to a long integer.

For example, an alternative non-linear option could be: 3 * sqrt(blocks / level_cost)

Default: blocks / level_cost

Allows to specify cool down between level requests in seconds.

Default: 60

Allows to specify the death penalty.

How many block values a player will lose per death. Default value of 100 means that for every death, the player will lose 1 level (if levelcost is 100).

Set to zero to not use this feature.

Default: 100

Allows to sum all team members for the death penalty.

If false, only the leader's deaths counts.

Default: false

Allows to show shorter island level numbers.

Shows large level values rounded down, e.g., 10,345 -> 10k

Default: false

This section lists the limits for any particular block. Blocks over this amount are not counted. This limit applies to all game modes and is not world-specific.

Format: MATERIAL: NUMBER

This section lists the value of a block in all game modes (worlds). To specific world-specific values, use the next section. Any blocks not listed will have a value of 0. AIR is always zero.

Format: MATERIAL: NUMBER

Custom blocks from Oraxen, Nexo, ItemsAdder, and CraftEngine are also supported. Use their namespaced ID as the key:

blocks:
  mynamespace:my_block: 50
  mynamespace:custom_ore: 3

As of Level 2.27.0, custom blocks are no longer filtered out of /level value, render with their real texture/model data and display name in /level detail and the value panel, and can be donated via /island donate hand, /island donate inv, and the donation panel. CraftEngine items are resolved via BentoBox 3.16.0's CraftEngineHook.getItemId / getItemStack helpers — earlier BentoBox versions will refuse to load Level 2.27.0+.

List any blocks that have a different value in a specific world. If a block is not listed, the default value will be used from the blocks section. Prefix with world name. The values will apply to the associated nether and the end if they exist.

Example:

    worlds:
      AcidIsland_world:
        SAND: 0
        SANDSTONE: 0
        ICE: 0

In this example, AcidIsland will use the same values as BSkyBlock for all blocks except for sand, sandstone and ice.

Released: 2026-02-21

• Oraxen and Nexo furniture/custom block support. Level can now count Oraxen furniture mechanics and Nexo custom blocks and furniture towards island level. These integrations are in beta — enable them if you have either plugin installed.
• New per-block placeholders: [gamemode]_island_count_<block> (count of a specific block on the island), [gamemode]_island_value_<block> (value of a block type), and [gamemode]_island_limit_<block> (configured block limit). Block keys use underscores, e.g. _island_count_minecraft_stone.

Release v2.23.0

Released: 2026-04-26

• CraftEngine custom block support. CraftEngine blocks are now counted during island level calculations. Add them to blockconfig.yml using their namespaced IDs (e.g. mynamespace:my_block: 50). Requires BentoBox 3.15.0+. CraftEngine can be disabled with disabled-plugin-hooks: [CraftEngine] in config.yml.
• Localizable hand keyword. The hand argument in /island donate and /island value is now translatable via a new island.donate.hand.keyword locale key. English hand is always accepted as a fallback.
• 🔡 All 16 non-English locale files updated to include missing keys.
• 🔡 Ukrainian locale now fully translated.

🔡 Regenerate locale files to pick up the new island.donate.hand.keyword key.

Release v2.25.0

Released: 2026-05-04

• Configurable donation panel. The donate GUI is now fully template-driven via a new panels/donation_panel.yml, matching the value, detail, and top-ten panels. Admins can resize the panel from 1 to 6 rows, relocate the four named buttons (INFO, CANCEL, PREVIEW, CONFIRM), swap their icons, and add decorative items. The donation grid auto-fills every cell that isn't a border or named button.
• force-shown: [1,2,3,4] controls how many rows the panel uses (1–6 supported). The four required buttons are placed by data.type. If the template is missing or any required button is absent, the panel falls back to the previous hardcoded 4-row layout.
• 🐛 Decorative template items now actually render in the inventory; the custom title: on the donation panel is now respected; force-shown is parsed as a list (consistent with other panel YAMLs).
• No API breaks, no locale changes, no config.yml migrations.

⚙️ Donation panel layout. A new panels/donation_panel.yml is shipped on first launch — leave it alone to keep the 2.25.0 layout, or edit it to customise.

Release v2.26.0