Home Explore Help
Sign In
yagocl
/
GI-on-Linux
forked from Krock/dawn
Watch 3
Star 0
Fork 0
Files
Tree: f597a53961
Branches Tags
GI-on-Linux
/
README.md

README.md 6.1 KB
History Raw

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