At work we use Slack for day-to-day business and shenanigans. We are also a bunch of avid League of Legends players. My idea was to combine the two and add LoL-stats straight in to our #gaming-channel!
- Koa.js - Node API
- Highland.js - Data manipulation
- Docker - Running the service
Three environment variables need to be setup before starting.
LOL_GLOBAL=https://global.api.pvp.net/api/lol/static-data/{region}
LOL_BASE=https://eune.api.pvp.net/api/lol/{region}
RIOT_API_KEY=[YOUR-API-KEY]
$ git clone https://github.com/believer/lol-slack.git
$ cd lol-slack
$ npm install
$ npm start
This starts one POST route at http://localhost:3000/lol. So to test it post a JSON object on the form of for example:
{
"text": "wins <summonerName>"
}
Slack have provided a great way for testing the message formatting right here. Each command also have a direct TRY IT link with a typical message and the response has a URL directly to the Slack formatting. This is how the message will look in the chat, instead of just looking at the JSON that the API reponds with ;)
The service responds to slash commands, i.e. /lol as a message. The available commands are listed below.
- region = eune, euw, na and so on
default: eune - platform = eun1, euw1, na1 and so on
default: eun1
Displays the current champions who are free to play.
Display the help message only to the user who requested the help. (Also responds if provided command does not exist)
%22%2C%22value%22%3A%228%20%2F%201%22%2C%22short%22%3Atrue%7D%5D%7D%5D%7D){kind=link}
Displays statistics from a summoner's latest game.
Displays division and stats for a summoner.
Displays total mastery score of a summoner.
*%22,%22attachments%22:%5B%7B%22mrkdwn_in%22:%5B%22text%22%5D,%22thumb_url%22:%22http://ddragon.leagueoflegends.com/cdn/5.2.1/img/champion/Sivir.png%22,%22title%22:%22Match%20played%20on%202016-04-28%2021:01%22,%22fields%22:%5B%7B%22title%22:%22Lane%22,%22value%22:%22BOTTOM%22,%22short%22:true%7D,%7B%22title%22:%22Role%22,%22value%22:%22DUO_CARRY%22,%22short%22:true%7D,%7B%22title%22:%22Champion%22,%22value%22:%22Sivir%22,%22short%22:true%7D,%7B%22title%22:%22Duration%22,%22value%22:%2222:51%22,%22short%22:true%7D%5D%7D,%7B%22mrkdwn_in%22:%5B%22text%22%5D,%22thumb_url%22:%22http://ddragon.leagueoflegends.com/cdn/5.2.1/img/champion/Ekko.png%22,%22title%22:%22Match%20played%20on%202016-04-28%2020:20%22,%22fields%22:%5B%7B%22title%22:%22Lane%22,%22value%22:%22TOP%22,%22short%22:true%7D,%7B%22title%22:%22Role%22,%22value%22:%22SOLO%22,%22short%22:true%7D,%7B%22title%22:%22Champion%22,%22value%22:%22Ekko%22,%22short%22:true%7D,%7B%22title%22:%22Duration%22,%22value%22:%2230:30%22,%22short%22:true%7D%5D%7D%5D%7D){kind=link}
Displays ranked matches from the last 24 hours.
Displays the current status of the servers in a region.
Displays the teams of a summoner.
%22%2C%22thumb_url%22%3A%22http%3A%2F%2Fddragon.leagueoflegends.com%2Fcdn%2F5.2.1%2Fimg%2Fchampion%2FSivir.png%22%2C%22fields%22%3A%5B%7B%22value%22%3A%22Known%20as%20the%20Battle%20Mistress%2C%20Sivir%20is%20a%20mercenary%20with%20a%20ruthless%20reputation.%20Combining%20unflinching%20bravery%20with%20endless%20ambition%2C%20she%20has%20garnered%20great%20fame%20and%20fortune.%20Faced%20with%20the%20revelation%20of%20her%20mysterious%20heritage%2C%20Sivir%20must%20weigh%20her%20...%22%7D%2C%7B%22title%22%3A%22Highest%20grade%22%2C%22value%22%3A%22S%20%22%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Champion%20points%22%2C%22value%22%3A106602%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Latest%20playtime%22%2C%22value%22%3A%222016-04-28%2021%3A26%22%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Chest%20granted%22%2C%22value%22%3A%22Yes%22%2C%22short%22%3Atrue%7D%5D%7D%2C%7B%22title%22%3A%22Viktor%20-%20the%20Machine%20Herald%20(lvl%205)%22%2C%22thumb_url%22%3A%22http%3A%2F%2Fddragon.leagueoflegends.com%2Fcdn%2F5.2.1%2Fimg%2Fchampion%2FViktor.png%22%2C%22fields%22%3A%5B%7B%22value%22%3A%22Early%20in%20life%2C%20Viktor%20discovered%20his%20passion%20for%20science%20and%20invention%2C%20particularly%20in%20the%20field%20of%20mechanical%20automation.%20He%20attended%20Zaun%27s%20prestigious%20College%20of%20Techmaturgy%20and%20led%20the%20team%20that%20constructed%20Blitzcrank%20-%20a%20scientific%20breakthrough%20...%22%7D%2C%7B%22title%22%3A%22Highest%20grade%22%2C%22value%22%3A%22A%20%22%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Champion%20points%22%2C%22value%22%3A68216%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Latest%20playtime%22%2C%22value%22%3A%222016-04-11%2020%3A46%22%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Chest%20granted%22%2C%22value%22%3A%22No%22%2C%22short%22%3Atrue%7D%5D%7D%2C%7B%22title%22%3A%22Lux%20-%20the%20Lady%20of%20Luminosity%20(lvl%205)%22%2C%22thumb_url%22%3A%22http%3A%2F%2Fddragon.leagueoflegends.com%2Fcdn%2F5.2.1%2Fimg%2Fchampion%2FLux.png%22%2C%22fields%22%3A%5B%7B%22value%22%3A%22Born%20to%20the%20prestigious%20Crownguards%2C%20the%20paragon%20family%20of%20Demacian%20service%2C%20Luxanna%20was%20destined%20for%20greatness.%20She%20grew%20up%20as%20the%20family%27s%20only%20daughter%2C%20and%20she%20immediately%20took%20to%20the%20advanced%20education%20and%20lavish%20parties%20required%20of%20families%20as%20...%22%7D%2C%7B%22title%22%3A%22Highest%20grade%22%2C%22value%22%3A%22S%22%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Champion%20points%22%2C%22value%22%3A60567%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Latest%20playtime%22%2C%22value%22%3A%222016-04-15%2020%3A03%22%2C%22short%22%3Atrue%7D%2C%7B%22title%22%3A%22Chest%20granted%22%2C%22value%22%3A%22Yes%22%2C%22short%22%3Atrue%7D%5D%7D%5D%7D){kind=link}
Displays the top three champions for a given summoner name.
Display the number of wins of a summoner.
