🎆🎇 Feedback:

Krock ae5f831597 Update revert script and status 5 months ago
100 1ff6944117 Update for 1.1.0 7 months ago
101 ba100cc691 Remove unhelpful image, correct the dll checker sentence 5 months ago
110 55bffa7165 Patch script for 120 completed 5 months ago
120 ae5f831597 Update revert script and status 5 months ago
asm_helper 2efebf091a Add byte code helper application 5 months ago
suspend_start edf88a3b4b Suspend/resume control app for Linux 6 months ago
.gitignore 63cd774f2b Add note about CN variant 5 months ago
CREDITS.md 2cf7954b2d Improve the troubleshooting page, error corrections 5 months 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-WORKING.jpg 1e3a5dbd3d Add logo if it works. Just in case :D 6 months ago
NO_TROUBLES.md ae5f831597 Update revert script and status 5 months ago
README.md ae5f831597 Update revert script and status 5 months ago
TOOLS.md 81db2dc321 Update with 21-4301, minor additions 6 months ago


Game Status v1.2.0

Scroll down for the setup instructions.

As of 1.2.0, 25 Dec you will need an additional patch. See Troubleshooting for details.

Game is playable!


If you would like to help us, check the tasks on the Issue tracker

  • Some information might be missing from the Markdown files. Be sure to check the comments!

Relevant: RE tools, 1.1.0 research journal


mhyprot2.sys is a kernel service which is and will not be supported by Wine. The service is used as cheat detection, hence being well protected.

Possible solutions:

  • Patch out anticheat (reason why this project exists)
  • Support the kernel service support in Wine
  • Wait for an official Linux build
  • Play another game. Format: link, caveats (Proton/Wine rating)

Project rules

  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.
    • Reduces the risk of this project to be taken down or used against our reverse-engineering efforts
    • Solution: Share the files required by the patch script (see GAMEVER/README.txt)
  3. Please do not abuse this project for cheating. We just want to play the game.

Beware that logs may contain personal information, such as MAC addresses or login data.

Applying the workaround

Apply the patch(.sh) as follows. You will need Wine 5.3 or newer.

# Download/clone the repository
git clone https://notabug.org/Krock/GI-on-Linux --depth 1

cd "/path/to/Genshin Impact Game"
bash "/path/to/GI-on-Linux/GAMEVER/patch.sh"

# Please use this to launch the game
wine cmd /c launcher.bat

Follow the script as instructed. Backups (.bak) are made automatically where needed.

Please do not report any game issues to an official channel. Check the troubleshooting page linked below, create an issue here or post your problem on a Wine/dxvk-specific page.

Undo: The patch can be reverted using patch_revert.sh in the same manner.

Chinese Variant: Not supported yet, as of 1.2.0; missing information.

Problem Troubleshooting


License: MIT