Project to Genshin Impact on Linux. Looking for: Reverse engineers and enthusiasts

Kowalski ecb52ef1d3 Added UserAssembly symbols for 1.1 6 months ago
100 1ff6944117 Update for 1.1.0 7 months ago
101 a8148b223c Sophisticated Lua script. let's do something with it 6 months ago
110 ecb52ef1d3 Added UserAssembly symbols for 1.1 6 months ago
suspend_start edf88a3b4b Suspend/resume control app for Linux 6 months ago
.gitignore f39738ca43 Sorry, wrong address 6 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 7 months ago 4e258b0e6c no progress. alternatives. 6 months ago 7b604c7e42 x64dbg tests. minor new information 6 months ago

GI on Linux

The goal of this project is to play Genshin Impact on Linux. This repository includes patches to get the game running.

License: MIT


Error 31-4302 when entering the door after login


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

  • Some research is stalling, and may be missing from the Markdown files. Be sure to check the comments!

Helpful tools:

Current conclusions: 1.1.0 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
  • Wait for Blue Protocol as an alternative (2021/22)

1 Week of Gameplay

From 23 October 2020 (1.0.1 update) to 28 October 2020 the game was confirmed working on multiple Wine versions (5.17 and newer). Prior and after, the error code 31-4302 is shown.

What has changed? Probably a server update. Needs investigating.

Project rules

  1. The workarounds must not be used for cheating. GI is a nice game and does not deserve cheaters.
  2. miHoYo reserves the right to distribute files. Please do not share any game data in public.
  3. Beware that logs may contain personal information, such as MAC addresses or login data.

Applying the workaround

Apply the patch(.sh) as follows:

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

A backup will be created and the relevant files patched.


Original research:

If you are on this list but do not agree with the license, please open an issue or contact me directly.

List ordered by first contribution in the project.

User Krock (PlayOnLinux, NotABug)

  • Initial Ghidra experiments, self-declared project leader

User timbuntu (PlayOnLinux, NotABug)

  • First success on version 1.0.1
  • MITM logs

User geearf2 (Freenode IRC)

  • Providing game data from 25 Oct

User SeppNel (PlayOnLinux, NotABug)

  • Windows/Linux comparisons on the same system
  • Network and xLua logs

User 0x90 (PlayOnLinux)

  • Research about in-memory modifications
  • x64dbg instructions

User Th1nkCh3ck (NotABug)

  • General information research

User Makksim (NotABug)

  • Summary of the mhyprot2 service behaviour

User tiagop (NotABug, Email)

  • Information collecting about Wine projects