Yotsuba Games
Back to Guide
Guide

Troubleshooting

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.bak sits next to the project — rename its extension to .ppl to 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

The diagnostics tab: FPS, evaluation time, IPC transfer, and heavy nodes

  • 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, check user_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
Troubleshooting — PixPipeline User Guide