Run Setup & Diagnostics (the first thing to try)
Bricklayer’s built-in troubleshooter checks every part of your setup and offers a one-click fix for what is broken.
Updated November 8, 2026
Whatever is wrong, start here. The troubleshooter checks the whole chain in one go and usually tells you the fix.
Open it
Either:
- Open the Command Palette (Ctrl+Shift+P) and run Bricklayer: Troubleshoot (Setup & Diagnostics), or
- Click Open the troubleshooter on the Welcome screen.
No terminal needed.
What it checks
It checks trust, the project, the live-sync runtime, the plugin, Studio, the connection, tools, and your AI, then floats problems to the top.
| Check | What it verifies | If it fails |
|---|---|---|
| Project | A valid local project exists and its files are readable. | Reopen the game from the Welcome screen so Bricklayer can recreate the project. |
| Studio plugin | Studio is running and the plugin has an open connection. | Start Studio with the project open, then re-run. |
| Sync | File changes move between the project and Studio. | Make sure the correct game is open; a mismatched place blocks sync. |
| AI provider | Your chosen AI is reachable and authorized. | Re-enter the key, or sign in again. |
How to use the results
- Work from the top item down. Later checks depend on earlier ones, so one fix at the top often turns several reds green.
- Use the one-click fix or the copyable command beside each red item.
- Click Re-run checks after each fix.
Before you re-run: save in Studio, keep Studio open with the right game loaded, and check the game name in Bricklayer matches.
Still red?
Start a help thread and include which checks are red and the exact text beside them. That one detail turns a long back-and-forth into a quick answer.
Did this answer your question?
Related articles
Still need help? or start a thread in the community forum.