Перейти к содержимому
Mineforgian

Waystone Warps

An enhanced teleportation experience for PaperMC servers that does away with bog standard /warp commands.

Загрузки
7K
Подписчики
51
Обновлён
15 мая 2026 г.
Лицензия
MIT

Опубликован 16 февраля 2025 г.

🧭 Waystone Warps

A waystone placed in the world

Transform your travels with the Waystone Warps plugin! Craft and place waystones to set up teleportation points throughout your world. Discover new waystones placed by others as you explore and easily teleport between them. Streamline your journey across the world knowing you can always teleport back home in a snap, or simply visit your friends in an instant.

Here are some of the cool features you can expect:

  • Physically Grounded - Warps are bound via a physical waystone structure in the world, making the experience much more immersive.
  • Intuitive GUI Menus - Your entire waystone can be managed using click menus. Never need to type a command ever again.
  • Manage Access Easily - Limit your waystones to only you, open it up to your friends, or leave it out there for the public to find.
  • Teleportation Fees - Let your players work for it! Change teleportation costs between xp, items, or even a provided economy plugin.

Installation

Download the latest release (.jar file) from the releases tab and place it in your server's plugins folder.

For additional functionality such as per player/rank permissions and warp limits, you must install Vault as well as a compatible permission and chat metadata provider. LuckPerms is a recommended plugin for handling both.

Getting Started

To establish a waystone warp, place down a lodestone on top of a smooth stone block, then right click the lodestone. This opens up a creation menu where you are able to name your warp. Once the waystone warp is established, you will be presented with various options to do with warp management.

To discover waystones made by other players, right click a waystone and watch the particles change colours.

To teleport to waystones, right click with a compass in hand. This will bring up a menu listing all your discovered waystons. Click on the waystone of choice to teleport to it.

Permissions

  • waystonewarps.command.warpmenu - Allows the use of the warpmenu command to open up the menu that allows players to teleport to warps.
  • waystonewarps.bypass.open_menu - Allows access to open the management menu.
  • waystonewarps.bypass.access_control - Allows access to change the access control.
  • waystonewarps.bypass.manage_players - Allows access to manage players.
  • waystonewarps.bypass.rename - Allows access to rename the waystone.
  • waystonewarps.bypass.icon - Allows access to change the waystone icon.
  • waystonewarps.bypass.relocate - Allows access to relocate the waystone.
  • waystonewarps.admin.invalids.list - Allows usage of the list command.
  • waystonewarps.admin.invalids.remove - Allows usage of remove command.
  • waystonewarps.admin.invalids.removeall - Allows usage of removeall command.
  • waystonewarps.teleport - Allows teleportation
  • waystonewarps.teleport.interworld - Allows teleportation to undiscovered warps
  • waystonewarps.teleport.cooldown_bypass - Allows bypassing the cooldown timer
  • waystonewarps.create - Allow the creation of warps
  • waystonewarps.discover - Allow the discovery of warps

Per Player Limits

Ensure that you have a Vault provider installed to set limits as described out in the installation section. Each Vault provider plugin has its own way of implementing this feature. As LuckPerms is the recommended provider, instructions will make use of it as such.

To set a metadata for a player, use command:

/lp group <group_name> meta set <limit_name> <desired_number>

For groups:

/lp user <user_name> meta set <limit_name> <desired_number>

Here are the different limits you can set:

  • waystonewarps.warp_limit - Defines how many waystone warps a player can create.
  • waystonewarps.teleport_cost - Defines how much it costs to teleport.
  • waystonewarps.teleport_timer - Defines how long it takes to teleport.

Building from Source

Requirements

  • Java JDK 21 or newer
  • Git

Compiling

git clone https://gitlab.com/Mizarc/waystonewarps.git
cd waystone-warps/
./gradlew shadowJar

Built .jar binary can be found in the build/libs folder.

Support

If you encounter any bugs, crashes, or unexpected behaviour, please open an issue in this repository.

License

Waystone Warps is licensed under the permissive MIT license. Please view LICENSE for more info.

Ченджлог

1.1.0Релиз26.1, 26.1.1, 26.1.2 · 15 мая 2026 г.

New release with 26.1 support! I took a bit of a hiatus so there were pending issues and PRs that I could've solved earlier, but they're here now.

Thank you to all contributors who not only designed new features, but implemented said features in a pull request. Not everything went through as I either found the UX unintuitive or wanted some changes for consistency, I kept in as much as I could within the bounds of my vision for the future of this plugin. As this is the first feature update of the stable release, I tried to keep the transition as seamless as possible. As far as I'm aware the database should migrate automatically with no issues, but do let me know if there are any concerns.

Added

  • Support for Minecraft 26.1.
  • New /warpcreate command to create a new waystone via command. Build a waystone as usual but type this command while looking at the lodestone block. Permission to use: waystonewarps.command.warpcreate
  • New "Global" access type for warps. Warps with this access can be used without discovery.
  • Boss bar teleport timer. Can be optionally toggled via config.
  • Waystones can no longer be moved into areas protected by land protection plugins.
  • Teleport cost can be dynamic based on distance, config options provided to tweak.
  • Warp groups feature, optionally enabled via config. Allows players to put their warp under a group for easier browsing. Groups are admin-defined.
  • Teleporting can now be restricted by a config cooldown or a player override with a metadata value: waystonewarps.teleport_cooldown
  • Player override values can be set without a metadata provider such as Vault. Permissions are as follows:
    • waystonewarps.warp_limit.<number>: Sets a player's waystone creation limit, for example waystonewarps.warp_limit.4 or waystonewarps.warp_limit.19. Highest matching value wins.
    • waystonewarps.warp_limit.*: Allows unlimited waystone creation.
    • waystonewarps.teleport_cost.<number>: Sets a player's teleport cost multiplier, for example waystonewarps.teleport_cost.0.5 for half price. Lowest matching value wins.
    • waystonewarps.teleport_cost.*: Allows free teleportation (zero cost).
    • waystonewarps.teleport_timer.<number>: Sets a player's teleport timer in seconds, for example waystonewarps.teleport_timer.3 for 3-second timer. Lowest matching value wins.
    • waystonewarps.teleport_timer.*: Allows instant teleportation (zero timer).
    • waystonewarps.teleport_cooldown.<number>: Sets a player's teleport cooldown in seconds, for example waystonewarps.teleport_cooldown.20 for 20-second cooldown. Lowest matching value wins.
    • waystonewarps.teleport_cooldown.*: Allows instant teleportation (zero timer).
  • Towny support, which allows for free travel between two of the same town.
  • Simplified Chinese (zh_cn) localization.

Changed

  • Waystone skin menu tooltip now provides clearer information on how to use the blocks to apply the skins.

Fixed

  • Teleport particles and sound not appearing when teleportation is instant.
  • Shift clicking items into menus deletes items.
  • Check failure error when an item being placed does not have an attached ItemMeta.

Removed

  • waystonewarps.teleport.cooldown_bypass permission.
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 4 января 2026 г.

Here comes the long awaited stable release of Waystone Warps 1.0! I know you guys have been messaging me on Discord and even emailing me about adding support for 1.21.11, so I put in some extra legwork this week to dish out a whole host of new features focusing on the refinement of the plugin.

While the general usage of the plugin remains the same, this release brings in fine control as to what administrators and developers are able to leverage. Administrators now have more fine grained permission control and can even modify other players' claims. A new command system is in place that allows you to remove invalid claims in older worlds. There's even a new API for developers to hook into. If you're a developer and have problems using this API, let me know what I can do to resolve it. Of course we can't forget the localisation system, allowing this plugin to be translated into whatever language you want.

I think it's now all ready to be labelled a stable release, though I don't expect this to be a totally bug free experience. If you have any issues, feel free to raise an issue about it. I'll get onto it as soon as possible.

Added

  • Support for Minecraft 1.21.11.
  • Waystone creation is covered by protections that protect against block placing.
  • Icons for waystones now support metadata including custom model data, armour dyes, trims, firework colours, potion types.
  • Automatic database schema migrations on startup, including schema version tracking.
  • New permissions to allow administrators to manage other players' waystones:
    • waystonewarps.bypass.open_menu: Allows access to open the management menu.
    • waystonewarps.bypass.access_control: Allows access to change the access control.
    • waystonewarps.bypass.manage_players: Allows access to manage players.
    • waystonewarps.bypass.rename: Allows access to rename the waystone.
    • waystonewarps.bypass.icon: Allows access to change the waystone icon.
    • waystonewarps.bypass.relocate: Allows access to relocate the waystone.
  • New command system to remove invalid warp world data:
    • /waystonewarps invalids list: Lists missing worlds containing warps.
    • /waystonewarps invalids remove <id> Removes warps for a given world.
    • /waystonewarps invalids removeall: Removes all warps for missing worlds.
  • New permissions to use the invalids command system:
    • waystonewarps.admin.invalids.list: Allows usage of the list command.
    • waystonewarps.admin.invalids.remove: Allows usage of remove command.
    • waystonewarps.admin.invalids.removeall: Allows usage of removeall command.
  • New API to get warps and listen to events:
    • WaystoneWarpsAPI: Provides getters to get warp data.
    • WarpCreateEvent: Called when a warp is created.
    • WarpDeleteEvent: Called when a warp is deleted.
    • WarpUpdateEvent: Called when a warp is updated.
  • New permissions to disallow teleportation:
    • waystonewarps.teleport: Disallows teleportation entirely
    • waystonewarps.teleport.interworld: Disallows teleportation to undiscovered warps
    • waystonewarps.teleport.cooldown_bypass: Bypasses the set cooldown timer
  • New permission to disallow the creation of warps waystonewarps.create
  • New permission to disallow the discovery of warps waystonewarps.discover
  • New permission to use the /warpmenu command waystonewarps.command.warpmenu
  • Localisation support, with languages now contained in properties files in the lang folder. Currently only supports English.

Changed

  • Primary menu action buttons are now gold with a grey description for standardisation.
  • Menu buttons that denote alternative actions are as described:
    • Info only: BLUE
    • Confirm: GREEN
    • Cancel/Back: RED
    • Unavailable: GREY

Fixed

  • Config not being read on the first launch, required restart before the plugin could actually let you do anything.
  • Waystones not being covered by protection plugins even though the block break itself is prevented.
  • Whitelists not being removed from the database when the waystone is removed.
  • Pagination for warps and player access were not showing correctly.
0.3.5Бета1.21.8, 1.21.9, 1.21.10 · 11 октября 2025 г.

I've figured out an independent solution for the inventory GUI system, meaning releases can happen faster after new MC versions come out.

Added

  • Support for Minecraft 1.21.7, 1.21.8, 1.21.9, and 1.21.10.

Changed

  • Waystones are now reverted back to their original state when the plugin is disabled.
0.3.4Бета1.21.4, 1.21.5, 1.21.6 · 5 июля 2025 г.

Sorry for the late update, we're dropping support for 2 new Minecraft versions this time and a small feature drop to go with it!

Added

  • Support for Minecraft 1.21.5 and 1.21.6.
  • Waystones can now display holographic text information above them containing their name and coordinates.
  • New config value to toggle whether waystones will have a hologram.
0.3.3Бета1.21.2, 1.21.3, 1.21.4 · 18 апреля 2025 г.

Fixed

  • Waystone creation not checking if the top block is a Lodestone, resulting in the menu popping up for any block on top of a valid base block.
  • Waystone creation with base bypassing removal of config specified base block
0.3.2Бета1.21.2, 1.21.3, 1.21.4 · 14 апреля 2025 г.

Quick minor release which addresses several known issues. Pending a proper 1.21.5 release due to blocked Inventory Framework dependency. No ETA until the dependency updates or an alternate solution is found.

Added

  • Player hand swings when interacting with a waystone or changing the base block.

Fixed

  • Trying to incorrectly find list_menu_via_compass and list_menu_via_waystone instead of warps_menu_via_compass and warps_menu_via_compass
  • Warp owner unable to teleport to their own warp when locked.
  • Incorrect message when teleport is cancelled due to movement.
0.3.1Бета1.21.2, 1.21.3, 1.21.4 · 25 марта 2025 г.

Known issue: Config values of warps_menu_via_compass and warps_menu_via_waystone are incorrectly set in the code to find list_menu_via_waystone and list_menu_via_waystone instead. Change the config values to the latter values until patched in the next update.

Fixed

  • Error handling when invalid cost type in the config. Falls back to ITEM if set to an invalid type.
  • Error when using invalid materials in the config. Invalid materials are now skipped over or set to default when required.

Fixed

  • Invalid cost type in the config. Falls back to ITEM if set to an invalid type.
  • Error when using invalid materials in the config. Invalid materials are now skipped over or set to default when required.
0.3.0Бета1.21.2, 1.21.3, 1.21.4 · 23 марта 2025 г.

Added

  • Warp menu contains filters to switch between discovered, favourites, and owned.
  • Search can be used to narrow down the list of discovered warps.
  • Warp sub-menu can be used to delete, favourite, or point the currently held compass to the direction of the warp.
  • Waystones can have their appearance changed by clicking on the base of the block with a valid block.
  • Waystones can also have their appearance changed on creation by placing down the lodestone on a valid block type.
  • Valid block skins are displayed on the "View Available Skins" submenu of the management menu.
  • Waystone skin types can be specified in the config with a required structure.
  • Particles are displayed on the waystone depending on personal state. Bright green for owner, dull green for discovered, orange for locked, white for undiscovered.
  • Particles are displayed to indicate the player being teleported and arriving at their destination.
  • Sounds are played for vault creation and discovery.
  • Sounds are played for the player being teleported and arriving at their destination.
  • Sounds are played for changing the skin of the waystone.
  • Config toggle to enable the functionality of using the compass to open the warp list menu.
  • Config toggle to enable the functionality of using the waystone to open the warp list menu, moving the management menu to shift+right click.
  • A sample-config.yml file is generated fresh on every launch to ensure that the most update to date base config format is known to administrators.

Changed

  • The base of the waystone is now a slab rather than a barrier, making the space above the slab clickable to set the skin.
  • Lists of players and warps are sorted alphabetically.

Комментарии

Загружаем…