Troubleshooting

Windows says the installer is not safe

Locus does not update

Locus checks for updates when it starts. If the check fails, for example because you are offline, Locus starts normally without a message and tries again next time. There is no update prompt during an exam.

To update manually, download the latest version from the download page and install it over the old one.

Locus is slow

Turn on Low performance mode in Settings > Performance. See Performance.

A theme, resource pack or plugin cannot be added

Locus shows “This is not a valid … file” when the file is not a working zip archive, or when its theme.json, pack.json or plugin.json is missing or broken. Ask the author for a new copy.

Nothing can be added during an exam.

A plugin shortcut does nothing

Plugin shortcuts are skipped when another app already uses the same key combination. Close the other app or change its shortcut.

Resetting Locus

Open Settings > General and click Reset app settings.

If Locus does not start at all, quit it and delete its settings folder:

macOS: ~/Library/Application Support/xyz.lunalna.locus
Windows: %APPDATA%\xyz.lunalna.locus

This also removes your installed themes, resource packs, plugins and AI settings. Your saved files are not affected.