~ User Patch ~ | Feedback:

Krock 64e39c8385 Add experimental 1.3.0 patch 4 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 5bbfd311e6 Preparation for 1.3.0, Part 2 4 months ago
130 64e39c8385 Add experimental 1.3.0 patch 4 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-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 7 months ago
README.md 64e39c8385 Add experimental 1.3.0 patch 4 months ago
TOOLS.md 81db2dc321 Update with 21-4301, minor additions 6 months ago
TROUBLESHOOTING.md 64e39c8385 Add experimental 1.3.0 patch 4 months ago


Game Status v1.3.0

An early experimental patch is available. Scroll down for the setup instructions.

Work in progress


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. Problem: it's used as cheat detection.

Possible solutions:

  • Wine + patched game (what this project does)
  • Use a slow Windows VM or dual-boot
  • Wait for an official Linux build
  • Wait for kernel service support in Wine
  • 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 your log files 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 run "launcher.bat" to start 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. Your options are:

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

Chinese variant: Not supported due to missing information, see Issue#22



License: MIT