Troubleshooting

PLC-specific problems have their own diagnosis checklist; this page covers everything else.

Models & import

Import fails or hangs, very large STEP/IGES files take time on first conversion (the converter also downloads on first use, check your connection). For assemblies over a few hundred MB, split in CAD first.

Model invisible after import, usually scale: a metre-unit file imported as millimetres is 1000× too small (or the camera is inside it). Frame the object with a camera preset, and check the import scale.

Small parts missing, the simplifier strips them at Draft quality; re-import at Normal/Fine.

Model exceeds the size limit, per-model caps depend on your plan; simplify in CAD or import at Draft.

Motion & kinematics

Robot arm lies on its side, expected with DH conventions; rotate the base X by -90°. Explanation.

Mechanism assembles mirrored/inverted, flip the object's solution flag(s): crank, four-bar, five-bar.

Parts jump or vanish at travel extremes, the input left the mechanism's feasible range; clamp it.

Object doesn't move in simulation, walk it with Signal trace: typically the binding is empty, the variable's Simulation config is still Constant, or two writers (state machine + function) fight over it.

Motion stepped/stuttery in Online mode, polling interval too slow; see update behaviour.

Projects & storage

Project gone, projects are per browser profile; different browser/machine/private-window = different storage. This is why exported archives matter.

Unsaved-changes warning on close, you have unsaved work; saving is explicit.

Import blocked, the archive exceeds your plan's caps; see limits on import.

Performance

Low FPS, in order of impact: re-import heavy models at Draft, switch to Lambert materials, hide non-essential geometry, close other GPU-hungry tabs. Measure with the performance monitor.

Browser tab crashes on huge scenes, a memory ceiling; split the machine across projects, reduce import quality, or close other heavy tabs. The Windows PLC Connector provides PLC connectivity but does not render the scene.

Still stuck?

When contacting hello@machinerytwin.studio, an exported archive attached to the mail is the fastest path to a useful answer.