Arcane Waystones Version 0.4.3

A fast-travel system for Hytale servers.

By default Players can craft and place Waystone statues throughout the world, name them, and teleport between them instantly. We have a variety of configurations available to use how you want.

HOTFIX - JAN 24 FIX FOR LUCKPERMS kicking/crashing

Q&A

1. Do Players need to discover Waystones?

By default no, all public waystones are accessible from all other waystones. But in the config files or with the server command /waystones config requireDiscover true you can make players have to interact with a waystone first.

2. How do I configure my Waystones?

Players/Waystone owners can edit their waystones. But there are also a variety of commands available to set moderator permissions. We mainly use the built in perm system that Hytale comes with using the /perm user add ... structure. Please see below documentation on our permissions setup.

3. Can I limit how many waystones players can create?

Yes! Use the permission hytale.command.waystones.maxWaystones.X where X is the number. For example, /perm user add <uuid> hytale.command.waystones.maxWaystones.3 limits that player to 3 waystones. If a player has multiple limits, the highest value is used. OPs bypass this limit entirely.

4. What are Server-Owned waystones?

Admins can mark any waystone as "Server Owned" in the settings. These don't show an owner name in the list and can only be broken by OPs. Great for spawn points or public landmarks.

Installation

1. Download the latest .jar file from the releases
2. Place it in your server's (or Hytale) mods folder
3. Restart the server
4. The plugin will create its data files automatically

Permissions Quick Reference

(More details in the Permissions section)

Note: OPs bypass all restrictions.

Default Experience

Out of the box, here's what players can do:

Crafting a Waystone

Waystones are crafted at a Tinkering Workbench using:

• 10x Rock
• 1x Voidheart

Placing & Naming

1. Place the Waystone block anywhere in the world
2. Right-click on it to open the naming dialog
3. Enter a name for your Waystone and confirm
4. Your Waystone is now registered and ready to use!

Using Waystones

1. Right-click any Waystone to open the teleport menu
2. You'll see two lists - Public Waystones (visible to all) and Private Waystones (only your own)
3. Click a destination to teleport there instantly
4. A banner announces your arrival at the destination

Breaking Waystones

• Players can break their own waystones at any time
• Breaking removes it from the teleport network
• Server-owned waystones can only be broken by OPs

Waystone Settings

Owners can customize their waystones with these options:

Waystone Colors

Waystones come in three visual styles:

Players can change the color of their waystones in the settings menu. The color is purely cosmetic and doesn't affect functionality.

Commands

Edit Command Examples

/waystones edit "Spawn" name "Server Spawn"
/waystones edit "My Base" isPublic true
/waystones edit "Hub" color red
/waystones edit "Tower" teleportDirection north
/waystones edit "Market" serverOwned true
/waystones edit "Spawn" defaultDiscovered true

Editable properties: name, isPublic, priority, textColor, teleportDirection, playerOrientation, serverOwned, ownerName, ownerUuid, defaultDiscovered, color

Config Options

The plugin stores configuration in waystones.json within your universe folder. You can modify settings via commands:

Discovery System

When discovery is enabled:

• Players must physically visit a Waystone before they can see it in their list
• This encourages exploration - players must find Waystones before they can teleport to them
• Server admins can mark specific Waystones as "Default Discovered" so everyone can see them even without visiting
• Use /waystones edit "Spawn" defaultDiscovered true to make a waystone always visible

Common Server Setups

Public Server (Exploration Focus)

Enable discovery and mark spawn as always visible:

/waystones config requireDiscover true
/waystones edit "Spawn" defaultDiscovered true
/waystones edit "Spawn" serverOwned true

Survival Server (Limited Waystones)

Limit players to a few personal waystones:

/perm group add Survivors hytale.command.waystones.maxWaystones.3

VIP players could get more:

/perm group add VIP hytale.command.waystones.maxWaystones.10

Private Server (Full Access)

No configuration needed - the defaults work great for private servers where everyone is trusted.

Roleplay Server (No Public Waystones)

Force all player waystones to be private:

/perm group add Players hytale.command.waystones.blockPublicWaystoneCreation

Only admins can create public waystones for important locations.

Data Storage

All Waystone data is stored in your universe folder:

• waystones.json - All Waystone data and configuration
• waystones-players.json - Player discovery data (when discovery is enabled)

These files are automatically saved when changes occur.

Troubleshooting

Waystone not appearing in list

• Check if discovery is enabled - you may need to visit it first
• Check if it's a private Waystone owned by someone else
• Verify you have permission to see it

Can't break a Waystone

• Server-owned Waystones require OP status to break
• Check if you have the blockWaystoneRemoval permission
• Private Waystones owned by others require allowPrivateWaystoneRemoval permission

Color not changing

• Make sure you saved the settings after changing the color
• The server may need a moment to update the block in the world
• Try moving away and back to the Waystone

Debug Logging

Enable debug logs to see detailed information:

/waystones config debugLogs true

Check your server console for messages prefixed with [Waystone].

Credits

Created by AllieF, Textures and Testing by TheRogueLady