P E R F E C T WAYSTONES
Place waystones and fast travel across your world.
// WHY PERFECT WAYSTONES?
Give your players a clean, reliable fast travel network with real depth. Place waystone blocks around your world, discover them by visiting, and teleport between them from a polished menu. Charge orbs per trip, set per-waystone cooldowns, favorite destinations, edit on the fly. Admins set up server waystones for everyone, while players build their own public or private network. No client mod required and everything is saved to disk.
// V1.1 NEW FEATURES
Free update for all existing buyers.
WAYSTONE ORB CURRENCY
A new custom consumable item players carry in inventory. Each waystone can require a configurable orb cost per teleport, so fast travel finally has real economy without needing a money plugin. Give orbs via /pws orb <n> or distribute them as quest rewards.- ⏱ PER-WAYSTONE COOLDOWN
Set a cooldown in seconds for each waystone individually, directly from its settings menu. Perfect for balancing high-traffic teleports without disabling fast travel. 
FAVORITES & SEARCH
Pin your most used destinations as favorites (auto-sorted to the top), and a search bar to filter long lists instantly. No more scrolling through 50 waystones.- ✏ EDIT WITHOUT REPLACING
Tweak a waystone's name, visibility, orb cost, or cooldown directly from the travel menu — no need to break and replace the block. - 🌪 OPTIONAL WARMUP
Add a configurable channel time before teleport, cancelled if the player moves. Adds tension and prevents combat escape. 
DISCOVERY & TRAVEL EFFECTS
Configurable particle and sound effects when a waystone is unlocked or used, so each teleport feels like an event.
REWORKED 64x64 ICONS
All 21 waystone icons + orb icon redrawn in clean 64x64, with the gem core selectively recolored per variant — the stone frame stays consistent. The set finally feels like one cohesive collection.
// CORE FEATURES
- FAST TRAVEL NETWORK
Place waystone blocks and instantly travel between any waystone you have discovered. Pick a destination from the travel menu and you are there. - SERVER & PLAYER WAYSTONES
Admins place server waystones that are available to everyone. Players place their own personal waystones and manage them however they like. - PUBLIC OR PRIVATE
Each player waystone can be set public (others can travel to it once they discover it) or private (owner only). You decide who reaches your locations. - PER-PLAYER DISCOVERY
Players unlock a waystone by visiting it once. Everyone keeps their own discovery list, so exploration actually matters. - 21 VARIANTS WITH A GLOWING CORE
11 colors plus an oak finish, 21 variants in total. Each one has an emissive core that glows in the dark so your waystones stand out at night. - CROSS-WORLD TRAVEL
Travel between waystones located in different worlds, not just the one you are standing in. - JSON PERSISTENCE
Waystones, orbs, cooldowns, favorites and per-player discoveries are saved to disk and survive restarts. Nothing is lost. - 5 LANGUAGES
All messages available in EN, FR, ES, DE, IT, switchable from a single command. - BUILT FOR HYTALE UPDATE 5
Compiled and tested against Hytale Update 5 (Pre-Release 5). No mod manager warnings.
// COMMANDS
| /pws give <color> | Get a waystone block (optional color) |
| /pws orb [n] | Give Waystone Orbs to yourself (default 1) |
| /pws list | List every waystone on the server |
| /pws reload | Reload the configuration |
| /pws setlang <code> | Set the language (EN / FR / ES / DE / IT) |
Admin permission node: perfectwaystones.admin
// HOW IT WORKS
1. Get a waystone with /pws give and place it in the world.
2. Admins create server waystones for everyone; players create their own personal ones.
3. In the settings menu, optionally set an orb cost and a cooldown per waystone.
4. Walk up to a waystone and use it to discover it and open the travel menu.
5. Favorite your top destinations, search the list, then teleport (orbs are consumed if required, warmup applies if enabled).
// TECHNICAL DETAILS
- Type: Hytale server-side plugin (Java 21)
- Compatibility: Built for Hytale Update 5 (Pre-Release 5)
- Storage: JSON (waystones, orbs, cooldowns, favorites, per-player discoveries)
- Variants: 21 waystone blocks/items (11 colors + oak), emissive core, redrawn 64x64 icons
- Custom item: Waystonium Orb (consumable, configurable cost per waystone)
- Languages: EN, FR, ES, DE, IT
- Client mod: Not required, fully server-side
// ROADMAP
Planned for upcoming free updates. Your feedback shapes the priorities.
- Per-rank waystone limits Cap the number of waystones a player can own based on a permission tier (e.g. default 3, VIP 10, donor 25). Fully configurable.
- PerfectEconomy integration Optional money cost as an alternative to orbs, fully wired to PerfectEconomy.
- Crafting recipe Let players obtain waystones and orbs through configurable crafting recipes instead of admin give only.
- Group sharing & permissions Share private waystones with specific players or permission groups.
- More models & variants Additional waystone styles based on community requests.
// CHANGELOG
v1.1.0 - Waystone Orb currency, per-waystone cooldown, favorites + search, edit-in-menu, optional warmup, discovery & travel effects, redrawn 64x64 icons.
v1.0.0 - Initial release. 21 variants, server & player waystones, public/private, per-player discovery, cross-world travel, 5 languages, Hytale Update 5 ready.
Developed by KatsuyaTV
If you encounter any issues or have feature requests,
don't hesitate to reach out via DM, the discussion tab, or our Discord:
discord.gg/DuqSZKrpyM
