Waystones is a teleportation mod that adds mystical stone pillars throughout the world, allowing players to fast travel between discovered locations. The mod eliminates the need for command-based teleportation by providing craftable blocks and items that create a network of travel points across dimensions.
Players can discover Waystones naturally spawning in villages and throughout the wilderness, or craft their own to establish custom teleportation hubs. The mod offers multiple ways to teleport, from permanent stone structures to consumable scrolls, each with different costs and requirements.
Getting Started
Finding Your First Waystone
The easiest way to begin using Waystones is by finding one that has naturally spawned. Villages have a chance to generate with a Waystone already placed, providing an immediate teleportation point without any crafting required.
Wild Waystones also spawn approximately every 25 chunks throughout the Overworld, Nether, and End dimensions. These appear as tall stone pillars with a glowing crystal and can be activated by right-clicking on them.
When first activating a Waystone, players are prompted to give it a name. This name helps identify the location when selecting teleport destinations. Players can also choose whether the Waystone should be private or accessible to everyone on the server.
Teleportation Costs
Teleporting between Waystones costs experience levels by default. The cost scales based on distance traveled, calculated at approximately 1 level per 100 blocks. Traveling between dimensions has a fixed cost of 27 levels.
Global Waystones, which are accessible to all players, have no teleportation cost. Server administrators can configure these costs or disable them entirely through the mod configuration.
Set Waystones to global visibility when placing them to allow free teleportation. This is particularly useful for public servers or shared bases where players want unrestricted fast travel.
Waystones
Crafting Waystones
Crafting a Waystone requires first creating a Warp Stone, which serves as the magical core. The Warp Stone is crafted using 4 Amethyst Shards, 4 Ender Pearls, and 1 Gold Ingot arranged in a diamond pattern.
Once the Warp Stone is crafted, combine it with 5 Stone Bricks to create the Waystone block. The Warp Stone goes in the center with Stone Bricks surrounding it in a cross pattern.
Waystone Variants
Waystones come in six different visual styles to match various building aesthetics. The standard Waystone uses Stone Bricks, while variants include Mossy, Sandy, Deepslate, Blackstone, and End Stone designs.
Wild Waystones automatically generate with styles matching their biome. Desert biomes produce Sandy Waystones, swamps and jungles create Mossy variants, and deep cave locations spawn Deepslate versions.
Scrolls
Scrolls provide portable teleportation options that can be used without standing at a Waystone. They are consumable items that offer different levels of flexibility depending on the scroll type.
Return Scroll
Return Scrolls teleport players to the nearest activated Waystone. They are the most affordable scroll option, requiring only 2 Gold Nuggets, 1 Ink Sac, and 3 Paper to craft three scrolls.
These scrolls automatically bind to whichever Waystone is closest to the player, making them ideal for quick escapes back to civilization. Unlike other teleportation methods, Return Scrolls do not cost experience levels to use.
3Warp Scroll
Warp Scrolls open a selection menu allowing players to choose any activated Waystone as their destination. They require 4 Gold Nuggets, 1 Amethyst Shard, 1 Ink Sac, and 3 Paper to craft three scrolls.
When used, Warp Scrolls display the same interface as a Waystone, showing all available destinations. The scroll is consumed after successful teleportation but does not require experience levels.
3Bound Scroll
Bound Scrolls are created by right-clicking a Blank Scroll on a Waystone. The scroll permanently binds to that specific Waystone and will always teleport to that destination when used.
Blank Scrolls are crafted using 2 Gold Nuggets, 1 Feather, and 3 Paper to create three scrolls. Once bound, the scroll shows the name of its destination in the item tooltip.
Warp Stone
The Warp Stone is a reusable item that functions similarly to Warp Scrolls but has durability instead of being consumed. It has 10,000 durability and loses 80 durability per teleportation.
Using a Warp Stone requires holding right-click for approximately 1.6 seconds before the teleportation menu appears. The charge-up time creates particles around the player and can be interrupted by taking damage.
Warp Plates
Warp Plates are pressure-plate style blocks that automatically teleport entities when they stand on them. Unlike Waystones, they do not appear in the Waystone network and only teleport to other Warp Plates they are linked to.
Crafting Warp Plates
Warp Plates are crafted using 4 Stone Bricks, 4 Amethyst Shards, and 1 Flint in a cross pattern. The recipe does not require a Warp Stone, making them more accessible early in the game.
Using Attuned Shards
Warp Plates require Attuned Shards to establish connections between plates. When a Warp Plate is placed, it automatically generates a Dormant Shard inside. After 1.5 seconds, this shard attunes to the plate and becomes an Attuned Shard.
To link two Warp Plates, take the Attuned Shard from one plate and place it in another. Entities standing on a plate with an Attuned Shard will teleport to the original plate after 0.75 seconds.
Warp Plates work across dimensions and can teleport mobs and other entities. This makes them useful for mob farms, transportation systems, and creative builds that require automatic teleportation.
Warp Plates can hold multiple Attuned Shards for more complex setups. Adding Quartz to a plate enables round-robin mode, cycling through destinations. Adding a Spider Eye prioritizes single-use shards like Crumbling Attuned Shards.
Sharestones and Portstones
Sharestones
Sharestones are colored variants of Waystones that create their own separate networks. They can only teleport to other Sharestones of the same color, allowing players to create isolated teleportation systems.
All Sharestones are automatically global, meaning any player can use them without ownership restrictions. They come in 15 different dye colors, excluding white.
Sharestones are crafted using 6 Stone Bricks, 2 matching Dye, and 1 Warp Stone. The dyes determine the network the Sharestone belongs to.
Portstones
Portstones allow players to teleport to any Waystone in the network but cannot be teleported to themselves. This makes them useful for one-way access points, such as adventure map checkpoints or public transit hubs.
They come in all 16 dye colors and share the same visual style as Sharestones. Portstones are crafted using 3 Stone Bricks, 3 Stone Brick Slabs, and 1 Warp Stone.
Waystone
Sharestone
Portstone
Configuration Options
Waystones offers extensive configuration options for server administrators and modpack creators. These settings can be found in the waystones-common.toml configuration file.
Cost Settings
Experience costs can be completely disabled or adjusted through the configuration. The default formula calculates 1 level per 100 blocks traveled, with a cap of 27 levels for same-dimension travel. Interdimensional travel always costs 27 levels.
Global Waystones bypass all experience costs by default. Warp Plates also have no experience cost, making them ideal for free transportation networks.
World Generation
Wild Waystones generate every 25 chunks by default, but this can be adjusted or disabled entirely. Village Waystones can be set to regular, frequent, or disabled spawning rates.
The mod supports dimension-specific generation, with the Overworld, Nether, and End enabled by default. Custom dimensions can be added to the allow list through configuration.
Pet and Mob Transportation
Players can configure whether pets and leashed mobs teleport with them. By default, leashed mobs are transported while pets are not. Both options can be set to enabled, same-dimension only, or disabled.
The Wither is blocked from teleportation by default. Additional entities can be added to the deny list through the configuration file to prevent abuse or technical issues.
FAQ
Yes, but you need Silk Touch to preserve the Waystone’s data. Breaking a Waystone without Silk Touch will destroy it completely. Warp Plates can also be Silk Touched to preserve their configuration and linked shards.
Yes, all Waystones, Warp Plates, and teleportation items work across dimensions. Interdimensional travel has a fixed experience cost of 27 levels by default, though this can be configured or disabled.
By default, player-placed Waystones are private and only visible to the owner. However, you can toggle the visibility setting when naming the Waystone to make it global. Global Waystones appear in everyone’s teleportation menu.
This message appears when the destination Warp Plate no longer exists or has been broken. Check that the target plate is still in place and that the chunk containing it is loaded. The Attuned Shard may need to be replaced if the destination was destroyed.
Yes, Warp Plates teleport any entity that stands on them, including mobs, animals, and even item entities. This makes them useful for mob farms and automatic transportation systems. Be careful with placement to avoid unintended teleportation loops.
Set Waystones to global visibility when placing them, as global Waystones have no experience cost. Alternatively, use Warp Plates or scrolls, which never cost experience. Server administrators can also disable all costs through the configuration file.
Sharestones create isolated networks based on their color. A blue Sharestone can only teleport to other blue Sharestones. They are always global and do not appear in the regular Waystone network, making them useful for organizing transportation into categories.
