# What is this?
\npkWaystones 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.<\/p>\n
# About the plugin
\nThe 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.<\/p>\n
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.<\/p>\n
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.<\/p>\n
# Commands and Troubleshooting
\nWith **v1.1**, the plugin offers commands (requires op permission) that can be run in the game to help with troubleshooting. These are:<\/p>\n
– \/pkfix rescan \u2014 manually rebuilds the cache from datapack storage
\n– \/pkfix reload \u2014 reloads config.yml without restarting
\n– \/pkfix status \u2014 lists all cached waystones with coordinates, paginated
\n– \/pkfix force \u2014 toggles Brute Force mode (see below)<\/p>\n
**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.<\/p>\n
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.<\/p>\n","protected":false},"excerpt":{"rendered":"
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.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"pk-waystones-fix","_minecraft_project_id":"5TCbbXU1","_minecraft_author":"TarkinMX","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pk-waystones-fix.zip","_minecraft_size_bytes":23494,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:30:08.511808Z","_minecraft_date_created":"2026-05-11T05:18:25.514574Z","_minecraft_date_modified":"2026-05-11T01:54:50.755152Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pk-waystones-fix","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T04:20:05+00:00","_minecraft_import_hash":"493195189098786f9097cac7ee205860","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,92],"mod_loader":[132,133],"minecraft_version":[163],"class_list":["post-122105","mod","type-mod","status-publish","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-26-1-2"],"yoast_head":"\n