PerfectWaystones

Place waystone blocks around your world and fast travel between the ones you have discovered. Admins set up server waystones available to everyone, while players build their own public or private network. Includes a travel menu, a settings menu, per-player discovery and JSON persistence.

Version	1.0.0
Platform	Hytale Server Plugin
Java	21+
Compatibility	Hytale Update 5 (Pre-Release 5)
Dependencies	None
Languages	EN, FR, ES, DE, IT

Buy on BuiltByBit

Installation

Drop PerfectWaystones-1.0.0.jar in UserData/Mods/
Start the server
Use /pws give to get a waystone block
Place it, then use it to start travelling

How It Works

Get a waystone with /pws give (add a color, e.g. /pws give blue) and place it.
Admins create server waystones for everyone; players create their own personal ones.
Walk up to a waystone and use it to discover it and open the travel menu.
Pick any discovered waystone and teleport instantly.

Server & Player Waystones

Server waystones: placed by an admin (with perfectwaystones.admin). Available to everyone once discovered.
Player waystones: placed by a player, owned by that player, managed from the settings menu.

Discovery

Players unlock a waystone by visiting it once. Every player keeps their own discovery list, so a waystone only appears in the travel menu after it has been discovered. Server waystones are visible to all, an owner always sees their own, public waystones appear once discovered, and private waystones are owner-only.

Opened when you use a waystone. Lists every destination you can travel to, paginated. Select one and you are teleported one block above the target so you never spawn inside the block.

Opened when you place a waystone (or use one you own). Lets the owner:

Rename the waystone
Toggle public / private
Delete the waystone

Variants & Colors

21 waystone variants: 11 colors (Blue, Cyan, Green, Lightgreen, Lime, Orange, Pink, Red, Skyblue, Topaze, Yellow) plus an oak finish. Every variant has an emissive core that glows in the dark so waystones stand out at night.

Cross-World Travel

Waystones store their own world, so you can travel between waystones located in different worlds, not only the one you are standing in.

Commands

Command	Description
`/pws give <color>`	Get a waystone block (optional color)
`/pws list`	List every waystone on the server
`/pws reload`	Reload the configuration
`/pws setlang <code>`	Set the language (EN, FR, ES, DE, IT)
`/pws help`	Show help

Permissions

Permission	Description
`perfectwaystones.admin`	Place server waystones, break any waystone, and use admin commands

Configuration

File: UserData/Saves/MODDING/mods/KatsuyaTV_PerfectWaystones/config.json

{
  "lang": "EN"
}

Waystones are stored in waystones.json and per-player discoveries in discovery/<uuid>.json inside the same folder.

FAQ

Why can't I see a waystone in the travel menu?

You have to discover it first by visiting it. Private waystones you do not own never appear.

Can players place their own waystones?

Yes. Anyone can place a waystone, which becomes a personal waystone they own. Only admins (perfectwaystones.admin) create server waystones available to everyone.

Who can break a waystone?

The owner, or an admin. Server waystones can only be removed by an admin.

Does travel work across different worlds?

Yes, as long as the destination world is loaded.