Guides and workarounds

Krock 1063452e01 Preparation for 3.8.0 il y a 1 an
310 74214e0d59 Preparation for 3.3.0, Part 2 il y a 2 ans
320 efb803b1a7 Patch 3.4.0 (OS) ready for testing il y a 1 an
330 6282877d28 Patch 3.5.0 (OS) ready for testing il y a 1 an
340 a25484f4e5 Patch 3.6.0 (OS) ready for testing il y a 1 an
350 a12c360767 Patch 3.7.0 (OS) ready for testing il y a 1 an
360 a12c360767 Patch 3.7.0 (OS) ready for testing il y a 1 an
370 1063452e01 Preparation for 3.8.0 il y a 1 an
380 1063452e01 Preparation for 3.8.0 il y a 1 an
compat e065f24e01 Improve SteamOS and macOS instructions il y a 1 an
dev_tools 1063452e01 Preparation for 3.8.0 il y a 1 an
static 23c79e0677 Purge outdated patches and troubleshooting entries il y a 2 ans
updater c13765133c Update script: Remove broken md5 check il y a 1 an
.gitignore 3abdc35823 Adjust the packaging script, improve patch templates il y a 1 an
CREDITS.md 8b7a106839 Add instructions for macOS users il y a 1 an
FAQ.md 3b288c34d9 Minor documentation maintenance il y a 1 an
INSTALLATION.md 2fe0f6bd2e Extend fonts setup instructions il y a 1 an
LICENSE.txt 22a68f847f Initial upload il y a 4 ans
README.md 1063452e01 Preparation for 3.8.0 il y a 1 an
TROUBLESHOOTING.md 2fe0f6bd2e Extend fonts setup instructions il y a 1 an
TWEAKS.md 05bba0c186 Documentation maintenance il y a 1 an

README.md

Game Status v3.8.0

Scroll down for the setup instructions.

Work in progress

Supported versions: International, China (channel 1 and 14)

Explanation

mhyprot3.sys is a kernel service which is and will not be supported by Wine. Problem: it is used as cheat prevention.

Available solutions:

  • Wine + patched game (what this project does)
  • Dual-boot to Windows
  • Use Hyper-V in a Windows VM
  • Play another game. Format: link, caveats (Proton/Wine rating)

Related projects

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 (Lutris, Steam, macOS, custom)

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

Follow the script as instructed. Backups (.bak) are made automatically where needed. GAMEVER stands for the game version, i.e. 3.2.0 becomes 320.

# Download the repository (or use the download button)
git clone https://notabug.org/Krock/dawn --depth 1

# Tip: Drag&drop the desired directory or file into the terminal to copy its path

cd "/path/to/Genshin Impact Game"
bash "/path/to/dawn/GAMEVER/patch.sh"
# Despite its name, this second patch improves the game performance:
bash "/path/to/dawn/GAMEVER/patch_anti_logincrash.sh"

# For macOS only! Fixes model rendering issues
#bash "/path/to/dawn/compat/macos_cpu_skinning.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.

Troubleshooting

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

Frequently Asked Questions

Game updater & patch

Performance & visual tweaks

Credits

License: MIT