KawaMood's Waystones

🚀 Say Goodbye to Long Journeys!

Create and place waystones at your important locations. This is a convenient method for fast travel across your world, perfectly suited for survival and multiplayer gameplay!

🪄 What Are Waystones?

KawaMood's Waystones is a data pack inspired by the famous BlayTheNinth's Waystones mod. Waystones allow instant teleportation between different points in your world across any dimension (including custom ones). Unlike the mod, stones don't generate naturally - you need to craft them yourself.

🔨 Crafting and Usage

To craft a waystone you need:

• 1x Lodestone
• 2x Amethyst Shards
• 1x Eye of Ender
• 3x base blocks

The stone type depends on the base block used:

• Andesite - Andesite Waystone
• Sandstone - Sand Waystone
• Nether Bricks - Nether Waystone
• Mossy Stone Bricks - Mossy Waystone
• Cobbled Deepslate - Deepslate Waystone
• Copper Block - Copper Waystone
• Prismarine Bricks - Prismarine Waystone
• Tuff - Tuff Waystone

Before placing, it's recommended to rename the stone in an anvil - this makes navigation through available points easier. Icons in the list depend on the block the stone is placed on, allowing for recognizable markers. Icons also support NBT data.

Right-clicking the top part opens the interface. It displays available waystones on the first two lines and a toolbar for managing attributes and page navigation on the bottom line.

Left-clicking a stone from the list teleports you to it. Transportation includes vehicles (horses, boats) and leashed mobs, enabling quick livestock transfer between locations.

⚙️ Attribute Settings

The interface toolbar has three central buttons. If you're the stone owner or manager, they allow editing attributes. Other players cannot modify these settings.

Visibility

First button controls stone visibility:

• Discoverable - other players see it only after interaction
• Private - visible only to owner, managers, and specified players
• Public - visible to all players

Protection

Second button enables protection:

• Disabled - anyone can destroy the stone, including events (creeper explosions, TNT)
• Enabled - only owner and managers can remove it

Shared Access

Third button manages "Shared With" list. It allows specifying players who can see private stones. Place a Writable Book with friend nicknames (one nickname per page). Mind case sensitivity and avoid extra spaces.

💼 Manager Role

Managers can bypass most waystone system restrictions, view and edit all stones (including private ones). Role is assigned with commands:

/tag <nickname> add pk.waystones.manager
/tag <nickname> remove pk.waystones.manager

Example - assigning manager to player "Bob":

/tag Bob add pk.waystones.manager

⚙️ Additional Settings

Experience Cost

When enabled, teleportation requires level expenditure. Cost can be fixed or distance-based:

/function pk_waystones:settings/xp_consumption/set {value:<amount>, mode:<mode>}

Modes:

• fixed - fixed cost
• manhattan - grid-based calculation
• euclidian - straight-line calculation

Blacklisted Dimensions

Can restrict stone placement in specific dimensions:

/function pk_waystones:settings/blacklist_dimensions/add {dimension:"minecraft:the_nether"}

Nameplate Display

Floating nameplates above stones for easy identification:

/function pk_waystones:settings/display_nameplates/true

Monster Ignoring

By default, nearby monsters don't prevent teleportation:

/function pk_waystones:settings/ignore_monsters/true

Legacy Textures

Using regular block textures instead of custom ones:

/function pk_waystones:settings/legacy_textures/true

Default Visibility

Setting default visibility for new stones:

/function pk_waystones:settings/default_visibility/set {visibility:"private"}

Quantity Limits

Can limit stones per player or server:

/function pk_waystones:settings/limit_per_player/set {count:5}
/function pk_waystones:settings/limit_per_server/set {count:50}

🛠️ Other Commands

Getting Stones

Operators can obtain stones with command:

/function pk_waystones:cmd/give/waystone/andesite

Placing Stones

Direct stone placement with specific attributes:

/function pk_waystones:cmd/setblock/waystone {waystone:{}}

Hiding Coordinates

Players can hide coordinates in interface:

/trigger pk.waystones.hide_coordinates set 1

🎨 Resource Pack

For visual enhancement, a resource pack from Lordphiphi with item models and interface is available.

🗑️ Uninstallation

Automatic removal of all stones and data:

/function pk_waystones:cmd/uninstall