League of Legends helper script for installing and running on Linux.

Please choose an installation method suitable for your distribution. Remember to check all dependencies are installed properly if it's installed manually.

The following dependencies are included in the AUR package and the generated .deb package. If there's anything incorrect or missing, pull requests are appreciated.

• wine-lol (AUR)
• winetricks
• bash
• curl
• openssl
• samba
• mesa-utils
• lib32-gnutls
• lib32-libldap
• lib32-openal
• lib32-libpulse
• lib32-alsa-lib
• lib32-mpg123
• lib32-unixodbc
• lib32-vkd3d
• vulkan-icd-loader, lib32-vulkan-icd-loader
• Vulkan drivers for your graphic cards. For example:
  • lib32-vulkan-intel
  • lib32-nvidia-utils (Debian/Ubuntu: libnvidia-glvkspirv:i386 libglx-nvidia0:i386)
  • lib32-vulkan-radeon
  • lib32-amdvlk

Note
The above package names are based on Arch Linux. For other non-Arch based distributions, the names will most likely differ. Please refer to the documentation of your distribution for installing the correct Vulkan drivers and other dependencies.

There is no need for configuration. You may feel free to skip this part, unless you want to change the install path of the game or where the cache is placed.

The helper script looks for configuration files located at $XDG_CONFIG_HOME/league.sh or ~/.config/league.sh, in that order. The configuration file is a shell script and will be sourced before starting the game. You may define any environment variables or run any commands you want, which might be helpful in special situations.

These are the variables that will be explicitly referenced and used:

• DATA_HOME: The path where the game is, or will be, installed. (Default: $XDG_DATA_HOME or ~/.local/share)
• CACHE_HOME: The path for the cache files. (Default: $XDG_CACHE_HOME or ~/.cache)

For example, if the configuration file doesn't exist or if the DATA_HOME variable is not defined, the game would then be installed at ~/.local/share/leagueoflegends/ by default.

• Please make sure you have installed the correct Vulkan driver for your graphics card that you will be using. You can check what is installed with

  ls /usr/share/vulkan/icd.d/
  

Note
For Garena client (Southeast Asia), please skip to the section below.

• First install the game: leagueoflegends install.
  • Please do not log in or launch the game during installation.
  • If the installation progress stucks at 100%, close the window, and run leagueoflegends install again.
    • For more detail, check out this thread.
• Exit the window when the game installation is finished. (The progress circle disappears.)
• Start the game: leagueoflegends start.
• Log in with your Riot credentials and start LoL as usual.
• Once the League client shows up, please try a practice match to make sure everything works.
• To remove the game: leagueoflegends uninstall.

Note
If you use Nvidia graphics card and have trouble launching the League client or start the game (after champion selection), please check out the troubleshooting section.

leagueoflegends -h can be used to view the full list of options and commands.

[!] Usage: leagueoflegends [options] <command>

    League of Legends - helper program

    Options:
        -h, --help          Print this message and exit
        -v, --verbose       Enable verbose output
        -s, --skip-riot     Skip the Riot client

    Commands:
        start               Start LoL
        install             Install LoL
        uninstall           Uninstall LoL
        reinstall           Reinstall LoL
        replay <path>       Replay match (.rofl file)
        start-garena        Start Garena
        install-garena      Install Garena
        uninstall-garena    Uninstall Garena
        reinstall-garena    Reinstall Garena
        add-dxvk            Install DXVK to the LoL wineprefix
        del-dxvk            Remove DXVK from the LoL wineprefix
        rm-dxvk-cache       Remove DXVK cache
        cleanup-logs        Remove log files
        kill                Kill the wine processes of the wineprefix
        kill-garena         Kill the Garena wine processes
        run <cmd>           Run shell command with environment variables
        run-garena <cmd>    Run shell command with environment variables

Note
I haven't tested the Garena setup for years. Please proceed at your own risk. That being said, any pull requests or testing aid would be greatly appreciated.

• First install Garena: leagueoflegends install-garena
  • Choose the region when prompted.
  • There are two wine prefixes (environments) involved in this setup. Both Garena and LoL will be installed in ~/.local/share/garena/. However, the game will be launched from the other prefix, ~/.local/share/leagueoflegends/.
  • It's recommended to not change the default location of Garena, which is C:\Program Files\Garena\Garena\. If you do want to change the default location, remember to also change it in the script.
  • Once Garena is successfully installed, it will be automatically started. Please log in and go ahead to install LoL from Garena.
  • LoL will by default be installed at Z:\Garena\Games\, which is in most cases not desirable. Please change it to C:\Program Files\Garena\Games\, or any other location you desire as long as it is consistent with the script variables.
• Exit the Garena window when the game installation is finished.
• Kill the Garena process to finish installation: leagueoflegends kill-garena.
  • Because the process will only be minimized to system tray upon exit.
• Start the game: leagueoflegends start-garena.
  • This will start Garena. Navigate to LoL and press "Play" from Garena.
• To remove the game: leagueoflegends uninstall-garena.
• To also remove the environment from which the game is launched: leagueoflegends uninstall.

leagueoflegends kill would use wineserver --kill to try to kill all the wine processes of the current wine prefix, which can be helpful if some error happens and the script hangs.

leagueoflegends run <...> can be use to run any command with the wine-related environment variables, such as WINEARCH, WINEDLLOVERRIDES, and WINEPREFIX. This way, you could easily run wine utilities like leagueoflegends run winecfg, or leagueoflegends run winetricks, etc.

If you use Nvidia graphics card and have trouble launching the League client or start the game (after champion selection), please exit the game (with leagueoflegends kill or leagueoflegends kill-garena if you are running the Garena version) and then try leagueoflegends rm-dxvk-cache before restarting it. This should only need to be done once to clean up the old cache, since DXVK caching is currently disabled. (Reference)

If the issue still remains, you may want to purge and reinstall the Nvidia related packages as described here.

Alternatively, as a quick (and dirty) workaround, remove the nvidia package and install nvidia-dkms instead. Remember to also install the kernel headers packages according to your kernel (e.g., linux-headers). Then reboot and reinstall LoL.