# BentoBox v3.16.0 configuration file.
# Default language for new players.
# This is the filename in the locale folder without .yml.
# If this does not exist, the default en-US will be used.
# Use economy or not. If true, an economy plugin is required. If false, no money is used or given.
# If there is no economy plugin present anyway, money will be automatically disabled.
# Whether to charge the blueprint bundle cost when a player resets their island.
# If false, only island creation will charge the cost. Default is false.
charge-for-blueprint-on-reset: false
# Console commands to run when BentoBox has loaded all worlds and addons.
# Commands are run as the console.
# e.g. set aliases for worlds in Multiverse here, or anything you need to
# run after the plugin is fully loaded.
# JSON, MYSQL, MARIADB, MONGODB, SQLITE, and POSTGRESQL.
# Transition database options are:
# JSON2MARIADB, JSON2MYSQL, JSON2MONGODB, JSON2SQLITE, JSON2POSTGRESQL
# MYSQL2JSON, MARIADB2JSON, MONGODB2JSON, SQLITE2JSON, POSTGRESQL2JSON
# If you need others, please make a feature request.
# Minimum required versions:
# MySQL versions 5.7 or later
# MariaDB versions 10.2.3 or later
# MongoDB versions 3.6 or later
# SQLite versions 3.28 or later
# PostgreSQL versions 9.4 or later
# Transition options enable migration from one database type to another. Use /bbox migrate.
# JSON is a file-based database.
# MYSQL might not work with all implementations: if available, use a dedicated database type (e.g. MARIADB).
# BentoBox uses HikariCP for connecting with SQL databases.
# If you use MONGODB, you must also run the BSBMongo plugin (not addon).
# See https://github.com/tastybento/bsbMongo/releases/.
# You can find more details in this video: https://youtu.be/FFzCk5-y7-g
# Port 3306 is MySQL's default. Port 27017 is MongoDB's default.
# How often the data will be saved to file in mins. Default is 5 minutes.
# This helps prevent issues if the server crashes.
# Data is also saved at important points in the game.
# How many players will be saved in one tick. Default is 200
# Reduce if you experience lag while saving.
# Do not set this too low or data might get lost!
max-saved-players-per-tick: 20
# How many islands will be saved in one tick. Default is 200
# Reduce if you experience lag while saving.
# Do not set this too low or data might get lost!
max-saved-islands-per-tick: 20
# Number of active connections to the SQL database at the same time.
# Enable SSL connection to MongoDB, MariaDB, MySQL and PostgreSQL databases.
# Database table prefix. Adds a prefix to the database tables. Not used by flatfile databases.
# Only the characters A-Z, a-z, 0-9 can be used. Invalid characters will become an underscore.
# Set this to a unique value if you are running multiple BentoBox instances that share a database.
# Be careful about length - databases usually have a limit of 63 characters for table lengths
# Custom connection datasource properties that will be applied to connection pool.
# Check available values to your SQL driver implementation.
# prepStmtCacheSize: '250'
# prepStmtCacheSqlLimit: '2048'
# MongoDB client connection URI to override default connection options.
# See: https://docs.mongodb.com/manual/reference/connection-string/
mongodb-connection-uri: ''
# Allow FTB Autonomous Activator to work (will allow a pseudo player [CoFH] to place and break blocks and hang items)
# Add other fake player names here if required
# /!\ This feature is experimental and might not work as expected or might not work at all.
# Flingback power. How far hostile mobs will be flung back when a player teleports into them.
# 2.5 will push back a number of blocks, 5 will throw them far, 1 will not do much.
# Kill mobs on teleport. If the world flag in Admin Settings is set, then they will be killed/removed instead of flung.
teleport-remove-mobs: false
# Panel click cooldown. Value is in milliseconds. Prevents players spamming button presses in GUIs.
# Toggle whether panels should be closed or not when the player clicks anywhere outside of the inventory view.
close-on-click-outside: true
# Defines the Material of the item that fills the gaps (in the header, etc.) of most panels.
filler-material: light_blue_stained_glass_pane
# Toggle whether player head texture should be gathered from Mojang API or mc-heads.net cache server.
# Mojang API sometime may be slow and may limit requests to the player data, so this will allow to
# get player heads a bit faster then Mojang API.
# Defines how long player skin texture link is stored into local cache before it is requested again.
# Defined value is in the minutes.
# Value 0 will not clear cache until server restart.
# Defines a number of player heads requested per tasks.
# Setting it too large may lead to temporarily being blocked from head gatherer API.
# Defines a number of ticks between each player head request task.
# Setting it too large may lead to temporarily being blocked from head gatherer API.
# /!\ In order to apply the changes made to this option, you must restart your server. Reloading BentoBox or the server won't work.
# Toggle whether superflat chunks regeneration should be logged in the server logs or not.
# It can be spammy if there are a lot of superflat chunks to regenerate.
# However, as superflat chunks regeneration can be performance-intensive, it is recommended to keep
# this setting set to true, as it will help you know if there are regenerations taking place.
clean-super-flat-chunks: true
# Toggle whether downloading data from GitHub should be logged in the server logs or not.
github-download-data: true
# Override island distance mismatch checking. BentoBox normally refuses to run if
# the island distance in the gamemode config is different to the one stored in the database
# for safety. This overrides that check. You should never need this, and if you do not understand it
override-safety-check: false
# The default number of concurrent islands a player may have.
# This may be overridden by individual game mode config settings.
# Blueprints can have a maximum use when players have concurrent islands.
# If this is true, then ones that are used up will not be shown in the island create menu.
hide-used-blueprints: false
# How long a player must wait until they can rejoin a team island after being kicked in minutes.
# This slows the effectiveness of players repeating challenges
# by repetitively being invited to a team island.
# How long a player must wait until they can coop a player in minutes.
# How long a player must wait until they can trust a player in minutes.
# How long a player must wait until they can ban a player after unbanning them. In minutes.
# How long a player must wait before they can reset their island again in seconds.
# Whether the reset cooldown should be applied when the player creates an island for the first time or not.
set-reset-cooldown-on-create: true
# Time in seconds that players have to confirm sensitive commands, e.g. island reset.
# Ask the player to confirm the command he is using by typing it again.
# Ask the recipient to confirm trust or coop invites.
# Team invites will always require confirmation, for safety concerns.
# Time in seconds that players have to stand still before teleport commands activate, e.g. island go.
# Sets the minimum length an island custom name is required to have.
# Sets the maximum length an island custom name cannot exceed.
# Requires island custom names to be unique in the gamemode the island is in.
# As a result, only one island per gamemode are allowed to share the same name.
# Note that island names are purely cosmetics and are not used as a way to programmatically identify islands.
# Remove hostile mob on teleport box radius
# If hostile mobs are cleared on player teleport, then this sized box will be cleared
# around the player. e.g. 5 means a 10 x 10 x 10 box around the player
# Be careful not to make this too big. Does not cover standard nether or end teleports.
# Minimum nether portal search radius. If this is too low, duplicate portals may appear.
# Vanilla default is 128.
# Number of blocks to paste per tick when pasting blueprints.
# Smaller values will help reduce noticeable lag but will make pasting take slightly longer.
# On the contrary, greater values will make pasting take less time, but this benefit is quickly severely impacted by the
# resulting amount of chunks that must be loaded to fulfill the process, which often causes the server to hang out.
# Island Level Purge Protection
# Islands above this level will not be purged even if they are old. Requires the Level Addon.
# If the Level addon is not present, this will not be checked.
# Island deletion: Number of chunks per world to regenerate per second.
# If there is a nether and end then 3x this number will be regenerated per second.
# Smaller values will help reduce noticeable lag but will make deleting take longer.
# A setting of 0 will leave island blocks (not recommended).
# Housekeeping: periodic auto-purge of unused region files.
# When a player resets their island, the old island is orphaned (marked
# deletable) and its region files are reclaimed later by a scheduled purge.
# WARNING: housekeeping deletes .mca region files from disk. It uses the same
# protections as the /bbox purge regions command (online players, island level,
# purge-protected flag, spawn islands, and unowned-but-not-deletable islands are
# all skipped) but is destructive by design.
# --- Deleted-island sweep (safe, on by default) ---
# Reaps region files for islands explicitly marked deletable (e.g. /is reset).
# Only removes islands that BentoBox itself soft-deleted — never touches
# active or unvisited islands. Enable this and leave age-sweep off for a
# 'just works' experience that reclaims disk space from reset islands.
# How often the deleted-island sweep runs, in hours.
# --- Age-based sweep (opt-in, more aggressive) ---
# Reaps region files whose .mca files are older than min-age-days, regardless
# of whether those islands are marked deletable. Can remove islands that were
# never reset but simply abandoned. Disabled by default — enable only if you
# want automatic reclamation of all old, unvisited islands.
# How often the age-based sweep runs, in days.
# Minimum age (in days) of region files eligible for the age-based purge.
# Chunk pre-generation settings.
# Pre-generates chunks around predicted future island locations
# to reduce lag when islands are created or reset.
# Enable or disable chunk pre-generation.
# Number of future islands to pre-generate chunks for, per game mode world.
# Higher values use more disk space but reduce the chance of lag on island creation.
# Maximum number of async chunk generation requests dispatched per tick batch.
# Lower values reduce server impact. Paper handles these asynchronously.
# Recommended range: 2-10.
# Ticks between pre-generation batches.
# 1 = every tick (fastest), 20 = once per second (gentlest).
# By default, If the destination is not safe, the plugin will try to search for a safe spot around the destination,
# then it will try to expand the y-coordinate up and down from the destination.
# This setting limits how far the y-coordinate will be expanded.
# If set to 0 or lower, the plugin will not expand the y-coordinate.
safe-spot-search-vertical-range: 400
# By default, if the destination is not safe, the plugin will try to search for a safe spot around the destination.
# This allows to change the distance for searching this spot. Larger value will mean longer position search.
# This value is also used for valid nether portal linking between dimension.
safe-spot-search-range: 16
# The command to run as the expelled player if they have no island and no spawn is set.
# This is typically provided by other plugins like EssentialsX.
# Leave blank to do nothing in this situation.
# The radius (in blocks) around an obsidian block to check for other obsidian blocks
# when a player tries to scoop it up with an empty bucket (OBSIDIAN_SCOOPING flag).
# If any obsidian is found within this radius, the scooping is denied.
# Set to 0 to disable the check and allow any lone obsidian block to be scooped.
# Range: 0 to 15. Default is 2.
obsidian-scooping-radius: 2
# The duration of the cooldown (in minutes) applied after a player scoops an obsidian block
# into a lava bucket using the OBSIDIAN_SCOOPING flag. During this cooldown, the player
# cannot scoop another obsidian block. This prevents lava bucket duplication exploits
# caused by rapidly scooping obsidian near water.
# Minimum value is 1 minute. Default is 1 minute.
# Note: Changes to this value require a server restart to take effect.
obsidian-scooping-cooldown: 1
# How long (in seconds) to show a hologram tip above newly formed obsidian
# that can be scooped back into lava. The hologram reminds players they can
# right-click obsidian with an empty bucket to recover lava.
# Set to 0 or less to disable the tip entirely. Default is 5 seconds.
obsidian-scooping-lava-tip-duration: 5
# Toggle whether BentoBox can connect to GitHub to get data about updates and addons.
# Disabling this will result in the deactivation of the update checker and of some other
# features that rely on the data downloaded from the GitHub API.
# It does not send any data.
# Time in minutes between each connection to the GitHub API.
# This allows for up-to-the-minute information gathering.
# However, as the GitHub API data does not get updated instantly, this value cannot be set to less than 60 minutes.
# Setting this to 0 will make BentoBox download data only at startup.