# Troubleshooting

## Godot executable is not configured

Select the absolute path to an existing Godot 4.x executable in the preview view. The plugin deliberately does not search every disk and does not download Godot.

## Godot version check fails

Run the selected executable with `--version` manually. Confirm that the file is a regular executable and that security software has not blocked it. Standard GDScript builds are recommended for Web preview.

## Web export template is missing

Install the matching official export templates from Godot's own editor, then retry. The plugin does not install templates automatically.

## Export preset `Web` is missing

Create a Web export preset in Godot or configure the plugin to use the exact visible preset name.

## Preview keeps the previous version

This is expected after an export error. The plugin atomically promotes only successful exports. Read the error panel and fix the reported GDScript, scene, resource, or preset error; the next successful build replaces the preview.

## Preview does not refresh

- Confirm **Auto rebuild** is enabled.
- Check that the changed path is not under `.godot`, `.godot-harness`, `build`, `dist`, or `node_modules`.
- Click **Rebuild** once to separate watcher problems from export problems.
- Check the plugin log for an export already in progress; changes during a build are coalesced into one subsequent build.

## Port conflict

Use `auto` for the preview port. Explicit ports must be local, available, and between 1024 and 65535.

## Plugin installation fails because pnpm is unavailable

DSH profile plugin management requires a working `pnpm` command. Repair or install pnpm according to the Harness/Node environment, then repeat `dsh plugin --profile web add ...`. Do not manually copy partial package contents into the runtime checkout.

## Harness refresh loses the visible state

The Client always re-queries the Host snapshot after mounting. If a managed runtime still exists, the view should recover. If the Host plugin itself restarted, managed child processes are cleaned and a new preview must be started.