GI-on-Linux/INSTALLATION.md

Game installation instructions

Minimal requirements:

• Any installation of wine >= 5.3 (sooner or later)

Highly recommended:

• Vulkan-capable graphics card ("How to check?")

Table of contents

• Lutris
• Steam
• Custom

Lutris

1. Download the Windows installer from the official site
2. Add the installer binary to your library
3. Set up a wineprefix for the game
   • This is where the game will be installed. 40+ GiB of free space is highly recommended.
   • Grab at least lutris-6.4 for the wine runner.
4. Install the components the game needs to run flawlessly
   • Open Winetricks via the context menu
   • Install the Windows component faudio and the font corefonts.
   • Lutris will take care of DXVK. No action needed there.
5. Launch the downloaded installer .exe
   • Use the Run EXE inside wine prefix menu action for this.
   • Go with the default settings, and wait for it to download the game.
   • Once it is done, do not press launch. Exit the launcher.
6. Apply the GI-on-Linux patch
   • See README.md: Applying the patch
7. Play the game
   • Change the game executable path to point to launcher.bat (same directory as GenshinImpact.exe)
   • Launch the game

Steam

1. Download the official launcher
2. "Add non-Steam game..." -> Show all files -> Select the launcher executable -> Done
3. Setup proton (if not done using global settings)
   • Navigate: Gear icon -> "Settings" -> "Compatibility"
   • Check "Force compatibility layer ..."
   • Select Proton 5.13 or newer
4. Install the game. Select a path that you can find later on!
5. Apply the patch script: "how?"
6. Update the target. Gear icon -> "Settings":
   • Target: explorer.exe
   • Execution directory: /path/to/your/gi/installation/
   • Start options: /desktop=anyname,1920x1080 cmd /c launcher.bat
   • Adjust the screen resolution above, if necessary.
7. Play.

Custom

Script-based approach to use any Wine version on any WINEPREFIX. If you do not understand what each step is supposed to do, use Lutris instead.

For the final game launch script after the prefix setup, use steps 1, 2 and 6.

# 1. Specify the path to wine(64)
#    This can be either system-wide or a custom installation
WINE="wine64"
#WINE="$HOME/.local/share/Steam/steamapps/common/Proton 5.13/dist/bin/wine64"

# 2. Specify a WINEPREFIX
export WINEPREFIX="/absolute/path/to/.prefix/"

# 3. Create or update WINEPREFIX
"$WINE" wineboot -u

# 4. Install DXVK (v1.9.0, for Wine 5.14+)
#    Use the newest Winetricks script from GitHub
export WINE
sh winetricks dxvk190

# 5. Install the game (if not already done)
"$WINE" "/path/to/installer.exe"

# 6. Game launch
cd "/path/to/Genshin Impact Game"
export WINEESYNC=1  # requires staging or Proton, see TWEAKS.md
"$WINE" explorer /desktop=anyname,1920x1080 cmd /c launcher.bat

# 7. Game update
#    See `updater/README.md` or attempt to use the official launcher:
"$WINE" "/path/to/official/launcher.exe"