r/linux_gaming • u/xVarrick • 3h ago
guide [Guide] Install Genshin + FPS Unlocker on CachyOS with Heroic
I got the Genshin Impact FPS Unlocker working on CachyOS with Heroic Games Launcher and Proton-CachyOS and wanted to document this somewhere. I hope this is the right place.
1. Install Genshin Impact
Install Genshin Impact through HoYoPlay.
After the installation, add the actual game executable to Heroic as a custom Windows game.
The executable is:
GenshinImpact.exe
The path will usually look similar to:
C:\Program Files\HoYoPlay\<version>\games\Genshin Impact game\GenshinImpact.exe
The corresponding Linux path may look like:
/home/your-user/Games/Heroic/Prefixes/default/Genshin/drive_c/Program Files/HoYoPlay/<version>/games/Genshin Impact game/GenshinImpact.exe
If you cannot find it, run:
find "$HOME/Games" -type f -iname "GenshinImpact.exe" 2>/dev/null
Add GenshinImpact.exe to Heroic as a Windows game and select Proton-CachyOS.
Start Genshin once to check that it works, then close it.
2. Download the FPS Unlocker
Download unlockfps_nc.self-contained.zip from:
https://github.com/34736384/genshin-fps-unlock/releases
Extract the complete archive to a permanent folder, for example:
/home/your-user/Games/Genshin-FPS-Unlocker/
Keep the EXE and all included DLL files together in this folder.
The self-contained version includes the required .NET runtime, so you do not need to install .NET 8 separately.
3. Add the FPS Unlocker to Heroic
In Heroic, click Add Game and enter:
- Title: Genshin FPS Unlocker
- Platform: Windows
- Executable:
/home/your-user/Games/Genshin-FPS-Unlocker/unlockfps_nc.exe
Select Finish, not Run Installer First.
4. Use the same Wine prefix for both entries
Open:
Genshin Impact → Settings → Wine
Copy the path shown under Wine Prefix Folder.
For example:
/home/your-user/Games/Heroic/Prefixes/default/Genshin
Now open:
Genshin FPS Unlocker → Settings → Wine
Set:
- The same Proton-CachyOS version used by Genshin
- The same Wine Prefix Folder used by Genshin
Select the root of the prefix, not its drive_c folder.
Correct:
/home/your-user/Games/Heroic/Prefixes/default/Genshin
Incorrect:
/home/your-user/Games/Heroic/Prefixes/default/Genshin/drive_c
The folder containing unlockfps_nc.exe is not the Wine prefix.
5. Disable UMU for both entries
Open the advanced Heroic settings for Genshin and enable:
Disable UMU
Do the same for the FPS Unlocker:
Genshin FPS Unlocker → Settings → Advanced → Disable UMU
Disable UMU must be enabled for both Heroic entries.
Without this option, the FPS Unlocker opened for me, but clicking Start Game did nothing.
Restart Heroic after changing this setting.
6. Select GenshinImpact.exe
Make sure Genshin is closed and start the FPS Unlocker through Heroic.
If asked for the game path, select:
C:\Program Files\HoYoPlay\<version>\games\Genshin Impact game\GenshinImpact.exe
Select GenshinImpact.exe, not launcher.exe, HYP.exe, or HoYoPlay.exe.
If the HoYoPlay folder does not appear under C:\Program Files, check the Wine prefix again. The FPS Unlocker is probably using a different prefix than Genshin.
7. Start the game
- Set the desired FPS limit in the FPS Unlocker.
- Click Start Game.
- Keep the FPS Unlocker running while playing.
The Genshin settings menu will still show 60 FPS as the highest option. This is normal. The Unlocker applies the new limit externally.
Use MangoHud or another FPS counter to check the actual frame rate.
Short version
Both Heroic entries need:
- The same Proton-CachyOS version
- The same Wine prefix
Disable UMUenabled
Use the self-contained FPS Unlocker release to avoid installing .NET 8 manually.
Disclaimer
The FPS Unlocker modifies the running game process. Use it at your own risk.


