🔧 Project Lunky Portal Crash Fix

[DEbug Log] How to Fix the Door Portal Crash

The most reported bug in Project Lunky. When entering The Lab's portal to transition between Random Generated Levels, the game triggers an Application Hanging or crashes to desktop (CTD) with no error message. Root cause: the engine attempts to load the next level's assets while the current level is still fully allocated — causing VRAM overflow and memory address conflicts during the instantaneous scene swap.

The Geek Fix — Step-by-Step:

1. Shadow Downgrade Protocol: Open Settings → Graphics → set Shadow Quality to Off. Project Lunky's real-time dynamic shadows are a GPU devourer — even an RTX 5060 Ti chokes during portal particle-effect rendering
2. Force Windowed Launch: Press Alt + Enter before entering the portal. Fullscreen high-refresh-rate sync can lock the portal's particle renderer
3. Set Texture Quality to Medium or below — high-res textures consume 1-2 GB VRAM that compounds during scene loading
4. Memory Flush: Close all background apps, especially Chrome tabs (each tab eats 100-500 MB RAM) and Duolingo — Lunky doesn't appreciate you sneaking in Portuguese lessons mid-run 🇵🇹
5. Right-click the game executable → Run as Administrator — grants higher memory allocation priority and page file access
6. Update your GPU drivers: NVIDIA or AMD — outdated drivers cause memory leaks during scene transitions
7. File Integrity Check: If you downloaded from itch.io, extract using 7-Zip instead of Windows' built-in extractor. The native unzip tool is known to corrupt large 4.7 GB archives silently

[Perf Trace] Lag Spike Solution (Even on RTX GPU)

Players with high-end GPUs like the RTX 5060 Ti still report severe lag spikes. The bottleneck isn't your GPU — it's a CPU + RAM contention issue. The roguelite level generator runs on the CPU thread, and when it spawns rooms, enemies, and pathfinding graphs simultaneously, it saturates all available cores.

1. Ensure the game runs on your dedicated GPU, not integrated graphics (check NVIDIA Control Panel → Manage 3D Settings)
2. Disable V-Sync in game settings
3. Disable Discord overlay and Steam overlay
4. Open Task Manager → right-click the game process → Set Priority to High
5. Ensure at least 8 GB RAM is free before launching
6. Close any recording/streaming software (OBS, Shadowplay)

Falling Out of Map (Mospital™ Cutscene Skip Bug)

Skipping the intro cutscene where Lixian shoves you into the Mospital™ can cause the player to clip through the floor and fall into the void, accessing unfinished areas of the map.

1. Do not skip the intro cutscene on your first playthrough
2. If already stuck, press Escape and restart the run
3. This is a known issue — Lixian may patch it in a future update

[Checksum] Game File Keeps Corrupting on Download

Several players report the 4.7 GB download file corrupting during transfer, especially on slow or unstable internet connections.

1. Extract using 7-Zip — Windows' built-in extractor silently corrupts large archives. This is the #1 hidden cause of "corrupted" game files
2. Use a download manager that supports resume (JDownloader or Free Download Manager)
3. Try downloading via the itch.io desktop app instead of the browser — it handles interrupted downloads gracefully
4. Disable antivirus temporarily — some flag the game executable as a false positive
5. Or skip the download entirely and play in your browser

🚀 4.7 GB Too Laggy? RTX Still Dropping Frames?

Don't let bad optimization ruin your escape. Select the fixes below to calculate your estimated FPS gain — then apply them in-game.