Skip to main content

Test smithing and crafting menus with older Java clients

Applies to: ViaBackwards; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

New Minecraft releases can change workstation screens and recipes. ViaBackwards translates many interactions, but its known issues include limitations affecting older clients and modern smithing behaviour. A client that can open the menu has not necessarily completed a valid transaction.

Record the starting point

Prepare disposable copies of the ingredients and record the expected output using the server's native client. Note custom recipe and menu plugins. Keep valuable player items out of the test, and verify the installed ViaBackwards release against its current known-issues list.

Work through the change

  1. Run the complete recipe with the native client first. Confirm the server creates the intended output and consumes the expected ingredients without a permission override.
  2. Repeat the exact interaction with the older supported client. Check input slots, preview output, shift-click and taking the finished item, using ordinary player permissions.
  3. Reconnect before checking the final inventory. A temporary visual item is different from a server-confirmed result; compare both clients without repeatedly clicking an uncertain output.
  4. If the interaction is unsupported, publish the limitation or require a compatible client for that feature. Test any custom workaround on a private copy and check it cannot duplicate ingredients.

Check the result

The recipe should either complete with consistent server-side inventory or fail in a documented, understandable way. Keep the test small enough to compare item counts before and after. A workaround should preserve the intended recipe cost rather than granting an unrelated replacement reward.

If the result differs

A failure on both clients suggests a recipe, permission or plugin issue outside protocol translation. A failure only on the older client should be checked against ViaBackwards limitations before changing the global crafting system. Include the exact menu and click sequence in a report.

Remove the disposable ingredients and restore the trial menu configuration if needed. Correct a test inventory through ordinary staff tools after checking server-side counts. Do not restore the entire world because one workstation preview displayed incorrectly.

References and related help