~ User Patch ~ | Feedback:

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

README.md

Playable
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.

Tools

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

Tweaks

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

Troubleshooting

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

See dedicated page

Contributing

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.

Development

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.

Credits

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

See dedicated page