Arcane Waystones (Customizable) - Physical Warps

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

Download the latest .jar file from the releases

Place it in your server's (or Hytale) mods folder

Restart the server

The plugin will create its data files automatically

Permissions Quick Reference

(More details in the Permissions section)

Permission Description

hytale.command.waystones.allowListMenu Access /waystones list command

hytale.command.waystones.allowEditAll Edit any waystone's settings

hytale.command.waystones.allowSeeAllPrivate See and teleport to all private waystones

hytale.command.waystones.allowPrivateWaystoneRemoval Break private waystones owned by others

hytale.command.waystones.allowShowUndiscovered See all waystones without discovering them

hytale.command.waystones.blockWaystonePlacement Prevent placing waystones

hytale.command.waystones.blockWaystoneRemoval Prevent breaking waystones

hytale.command.waystones.blockPublicWaystoneCreation Force new waystones to be private

hytale.command.waystones.maxWaystones.X Limit player to X waystones

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

Place the Waystone block anywhere in the world

Right-click on it to open the naming dialog

Enter a name for your Waystone and confirm

Your Waystone is now registered and ready to use!

Using Waystones

Right-click any Waystone to open the teleport menu

You'll see two lists - Public Waystones (visible to all) and Private Waystones (only your own)

Click a destination to teleport there instantly

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:

Setting Description

Name The display name shown in the teleport list

Visibility Public (everyone can see) or Private (only you)

Teleport Direction Which side of the statue players appear on (North/South/East/West)

Player Orientation Direction players face after teleporting (Away from or Towards the statue)

Color Visual style of the Waystone (Blue, Red, or Green)

Waystone Colors

Waystones come in three visual styles:

Color Description

Default (Blue) Standard cyan glow with blue fire particles

Red Warm red glow with fire particles

Green Nature-themed green glow with green fire particles

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

Commands

Command Description

/waystones list Open the waystone list without being at a waystone (requires allowListMenu permission)

/waystones edit "<name>" <property> <value> Edit a waystone property (requires allowEditAll permission)

/waystones config <property> <value> Edit plugin configuration (OP only)

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:

Command Description

/waystones config debugLogs true Enable debug logging (helpful for troubleshooting)

/waystones config debugLogs false Disable debug logging

/waystones config requireDiscover true Enable the discovery system

/waystones config requireDiscover false Disable the discovery system

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