Border#
Border can create and show a border around islands which players cannot pass.
The border can be:
- the vanilla world border
- a custom border that shows up when the player is near (visuals can be configured).
Created and maintained by tastybento.
Useful links
Installation#
- Restart the server (to enable the addon and have the
config.ymlfile generated) - Put the addon jar into the
plugins/BentoBox/addonsfolder - Customize settings in
config.yml(optional) - Restart the server to apply new settings
Commands#
Tip
[player_command] is a command that differs depending on the gamemode you are running. The Gamemodes' config.yml file contains settings that allows you to modify this value. As an example, on BSkyBlock, the default [player_command] is island.
border#
Command: /[player command] border
Description: Turns the border on/off.
Permission: [gamemode].border.toggle. Default: op.
Notes: Since Version 3.0.0 it requires a permission.
border type#
Command: /[player command] border type {barrier | vanilla}
Description: Sets the border type.
Permission: [gamemode].border.set-type. Default: true.
Example: /[player command] border type barrier
color#
Command: /[player command] color {red | green | blue}
Description: Sets the vanilla world border color for the player. Only applies when using the vanilla border type.
Permission: [gamemode].color.red, [gamemode].color.green, [gamemode].color.blue (or [gamemode].color.* for all). Default: op.
Example: /[player command] color green
Tip
[gamemode] is a prefix that differs depending on the gamemode you are running. The prefix is the lowercased name of the gamemode, i.e. if you are using BSkyBlock, the prefix is bskyblock. Similarly, if you are using AcidIsland, the prefix is acidisland.
Configuration#
The config.yml file contains settings.
The default value is usually the example value unless explicitly stated.
Disable game modes#
You can disable the addon with this setting.
By default, Border will operate in all game mode worlds on the BentoBox server.
You can disable a game mode by writing its name on a new line that starts with -.
Example to disable BSkyBlock:
disabled-gamemodes:
- BSkyBlock
Default value:
disabled-gamemodes: []
Return teleport#
Controls whether if players somehow manage to pass through the border (e.g. teleport in the same world), should they be teleported back to their islands.
Set to true if you want players to be teleported back.
Warning: If you set this value to false along with having use-barrier-blocks as false, players will be able to just simply walk through the border.
return-teleport: true
Tip
If you want to use this addon only to show the borders for the players, use the following settings:
use-barrier-blocks: false
return-teleport: false
Use barrier blocks.#
Only applies for players who are not using the vanilla border type.
true: the border will be made of barrier blocks.false: there will be no barrier block-based border. This means it is up to thereturn-teleportsetting whether players are teleported back when leaving the island.
use-barrier-blocks: true
Default border behavior#
Players can turn the border on and off with a command if they have the right permission.
This setting makes the default on or off; set it to true to have it on by default.
show-by-default: true
Show max-protection range border.#
Only applies for players who are not using the vanilla border type.
Set to true to show barrier (🚫) particles shown at the max protection range.
This is useful for game modes like Boxed where the player's protection area can move around.
Note that these are not barrier blocks but particles, so the "air" just looks like them.
show-max-border: true
Show particles#
Enables/disables all types of wall particles shown by the addon (border and max-protection range particles).
Set to false if you don't want any wall particles to be shown.
show-particles: true
Show warps on map#
Controls whether the vanilla world border color feature is available. Colors for individual players are set with the /[player_command] color command. Requires a web map plugin (Dynmap or BlueMap) and the BentoBox map hook.
show-warps-on-map: true
Placeholders#
| Placeholder | Description | Version |
|---|---|---|
%Border_color% | The current border color for the player (red, green, or blue) | 4.8.0 |
Changelog#
What's new in v4.7.0 → v4.8.2
Released: 2026-02-16 to 2026-04-04
- Vanilla world border color selection. Players using the vanilla border type can now choose their border color — red, green, or blue — via
/[player_command] color {red|green|blue}. - New
%Border_color%placeholder returns the player's current border color. - New permissions
[gamemode].color.red,[gamemode].color.green,[gamemode].color.blue(or[gamemode].color.*for all colors). Default: op. - Bug fix: border teleportation bypass when a player is outside all island spaces (4.7.0).
- Bug fix: vanilla world border not resetting when a player teleports between islands — was causing Bedrock/Geyser players to enter a restricted state (4.8.1).
- Bug fix:
%Border_color%placeholder throwing null error in some configurations (4.8.1). - Bug fix: border incorrectly activating in vanilla nether and end worlds (4.8.1).
Release v4.7.0 · v4.8.0 · v4.8.1 · v4.8.2
What's new in v4.8.3
Released: 2026-04-26
- 🔡 All locale files converted from legacy
&-colour codes to MiniMessage format. - 🔡 Missing
set-colorkeys added to every non-English locale. - 🔡 Bug fixes for Polish, Ukrainian, and Chinese locale files.
- 🔺 Minimum BentoBox API bumped to 3.12.0.
🔺 If you maintain custom locale overrides under plugins/BentoBox/addons/Border/locales/, migrate colour codes from &a style to MiniMessage tags (e.g. <green>) before restarting.
What's new in v4.8.4
Released: 2026-05-26
- 🐛 Fixed
NoSuchMethodError: WorldBorder.changeSizeon Paper/Purpur 1.21.10. The 4.8.3 build was compiled against Paper 1.21.11, which renamed the world-border lerp method, so the vanilla border type crashed on 1.21.10 servers when/[player_command] bordertype vanillawas used. Border now uses the cross-versionsetSizeAPI and works on both 1.21.10 and 1.21.11. - 🐛 Fixed the Modrinth publish workflow (incorrect artifact path).
No config or locale changes are required. If you worked around the bug with bordertype barrier, you can switch back to vanilla once 4.8.4 is installed.
Translations#
Help us keep translations accurate
Most BentoBox and addon translations are now generated with the help of AI, so the bulk of the work is already done — but AI is not perfect. What we really need from the community is error reports and corrections.
- Spotted a mistake or awkward phrasing? Open an issue or a PR on the relevant repository at bentobox.world (a short link to our GitHub org), or tell us on Discord.
- Want to add a brand-new language? Open a PR adding a new locale file to
src/main/resources/locales/in the relevant repo, or ask on Discord and we'll get you started.
| Language | Language code | Progress |
|---|---|---|
| English (United States) | en-US | 100% (Default) |
| Chinese, China | zh-CN | 100% |
| Chinese, Taiwan | zh-TW | 100% |
| Croatian | hr | 100% |
| Czech | cs | 100% |
| Dutch | nl | 100% |
| French | fr | 100% |
| German | de | 100% |
| Hungarian | hu | 100% |
| Indonesian | id | 100% |
| Italian | it | 100% |
| Japanese | ja | 100% |
| Korean | ko | 100% |
| Latvian | lv | 100% |
| Polish | pl | 100% |
| Portuguese | pt | 100% |
| Romanian | ro | 100% |
| Russian | ru | 100% |
| Spanish | es | 100% |
| Turkish | tr | 100% |
| Ukrainian | uk | 100% |
| Vietnamese | vi | 100% |
Source#
Want to contribute? See this documentation's source code at GitHub.