Skip to content


Warps enables players to add a personal warp signs to their island.

Created and maintained by tastybento.


  1. Place the Warps addon jar in the addons folder of the BentoBox plugin
  2. Restart the server
  3. The addon will create a data folder and inside the folder will be a config.yml
  4. Edit the config.yml how you want.
  5. Restart the server if you make a change



After addon is successfully installed, it will create config.yml file. Every option in this file comes with comments about them. Please check file for more information. You can find the latest config file: config.yml

What is warp restriction?

This limits warp sign creation to players who have at least a certain level of island. It requires the Level addon and the default level is 10.

What is welcome text

This is the text that player must put on sign to make it a warp sign, e.g., [Welcome]. It is not case sensitive!

This text must be in the top line.

What is disabled GameModes?

This list stores GameModes in which Warps addon should not work.

To disable addon it is necessary to write its name in new line that starts with -. Example:

   - BSkyBlock

What is lore format?

Lore format allows changing default color for description lines in sign. Description lines are used in GUI.

Description lines contains sign lines that are bellow [welcome] text.

What is doing allow in other worlds?

This enables warp signs to be placed in any world, even non-BentoBox worlds.

Players must have the welcomewarpsigns.warp permission to use.

What is warp and warps?

The command warp requires <player> to which warp should happen, while warps opens menu that allows to choose a player.

If you have enabled allow in other worlds then it will be as a main command /warp

While for each BentoBox GameMode it still will be /[player_cmd] warp

Customizable GUI's#

BentoBox 1.17 API introduced a function that allows to implement customizable GUI's. This addon is one of the first one which uses this functionality. We tried to be as simple as possible for customization, however, some features requires explanation. You can find more information how BentoBox custom GUI's works here: Custom GUI's

How can I customize GUI's

To customize Addon GUI's you need to have version 1.12. This is a first version that has implemented them. Addon will create a new directory under /plugins/BentoBox/addons/Warps with a name panels

What does PREVIOUS|NEXT button type?

The PREVIOUS and NEXT button types allows creating automatic paging, when you have more islands than spaces in GUI. These types have extra parameters under data:

  • indexing - indicates if button will show page number.


    description: warps.gui.buttons.previous.description
      type: PREVIOUS
      indexing: true
        action: PREVIOUS

What is RANDOM button type?

This button allows players teleporting to a random warp. It is available only if there are more than 1 warp.


    icon: DROPPER
    description: warps.gui.buttons.random.description
      type: RANDOM
        click-type: left

What is WARP button type?

The WARP button creates a dynamic entry for a warp object.

Specifying title, description and icon will overwrite dynammic generation based on sign and database data. By default these values will be generated from database entries.

Icon PLAYER_HEAD will be replaced with owner player head. However, currently there is no option to specify differnet player head.


      icon: PLAYER_HEAD
      description: warps.gui.buttons.warp.description
        type: WARP
          click-type: left



[player_command] is command that differ depending on the gamemode you are running. The Gamemodes' config.yml file contains options that allows you to modify these values. As an example, on BSkyBlock, the default [player_command] is island. Be aware, that this addon allows changing player commands aliases in addon config.yml file.

  • /[player_command] warp <player>: warps player to targeted sign.
  • /[player_command] warps: opens GUI that allows to view all available warp signs.



[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.

  • [gamemode].island.warp - Player can use /[player_command] warp and /[player_command] warps commands. Enabled by default.
  • [gamemode].island.addwarp - Players can create warp signs. Enabled by default.
  • welcomewarpsigns.warp - Player can use /warp and /warps commands. Disabled by default. Requires allow-in-other-worlds.
  • welcomewarpsigns.addwarp - Players can create warp signs. Disabled by default. Requires allow-in-other-worlds.
Something is missing?

You can find the comprehensive list of permissions in the addon.yml file of this addon.
If something is indeed missing from the list below, please let us know!


Can you add a feature X?

Please add it to the list here.

I have a bug, where should I report it?

Please add it to the list here.


We need your help!

A vast majority of strings in BentoBox and its addons can be translated into virtually any language. However, most of the translations that are provided with BentoBox or said addons are made by the community, on which we heavily rely. We cannot review all the content of these translations nor guarantee its quality, hence why we highly appreciate any contributions.

  • If your language is not available for this addon or if you would like to improve the existing translation, please read the translation guidelines and start translating!
  • If your language is not listed below, please contact us on Discord and we will setup everything so that you can start translating!
Available Language Language code Progress
English (United States) en-US 100% (Default)
Chinese (China) zh-CN progress
Chinese (Hong Kong) zh-HK progress
Chinese (Taiwan) zh-TW progress
Croatian hr progress
Czech cs progress
French fr progress
German de progress
Hungarian hu progress
Indonesian id progress
Italian it progress
Japanese ja progress
Korean ko progress
Latvian lv progress
Polish pl progress
Portuguese pt progress
Romanian ro progress
Russian ru progress
Spanish es progress
Turkish tr progress
Vietnamese vi progress



Since BentoBox 1.17 API implemented a feature that solved an issue with classloaders. Plugins that wants to use events directly, now can do it.

You just need to add Visit to your project as dependency. You can use Maven for that:



Event that is triggered after player created a new warp sign.

Link to the class: WarpInitiateEvent


  • UUID player - id of the player who creates warp sign.
  • Location warpLoc - the location of warp sign.

Code example

@EventHandler(priority = EventPriority.MONITOR)
public void onWarpInitiate(WarpInitiateEvent event) {
    UUID player = event.getPlayer();
    Location warpLoc = event.getWarpLoc();


Event that is triggered after player created a new warp sign.

Link to the class: WarpRemoveEvent


  • UUID owner - id of the player who owns warp sign.
  • UUID remover - id of the player who removes warp sign.
  • Location warpLoc - the location of warp sign.

Code example

@EventHandler(priority = EventPriority.MONITOR)
public void onWarpRemove(WarpRemoveEvent event) {
    UUID owner = event.getOwner();
    UUID remover = event.getRemover();
    Location warpLoc = event.getWarpLocation();

Last update: May 17, 2022 10:22:35