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

---

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:



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:



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

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.

---

License

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.

---

Credits

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