A blue warning (SmartScreen) appears at launch
The app is not yet code-signed, so Windows may warn on first launch. Click "More info" → "Run anyway". Always download from the official distribution page.
A project won't open
- Read the error dialog. For corrupted files, the automatic backup
<name>.ppl.baksits next to the project — rename its extension to.pplto return to the last saved state - Files saved by a newer version cannot be opened by an older app — update
The app crashed or the screen broke
- If the error screen appears, "Reload" usually recovers. Your work is
auto-saved as recovery snapshots (.ppl) in
user_data/recovery/ - Crash details are logged to
user_data/logs/crash/— attach them when reporting
Everything is slow
- The diagnostics tab in the bottom status bar shows evaluation time, transfer sizes, and which nodes are heavy

- Effective fixes: disable node previews, reduce image sizes or frame counts, lower parameters on heavy nodes (blur family, raymarching)
- "Clear cache" releases a tab's memory
Assets or presets are missing
- Official presets (map assets, materials) are placed under
user_data/on first launch. If missing, checkuser_data/library/maps/etc. in the distribution zip - If you launch from a shortcut, make sure its "Start in" folder points at the app's install folder
Where the logs are
| What | Where |
|---|---|
| Crash reports | user_data/logs/crash/ |
| Performance diagnostics | user_data/logs/performance/ |
| Headless run history | user_data/settings/run_history.json |
| Recovery snapshots | user_data/recovery/ |
Still stuck?
- With an AI agent available: ask "referring to
ai/manual/, solve â—‹â—‹" and it will answer based on this manual - Otherwise contact support via the distribution page, attaching crash logs and reproduction steps