~ User Patch ~ | Feedback: https://www.strawpoll.me/42335831

Krock befa7237f0 Add notahuman's vkBasalt preset 6 hours ago
140 d363d6862d Patch 1.6.0 ready for testing 4 months ago
150 c26e9c3dc9 Preparation for 1.6.0, Part 2 4 months ago
151 4e9b7ebdc4 Patch 2.0.0 ready for testing 2 months ago
160 9f7e43d355 Preparation for 2.0.0, Part 2 2 months ago
161 dbb80dd984 Patch 2.1.0 ready for testing 1 month ago
200 c3a71a2993 Patch 2.2.0 ready for testing 2 days ago
210 c3a71a2993 Patch 2.2.0 ready for testing 2 days ago
220 9cf84a2609 Unlock 2.2.0 patch 7 hours ago
dev_tools e4a7e4e36f Add Frequenty Asked Questions file 1 month ago
static befa7237f0 Add notahuman's vkBasalt preset 6 hours ago
updater e1e3375110 [PATCH 2/2] Use subshell instead of backticks 1 day ago
.gitignore 63cd774f2b Add note about CN variant 9 months ago
CREDITS.md bd5193832b Documentation revamp part 1 5 months ago
FAQ.md c3f505f11d General documentation improvements 1 month ago
INSTALLATION.md e8773812fc Add note about multiple WINEPREFIX directories 2 months ago
LICENSE.txt 22a68f847f Initial upload 11 months ago
README.md befa7237f0 Add notahuman's vkBasalt preset 6 hours ago
TROUBLESHOOTING.md d43b873199 Add alternatives, add connection fixes 4 days ago
TWEAKS.md befa7237f0 Add notahuman's vkBasalt preset 6 hours ago


Game Status v2.2.0

Scroll down for the setup instructions.

Game is playable!

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


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: Developer stuff


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

Available solutions:

Project rules

  1. miHoYo reserves the right to distribute files. Please do not share any game data in public.
  2. For your own sake: Please do not share this project in public.
    • 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.

For project contributors: Beware that your log files may contain personal information, such as MAC addresses or login data.

Applying the workaround

See also: Full setup instructions

You will need Wine 5.3 or newer. DXVK is highly recommended.

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

# Download the repository (or use the download button)
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"
# Fixes a crash when entering the door
bash "/path/to/GI-on-Linux/GAMEVER/patch_anti_logincrash.sh"

# Please run "launcher.bat" to start the game
wine cmd /c launcher.bat

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


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

Frequently Asked Questions

Game updater & patch

Performance & visual tweaks


License: MIT