Troubleshooting
Sorted by what you can see, not by what is at fault. Before anything else, open the Logs editor — it sits under the iCity Editor in the “iCity 2” workspace, and the strip along its top says whether the engine is alive and how much of its restart budget this session has spent. Most of what follows is visible there first.
Nothing responds
Almost everything in this section is one fact: the engine is stopped. Draft is entirely dispatched to it, so with it off the interface withdraws the tools rather than offering handles onto nothing.
The iCity Editor in Draft with the engine stopped and a project open, in any mode other than Graph: the tool rail empty, the message 'The iCity engine is not running. Start it to edit your city.' with the Start Engine button beneath it, and the 3D viewport beside it showing the city with no selection gizmos drawn. Frame the Blender status bar too, so the absent D / G / Del hints are visible.
iCity2App.exe in Addon/bin/windows/, with iCity2Client.dll beside it. Security software quarantining or blocking either produces both messages. Exclude them and start again.The Logs editor prints the engine's state as a word and a count: inactive (not running), monitoring (alive), activating (restarting), crashed, followed by restarts n/3. Cloud job lines never appear here — they live in the Design composer's thread and the Cloud Activity popup.
The iCity Logs editor in the 'iCity 2' workspace after the engine has crashed and auto-restarted three times: the strip along its top reading the state word 'crashed' with 'restarts 3/3', and the line 'Restart budget exhausted (3 attempts) — engine stopped' in the log body with a few lines of ordinary engine output above it for context.
I cannot sign in
Signing in happens in your browser and comes back to Blender over a local port. Most failures are that return trip, not your password.
http://127.0.0.1:9876/callback for the answer and the browser could not reach it. Close other copies of Blender, then check whether a firewall or antivirus is stopping Blender from listening, and sign in again.My city is gone
Your city is not your .blend. It lives in the engine process and is written to Documents/iCity 2/<project> by the header S button — Blender's own save does not reach it. How iCity fits with Blender is the full explanation; these are the ways it bites.
project.json holds only the server id, and it is missing. Click the flag and choose to upload it as new or adopt the existing record. The editor repairs it by itself within a few seconds if this session still knows the id.Something says UNSYNCED
UNSYNCED appears beside the object name in the selection header. It means that object is locked: frozen out of procedural editing. The engine's re-emits skip it, the gizmos ignore it, and it becomes normally selectable with Blender's own tools instead.
Close crop of the selection header in the iCity Editor with a single locked building selected, so the object name is followed by the UNSYNCED marker. Capture in Massing mode so the section beneath shows 'Floors: procedural buildings only' in place of the floors stepper.
The dress looks wrong
City sync — the header pair, not the footer one — is the automatic side, and it is on by default. It fires about two seconds after you return to Design with a changed draft, it re-dresses with the theme you already have, and it spends credits doing so. The ▾ beside the button switches it to Manual.
The 3D viewport with a scatter shape just drawn by a system that has no assets in its objects row, so the shape is filled with uniform grey placeholder cubes. Show the Scatter tab beside it with that system's objects row expanded and empty, its '+' button visible.
default_project folder inside the addon, and the copy you installed does not have one. Reinstall from the current download, or use Generate theme or Append from a project instead. See Themes.A job never came back
Job tracking is session-only. Records live on Blender's window manager and polling runs in memory; nothing resumes after a restart.
The Design composer thread after a submission was refused for credits: the prompt that was sent, followed by the failure entry printed as '402 — Not enough credits' with no further detail lines, and the send button back to an up arrow rather than a red stop square.
outputs.csv once the engine settles, and it is safe to repeat — the pipeline clears what a previous link made rather than stacking on it.My own assets do not appear
The scanner reads folders, never loose files, and it says nothing when a folder is shaped wrong — it simply contributes no assets. The layout is the whole contract:
<your folder>/
materials/<Category>/<AssetName>/
preview image + texture maps (config.json optional)
props/<Category>/<AssetName>/
preview image + .blend / .glb / .gltf / .fbx / .objWindows File Explorer with the navigation pane expanded on a custom assets folder, showing the tree three levels deep: the root with its materials/ and props/ subfolders, a category folder open under each, and one asset folder open in the file pane holding its preview image and its texture maps or model file. Address bar visible so the path reads.
materials/ or props/, under a category folder. A root with neither subfolder contributes nothing at all. See Using your own assets.If none of the above matches, press Report in the header. It opens the report form with this session's log attached, and you can follow the reply under Account ▸ Contact us ▸ My cases.
Otherwise: the Discord is fastest for anything scene-specific, and Contact support suits licensing, billing and anything that needs a file attached.
The Discord is fastest for anything scene-specific. Email suits licensing, billing and anything needing a file attached.
Contact support →