Troubleshooting

Chat Window Won't Open

1. Check Window › General › Console for errors.
2. Open Adjoint › Setup Window and confirm you're signed in and glTFast shows as installed.
3. Right-click Packages › Adjoint in the Project panel and choose Reimport.
4. Restart Unity.

Messages Not Sending

• Check the Unity Console for errors.
• Open the Setup Window and confirm you're signed in.
• Verify your internet connection.

The Agent Doesn't Understand My Project

• Fill out Project Rules with your conventions, folder layout, and anything non-obvious. This pays off on every message afterward.
• @mention the specific files or GameObjects you want the agent to work with.
• Be explicit about folder targets: “Create this in Assets/Scripts/AI/”

3D Models Not Generating

• Check the Generations tab for error messages.
• Generation takes a couple of minutes, it is not instant.
• Retry with a simpler or more specific prompt.

Audio Not Generating

• Check the Generations tab for error messages.
• Retry with a shorter duration or a simpler voice prompt if a long clip is failing.

Generated Assets Not Appearing

• Wait for import to finish (the Console shows progress).
• Force a refresh with Assets › Refresh.
• Check Assets/Generated/ in the Project panel.

Chat Is Slow

• First-time project indexing can take 30 to 60 seconds. Give it a moment.
• Switch to a faster model from the dropdown at the bottom.
• Start a new chat to clear accumulated context.

Unity Freezes Briefly During Changes

Some operations (scene queries, component changes, asset creation) run on the main thread. This is expected. Long operations like lightmap baking run asynchronously and do not block the editor.

Compilation Errors After a Change

Adjoint tries to fix errors automatically. If the loop stops short:

• Ask the agent: “Fix the compilation error in @FileName.cs” with the file @mentioned.
• Reject the change and retry with a clearer prompt or with Plan Mode.

For how changes are reviewed in the first place, see Safety and Approval.