Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/magisteriis/setup-league-client
A GitHub Action for setting up the League of Legends client (a.k.a. LCU).
https://github.com/magisteriis/setup-league-client
actions game integration-testing lcu league-client league-of-legends riot-games
Last synced: 2 months ago
JSON representation
A GitHub Action for setting up the League of Legends client (a.k.a. LCU).
- Host: GitHub
- URL: https://github.com/magisteriis/setup-league-client
- Owner: magisteriis
- License: unlicense
- Created: 2022-01-15T19:56:15.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-11-14T11:55:17.000Z (about 1 year ago)
- Last Synced: 2024-05-02T01:44:58.406Z (8 months ago)
- Topics: actions, game, integration-testing, lcu, league-client, league-of-legends, riot-games
- Language: PowerShell
- Homepage: https://github.com/marketplace/actions/setup-league-client
- Size: 133 KB
- Stars: 18
- Watchers: 3
- Forks: 2
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Setup League Client
[](https://github.com/magisteriis/setup-league-client/actions/workflows/daily-test.ea5ea07.yml)
[](https://github.com/magisteriis/setup-league-client/actions/workflows/daily-test.v1.yml)
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][actions-reference-commit] 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](https://github.com/MingweiSamuel) for his [lcu-schema/update.ps1][lcu-schema-update.ps1] (licensed under the [MIT license][lcu-schema-license]).
### Sponsors
[](https://sentry.io/for/good/)
[](https://jb.gg/OpenSourceSupport)
## Notice from Riot Games, Inc.
The GitHub Action "[Setup League Client](https://github.com/marketplace/actions/setup-league-client)" by [@magisteriis](https://github.com/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.
[actions-reference-commit]: https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions#jobsjob_idstepsuses
[lcu-schema-update.ps1]: https://github.com/MingweiSamuel/lcu-schema/blob/a309d795ddf0eba093cb6a6f54ffa9238e947f3a/update.ps1
[lcu-schema-license]: https://github.com/MingweiSamuel/lcu-schema/blob/a309d795ddf0eba093cb6a6f54ffa9238e947f3a/LICENSE