README.md

Ancient Chimes

League of Legends Friend List Exporter using League Client API (LCU)

YouTube

Installation & Setup

I checked this app working on windows. I'm not sure mac.

1. Download ancient-chimes-X.X.X-win.zip

2. Extract the zip

3. Open "system.yaml" in here

C:\Riot Games\League of Legends\RADS\projects\league_client\releases\<LATEST_VERSION>\deploy

4. Add the 1 line code into 2nd line

enable_swagger: true

*You need to add the code everytime LoL client updated

5. Start League of Legends client

6. Double click "ancient-chimes.exe" in the extracted folder

*if you see "Windows protected your PC" popup, try this

Desktop > click windows mark > type "Windows Defender" and click > select "App & browser control" > choose Off in "Check apps and files" section

To use

1. Load

Get Summoner names from friend list

2. Export

Download the friend list as text

To develop

To clone and run this repository you'll need them. More References

1. Git
2. Node.js (with npm)
3. yarn (like fast npm)
4. From command prompt

# Clone this repository
git clone https://github.com/ulgg/ancient-chimes
# Go into the repository
cd ancient-chimes
# Install dependencies
yarn install
# Run the app
yarn start

Build exe from source

# Make exe(zip) of the app
yarn dist

Thanks and References

My learning history. Quick Note of this README (JP)

You can create an app using League Client API too. Like send a notification, send a message, change summoner icon.

• Git install - even monkey can understand (JP)
• nvm+Node.js+npm install (JP) - manage node+npm version
• yarn install (JP) - faster npm
• Visual Studio Code (Editor) Electron debugging - IDE
• rift-explorer - API reference. You can test League Client API call
• lcu-connector - You can call League Client APIs in Node.js
• Pyke_Client_LoL - You can learn how to use lcu-connector
• electron-quick-start - I started to create this app from this
• electron-builder - You can make exe of an electron app
• Let's try to create an Electron app (JP)
• Electron Main process Http Request (via auth proxy)(JP)
• Electron communication process by IPC(JP)
• async/await with forEach(JP)
• Community Dragon - online asset (exp. summoner icon image)
• League Client APIs (Riot Games) - About League Client API
• Communication Channel Refresh (Riot Games) - Discord channel #lcu-api and #api-challenge-2018 are helpful. See pins!
• THE ARCHITECTURE OF THE LEAGUE CLIENT UPDATE (Riot Games)
• League Client Update Extra Insights
• A Twitch viewer recommended Visual Studio Code Editor for me. Thanks.
• My friend 魚児在河里游泳 has same idea. and we wish if friend list would have last login date.

FAQ

• Which technologies do you use?

Node.js, npm, yarn, Electron, JavaScript, HTML, Bootstrap, Git, Wireshark, Fiddler 4, HttpRequest, SubLime(Editor), Visual Studio Code(Editor)

• Why did you chose them?

Because I wanted friends use the app easily. and there are many samples like rift-explorer, lcu-connector, Pyke_LoL. First, I was going to create web app with Express, Pug, Google App Engine. But I noticed I couldn't call League Client API from internet. If my friends want to use the app, they need to install some unpopular softwares and need effort to learn them. Although I spend around 2 weeks to learn Express, Pug.

• How did you learn about them?

I had 0 knowledge about them. I learned them from Qiita, StackOverflow, Personal blogs, References, Twitch viewers comments. I have read the "all" messages on Riot Games Dev Discord #lcu-api and #api-challenge-2018 channel.

• Which League Client API are you using?

(1)lol-game-client-chat

• What has prompted the use of this API?

Read summoner names in friend list from client. I can't get friend list from normal Riot Games API.

• How are you planning on using the data you gather from this API?

Download friend list for saving current friend's summoner name. If you transfer your account to other region once and you come back the old region. You can recovery friends from the list. If you have sub account, you can add same friends from the list.

• Why did you create this?

I wanted to download friend list when I transfered my NA account to Japan server 3 years ago. I and my friend wished friend list would have last login date. Then we can remove some non active friends and find new friends. and I wanted to entry to The Riot Games API Challenge 2018.

• I can't find/add friend!

If players change thier name you can't find them by old name.

• Will you add some features to soulve them?

No. I can't use some API, they are unalloewd unfortunity. I can't get that current names and last played date.

Tasks

• Import friend list and get current summoner name (never release. but I created it once. it need unallowed API)
• Get last played date (never release. unallowed API)
• Reduce time to get last played date (very slow. around 5 min for getting 311 friends (.-.))
• Understand Async/Await (I counldn't use Async. So I used IPC for synchronous request loop)
• Get correct last played date (I can't get correct date from lol-carreer-stats. some friend's date is older or null)
• When I close League client, my app can't call API untill restart. lcu-connecter stop() is key I think
• I want to sort friend list by last played date (never release. unallowed API)

Next

Interested in League Voice with discord voice, notification +-LP at end of game every 1 hour for twitch streaming, and mission notification.

Me

Playing Games and Drawing.

I hope that this app'll help other players to create apps using League Client API(LCU) :)

Twitter / League of Legends (JP) ulg / Twitch / pixiv

License

MIT

Ancient Chimes 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 League of Legends. League of Legends and Riot Games are trademarks or registered trademarks of Riot Games, Inc. League of Legends © Riot Games, Inc.