pkWaystones Fix

What is this?

pkWaystones Fix is a Paper server plugin that fixes a bug first introduced in Paper 26.1.2 build 18 where Kawamood's Waystones datapack's GUI stops working. You can see the bug tracker here. Additionally, Kawamood's Waystones data pack is a requirement.

About the plugin

The bug mentioned above is caused by Paper delaying barrel open/close block state updates, which causes the datapack to never detect that a waystone was opened. The plugin fixes this by intercepting player interactions with waystones, forcing the waystone's inventory state to open=true immediately, and keeping it open every tick via a repeating task while the player has the GUI open. It also silently re-triggers the datapack's advancement that normally starts the GUI.

To do any of this, the plugin needs to keep track of where every waystone is located. On the first startup, it will scan the datapack's command storage and build a local cache of all waystones, storing each waystone's coordinates, dimension, name, and ID. Kawamood's Waystones datapack uses barrels hidden inside the waystone to manage its inventory. This cache is what allows the plugin to identify whether a right-clicked barrel belongs to a waystone or is just a regular barrel. If the coordinates don't match a cache entry, the interaction is ignored and vanilla behavior takes over.

The cache is kept in sync in real time by monitoring for waystones being placed or removed so the plugin doesn't need to rescan the entire server when a waystone is placed or removed.

Commands and Troubleshooting

With v1.1, the plugin offers commands (requires op permission) that can be run in the game to help with troubleshooting. These are:

- /pkfix rescan — manually rebuilds the cache from datapack storage - /pkfix reload — reloads config.yml without restarting - /pkfix status — lists all cached waystones with coordinates, paginated - /pkfix force — toggles Brute Force mode (see below)

Brute Force mode applies the fix to every downward-facing barrel on the server regardless of if it belongs to a Waystone. This is useful for troubleshooting, but leaving it on permanently may impact performance.

The plugin also has a toggleable logging system. The logging system displays chunk loading, entity tracking, player interactions, cache operations, and the fix itself. These can be individually enabled or disabled in config.yml to help diagnose issues. You can find this in the pkWaystonesfix folder in your plugins folder.