monkaCode/valolytics.md

## valolytics.md

      
    Raw
  

              valolytics.md
            
          
    How to get started with Valolytics

Need help? Join the Discord server: https://discord.com/invite/kgYhPXzvEX
How to create a Valolytics account?


Head over to https://www.valolytics.gg/ and press the Login button at the top right corner.
Then login with your discord account. If you successfully logged in, a pop up message should appear.
Now you can connect your Riot Games account with your Valolytics account at the top right, but you don't have to (if you are a coach or an analyst, you don't need to connect your account)

How to use the Discord bot?

You can invite the Valolytics discord bot to your server with this link: https://discord.com/oauth2/authorize?client_id=942068502645317723&permissions=2147805184&scope=bot%20applications.commands
How to create an team and add other users to it?


Use the /create_team command with a name of the team.
You can invite other discord users to your team with the /invite command. In the user parameter you need to ping the user, or write <@402866282082467851> and replace the id with the discord user id you want to invite.
Now the invited user can accept an invite with /accept_invite. The invited user needs to login first with the discord account on the website too.
If you want to clear up your invites, you can execute the command /reject_invite
With the command /add_riot_accounts you can add the connected Riot Games accounts from the users to your team.
With the command /remove_riot_accounts you can remove a already added Riot Games account from one of your players in the team.
If you want that one user is not anymore part of the team, you can use the command /remove_users to remove him from the team.

How is the workflow to add matches to the database?


You need to execute the command /match_history and select a player and a match mode (Custom Game, Unrated, Competitive, Premier).
Now you will get a list of the recent played matches of the selected player. You need to copy the match id and go to step 3.
With the /match command you can access the match data, when you putting the copied match id to the parameter.
You will see the match data from this match and you have the ability to add this game to the database with a label at the bottom with the green buttons and you can also remove the game from a label with the red button.


What are labels and how can i change them?

Valolytics has a label system where you can differentiate your played matches into different sets of matches. For example you could have one label for Scrims and one for Officials. You can have up to 5 labels. You can add a new label with /add_label, change an existing labels name with /change_label or delete a label with /remove_label. Be careful with the last one, if you remove a label all matches assigned to this label will be deleted.
Discord user permission system

The Valolytics discord bot works with a user permission system, for some critical actions you need a permission for it (for example for adding a match). You can set the permissions for a certain user with the /set_user_permissions command.
Which statistics commands are out there?


The /player_stats let you get the data for a certain player. You can filter the request by the map and the label. Once the command is executed, you will see the stats for all agents, splitted into attack and defense. At the bottom of the response you can filter these stats further with different agents. You will get statistics about different values like ACS, KAST% or Rating for example. Also you will get weapon stats and ability usage stats.


The /team_stats displays statistics about your team. There you will be able to see stats about the round winrates at the pistol, anti-eco and bonus round. Even splitted into quarters. Also you can see stats about the postplants when you filtering with a map. Even further you can see a summary of all player data (like the player_stats command).


The /heatmap will give you a different heatmaps. Currently there are the Player Performance Heatmap and the Plant Win% Heatmap.
The Player Performance Heatmap shows in green from which position the player is more likely to get a kill and in red where he is more likely getting killed.


The Plant Win% Heatmap shows the postplant winrate of a specific plant spot.


more commands are coming in the future...