# SignWarp<\/p>\n
   <\/p>\n
A Bukkit plugin for teleportation using signs.
\n**(Minecraft Version 1.20 – 1.21.8)**<\/p>\n
SignWarp allows players to place signs to teleport between them with a simple right-click.<\/p>\n
By default, teleportation costs one ender pearl, which must be in the player’s hand when interacting with the sign, but this can also be disabled in the configuration.<\/p>\n
## Permissions<\/p>\n
– `signwarp.create` – Allow creation and destruction of warp signs (default: op)
\n– `signwarp.use` – Allow usage of warp signs (default: everyone)
\n– `signwarp.reload` – Allow access to reload (default: op)
\n– `signwarp.admin` – Allows access to the warp management GUI (default: op)
\n– `signwarp.*` – Allow access to all features (default: op)
\n– `signwarp.limit.unlimited` – Allows unlimited warp creation<\/p>\n
Commands:<\/p>\n
– `\/signwarp reload` – Reloads the configuration.
\n– `\/signwarp gui` – Open the warp management GUI.<\/p>\n
## How to Use<\/p>\n
First, place a sign where you want to teleport with the following content:<\/p>\n
– First line: **[WarpTarget]** or **[WPT]**
\n– Second line: The name you want to use<\/p>\n
This will create a warp sign that sets the location to which a player teleports.<\/p>\n
After creating the warp sign, create one or more warp signs from which you want to teleport to the target sign.<\/p>\n
This is done by placing a sign with the following content:<\/p>\n
– First line: **[Warp]** or **[WP]**
\n– Second line: The name you want to use<\/p>\n
**Note: The target sign (WarpTarget) must exist before creating the warp sign!**<\/p>\n
### Bi-Directional Teleportation (New in v1.2.0!)<\/p>\n
SignWarp now supports **bi-directional teleportation**! This enhancement allows players to travel back and forth between paired warp signs seamlessly.<\/p>\n
#### How It Works<\/p>\n
– **Forward Travel**: Right-clicking a **[Warp]** sign teleports you to the corresponding **[WarpTarget]** (existing behavior)
\n– **Return Travel**: Right-clicking a **[WarpTarget]** sign now teleports you back to the corresponding **[Warp]** sign (new feature!)<\/p>\n
This creates a true two-way teleportation system between paired signs, perfect for:<\/p>\n
– Creating transportation networks between bases
\n– Setting up quick travel points in adventure maps
\n– Establishing merchant shop connections
\n– Building dungeon entrance\/exit systems<\/p>\n
#### Technical Details<\/p>\n
– Both directions respect the same permissions, cooldowns, and costs
\n– The plugin tracks sign locations in a database for reliable bi-directional links
\n– If either sign is broken, the link is automatically cleaned up
\n– Works with all existing warp configurations (economy costs, item costs, effects, etc.)<\/p>\n
Once you have created both signs, you can right-click with the `use-item` in your hand (by default, it’s an ender pearl).
\nEach teleportation will cost the number of items configured in `use-cost` (default: 1).<\/p>\n
You can remove the `use-item` option in the config.yml or set it to “none” to allow any item to be used (i.e., each warp is free per use).<\/p>\n
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.<\/p>\n
## Warp Limit System<\/p>\n
Control the maximum number of warps players can create using permissions.<\/p>\n
Example with LuckPerms:<\/p>\n
`\/lp group default permission set signwarp.limit.3`<\/p>\n
This allows players in the default group to create up to 3 warps.<\/p>\n
Without a limit permission, players can create an unlimited number of warps by default.<\/p>\n
## Admin GUI<\/p>\n
<\/p>\n
## Message Customization<\/p>\n
In the `config.yml` configuration file, you have the option to customize the messages used by the plugin. These messages are defined under the key messages and can be modified according to your preferences.<\/p>\n
**Preview :**<\/p>\n
“`yaml
\nmessages:
\n create_permission: “&cYou do not have the required permissions to create warp signs!”
\n no_warp_name: “&cNo warp name set!nPlease specify the warp name on the second line.”
\n warp_created: “&aWarp sign successfully placed.”
\n warp_name_taken: “&cA warp target with the same name already exists!”
\n warp_destroyed: “&aWarp destroyed.”
\n target_sign_created: “&aTarget sign for warp successfully placed.”
\n destroy_permission: “&cYou do not have the required permissions to destroy warp signs!”
\n invalid_item: “&cYou must use {use-item} for this warp!”
\n not_enough_item: “&cYou need {use-cost} {use-item} for this warp!”
\n warp_not_found: “&cSpecified warp does not exist!”
\n use_permission: “&cYou do not have the required permissions to use the warp sign!”
\n teleport: “&eTeleporting to {warp-name} in {time} seconds…”
\n teleport-success: “&aSuccessfully teleported to {warp-name}.”
\n teleport-cancelled: “&cTeleport cancelled.”
\n notify-cost: “&aYou have been charged {cost} currency for the teleportation.”
\n not_permission: “&cYou do not have permission!”
\n limit_reached: “&cYou have reached your warp creation limit ({limit}).”
\n warp_sign_removed: “&aWarp sign removed successfully!”
\n no_bidirectional_link: “&cNo return point found for this warp!”
\n “`<\/p>\n
– `{warp-name}` : This placeholder is replaced by the name of the warp specified on the sign.
\n– `{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”.
\n– `{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”.
\n– `{cost}` : This placeholder is replaced by the amount of currency charged for teleportation.
\n– `{time}` : This placeholder is replaced by the time in seconds before the teleportation is completed.<\/p>\n
You have the option 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 informations<\/p>\n
## Sound and Effect Customization<\/p>\n
You can customize the sound and effect played during teleportation in the `config.yml` configuration file:
\nList Sound and List Effect<\/p>\n
**Note : The sound and effect must be in uppercase and replace “.” by “_” for the sound.**<\/p>\n
**Preview :**<\/p>\n
“`yaml
\nteleport-sound: ENTITY_ENDERMAN_TELEPORT
\nteleport-effect: ENDER_SIGNAL
\n“`<\/p>\n
## Screenshot<\/p>\n
<\/p>\n
## Statistics (bstats.org)<\/p>\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Allows players to place panels to teleport between them by simply right-clicking on them.<\/p>\n","protected":false},"featured_media":139412,"template":"","meta":{"_minecraft_slug":"signwarp","_minecraft_project_id":"1QUtO3R9","_minecraft_author":"siriusbks","_minecraft_license":"MIT","_minecraft_downloads":1105,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"signwarp.zip","_minecraft_size_bytes":38968381,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-16T08:18:59.349838Z","_minecraft_date_created":"2024-04-15T00:09:42.575602Z","_minecraft_date_modified":"2025-09-08T17:49:48.690498Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/signwarp","_minecraft_icon_attachment_id":139412,"_minecraft_imported_at":"2026-06-08T06:17:51+00:00","_minecraft_import_hash":"844bcfba909ac297d361751e445990a4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,127,128,129,869,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-139411","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n