Skip to content
trending-up

GitHub Action

Setup League Client

v1 Latest version

Setup League Client

trending-up

Setup League Client

Installs the latest version of the League of Legends client

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Setup League Client

uses: magisteriis/setup-league-client@v1

Learn more about this action in magisteriis/setup-league-client

Choose a version

Setup League Client

Daily Test (@ea5ea07) Daily Test (@v1)

image

An action for setting up the League of Legends client (a.k.a. League Client/LCU). Good for testing League Client integrations.

The action requires a Windows runner.

The setup takes around 5-10 minutes.

Example

- name: Setup League Client
  id: league-client
  uses: magisteriis/setup-league-client@ea5ea0748d459cb8e4bade9d50d2f81b70f009f7
  with:
    username: ${{ secrets.LOL_USERNAME }}
    password: ${{ secrets.LOL_PASSWORD }}
    region: EUW
    
- name: Test LCU Integration
  run: .\tests.ps1
  shell: pwsh
  env:
    LCU_PASSWORD: ${{ steps.league-client.outputs.lcu-password }}
    LCU_PORT: ${{ steps.league-client.outputs.lcu-port }}
    LCU_DIR: ${{ steps.league-client.outputs.lcu-directory }}

Questions

Why is the action referenced using a commit in the example?

It's the most secure and stable way to reference an action as tags can be moved. This specific commit also has daily tests as you can see in the top. If you prefer you can reference the action with @v1 to use any fixes automatically.

Why isn't the region a secret in the example?

The region is being output in the action logs. I haven't found a good way to mask it since it's also being output in base64. The locale (e.g. en_US) is also being output.

What is an LCU password?

It's the password used when establishing either an HTTPS or a WSS connection to the LCU. It changes everytime the League Client is restarted. Since the League Client can only be accessed from the local machine (or runner) under normal circumstances it's safe to display and good for debugging purposes.

Thanks

Thanks to @MingweiSamuel for his lcu-schema/update.ps1 (licensed under the MIT license).

Sponsors

Sentry Logo JetBrains Logo (Main) logo

Notice from Riot Games, Inc.

The GitHub Action "Setup League Client" by @magisteriis isn't endorsed by Riot Games and doesn't reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games, and all associated properties are trademarks or registered trademarks of Riot Games, Inc.