Guides and workarounds

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

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