A Bukkit plugin to teleport using signs.
(Minecraft Version 1.20 - 1.21)


SignWarp allows players to place signs to teleport between them with a simple right-click.

By default, teleportations have a cost of one ender pearl which must be in the player's hand when interacting with the sign, but it can also be disabled in the configuration.

Permissions

- signwarp.create - Allow creation and destruction of warp signs (default: op)
- signwarp.use - Allow usage of warp signs (default: everyone)
- signwarp.reload - Allow access to reload (default: op)
- signwarp.admin - Allows access to the warp management GUI (default: op)
- signwarp.* - Allow access to all features (default: op)

Commands:

- /signwarp reload - Reloads the configuration.
- /signwarp gui - Open the warp management GUI

How to use?

First, place a sign where you want to teleport with the following content:

- First line: [WarpTarget] or [WPT]
- Second line: The name you want to use

This will create a warp sign that sets the location to which a player teleports.

After creating the warp sign, create one or more warp signs from which you want to be able to teleport to the target sign.

This is done by placing a sign with the following content:

- First line: [Warp] or [WP]
- Second line: The name you want to use

Note: The target sign (WarpTarget) must exist before creating the warp sign!

Once you have created both signs, you can right-click with the use-item in your hand (by default, it's an ender pearl).
Each teleportation will cost the number of items configured in use-cost (default: 1).

You can remove the use-item option in the config.yml or set it to "none" to allow any item to be used (meaning each warp is free per use).


Alternatively, you can enable teleport-cost in the config.yml to charge players a set amount of in-game currency for each teleportation. Ensure Vault is installed on your server to use this feature.

It is possible to define a cooldown in seconds

Admin GUI



Message Customization

In the config.yml file, you have the ability to customize the messages used by the plugin. These messages are defined under the messages key and can be modified according to your preferences.

• {warp-name}: This placeholder is replaced by the name of the warp specified on the sign.
• {use-item}: Used to represent the name of the item required to use the warp. For example, if the required item is an ender pearl, this placeholder will be replaced by "ENDER_PEARL".
• {use-cost}: This placeholder is replaced by the number of items needed to use the warp. For example, if the cost to use the warp is 1 ender pearl, this placeholder will be replaced by "1".
• {cost} : This placeholder is replaced by the amount of currency charged for teleportation.
  
• {time}: This placeholder is replaced by the time in seconds before the teleportation is completed..

You have the ability to stylize your texts with Minecraft color codes. These codes start with the character &, followed by a letter or number representing a specific color. More information

Sound and Effect Customization

You can customize the sound and effect played during teleportation in the `config.yml` configuration file:
List Sound and List Effect

Note : The sound and effect must be in uppercase and replace "." by "_" for the sound.

Screenshot