Troubleshooting

Apply says the preview is stale

A mapping, selected occurrence, candidate file, asset identity, or relevant project state changed. Run Preview again and review the new result.

A scene or Prefab Stage is blocked

Save it explicitly or exclude it from scope. Asset Swap never decides how to merge unsaved work.

Unity reports a dependency but no adapter finds a property

The occurrence is intentionally unsupported. It may be a missing-script payload or unknown schema. Restore the missing script or install a deterministic adapter; do not repair it with text replacement.

A file is read-only

Check it out in version control or adjust its filesystem permissions, then rerun Preview. Package Cache and imported read-only packages remain unavailable by design.

Rollback reports a conflict

The current file matches neither the recorded before nor after hash. Asset Swap did not overwrite it. Preserve the user's change, compare it with the transaction backup, and restore a known state before retrying.

An optional integration is unavailable

Install a supported Addressables, Timeline, or Localization package and wait for compilation. Asset Swap does not install it automatically.

Batch mode returns 31

The reference operation may have succeeded, but evidence could not be written. Inspect the output directory permissions and free space. Treat evidence export failure as a failed CI job.