JMC Warp is a plugin for Minecraft servers that adds the ability to craft special Warpstone blocks that allow players to easily teleport between two connected Warpstones.

Installing
Guide for players
Guide for administrators
Guide for developers
FAQ

Simply copy the plugin's .jar file into your server's plugin folder and restart the server. The plugin will then be enabled.

A Warpstone can be crafted by placing a Lodestone and an Enderpearl into a crafting square. The recipe is shapeless so you don't need to worry about where the ingredients are placed.

A Warpstone can be renamed in an anvil like any other item and this allows the player to differentiate between different Warpstone locations. e.g Farm or Home.

When a Warpstone is first placed in the world it will not be connected to any destinations so it will function like a normal Lodestone. In order to connect two Warpstones one must be placed on top of another. This will connect the two so that they will allow teleportation between them. If the connect is successful the player will hear a sound effect, see a particle effect, and receive a message letting them know that the two Warpstones are now connected.

Warpstones can be picked up and relocated just like any other block and they will retain their connections.

Once two Warpstones are connected together and each are placed in the world, players are free to use them as warps. Simply standing on either Warpstone will teleport them to the other.

If the destination Warpstone has been removed from the world (either by a player or due to an explosion) the Warpstone will not teleport the player but let them know that the destination is no longer valid.

The following settings can be changed in the config.yml file.

Default: minecraft:lodestone
Specifies which block to use in the warpstone crafting recipe.

Gives the player a warpstone.

The Warpstone state is currently persisted in the file todo.yml. In future versions this may change to something more scalable.

The plugin raises the following events;

Raised when a Warpstone is crafted.

Raised when a Warpstone is placed in the world by a player.

Raised when a Warpstone is placed on top of another and the two are successfully connected together.

Raised when a player walks on to a Warpstone even if it doesn't have a destination.

Raised after a player has walked onto a Warpstone and has been teleported to the destination Warpstone.

Rasied when Warpstone is destroyed via EntityExplodeEvent, BlockExplodeEvent or BlockBreakEvent.

The Warpstone will always drop itself so a player can pick it back up and it will retain all of it's connection information so that it can be replaced.

If a Warpstone is connected to more than one destination it will store that information but a player using that Warpstone will currently always warp to the first destination that was connected. Effectively ignoring all connections after the first. This will be addressed in a future version where the player will be able to select which of the connected destinations to warp to.

Currently anybody can craft a Warpstone if they have the right ingredients but in a future version this ability will need to be unlocked via a command so that ranks and permissions can be supported.

Not at the moment but in a future version a Warpstone will be able to be placed in a Grindstone in order for it's connection to be removed. Effectively turning back into a Lodestone.

Lodestones seem to fit from a lore perspective and they also aren't cheap to craft meaning Warpstones won't be overused. This can be changed in the configuration.

Blocks are diegetic, commands are cumbersome to type on certain devices.

If the destination Warpstone is no longer placed in the world (because a player removed it or it got destroyed somehow) the Warpstone will simply not teleport the player and will inform them with a message.

Yep. Multidimensional warping is supported.