If you've played Project Lunky — the viral horror roguelite by Lixian (LixianGames) — you've probably hit one of two infuriating issues: the game crashes when you enter a door portal, or your FPS tanks to single digits despite having a decent GPU. This guide covers every known fix.
📋 Table of Contents
1. What Causes the Portal Crash?
The door portal crash is the single most reported bug in Project Lunky. When you step into a portal to transition between lab levels, the game either freezes completely or crashes to desktop with no error message.
Based on community testing and analysis of crash logs, the root cause is excessive memory allocation during scene transitions. The game attempts to load the next level's assets (textures, enemy spawns, room geometry) while the current level is still fully loaded in RAM. On systems with 8 GB or less, this causes an out-of-memory condition.
The issue is exacerbated by shadow rendering — the shadow system allocates large shadow maps that persist across scene transitions. This is why disabling shadows is the single most effective fix.
2. Portal Crash Fix (Step-by-Step)
Follow these steps in order. Most players are fixed by step 1-2 alone:
Step 1: Disable Shadows
Open Settings → Graphics → set Shadow Quality to Off. This alone fixes the crash for ~70% of players. Shadows are the biggest memory consumer during portal transitions.
Step 2: Lower Texture Quality
Set Texture Quality to Medium or Low. High-res textures consume 1-2 GB of VRAM that compounds during scene loading.
Step 3: Close Background Apps
Each Chrome tab uses 100-500 MB RAM. Close Chrome, Discord, Spotify, and any other memory-hungry apps. You need at least 4 GB of free RAM for stable portal transitions.
Step 4: Run as Administrator
Right-click the game .exe → Run as Administrator. This gives the game higher memory allocation priority and access to larger page files.
Step 5: Update GPU Drivers
Download the latest drivers: NVIDIA GeForce Experience or AMD Adrenalin Software. Outdated drivers can cause memory leaks during scene transitions.
Step 6: Switch to Windowed Mode
Fullscreen mode allocates a dedicated framebuffer. Windowed mode shares the desktop compositor's buffer, freeing ~500 MB of VRAM.
Step 7: Re-download the Game
If none of the above works, your game files may be corrupted. Delete the entire game folder and re-download from itch.io.
3. Why FPS Drops Even on RTX GPUs
Players with RTX 5060 Ti, RTX 4070, and even RTX 4090 report severe FPS drops — sometimes to single digits. The confusion is understandable: how can a roguelite lag on a $400+ GPU?
The answer: Project Lunky's performance bottleneck is CPU and RAM, not GPU. The roguelite level generation system runs on the CPU. When the game generates new rooms, spawns enemies, and calculates pathfinding for multiple AI entities simultaneously, it spikes CPU usage.
Additionally, the game may default to your integrated GPU (Intel UHD / AMD Radeon Vega) instead of your dedicated RTX card. This is the #1 hidden cause of lag on laptops.
4. FPS Drop Fix (Step-by-Step)
Step 1: Force Dedicated GPU
NVIDIA: Open NVIDIA Control Panel → Manage 3D Settings → Program Settings → Add ProjectLunky.exe → set to 'High-performance NVIDIA processor'. AMD: Open AMD Software → Gaming → Add Game → set Graphics Profile to 'Gaming'.
Step 2: Disable V-Sync
V-Sync caps your framerate to your monitor's refresh rate and introduces input lag. Disable it in game settings for smoother gameplay.
Step 3: Disable Overlays
Discord overlay, Steam overlay, GeForce Experience overlay, and Xbox Game Bar all consume GPU resources. Disable all of them.
Step 4: Set High Process Priority
Open Task Manager (Ctrl+Shift+Esc) → Details tab → right-click ProjectLunky.exe → Set Priority → High.
Step 5: Free Up RAM
Ensure at least 8 GB RAM is free. Close Chrome, background updaters, and disable startup programs you don't need.
Step 6: Disable Recording Software
OBS, Shadowplay, Medal, and similar recording tools encode video in real-time, consuming both CPU and GPU. Disable them while playing.
5. Mospital™ Cutscene Skip Bug
If you skip the intro cutscene where Lixian shoves you into the Mospital™, your character can clip through the floor and fall into the void below the map.
The fix is simple:don't skip the intro cutscene on your first playthrough. The cutscene sets up the player's spawn position correctly.
If you're already stuck, press Escape → Restart Run.
6. Download File Corruption Fix
Multiple players report the 4.7 GB download file corrupting during transfer, especially on slow or unstable internet connections.
- Use the itch.io desktop app instead of browser download — it supports resume
- Use a download manager like Free Download Manager or JDownloader
- Temporarily disable antivirus — some flag the game .exe as a false positive
- Try downloading at off-peak hours when your internet is more stable
7. The Zero-Bug Alternative: Browser Version
If you're tired of troubleshooting, our browser-based version runs entirely in your browser tab:
- No portal crash — optimized scene transitions
- No FPS drops — lightweight rendering at 60 FPS
- No download — 0 GB, instant play
- Unblocked — works on school and work networks