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 and Kawamood's Painting Table datapack GUIs stop working. You can see the bug tracker here. Additionally, Kawamood's Waystones and/or Painting Table are required.

About the plugin

The bug mentioned above is caused by Paper delaying barrel open/close block state updates, which causes these datapacks to never detect that a Waystone or Painting Table was opened. The plugin fixes this by intercepting player interactions with Waystones or Painting Tables, forcing their 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 and Painting Table is located. On the first startup, it will scan for each datapack's command storage and build a local cache of all Waystones and Painting Tables, storing their coordinates, dimension, name (Waystones only), and ID. Kawamood's datapacks use barrels hidden inside the Waystones and Painting Table to manage their inventories. This cache is what allows the plugin to identify whether a right-clicked barrel belongs to a Waystone, Painting Table, 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 and Painting Tables being placed or removed so the plugin doesn't need to rescan the entire server when one of these items are placed or removed.

Commands and Troubleshooting

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

• /pkfix rescan waystones — manually rebuilds the Waystones cache from datapack storage
• /pkfix rescan paintingtable — manually rebuilds the Painting Table cache from datapack storage
• /pkfix status waystones [page] — lists all cached Waystones with coordinates, paginated
• /pkfix status paintingtable [page] — lists all cached Painting Tables with coordinates, paginated
• /pkfix reload — reloads config.yml without restarting
• /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 or Painting Table. 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 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.