Minecraft

How to Install and Use the Visual Workbench Mod in Minecraft

Minecraft·May 20, 2026·23 min read

Overview

Visual Workbench is a small Minecraft mod that makes crafting tables feel more alive. Instead of hiding everything inside the crafting menu, it displays the current recipe materials on top of the block. If the recipe is valid, the finished item appears above them with a simple animation.

The mod also keeps items inside the workbench after the GUI closes, which can make crafting less annoying and make bases look a little more lived in. It is not a giant content overhaul, but it is a useful quality of life mod for players who enjoy visual feedback and cleaner crafting setups.

This guide explains how to download Visual Workbench, install it on your client, add it to a Minecraft server, adjust custom item support, and handle the most common problems.

Downloading Visual Workbench

  1. Open the Visual Workbench page on CurseForge, then choose Files near the top of the page.
  1. Find the file that matches the Minecraft version and mod loader you plan to use.
  1. Select the correct file, then press Download on the right side.
  1. Save the file somewhere easy to find, such as your desktop or downloads folder.

Visual Workbench requires extra dependency mods depending on your loader. For Forge, install Puzzles Lib as well. For Fabric, install Fabric API, Forge Config API Port, and Puzzles Lib. Keep the Visual Workbench file and all required dependencies ready, since they need to be installed on both the Minecraft client and the server.

Installing the Mod on Your Client

Before adding the files, make sure your Minecraft launcher already has a Forge or Fabric profile for the same Minecraft version. Mods will not load on a standard vanilla profile, no matter how politely you ask the launcher.

  1. Open the Minecraft Launcher and go to Installations.
  1. Find your Forge or Fabric profile, then click the folder icon for that profile.
  1. Open the `mods` folder. If there is no `mods` folder, create one with that exact name.
  1. Drag Visual Workbench and its required dependency files into the folder.
  1. Return to the launcher, select the modded profile, and press Play.

If the game opens normally, the client side of the installation is ready.

Installing Visual Workbench on a Server

Your server must also run Forge or Fabric, matching the loader and Minecraft version used by your client. In your hosting control panel, choose the correct server software before uploading the mod files.

  1. Open your server panel and go to your FTP or file manager.
  1. Enter your panel password, then select Login.
  1. Open the `mods` directory from the server file list.
  1. Click Upload.
  1. Drag Visual Workbench and all required dependency files into the upload area.
  1. Wait until every upload reaches 100%, then restart the server from the main panel.

After the restart, join with a client that has the same mod files installed. Mismatched versions are one of the fastest ways to turn a simple mod install into a crash report collection.

Using Visual Workbench In Game

Once you join the server, the world will mostly look unchanged. Visual Workbench only changes how crafting tables behave, so start by placing one or using an existing table in your base.

Craft a workbench with four wood planks if needed, then right-click it as usual. Add materials for any recipe, close the crafting interface, and look at the top of the block. The items should remain visible instead of disappearing from view.

Recipe Display and Animations

When materials are inside the crafting table, Visual Workbench shows tiny versions of them on the table surface. If the arrangement creates a valid recipe, the resulting item appears above the materials.

The display follows player perspective as they move around, keeping the recipe readable from different angles. This is mainly a visual and convenience feature, so expect a subtle improvement rather than a full crafting system replacement.

Modded items can also appear on the table, though some may require configuration before they display correctly.

Stored Materials and Drops

Items placed inside the crafting table remain stored there after the interface closes. If the crafting table is broken while items are inside, the materials drop normally instead of vanishing.

This makes the table behave a little like a tiny container, though that is not its main purpose. It is handy for keeping a recipe staged, showing materials to other players, or setting up screenshots without juggling items in your inventory.

Configuring Custom Item Support

Visual Workbench can support custom and modded items, but some entries may need to be added to its configuration file. Popular modded materials may already be included. Others need to be listed manually using their item IDs.

Item IDs usually follow the same pattern as vanilla Minecraft IDs, such as `minecraft:stone` or `minecraft:diamond_sword`. A modded item from another mod might use a namespace like `create:item_name`. If you are unsure of the exact ID, check that mod's documentation, wiki, or in-game item tools if available.

To edit the Visual Workbench configuration:

  1. Open your FTP or file manager in your server panel and log in with your password.
  1. Find and open the `config` folder.
  1. Locate `visual_workbench.json`, then choose Edit.
  1. Make the needed configuration changes.
  1. Press Save at the top of the editor.
  1. Restart the server so the new settings can load.

Keep formatting exact when editing JSON. A missing comma or bracket can stop the file from loading correctly.

Common Problems

Players Cannot Join the Server

First, confirm that players are using the correct server address, including the IP address and port or the assigned subdomain. This information is available from the main server panel.

If the address is correct, check the mod installation. Visual Workbench and its dependencies must be uploaded to the server's `mods` folder, not the root directory or another folder. The server also needs to be restarted after uploading the files.

The Game or Server Crashes on Startup

Crashes usually point to missing dependencies, incorrect loader files, or mismatched Minecraft versions. Make sure the server and every joining client use the same loader type, the same Minecraft version, and compatible versions of Visual Workbench and its dependencies.

Forge and Fabric use different files and requirements, so do not mix them. If the client still struggles after the files are correct, allocating more memory to the Minecraft launcher may help.

  • Visual Workbench on CurseForge
  • How to upload mods to a Minecraft server
  • Modded Minecraft server optimization guide
  • How to use FTP or file manager access

Still have questions?

Come chat with us and we will get back to you as soon as possible!

Contact Support