Guides and workarounds

Cha14ka be4fef45ca 4.8 wish history url 3 mesi fa
400 b40491696d Scripts for 4.1.0 (no patch) 1 anno fa
401 fc7893b4cf Scripts for 4.2.0 (no patch) 1 anno fa
410 e14e1d7c92 Scripts for 4.3.0 (no patch) 11 mesi fa
420 2fdea91aac Scripts for 4.4.0 (no patch) 9 mesi fa
430 65a83adecd Scripts for 4.5.0 (no patch) 8 mesi fa
440 0f419d1ef5 Scripts for 4.6.0 (no patch) 7 mesi fa
450 1c88455b8c Scripts for 4.7.0 (no patch) 5 mesi fa
460 10ec6b7843 Scripts for 4.8.0 (no patch) 4 mesi fa
470 10ec6b7843 Scripts for 4.8.0 (no patch) 4 mesi fa
480 10ec6b7843 Scripts for 4.8.0 (no patch) 4 mesi fa
compat be4fef45ca 4.8 wish history url 3 mesi fa
dev_tools 3e2c926ba8 Status update: high CPU load is back 4 mesi fa
static e0816f9957 Game version 3.8.0 does not need patches 1 anno fa
updater e566f50e19 Update script: Make patch dir optional 4 mesi fa
.gitignore 3abdc35823 Adjust the packaging script, improve patch templates 1 anno fa
CREDITS.md 8b7a106839 Add instructions for macOS users 1 anno fa
FAQ.md 245bc13551 Update FAQ.md 8 mesi fa
INSTALLATION.md 77e0e487c9 Improve the error 31-4302 troubleshooting steps 11 mesi fa
LICENSE.txt 22a68f847f Initial upload 4 anni fa
README.md ef0ff7f221 Preparation for 4.8.0 (no patch) 4 mesi fa
TROUBLESHOOTING.md 7a8c524d38 Document high CPU usage workaround 5 mesi fa
TWEAKS.md 05bba0c186 Documentation maintenance 1 anno fa

README.md

Game Status v4.8.0

Scroll down for the setup instructions.

Game is playable!

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

Note: as reported in Issue#401, the CN game servers are likely to prevent players on Linux and macOS from logging in for unknown reasons.

Situation

Before game version 3.8.0, a patch was needed to work around the game's cheat prevention kernel service which is and will not be supported by Wine. Since version 3.8.0 no additional patches are needed and the game is playable (almost) out of the box (🎉). To get the best gaming experience please check the setup instructions below.

Similar games. Format: link, caveats (Proton/Wine rating)

This list is incomplete. https://areweanticheatyet.com/ might provide information about specific titles.

Related compatibility 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.

Game installation instructions

Please check the Game installation instructions for the minimal requirements and a guided installation of the game using Lutris, Steam, macOS or custom scripts.

Afterwards, it is recommended to execute patch.sh so that launcher.bat is generated within the game directory because all instructions assume its presence. Note: the main patch script no longer modifies any game files and is considered harmless.

Follow the script as instructed. 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"

# Start the game after checking the domains
wine cmd /c launcher.bat

To stay up-to-date with the blocked domains, it is recommended to re-run the "patch" script after each game update.

Undo

Old patch residues can be removed by executing patch_revert.sh in the same manner as patch.sh above. To remove the blocked logging servers, edit /etc/hosts with superuser permissions.

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