~ User Patch ~ | Feedback:

yagocl f597a53961 Add alternative to vkbasalt SMAA 1 month ago
101 c50c174640 Patch 1.4.0 ready for testing 2 months ago
110 c50c174640 Patch 1.4.0 ready for testing 2 months ago
120 c50c174640 Patch 1.4.0 ready for testing 2 months ago
130 394288bd68 Patch 1.5.0 ready for testing 1 month ago
132 394288bd68 Patch 1.5.0 ready for testing 1 month ago
140 394288bd68 Patch 1.5.0 ready for testing 1 month ago
150 7214abb9fd Unlock 1.5.0 patch file 1 month ago
151 03276f31b7 Add 1.5.1 testing patch 1 month ago
asm_helper 2efebf091a Add byte code helper application 5 months ago
suspend_start edf88a3b4b Suspend/resume control app for Linux 6 months ago
updater c979159caa Updater: Fix path in documentation 1 month ago
.gitignore 63cd774f2b Add note about CN variant 5 months ago
CREDITS.md 19f4e95992 Update script documentation and style edits 2 months ago
INSTALLATION.md 6c9b7f9f94 More readme work 1 month ago
LICENSE.txt 22a68f847f Initial upload 7 months ago
LOGO-IF-E31-4302.jpg 4809667607 Add CE recipe and status indicator 6 months ago
LOGO-IF-WIP.jpg 4a1308017d Add second patch to instructions, add WIP image 5 months ago
LOGO-IF-WORKING.jpg 1e3a5dbd3d Add logo if it works. Just in case :D 6 months ago
README.md 725c2e2f16 More readme work 1 month ago
TOOLS.md 81db2dc321 Update with 21-4301, minor additions 6 months ago
TROUBLESHOOTING.md 8458698870 Remove performance info from troubleshooting file. 1 month ago
TWEAKS.md f597a53961 Add alternative to vkbasalt SMAA 1 month ago


License Supported versions

Table of Contents

Introduction to GI-on-Linux

GI-on-Linux is a community effort to create patches and tools to make Genshin Impact playable on a GNU/Linux system through Wine. We also have tools to facilitate maintenance and updates.

So far, our efforts were successful and Genshin Impact should run at near native performance for most people, and with complete functionality.

NOTE: The Chinese variant (Yuanshen) is not yet supported due to missing information, see Issue#22

What this patch does

mhyprot2.sys is a kernel service which is and will not be supported by Wine. Problem: it's used as cheat detection, and without it, the game will simply not open.

Available solutions:

This patch allows the game to run without mhyprot2.sys, by spoofing some values to make the game think it's running on a normal Windows system.

Project guidelines

  1. miHoYo reserves the right to distribute files. Please do not share any game data in public.
  2. For your own sake: Do not share this project in official channels. Why?

    • Reduces the risk of this project to be taken down or used against our reverse-engineering efforts
    • Solution: Use indirect/redirect links and private messages
  3. Please do not abuse this project for cheating. We just want to play the game.

  4. (For project contributors) Beware that your log files may contain personal information, such as MAC addresses or login data. Snip any sensitive data beforehand to enforce your privacy.

Please do not report any game issues to an official channel. Your options are:

Installing the game

This page contains instructions for getting the vanilla game installed on Linux (via Lutris, for example). However, without the patch, you will not be able to play.

See dedicated page

Applying the patch

You will want to follow these steps on the terminal.

# Download the repository (or use the download button) to your home folder, or anywhere else you want.
git clone https://notabug.org/Krock/GI-on-Linux
# Go to the folder the game files are in. This is an example:
cd "(your wineprefix)/drive_c/Program Files/Genshin Impact/Genshin Impact game/"
# Apply the main patch (assuming it is in your home folder).
# For example, if you updated to 1.5.1, change (game version) to 151.
bash "$HOME/GI-on-Linux/(game version)/patch.sh"
# Apply the patch that fixes a crash when entering the door
bash "$HOME/GI-on-Linux/(game version)/patch_anti_logincrash.sh"

Once it's all done, you should have a launcher.bat on the game folder to launch it with.

The patches can be reverted using the included patch_revert.sh in the same manner.


The repository comes with the following additional tools:

  • An updater for Genshin Impact
    • You can use it instead of the official launcher.exe to get new updates.
    • If you don't want to, the official launcher.exe is at (your wineprefix)/drive_c/Program Files/Genshin Impact


A list of tweaks you can do to the game under Linux to improve visuals, performance, etc.
Most Linux users do love to tinker, after all.

See dedicated page


An (extensive?) list of problems you may face and possible solutions.

See dedicated page


Reporting issues

If you would like to help us, check the open tasks on the issue tracker. You can also make a new issue to report problems with the game, if you believe they are related to the patch or Wine.


Some information might be missing from the Markdown files. Be sure to check the comments on older issues, for additional info on the game's inner workings.


A list of people that contributed their time to the project.
GI-on-Linux is a community effort.

See dedicated page