Guides and workarounds

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

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