Troubleshooting and FAQ
The most common questions, with the message you see and what to do about it.
Setting up a scenario
The Simulate button is disabled
The header button needs a pickup and a drop-off connected by an allowed route. In Draw, click an empty area of the canvas: the Properties panel shows the Ready to simulate checklist. As soon as there is one path and two stations, Configure simulation opens the Scenario, where you can pick the stations or accept Use connected pair.
“Enable at least one Pick and one Drop station”
No unblocked station has the Pickup or Drop role. Select stations in Draw and tick the roles. A station with both roles can serve as either end, but never as both ends of the same order.
“No permitted route between selected pickups and drop-offs”
- Check that the paths are really connected: new paths must start on the snap square of an existing endpoint or path. Paths that cross in the middle are not connected.
- Check travel directions: a one-way path may point the wrong way.
- If the layout has links, a chain of links must go from the pickup to the drop-off. Select the links and press Recalculate route after changes.
Only some AGVs are placed
The Fleet step shows, for example, 2/3 AGV. Each AGV needs its own unblocked Charger or Parking location, spaced at least the minimum distance from the others. Mark more stations, move them apart, lower the minimum distance or reduce the fleet. The studio never uses other nodes as a fallback.
During a run
Orders pile up in the queue
Look at the waiting reason in Pending:
- Compatible AGVs busy: the fleet is saturated. Add AGVs, lengthen the order interval, shorten service times, or raise speeds. Check utilisation in Results.
- No AGV can reach the pickup: vehicles cannot get from where they are to the pickup. With links, add link chains from chargers/parking and drop-offs to the pickups.
Vehicles stop and wait for each other (Possible gridlock)
Local collision avoidance does not plan manoeuvres. Typical causes are dead ends shared by several vehicles, two-way single lanes and waiting positions that block an exit. Remedies:
- turn two-way sections into one-way loops;
- add an exclusive traffic zone covering the whole single-lane section and its entrances;
- add a charger or parking outside zones so vehicles can clear them;
- use zone conditions on links to hold vehicles at a safe point.
“Return impossible” or “Return pending”
An idle AGV has no free, reachable charger or parking. Impossible means no route exists with the current directions and links; pending means stations are occupied, reserved or too close to another AGV. Add stations or links for the way back.
An AGV stopped with an empty battery
It reached 0 % away from a charger. Raise the Charge below threshold so vehicles leave for charging earlier, add chargers closer to the work, or check that Unloaded driving autonomy matches your vehicles. Remember that a Parking location does not charge.
Start is disabled
The run reached the chosen duration. Press Reset, or choose a longer duration (or ∞) in the toolbar.
The run is slow or stops when I switch tab
Choose Max speed or use Run. Hidden tabs keep simulating through a background worker, but browser energy savers may freeze a tab hidden for a long time: exclude the studio's address from them for very long runs.
“Plant logic: …” error in Simulate
The diagram has a problem at runtime, for example an instant loop. Open Plant logic, read the issue next to the named block (often: add a Wait on the return connection), then press Reset.
CAD backgrounds
The drawing has the wrong size
The file probably declares the wrong unit, or none. Reimport choosing Original drawing units explicitly, or correct the size with Scale factor (for example 1000 if the drawing is in metres but was read as millimetres).
“WebGL is unavailable”
Enable hardware acceleration in the browser, or choose Image · 1 cm detail in Advanced options.
Parts of the drawing are missing or look wrong
Read the Import results report. Try Recover hatch outlines, the Local alternative reading method if available, or hide layers covered by WIPEOUT masks. External references (XREF) must be bound into the drawing in your CAD tool.
“Too complex” or size limit errors
Choose fewer layers with Change content, or simplify a copy of the drawing in your CAD tool. Files over 100 MB cannot be uploaded.
Saving
Save is disabled
A field contains an invalid value. The save state reads Fix the fields: find the field marked in the panels and correct it, or press Esc in it.
“The source project changed: reopen it before saving”
The file was modified elsewhere since you opened it. Use Save as to keep your version, or reopen the file.
“API unavailable”
The studio cannot reach its server: your connection dropped, or the service is restarting or waking up after inactivity. The draft and Export project still work; export a copy if in doubt, wait a moment and try Save again.
“Runs awaiting save”
A finished or reset run could not be sent to the archive, usually because the connection dropped. Press Retry when you are back online; the studio also retries when you reopen it. Keep the tab open if a warning says the browser cannot store the queue, and download the ZIP or PDF of important runs in the meantime.
I refreshed the page. Is my work lost?
Usually not: the automatic draft restores the last project and valid unsaved changes in the same browser and address. It does not survive clearing site data or switching browser, so save or export regularly.
Frequently asked questions
Can the studio control real AGVs?
No. It never uploads files or sends commands to vehicles, and its results do not certify safety.
Why do two runs give different numbers?
The periodic generator is deterministic, but Random mission blocks use a random generator. Run a scenario several times and compare the spread before drawing conclusions.
Does changing the language or theme affect my project?
No. They are browser preferences: they never modify the project, add history steps or restart the simulation. Exported CSV files use the separator of the current language.
Do I need a return link for every transport?
No. A transport only needs a route from pickup to drop-off. Vehicles do need a way to continue afterwards, towards the next pickup or a charger/parking, or they will wait.