Minecraft Data Packs / Quality of Life

Waystones - A fast way to travel in your world with waypoints

  • check_circle Advancements
  • check_circle Functions
  • check_circle Recipes
  • 107,087 views, 348 today
  • 34,629 downloads, 131 today
  • 497
  • 588
  • 199
PauseKawa avatar PauseKawa
Level 65 : High Grandmaster Programmer
Pause Kawa - Waystones - V.1.0.5

Craft and place Waystones to define waypoints at different locations of your world.
A good way to travel fastly between your base and the ones of your friends!

Features :

  • Introduce Waystones, a block that allows you to define waypoints in order to fastly travel in your world.
  • A Waystone can be crafted with 1x Eye Of Ender, 2x Amethyst Shard, 1x Lodestone, and 3x Polished Andesite.
  • They work only in vanilla dimensions. You can place up to a total of 28 waypoints in your world.

How to use the Waystone?

I recommend you to see the tutorial video to get a better explanation and examples.

1. You can craft a Waystone using the following recipe:

Waystones - A fast way to travel in your world with waypoints Minecraft Data Pack

2. When you got the item, rename it into an Anvil. The name of the item will define the name of the Waystone and the waypoint in the list.
3. Place your Waystone anywhere in a vanilla dimension. Of course the location needs to have enough space for the block to fit (3-block high).
4. Right click the Waystone to open the waypoints list: From here you'll see all available waypoints you (or other players) already set in the world:

Waystones - A fast way to travel in your world with waypoints Minecraft Data Pack

5. Left click a waypoint to be teleported to it.
6. If you need to move or remove the Waystone, you can do it simply by breaking it. It will drop the relative item back.

Miscellaneous information about the block's behavior:
  • Clicking a waypoint will teleport the player in a circle of 1 block around the Waystone, so it is recommended to keep this radius not obstructed.
  • Trying to set the Waystone by clicking on the top of a non-full-high block will cancel the placement. Of course the item will be given back to your player, but be sure to place it on the top of a solid block.

Helpful commands (for OP players or cheats enabled world):

If you want to directly get a Waystone without the need of crafting it, you can give it to yourself with the command:
function pk_wast:waystone/helpers/give
If you want to remove every Waystones of a specific dimension (and their relative waypoint in the waypoints list), you join this dimension and use this command:
function pk_wast:base/uninstall/remove_all_waystones_in_dimension

Change the item used as appearance for the waypoint's button in the waypoints list:

There are two render-item-modes available to manage the render of an item used as a waypoint's button in the waypoints list:

The Biome mode is the default one. The button will take the appearance of a block that represents the biome the Waystone has been placed in.
If you switched to the other mode, you can enable it back using this command (it is already enabled by default):
data modify storage pk_wast:data RenderItemMode set value "biome"
The Support mode will make the button take the appearance of the block the Waystone has been placed on (need to be a valid full block).
If you want to use this mode, you can enable it using this command:
data modify storage pk_wast:data RenderItemMode set value "support"
In both modes, if the biome or block is not recognized by the data pack, it will set a grass block as default appearance for the waypoint button.

How to install?

Please refer to the Planet Minecraft tutorial to know how to install a data pack : How to Install Minecraft Data Packs.

How to uninstall?

1. In order to uninstall, first run this command in each vanilla dimension you (or your players) placed Waystones:
function pk_wast:base/uninstall/remove_all_waystones_in_dimension
2. Then when you remove them all for each dimension, you can run this function to clear the remaining storage data and scoreboard objectives:
function pk_wast:base/uninstall/clear_data
3. When it's done, you can remove the data pack from the "datapacks/" folder of your world.

Report an issue

Waystones - A fast way to travel in your world with waypoints Minecraft Data Pack Preferably join our Discord Server and create a thread in the dedicated channel for data pack issues.
Otherwise, you can do it directly in the comments section.

Known issues :

- "The data pack doesn't work well on Realms" : It is a common issue on Realms, you just need to remove and reinstall the data pack completely. Realms seems to have problems to load some references, and replace all "world" term from files name with the server's name. Yeah, even in data packs... So some predicates just break. The issue has been reported since a while, but still no fix provided from Mojang.
Ref: https://bugs.mojang.com/browse/REALMS-5452

- Vanilla Tweaks "Unlock all recipes" will spam the knowledge book's recipe toast every 5 seconds. It will be fixed in a future update of this last data pack by its author soon. Edit: Several months later, VT's data pack get an update without this issue being fixed... So I made a fork that is compatible with data packs that use the custom recipes trick. You can download it here.


This data packs is protected by the CC BY-NC-SA 3.0 license.

You're free to share and adapt this content under the following terms:
  • Attribution (BY) — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
  • NonCommercial (NC) — You may not use the material for commercial purposes.
  • ShareAlike (SA) — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.


This data pack was inspired by the famous Waystones mod of BlayTheNinth
Aeldrion - Iris raycast system (homemade fork)
Aeldrion - Minecraft-Random RNG system
CompatibilityMinecraft 1.18
toMinecraft 1.19

5 Update Logs

Update #5 : by PauseKawa 10/26/2022 10:29:11 pmOct 26th, 2022

Bug fix:
- /!\ Important : Using the drop key directly in a Waystone's GUI container allowed you to drop and use GUI items, causing a GUI items duplication exploit.

Create an account or sign in to comment.

03/14/2023 10:14 pmhistory
Level 1 : New Explorer
Its_Stubby avatar
Does this work for fabric? can't get it to work with fabric and sodium installed. I also have malilib for the minihud mod installed, IDK if they interfere with this.
03/15/2023 5:41 pm
Level 65 : High Grandmaster Programmer
PauseKawa avatar
I don't know TBH, the mod you have shouldn't affect the way data packs work.

What happens exactly?
03/14/2023 4:09 pm
Level 1 : New Explorer
SuperMegaGlitch1 avatar
Can I use it on 1.19.4?
03/14/2023 6:42 pm
Level 65 : High Grandmaster Programmer
PauseKawa avatar
03/08/2023 10:21 pm
Level 1 : New Miner
Proxilemit avatar
do these waystones spawn naturally in the world?
03/09/2023 12:44 pm
Level 65 : High Grandmaster Programmer
PauseKawa avatar
Hi, no they don't. They need to be placed by players.
03/02/2023 11:50 am
Level 40 : Master Engineer
JackieT avatar
Nice looking pack!
Why does it have a maximum of 26 waystones, though?
03/02/2023 11:57 am
Level 65 : High Grandmaster Programmer
PauseKawa avatar
28 Waystones, because 27 is the amount of slots a barrel can contain.
I didn't provide a pagination system that allows you to have several pages. It would be rather hard to do it dynamically (but probably not impossible).

At this stage I don't know if I will create another data pack from scratch in the future or let it like this, but I changed many things in my standards since I coded this data pack.
03/02/2023 11:59 am
Level 40 : Master Engineer
JackieT avatar
Ah, okay, that makes sense.
02/20/2023 6:26 pm
Level 1 : New Collective
yLe_ avatar
Hi! I'm running a paper server (no mods) and there's a problem that only people that have op can open the menu. Any solutions to that?
Planet Minecraft


© 2010 - 2023