FAQ and troubleshooting
Installing
Section titled “Installing”Windows says it protected my PC
Section titled “Windows says it protected my PC”The builds are not code-signed yet. On the SmartScreen prompt, click More info, then Run anyway. See Download and install.
macOS will not open Lothal
Section titled “macOS will not open Lothal”Open System Settings → Privacy & Security and click Open Anyway beside the message about Lothal. See Download and install.
Linux: the program will not start
Section titled “Linux: the program will not start”Keep every file from the zip in one folder. The program needs liblothal_core.so next to it.
Flying
Section titled “Flying”My gamepad does nothing
Section titled “My gamepad does nothing”Lothal reads the first connected gamepad. If none is connected, it reads the keyboard instead. It switches to the gamepad as soon as one is connected. If it still does nothing, check that your operating system sees the gamepad. The right stick is pitch and roll, the left stick throttle and yaw.
The drone drops or will not climb
Section titled “The drone drops or will not climb”Check the pack. Charge carries over between flights, and a nearly empty pack sags. Recharge it on the Battery page. Also check the Propellers row: if the hover throttle is high, the drone has little thrust to spare.
My hex or octo frame is not what flies
Section titled “My hex or octo frame is not what flies”Sim flies quads only. A frame drawn with other than four motors is not flown, and the Frame row says so.
Can I fly my real radio’s rates?
Section titled “Can I fly my real radio’s rates?”Lothal’s sim flies at its own full-stick rate. Set your rate on Config → Rates and the page shows how it compares. See Config.
The screen
Section titled “The screen”The window is too small
Section titled “The window is too small”Lothal needs at least 1024 × 600, and is laid out for 1280 × 720 or larger. If an overlay chart will not turn on, there is no room for it: make the window bigger.
I deleted a drone by mistake
Section titled “I deleted a drone by mistake”It is in the trash, not gone. See Projects and saving.
Export build sheet is greyed out
Section titled “Export build sheet is greyed out”The project menu’s Export build sheet… is not built in this version. Use Config → Sheet → Export sheet instead.
Explode, X-ray and Measure do nothing
Section titled “Explode, X-ray and Measure do nothing”They are present but disabled in this version.
Logs and data
Section titled “Logs and data”Can Studio open my Betaflight or INAV logs?
Section titled “Can Studio open my Betaflight or INAV logs?”No. Studio reads flights recorded in Lothal. The repository has developer scripts for real blackbox logs; see Reading real flight logs.
Where is the log for a bug report?
Section titled “Where is the log for a bug report?”In the logs folder of Lothal’s data folder. See
Where files live. Attach it to your report, with your operating
system and Lothal version.
Does Lothal send my data anywhere?
Section titled “Does Lothal send my data anywhere?”No. The only network request is a check for a newer version. See Privacy.
Building from source
Section titled “Building from source”Godot says a function or the GDExtension library is missing
Section titled “Godot says a function or the GDExtension library is missing”The Rust physics core is not in build/, or was built for another platform. Build it with
cargo build --release in rust/ and copy the library into build/ before starting Godot. See
Build from source.
Still stuck?
Section titled “Still stuck?”Open an issue on GitHub. Lothal is a one-person project, so replies may be slow.
Documentation licensed underCC BY 4.0. Lothal itself is GPL-3.0-or-later.Report a problem.Roadmap.