Getting started
Everything after you buy: what your computer needs, installing, activating, your first build, updates and what to do when something goes wrong. Can't find your answer? Reply to any email from us, or write to info@citylith.com.
- What your computer needs
- Install
- Activate your licence
- Your first build
- Citylith in Blender
- Downloads and disk space
- Which computers count, seats and your plan
- Updates and uninstalling
- When something goes wrong
- Refunds
What your computer needs
- Windows 10 or 11, 64-bit.
- 3ds Max 2024, 2025, 2026 or 2027, and / or Blender 4.2 LTS, 4.5 LTS or 5.x.
- Internet while you build: every build checks your licence and downloads the map, elevation and building data for the area you pick. Scenes you built open and render offline.
- Disk: room for Citylith and for what it downloads as you build: map data, facade textures and landmark models (see below).
- Optional, in 3ds Max: Forest Pack for light scatters of trees, cars and furniture; Chaos Cosmos for car and tree models. Without Forest Pack, Citylith places splines.
Install
- Open the download page, paste your licence key, tick the two boxes and download. Your key is in the email we sent after you paid. The download is one installer: the plugin and its base textures. Facade textures and landmark models come at Build, only the ones the area needs, and stay on your computer for the next build.
- Close every 3ds Max and Blender window. The installer asks you to if 3ds Max is still open.
- Run Citylith Setup. It needs administrator rights.
- On the page Choose your apps, tick 3ds Max, Blender or both.
- Start 3ds Max: the Citylith toolbar appears by itself, in every installed version from 2024 to 2027. Start Blender: the Citylith add-on is switched on in every installed version from 4.2 (see Citylith in Blender).
“Windows protected your PC”? Our installer is signed, but it is new, so Windows SmartScreen may still stop it the first time. Click More info, then Run anyway. If your antivirus stops a Citylith file, write to us; we report false alarms to the antivirus maker.
Activate your licence
- In 3ds Max, open Tools > Licence… on the Citylith toolbar. In Blender, open the Citylith window, then Licence key and plan… in the menu at its top right.
- Paste your licence key and press Activate. This needs an internet connection.
The Licence window then shows your plan, the area you have built this month and how long the plan runs. It shows only the last block of your key; the whole key is in the email we sent after you paid. Keep the key private: anyone with it can use your plan. One activation covers 3ds Max and Blender on the same computer.
Your first build
Click Build, the first button on the Citylith toolbar. Up to five steps follow:
- Where? Pick the area on the map and its size, or a whole city by its outline. Switch on Full detail only near a point to keep cars, trees and fine detail inside a circle and lighten the rest. Then the ground's look: an aerial photo where an open one exists, or satellite colour with ground textures.
- What to build? Ground, roads, sidewalks, bridges, water, buildings, trees, cars and street furniture: tick what you need.
- Trees, cars and furniture, when you ticked them: Forest Pack or splines, Chaos Cosmos models and how much traffic.
- How should it look? 3D roofs or low-poly, day or night facades, and how far from a centre the buildings get detailed facades. Buildings with no height: estimate them from nearby buildings (recommended) or leave them out.
- Build. The button shows about how many minutes it takes. A small area builds in a few minutes. A whole city builds outside 3ds Max, so you can keep working.
A build you stop can go on later from where it stopped: step 1 offers Continue a stopped build. After a build, the other toolbar buttons change the scene without building again: day or night, trees, traffic, clearing your site, and the real sun under Tools.
New areas count toward your plan's monthly total (Basic 20 km², Pro 200 km², Studio 500 km²). Rebuilding an area you built in the last 30 days does not count. Check the coverage of a place before you build it for a client.
Citylith in Blender
- In the 3D View, press N to open the Sidebar and choose the Citylith tab.
- Press Open Citylith. The Citylith window opens with the same map, area picker and options as in 3ds Max.
- Build. The area builds outside Blender, then comes into your scene: streets, ground, buildings, bridges, water, trees, traffic, yards and street furniture, with materials for Cycles and EEVEE.
After a build, the Citylith tab changes the scene without building again: day or night facades, the real sun for any date and time, aerial photo or textures on the ground, traffic driven again, clearing your site and putting it back, show / hide, and what you changed. Forest Pack, Chaos Scatter, Chaos Cosmos and V-Ray / Corona materials are 3ds Max only.
Downloads and disk space
Citylith keeps the data it downloads, so an area you build again loads without downloading. It lives in %LOCALAPPDATA%\Citylith. Open Tools > Download cache… to:
- set Keep at most a number of GB: before each build, the downloads used longest ago are removed until they fit;
- Clear the cache: remove every download now (your scenes stay);
- remove Old build folders of areas whose scenes you no longer need.
Which computers count, seats and your plan
- New computer: on the old one, open Tools > Licence… and press Use on another computer. Then activate the key on the new one. You can move up to 3 times in 30 days; the old computer broken or gone? Write to us.
- Basic runs on one computer, Pro on two. Studio runs on one computer per seat at a time. A seat is given back when Citylith closes: when you quit 3ds Max, or close the Citylith window in Blender. If the app ends without closing properly, the seat frees itself within 2 hours. A computer counts once you activate your key on it, whichever 3ds Max and Blender versions it has: both apps on one computer are one computer. Each computer runs one Citylith session at a time.
- Seats, plan, card, invoices or cancelling: press Manage plan… in the Licence window to open your account page, or open your account page with your key. If you cancel, your plan keeps working until the end of the year you paid for.
Updates and uninstalling
Updates arrive inside Citylith. When a new version is out, a window shows what is new when you open the Citylith panel. Press Update: Citylith downloads only the files that changed, with a progress bar, then asks you to restart 3ds Max to finish. Max asks to save your scene first. In Blender the same window opens in the Citylith window; after the update, save your scene and restart Blender. You can also look yourself with Tools > Check for updates. Updates are included while your plan runs; see what's new in each version.
Installing again, for example on a new computer: download the newest installer from the download page. It installs over an older version; your downloads stay.
Uninstall: close 3ds Max and Blender, then remove Citylith in Windows Settings > Apps. It removes the add-on from Blender too. It asks whether to delete the downloaded data too; keep it if you will install Citylith again.
When something goes wrong
“Citylith's server cannot be reached”
Check the internet connection. On an office network, ask for data.citylith.com to be allowed through the firewall or proxy.
A build stopped
Try again: it goes on from where it stopped. If it stops for a reason on your computer (no internet, a full drive, not enough memory), the panel says what to fix. Otherwise it offers to send us a report: press Send. You can also send us a problem at any time from the panel: Report a problem in its top-right menu.
The licence says all computers are in use
Free a computer you no longer use with Use on another computer, or wait for a Studio seat to free itself. If you lowered seats or changed plan, the computers you joined first keep working.
Citylith says the licence has ended
Your plan was not renewed, so Citylith can no longer start builds or download updates. Your scenes still open and render. To build again, turn the renewal back on from your account page before the year ends, or buy a plan again on the pricing page and activate the new key.
The toolbar or the Blender tab is missing
Check that 3ds Max is 2024 or later, or Blender 4.2 or later, that you ticked it on Choose your apps, and that the installer finished. Then restart the app. In Blender, look under Edit > Preferences > Add-ons for Citylith and switch it on. Still missing? Write to us with your 3ds Max or Blender version.
Refunds
Within 14 days of your first purchase you get a full refund if Citylith does not run on your computer and we cannot fix it, or if you built no more than 5 km² in total. A refund ends the licence, and the scenes built under it may no longer be used. The full rules are in section 5 of the licence agreement. To ask, write to info@citylith.com.