Nightbot commands

We offer you useful Nightbot commands for your personal Nightbot instance. Our commands give your viewers quick insights into the statistics of all Age of Empires II: Definitive Edition players without having to leave your stream or chat room.
Just configure your commands and copy the codes to add them to your Nightbot. The commands can be used immediately, registration is not required.

`!rank` command

The !rank <username/id> command displays a users rank and his current elo on a specific ladder. It accepts usernames or user ids, if a username is given it searches for users starting with the given username and returns the first one with the highest rank.

It can be used with or without default_user_id. If used with default_user_id the command can also be executed without any argument (!rank), and then displays the rank and elo of the specified user.

Add command to Nightbot:


            

            
                !addcom !{{ bag.rankCommand }} $(urlfetch https://www.aoe2insights.com/nightbot/rank/{{ bag.rankLadder }}/?query=$(querystring)&default_user_id={{ bag.rankDefaultUserId }})

Example output:


            User: !{{ bag.rankCommand }} GL.TheViper

            Nightbot: GL.TheViper (2644, 2769 max) ranks #2 at RM 1v1 with a 69.53% winrate (by aoe2insights.com)

`!streak` command

The !streak <username/id> command displays a users game count, win rate and its current winning streak. It accepts usernames or user ids, if a username is given it searches for users starting with the given username and returns the first one with the highest rank.

It can be used with or without default_user_id. If used with default_user_id the command can also be executed without any parameter (!streak)

Add command to Nightbot:


            

            
                !addcom !{{ bag.streakCommand }} $(urlfetch https://www.aoe2insights.com/nightbot/streak/{{ bag.streakLadder }}/?query=$(querystring)&default_user_id={{ bag.streakDefaultUserId }})

Example output:


            User: !{{ bag.streakCommand }} GL.TheViper

            Nightbot: GL.TheViper played 1387 games with a 65.61% winrate and is on a +5 streak (by aoe2insights.com)

`!leaderboard` command

The !leaderboard command displays the chosen leaderboard in an ascending order. It accepts the ladder of which the leaderboard should be chosen, an optional list of comma separated user_ids to limit the leaderboard to and a limit of returned users.

Configure

Command name

Ladder

User Ids (optional)

(comma separated)

Show rank

Limit (up to 20)

Add command to Nightbot:


            

            
                !addcom !{{ bag.leaderboardCommand }} $(urlfetch https://www.aoe2insights.com/nightbot/leaderboard/{{ bag.leaderboardLadder }}/?user_ids={{ bag.leaderboardUserIds }}&rank={{ bag.leaderboardRank }}&limit={{ bag.leaderboardLimit }})

Example output:


            User: !{{ bag.leaderboardCommand }}

            
                Nightbot: Modri (2640), MbL40C (2589), ___MbL___ (2544), Lucky_zZ (2492), Combi | 7Swords (2381) (by aoe2insights.com)
            
            
                Nightbot: [#12] Modri (2640), [#19] MbL40C (2589), [#28] ___MbL___ (2544), [#37] Lucky_zZ (2492), [#67] Combi | 7Swords (2381) (by aoe2insights.com)
            
            
                Nightbot: [#1] Modri (2640), [#2] MbL40C (2589), [#3] ___MbL___ (2544), [#4] Lucky_zZ (2492), [#5] Combi | 7Swords (2381) (by aoe2insights.com)

AoE2 Insights