Troubleshooting
Resolve common Zeta issues — SDK version mismatches, Godot import problems, SQLite version conflicts, store locks, and key file errors.
Resolve common setup and runtime issues
Find solutions to the most common Zeta setup and runtime issues, including SDK mismatches, Godot import failures, SQLite conflicts, store locks, missing keys, smoke-test failures, and test errors.
Zeta targets Windows with Godot 4.7.2 .NET and .NET SDK 10.0.401. Run commands from the repository root unless a troubleshooting step says otherwise.
Validate the complete environment
When several issues occur together, run the repository validation script instead of diagnosing each stage independently:
.\scripts\Validate.ps1
The script checks locked dependency restore, the full solution build, xUnit tests, Godot headless import, and the headless smoke test. The first failing stage identifies the part of the environment that needs attention.