Troubleshooting

Only one tool is listed

You see hf_bridge_status and nothing else.

The connector is working; the editor is not there. Either no project is open, or the plugin is not enabled in the one that is.

Open your project. The remaining tools appear within a second or two and you do not need to restart Claude. Ask the bridge status tool directly and it will tell you what it can see.

No tools at all

The connector did not install. Check Claude Desktop’s connector settings and reinstall HullForge.mcpb.

REFUSING TO EDIT … because the change could not be saved

Working as intended. See Safety and refusals.

Nine times out of ten this is revision control configured but not logged in. Log in and retry.

A change had no visible effect

Ask for the editor state. If shaders are still compiling, materials render as the default grey until they finish, and no amount of re-applying the change will help.

This is the single most common cause of “I changed it and nothing happened”.

Interchange produced no assets

The file may be a format this project has no importer enabled for, or it may be empty or corrupt.

Ask for the editor log filtered to the Interchange category. It usually says exactly what it objected to.

Port already in use

Set Port to 0 in Project Settings > Plugins > HullForge. The operating system picks a free one, and clients still find it automatically.

A tool reported success but nothing changed

This should not happen, and it is worth reporting if it does.

Every write is re-read and compared, so a mutation that did not take effect is supposed to be reported as a failure. If you see a success that was not real, that is a bug in HullForge rather than expected behaviour.

Something else

Email support@jigwright.com with your Unreal version, your operating system, and what you expected to happen.

If a tool returned an error, paste it verbatim. The messages are written to name the cause and the fix, so the text itself is usually the most useful thing you can send.