What is this?

pkWaystones Companion is a Paper plugin that provides Bedrock client compatibility for Kawamood's Waystones datapack via Geyser/Floodgate. Additionally, Kawamood's Waystones and PacketEvents are required.

Provides decorative Waystone markers for Bedrock players!

Bedrock players see the actual destination icons. No more cooked cod!

Installation

• As mentioned above, Kawamood's Waystones and PacketEvents are required.
• Simply drop this plugin into your minecraft\plugins folder and restart your server.

About the plugin

• Waystone Detection — On first startup, the plugin scans Waystones storage and caches all Waystone entries. The cache also updates automatically when Waystones are placed or removed.
• Visual Replacement — When a Bedrock player receives a chunk containing a Waystone, the plugin will use the cache to identify Waystone locations and push fake blocks to the Bedrock client. These fake blocks replace the floating barrel with a decorative appearance that corresponds to that Waystone's variant.
• Waystone Interaction — When a Bedrock player interacts with a Waystone, the plugin sends the real barrel block to the Bedrock client so it knows there's a container there, allowing the datapack's session to trigger normally. Kawamood's Waystones datapack handles all teleportation logic, XP costs, cooldowns, and GUI population. When the player closes the inventory, all fake blocks are refreshed.
• Inventory Icon Patching — The plugin uses PacketEvents to intercept the Waystone's inventory destination buttons and replaces them with the correct block icon that Java players see. No more cooked cod!

Expected behavior

• Visuals — Due to Bedrock limitations, the Bedrock client has to be told that there is a barrel present for the Waystone's inventory management so seeing the barrel blink into existence is expected. The decorative appearance of the Waystone is created with fake blocks so they will disappear and reappear when interacting with the Waystone. When selecting a destination in the Waystone's inventory, a cooked cod may be seen.
• Sound — The opening barrel sound would be heard when interacting with a Waystone. This is now suppressed but may still be heard from time to time due to Bedrock being Bedrock. The portal travel sound from the datapack wouldn't play when teleporting on the Bedrock player's side so it is now played at the destination after the player lands.

Commands

• /pkcom (requires op) provides commands for resyncing the cache, reloading config, viewing status, listing cached Waystones, and toggling all log flags as well as toggling the visuals.

Things planned for next release

• Fix Waystones being rendered as Steve heads when the item is in the Bedrock player's inventory.
• Cleanup Waystone visuals for the Bedrock player. Currently, the base slab and carpet on top are left behind when a Waystone is destroyed. This doesn't affect anything as they're just fake blocks being pushed to the Bedrock player's client and will disappear for the Bedrock player when the they leave the area and come back. Another visual issue is if a block is directly above the Waystone, it gets replaced with a carpet. Again, this is only a visual on the client side and doesn't affect anything on the server side. It'll be resolved as well.

Possibility in a future release

• Register recipes for Bedrock players to find Waystones in their recipe books if at all possible so they're not having to build the Waystones manually.