node-dota2
========


A node-steam plugin for Dota 2, consider it in alpha state.

Check out RJackson1's blog post (his only blog post), Extending node-dota2, for a rough overview of adding new functionality to the library.
A fair warning, while the way you search for new functionality is still the same, quite a lot has changed (and been simplified) implementation wise.
It is now easier to implement new functionality than it was back when this blog was written.

Installation and setup

* npm install in the repository root
* Copy config.js.example to config.js and edit appropriately
* Run the example script: node example.js
* If you receive Error 63 you need to provide a Steam Guard code by setting the Steam Guard code in config.js and launching again.
* Make sure to use at least version 4.4.5 of node js

Initializing

Parameters:
* steamClient - Pass a SteamClient instance to use to send & receive GC messages.
* debug - A boolean noting whether to print information about operations to console.
* debugMore - A boolean noting whether to print extended debug information. Activating this will log messages for each proto message exchanged with the GC.

``js
var Steam = require('steam'),
steamClient = new Steam.SteamClient(),
dota2 = require('dota2'),
Dota2 = new dota2.Dota2Client(steamClient, true, false);
`

Disclaimer

We do not in any way encourage people to use their own accounts when using this library.
This library tries to mimic the behavior of the Dota 2 client to allow people to programmatically interact with the Dota 2 GC,
however we make no efforts to hide this fact and it's pretty easy for Valve to detect clients using this library based on the generated traffic.
While Valve has not yet expressed a dislike regarding reverse engineering projects like this one,
it's not unimaginable that this might one day change and result in VAC bans.

Examples

The examples directory contains two Dota2 bots as an example. One contains commented-out dota2 methods, the other has boolean activated methods.
Both examples show how to interact with the library.

Testing

There is a partial automated test suite for node-dota2, which is located in the test directory.
You need to configure the STEAM_USERNAME and STEAM_PASSWORD environment variables to be able to run it.
You can launch the tests by running the file with mocha.

API

The API doc can be consulted here or at doclets.io

Dota2

Dota 2 module

* Dota2
* _static_
* .Dota2Client ⇐ EventEmitter
* new Dota2.Dota2Client(steamClient, debug, debugMore)
* _instance_
* .Inventory : Array.<CSOEconItem>
* .chatChannels : Array.<CMsgDOTAJoinChatChannelResponse>
* .Lobby : CSODOTALobby
* .Options : Object
* .LobbyInvite : CSODOTALobbyInvite
* .Party : CSODOTAParty
* .PartyInvite : CSODOTAPartyInvite
* .launch()
* .exit()
* [.joinChat(channel_name, [channel_type])](#module_Dota2.Dota2Client+joinChat)
* [.leaveChat(channel_name, [channel_type])](#module_Dota2.Dota2Client+leaveChat)
* [.sendMessage(message, channel_name, [channel_type])](#module_Dota2.Dota2Client+sendMessage)
* [.shareLobby(channel_name, [channel_type])](#module_Dota2.Dota2Client+shareLobby)
* [.flipCoin(channel_name, [channel_type])](#module_Dota2.Dota2Client+flipCoin)
* [.rollDice(min, max, channel_name, [channel_type])](#module_Dota2.Dota2Client+rollDice)
* .requestChatChannels()
* [.requestPlayerMatchHistory(account_id, [options], [callback])](#module_Dota2.Dota2Client+requestPlayerMatchHistory)
* [.requestProfileCard(account_id, [callback])](#module_Dota2.Dota2Client+requestProfileCard)
* [.requestHallOfFame(week, [callback])](#module_Dota2.Dota2Client+requestHallOfFame)
* .requestPlayerInfo(account_ids)
* [.requestTrophyList(account_id, [callback])](#module_Dota2.Dota2Client+requestTrophyList)
* [.requestPlayerStats(account_id, [callback])](#module_Dota2.Dota2Client+requestPlayerStats)
* [.requestJoinableCustomGameModes([server_region])](#module_Dota2.Dota2Client+requestJoinableCustomGameModes)
* .requestPlayerCardsByPlayer() ⇒ Array.<FantasyPlayer>
* .FantasyPlayer : Object
* [.requestPlayerCardRoster(league_id, timestamp, [callback])](#module_Dota2.Dota2Client+requestPlayerCardRoster)
* [.draftPlayerCard(league_id, timestamp, slot, player_card_id, [callback])](#module_Dota2.Dota2Client+draftPlayerCard)
* .setItemPositions(item_positions)
* .deleteItem(item_id)
* [.requestLeaguesInMonth([month], [year], [tier], [callback])](#module_Dota2.Dota2Client+requestLeaguesInMonth)
* .requestLeagueInfo()
* .requestTopLeagueMatches()
* [.createPracticeLobby(options, [callback])](#module_Dota2.Dota2Client+createPracticeLobby)
* ~~._createPracticeLobby()~~
* ~~.createTournamentLobby()~~
* [.configPracticeLobby(lobby_id, options, [callback])](#module_Dota2.Dota2Client+configPracticeLobby)
* [.requestPracticeLobbyList([callback])](#module_Dota2.Dota2Client+requestPracticeLobbyList)
* [.requestFriendPracticeLobbyList([callback])](#module_Dota2.Dota2Client+requestFriendPracticeLobbyList)
* [.balancedShuffleLobby([callback])](#module_Dota2.Dota2Client+balancedShuffleLobby)
* [.flipLobbyTeams([callback])](#module_Dota2.Dota2Client+flipLobbyTeams)
* .inviteToLobby(steam_id)
* [.practiceLobbyKick(account_id, [callback])](#module_Dota2.Dota2Client+practiceLobbyKick)
* [.practiceLobbyKickFromTeam(account_id, [callback])](#module_Dota2.Dota2Client+practiceLobbyKickFromTeam)
* [.joinPracticeLobby(id, password, [callback])](#module_Dota2.Dota2Client+joinPracticeLobby)
* [.leavePracticeLobby([callback])](#module_Dota2.Dota2Client+leavePracticeLobby)
* [.abandonCurrentGame([callback])](#module_Dota2.Dota2Client+abandonCurrentGame)
* [.launchPracticeLobby([callback])](#module_Dota2.Dota2Client+launchPracticeLobby)
* [.joinPracticeLobbyTeam(slot, team, [callback])](#module_Dota2.Dota2Client+joinPracticeLobbyTeam)
* [.joinPracticeLobbyBroadcastChannel([channel], [callback])](#module_Dota2.Dota2Client+joinPracticeLobbyBroadcastChannel)
* [.addBotToPracticeLobby(slot, team, bot_difficulty, [callback])](#module_Dota2.Dota2Client+addBotToPracticeLobby)
* .respondLobbyInvite(id, accept)
* [.requestMatches([criteria], [callback])](#module_Dota2.Dota2Client+requestMatches)
* [.requestMatchDetails(match_ids, [callback])](#module_Dota2.Dota2Client+requestMatchDetails)
* [.requestMatchMinimalDetails(match_id, [callback])](#module_Dota2.Dota2Client+requestMatchMinimalDetails)
* .requestMatchmakingStats()
* .requestTopFriendMatches()
* [.respondPartyInvite(id, [accept], [ping_data])](#module_Dota2.Dota2Client+respondPartyInvite)
* .leaveParty()
* .setPartyLeader(steam_id)
* .setPartyCoach(coach)
* .inviteToParty(steam_id)
* .kickFromParty(steam_id)
* .requestSourceTVGames(filter_options)
* [.requestMyTeams([callback])](#module_Dota2.Dota2Client+requestMyTeams)
* "ready"
* "unhandled" (kMsg, kMsg_name)
* "hellotimeout"
* "inventoryUpdate" (inventory)
* "practiceLobbyUpdate" (lobby)
* "practiceLobbyCleared"
* "lobbyInviteUpdate" (lobbyInvite)
* "lobbyInviteCleared"
* "partyUpdate" (party)
* "partyCleared"
* "partyInviteUpdate" (partyInvite)
* "partyInviteCleared"
* "chatJoined" (channelData)
* "chatJoin" (channel, joiner_name, joiner_steam_id, otherJoined_object)
* "chatLeave" (channel, leaver_steam_id, otherLeft_object)
* "chatMessage" (channel, sender_name, message, chatData)
* "chatChannelsData" (channels)
* "playerMatchHistoryData" (requestId, matchHistoryResponse)
* "profileCardData" (account_id, profileCardResponse)
* "hallOfFameData" (week, featured_players, featured_farmer, hallOfFameResponse)
* "playerInfoData" (playerInfoData)
* "trophyListData" (trophyListResponse)
* "playerStatsData" (account_id, playerStatsResponse)
* "joinableCustomGameModes" (joinableCustomGameModes)
* "playerCardRoster" (playerCardRoster)
* "playerCardDrafted" (playerCardRoster)
* "popup" (id, popup)
* "leaguesInMonthData" (month, year, leagues)
* "liveLeagueGamesUpdate" (live_league_games)
* "leagueData" (leagues)
* "topLeagueMatchesData" (matches)
* "practiceLobbyJoinResponse" (result, response)
* "practiceLobbyListData" (practiceLobbyListResponse)
* "practiceLobbyResponse" (result, response)
* "friendPracticeLobbyListData" (practiceLobbyListResponse)
* "inviteCreated" (steam_id, group_id, is_online)
* "matchesData" (requestId, total_results, results_remaining, matches, series, matchResponse)
* "matchDetailsData" (match_id, matchDetailsResponse)
* "matchMinimalDetailsData" (last_match, matchMinimalDetailsResponse)
* "matchmakingStatsData" (matchgroups_version, match_groups, matchmakingStatsResponse)
* "topFriendMatchesData" (matches)
* "sourceTVGamesData" (sourceTVGamesResponse)
* "teamData" (teams, league_id)
* _static_
* .ToAccountID(steamID) ⇒ number
* .ToSteamID(accid) ⇒ Long
* .schema
* .CMsgGCToClientPlayerStatsResponse : Object
* .EResult : enum
* .ServerRegion : enum
* .SeriesType : enum
* .BotDifficulty : enum
* _inner_
* ~requestCallback : function
* ~Long

$3

Kind: static class of Dota2
Extends: EventEmitter
Emits: ready, unhandled, hellotimeout, popup, sourceTVGamesData, inventoryUpdate, practiceLobbyUpdate, practiceLobbyCleared, lobbyInviteUpdate, lobbyInviteCleared, practiceLobbyJoinResponse, practiceLobbyListData, practiceLobbyResponse, friendPracticeLobbyListData, inviteCreated, partyUpdate, partyCleared, partyInviteUpdate, partyInviteCleared, joinableCustomGameModes, chatChannelsData, chatJoin, chatJoined, chatLeave, chatMessage, profileCardData, playerMatchHistoryData, playerInfoData, playerStatsData, trophyListData, hallOfFameData, playerCardRoster, playerCardDrafted, leaguesInMonthData, liveLeagueGamesUpdate, leagueData, topLeagueMatchesData, teamData, matchesData, matchDetailsData, matchMinimalDetailsData, matchmakingStatsData, topFriendMatchesData

* .Dota2Client ⇐ EventEmitter
* new Dota2.Dota2Client(steamClient, debug, debugMore)
* _instance_
* .Inventory : Array.<CSOEconItem>
* .chatChannels : Array.<CMsgDOTAJoinChatChannelResponse>
* .Lobby : CSODOTALobby
* .Options : Object
* .LobbyInvite : CSODOTALobbyInvite
* .Party : CSODOTAParty
* .PartyInvite : CSODOTAPartyInvite
* .launch()
* .exit()
* [.joinChat(channel_name, [channel_type])](#module_Dota2.Dota2Client+joinChat)
* [.leaveChat(channel_name, [channel_type])](#module_Dota2.Dota2Client+leaveChat)
* [.sendMessage(message, channel_name, [channel_type])](#module_Dota2.Dota2Client+sendMessage)
* [.shareLobby(channel_name, [channel_type])](#module_Dota2.Dota2Client+shareLobby)
* [.flipCoin(channel_name, [channel_type])](#module_Dota2.Dota2Client+flipCoin)
* [.rollDice(min, max, channel_name, [channel_type])](#module_Dota2.Dota2Client+rollDice)
* .requestChatChannels()
* [.requestPlayerMatchHistory(account_id, [options], [callback])](#module_Dota2.Dota2Client+requestPlayerMatchHistory)
* [.requestProfileCard(account_id, [callback])](#module_Dota2.Dota2Client+requestProfileCard)
* [.requestHallOfFame(week, [callback])](#module_Dota2.Dota2Client+requestHallOfFame)
* .requestPlayerInfo(account_ids)
* [.requestTrophyList(account_id, [callback])](#module_Dota2.Dota2Client+requestTrophyList)
* [.requestPlayerStats(account_id, [callback])](#module_Dota2.Dota2Client+requestPlayerStats)
* [.requestJoinableCustomGameModes([server_region])](#module_Dota2.Dota2Client+requestJoinableCustomGameModes)
* .requestPlayerCardsByPlayer() ⇒ Array.<FantasyPlayer>
* .FantasyPlayer : Object
* [.requestPlayerCardRoster(league_id, timestamp, [callback])](#module_Dota2.Dota2Client+requestPlayerCardRoster)
* [.draftPlayerCard(league_id, timestamp, slot, player_card_id, [callback])](#module_Dota2.Dota2Client+draftPlayerCard)
* .setItemPositions(item_positions)
* .deleteItem(item_id)
* [.requestLeaguesInMonth([month], [year], [tier], [callback])](#module_Dota2.Dota2Client+requestLeaguesInMonth)
* .requestLeagueInfo()
* .requestTopLeagueMatches()
* [.createPracticeLobby(options, [callback])](#module_Dota2.Dota2Client+createPracticeLobby)
* ~~._createPracticeLobby()~~
* ~~.createTournamentLobby()~~
* [.configPracticeLobby(lobby_id, options, [callback])](#module_Dota2.Dota2Client+configPracticeLobby)
* [.requestPracticeLobbyList([callback])](#module_Dota2.Dota2Client+requestPracticeLobbyList)
* [.requestFriendPracticeLobbyList([callback])](#module_Dota2.Dota2Client+requestFriendPracticeLobbyList)
* [.balancedShuffleLobby([callback])](#module_Dota2.Dota2Client+balancedShuffleLobby)
* [.flipLobbyTeams([callback])](#module_Dota2.Dota2Client+flipLobbyTeams)
* .inviteToLobby(steam_id)
* [.practiceLobbyKick(account_id, [callback])](#module_Dota2.Dota2Client+practiceLobbyKick)
* [.practiceLobbyKickFromTeam(account_id, [callback])](#module_Dota2.Dota2Client+practiceLobbyKickFromTeam)
* [.joinPracticeLobby(id, password, [callback])](#module_Dota2.Dota2Client+joinPracticeLobby)
* [.leavePracticeLobby([callback])](#module_Dota2.Dota2Client+leavePracticeLobby)
* [.abandonCurrentGame([callback])](#module_Dota2.Dota2Client+abandonCurrentGame)
* [.launchPracticeLobby([callback])](#module_Dota2.Dota2Client+launchPracticeLobby)
* [.joinPracticeLobbyTeam(slot, team, [callback])](#module_Dota2.Dota2Client+joinPracticeLobbyTeam)
* [.joinPracticeLobbyBroadcastChannel([channel], [callback])](#module_Dota2.Dota2Client+joinPracticeLobbyBroadcastChannel)
* [.addBotToPracticeLobby(slot, team, bot_difficulty, [callback])](#module_Dota2.Dota2Client+addBotToPracticeLobby)
* .respondLobbyInvite(id, accept)
* [.requestMatches([criteria], [callback])](#module_Dota2.Dota2Client+requestMatches)
* [.requestMatchDetails(match_ids, [callback])](#module_Dota2.Dota2Client+requestMatchDetails)
* [.requestMatchMinimalDetails(match_id, [callback])](#module_Dota2.Dota2Client+requestMatchMinimalDetails)
* .requestMatchmakingStats()
* .requestTopFriendMatches()
* [.respondPartyInvite(id, [accept], [ping_data])](#module_Dota2.Dota2Client+respondPartyInvite)
* .leaveParty()
* .setPartyLeader(steam_id)
* .setPartyCoach(coach)
* .inviteToParty(steam_id)
* .kickFromParty(steam_id)
* .requestSourceTVGames(filter_options)
* [.requestMyTeams([callback])](#module_Dota2.Dota2Client+requestMyTeams)
* "ready"
* "unhandled" (kMsg, kMsg_name)
* "hellotimeout"
* "inventoryUpdate" (inventory)
* "practiceLobbyUpdate" (lobby)
* "practiceLobbyCleared"
* "lobbyInviteUpdate" (lobbyInvite)
* "lobbyInviteCleared"
* "partyUpdate" (party)
* "partyCleared"
* "partyInviteUpdate" (partyInvite)
* "partyInviteCleared"
* "chatJoined" (channelData)
* "chatJoin" (channel, joiner_name, joiner_steam_id, otherJoined_object)
* "chatLeave" (channel, leaver_steam_id, otherLeft_object)
* "chatMessage" (channel, sender_name, message, chatData)
* "chatChannelsData" (channels)
* "playerMatchHistoryData" (requestId, matchHistoryResponse)
* "profileCardData" (account_id, profileCardResponse)
* "hallOfFameData" (week, featured_players, featured_farmer, hallOfFameResponse)
* "playerInfoData" (playerInfoData)
* "trophyListData" (trophyListResponse)
* "playerStatsData" (account_id, playerStatsResponse)
* "joinableCustomGameModes" (joinableCustomGameModes)
* "playerCardRoster" (playerCardRoster)
* "playerCardDrafted" (playerCardRoster)
* "popup" (id, popup)
* "leaguesInMonthData" (month, year, leagues)
* "liveLeagueGamesUpdate" (live_league_games)
* "leagueData" (leagues)
* "topLeagueMatchesData" (matches)
* "practiceLobbyJoinResponse" (result, response)
* "practiceLobbyListData" (practiceLobbyListResponse)
* "practiceLobbyResponse" (result, response)
* "friendPracticeLobbyListData" (practiceLobbyListResponse)
* "inviteCreated" (steam_id, group_id, is_online)
* "matchesData" (requestId, total_results, results_remaining, matches, series, matchResponse)
* "matchDetailsData" (match_id, matchDetailsResponse)
* "matchMinimalDetailsData" (last_match, matchMinimalDetailsResponse)
* "matchmakingStatsData" (matchgroups_version, match_groups, matchmakingStatsResponse)
* "topFriendMatchesData" (matches)
* "sourceTVGamesData" (sourceTVGamesResponse)
* "teamData" (teams, league_id)
* _static_
* .ToAccountID(steamID) ⇒ number
* .ToSteamID(accid) ⇒ Long

#### new Dota2.Dota2Client(steamClient, debug, debugMore)
The Dota 2 client that communicates with the GC

| Param | Type | Description |
| --- | --- | --- |
| steamClient | Object | Node-steam client instance |
| debug | boolean | Print debug information to console |
| debugMore | boolean | Print even more debug information to console |

#### dota2Client.Inventory : Array.<CSOEconItem>
The current state of the bot's inventory. Contains cosmetics, player cards, ...

Kind: instance property of Dota2Client

#### dota2Client.chatChannels : Array.<CMsgDOTAJoinChatChannelResponse>
The chat channels the bot has joined

Kind: instance property of Dota2Client

#### dota2Client.Lobby : CSODOTALobby
The lobby the bot is currently in. Falsy if the bot isn't in a lobby.

Kind: instance property of Dota2Client

##### Lobby.Options : Object
Kind: static typedef of Lobby
Properties

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| game_name | string | | Name of the lobby |
| pass_key | string | | Lobby password |
| server_region | ServerRegion | module:Dota2.ServerRegion.UNSPECIFIED | Server region where the lobby will be created |
| game_mode | DOTA_GameMode | DOTA_GameMode.DOTA_GAMEMODE_AP | Game mode |
| game_version | DOTAGameVersion | DOTAGameVersion.GAME_VERSION_STABLE | Version of the game |
| cm_pick | DOTA_CM_PICK | DOTA_CM_PICK.DOTA_CM_RANDOM | Who gets first pick |
| allow_cheats | boolean | false | Whether or not to allow cheats |
| fill_with_bots | boolean | false | Whether or not to fill empty slots with bots |
| bot_difficulty_radiant | BotDifficulty | PASSIVE | The bot difficulty for radiant bots, if fill_with_bots is true. |
| bot_difficulty_dire | BotDifficulty | PASSIVE | The bot difficulty for dire bots, if fill_with_bots is true. |
| bot_radiant | number | | Presumably the ID of the custom AI to be applied to radiant bots. |
| bot_dire | number | | Presumably the ID of the custom AI to be applied to dire bots. |
| allow_spectating | boolean | true | Whether or not to allow spectating |
| series_type | SeriesType | NONE | Whether or not the game is part of a series (Bo3, Bo5). |
| radiant_series_wins | number | 0 | # of games won so far, e.g. for a Bo3 or Bo5. |
| dire_series_wins | number | 0 | # of games won so far, e.g. for a Bo3 or Bo5. |
| previous_match_override | number | | In a series, the match ID of the previous game. If not supplied, the GC will try to find it automatically based on the teams and the players. |
| allchat | boolean | false | Whether or not it's allowed to all-chat |
| dota_tv_delay | LobbyDotaTVDelay | LobbyDotaTV_120 | How much time the game should be delayed for DotaTV. |
| leagueid | number | | The league this lobby is being created for. The bot should be a league admin for this to work. |
| custom_game_mode | string | | Name of the custom game |
| custom_map_name | string | | Which map the custom game should be played on |
| custom_difficulty | number | | Difficulty of the custom game |
| custom_game_id | Long | | 64bit ID of the custom game mode |

#### dota2Client.LobbyInvite : CSODOTALobbyInvite
The currently active lobby invitation. Falsy if the bot has not been invited.

Kind: instance property of Dota2Client

#### dota2Client.Party : CSODOTAParty
The party the bot is currently in. Falsy if the bot isn't in a party.

Kind: instance property of Dota2Client

#### dota2Client.PartyInvite : CSODOTAPartyInvite
The currently active party invitation. Falsy if the bot has not been invited.

Kind: instance property of Dota2Client

#### dota2Client.launch()
Reports to Steam that you're playing Dota 2, and then initiates communication with the Game Coordinator.

Kind: instance method of Dota2Client

#### dota2Client.exit()
Stop sending a heartbeat to the GC and report to steam you're no longer playing Dota 2

Kind: instance method of Dota2Client

#### dota2Client.joinChat(channel_name, [channel_type])
Joins a chat channel. If the chat channel with the given name doesn't exist, it
is created. Listen for the chatMessage event for other people's chat messages.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Default | Description |
| --- | --- | --- | --- |
| channel_name | string | | Name of the chat channel |
| [channel_type] | DOTAChatChannelType_t | DOTAChatChannelType_t.DOTAChatChannelType_Custom | The type of the channel being joined |

#### dota2Client.leaveChat(channel_name, [channel_type])
Leaves a chat channel. If you've joined different channels with the same name,
specify the type to prevent unexpected behaviour.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| channel_name | string | Name of the chat channel |
| [channel_type] | DOTAChatChannelType_t | The type of the channel being joined |

#### dota2Client.sendMessage(message, channel_name, [channel_type])
Sends a message to the specified chat channel. Won't send if you're not in the channel you try to send to.
If you've joined different channels with the same name, specify the type to prevent unexpected behaviour.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| message | string | The message you want to send |
| channel_name | string | Name of the chat channel |
| [channel_type] | DOTAChatChannelType_t | The type of the channel being joined |

#### dota2Client.shareLobby(channel_name, [channel_type])
Shares the lobby you're currently in with the chat so other people can join.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| channel_name | string | Name of the chat channel |
| [channel_type] | DOTAChatChannelType_t | The type of the channel being joined |

#### dota2Client.flipCoin(channel_name, [channel_type])
Sends a coin flip to the specified chat channel. Won't send if you're not in the channel you try to send to.
If you've joined different channels with the same name, specify the type to prevent unexpected behaviour.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| channel_name | string | Name of the chat channel |
| [channel_type] | DOTAChatChannelType_t | The type of the channel being joined |

#### dota2Client.rollDice(min, max, channel_name, [channel_type])
Sends a dice roll to the specified chat channel. Won't send if you're not in the channel you try to send to.
If you've joined different channels with the same name, specify the type to prevent unexpected behaviour.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| min | number | Lower bound of the dice roll |
| max | number | Upper bound of the dice roll |
| channel_name | string | Name of the chat channel |
| [channel_type] | DOTAChatChannelType_t | The type of the channel being joined |

#### dota2Client.requestChatChannels()
Requests a list of chat channels from the GC. Listen for the chatChannelsData event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client


#### dota2Client.requestPlayerMatchHistory(account_id, [options], [callback])
Requests the given player's match history. The responses are paginated,
but you can use the start_at_match_id and matches_requested options to loop through them.
Provide a callback or listen for the playerMatchHistoryData event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Default | Description |
| --- | --- | --- | --- |
| account_id | number | | Dota 2 account ID of the player whose match history the bot should fetch |
| [options] | Object | | Filtering options |
| [options.start_at_match_id] | number | | Which match ID to start searching at (pagination) |
| [options.matches_requested] | number | | How many matches to retrieve |
| [options.hero_id] | number | | Show only matches where player played the given hero |
| [options.request_id] | number | account_id | A unique identifier that identifies this request |
| [options.include_practice_matches] | boolean | | Whether or not to include practice matches in the results |
| [options.include_custom_games] | boolean | | Whether or not to include custom games in the results |
| [callback] | requestCallback | | Called with err, CMsgDOTAGetPlayerMatchHistoryResponse |

#### dota2Client.requestProfileCard(account_id, [callback])
Sends a message to the Game Coordinator requesting account_id's profile card.
This method is heavily rate limited. When abused, the GC just stops responding.
Even the regular client runs into this limit when you check too many profiles.
Provide a callback or listen for profileCardData event for Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| account_id | number | Dota 2 account ID of the player whose profile card the bot should fetch |
| [callback] | requestCallback | Called with err, CMsgDOTAProfileCard |

#### dota2Client.requestHallOfFame(week, [callback])
Sends a message to the Game Coordinator requesting the Hall of Fame data for week.
Provide a callback or listen for the hallOfFameData event for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| week | number | The week of which you wish to know the Hall of Fame members; will return latest week if omitted. Weeks are counted from start of unix epoch with a lower bound of 2233 (2012-10-18) |
| [callback] | requestCallback | Called with err, CMsgDOTAHallOfFameResponse |

#### dota2Client.requestPlayerInfo(account_ids)
Sends a message to the Game Coordinator requesting one or multiple account_ids player information.
This includes their display name, country code, team info and sponsor, fantasy role, official information lock status, and if the user is marked as a pro player.
Listen for the playerInfoData event for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| account_ids | number | Array.<number> | Either a single or array of Account IDs (lower 32-bits of a 64-bit Steam ID) of desired user(s) player info. |

#### dota2Client.requestTrophyList(account_id, [callback])
Sends a message to the Game Coordinator requesting account_id's trophy data.
Provide a callback or listen for trophyListData event for Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| account_id | number | Dota 2 account ID of the player whose trophy data the bot should fetch |
| [callback] | requestCallback | Called with err, CMsgClientToGCGetTrophyListResponse |

#### dota2Client.requestPlayerStats(account_id, [callback])
Sends a message to the Game Coordinator requesting account_id's player stats.
Provide a callback or listen for playerStatsData event for Game Coordinator's response.
This data contains all stats shown on a player's profile page.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| account_id | number | Dota 2 account ID of the player whose player stats the bot should fetch |
| [callback] | requestCallback | Called with err, CMsgGCToClientPlayerStatsResponse |

#### dota2Client.requestJoinableCustomGameModes([server_region])
Requests a list of custom game modes for which there are currently lobbies available.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Default | Description |
| --- | --- | --- | --- |
| [server_region] | ServerRegion | ServerRegion.UNSPECIFIED | The server region for which you'd like to obtain the joinable custom game modes |

#### dota2Client.requestPlayerCardsByPlayer() ⇒ Array.<FantasyPlayer>
Requests the player stats for each of the players for which you have one or multiple player cards.
All requests are staggered in 200ms intervals and time out after 2s.
Requires the GC to be ready.

Kind: instance method of Dota2Client
Async: Returns a list of promises that resolve to FantasyPlayer objects


##### requestPlayerCardsByPlayer.FantasyPlayer : Object
Player with player cards

Kind: static typedef of requestPlayerCardsByPlayer
Properties

| Name | Type | Description |
| --- | --- | --- |
| account_id | number | Dota2 account ID of the player |
| cards | Array.<Object> | Player cards of this player in the bot's inventory |
| cards[].id | number | ID of the card |
| cards[].bonuses | Long | 64bit bitmask for the bonuses of this card |
| stats | CMsgGCToClientPlayerStatsResponse | Player stats |

#### dota2Client.requestPlayerCardRoster(league_id, timestamp, [callback])
Sends a message to the Game Coordinator requesting your fantasy line-up for a specific day of a given tournament.
Provide a callback or listen for the playerCardRoster event for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| league_id | number | ID of the league |
| timestamp | number | Date in timeframe of the league |
| [callback] | requestCallback | Called with err, CMsgClientToGCGetPlayerCardRosterResponse |

#### dota2Client.draftPlayerCard(league_id, timestamp, slot, player_card_id, [callback])
Sends a message to the Game Coordinator requesting to draft a certain player card in a specific slot, for a given day in a tournament.
Provide a callback or listen for the playerCardDrafted event for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| league_id | number | ID of the league for which you're drafting a player card |
| timestamp | number | Timestamp of the day for which you want to draft a player card |
| slot | number | Slot in the draft which you want to fill |
| player_card_id | number | Item ID of the player card you want to draft |
| [callback] | requestCallback | Called with err, CMsgClientToGCSetPlayerCardRosterResponse |

#### dota2Client.setItemPositions(item_positions)
Attempts to change the position of one or more items in your inventory.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| item_positions | Array.<Object> | The new positions of the items |
| item_positions[].item_id | number | ID of the item |
| item_positions[].position | number | New position of the item |

#### dota2Client.deleteItem(item_id)
Attempts to delete an item in your inventory.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| item_id | number | ID of the item |

#### dota2Client.requestLeaguesInMonth([month], [year], [tier], [callback])
Sends a message to the Game Coordinator requesting data on leagues being played in the given month.
Provide a callback or listen for leaguesInMonthData for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Default | Description |
| --- | --- | --- | --- |
| [month] | number | (new Date()).getMonth() | Month (MM) you want to query data for. IMPORTANT NOTE: Month is zero-aligned, not one-aligned; so Jan = 00, Feb = 01, etc. |
| [year] | number | (new Date()).getFullYear() | Year (YYYY) you want to query data for. |
| [tier] | number | 0 | Search only for a specific tier of tournaments. |
| [callback] | requestCallback | | Called with err, CMsgDOTALeaguesInMonthResponse |

#### dota2Client.requestLeagueInfo()
Requests info on all available official leagues from the GC.
Listen for the leagueData event for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client


#### dota2Client.requestTopLeagueMatches()
Sends a message to the Game Coordinator requesting the top league matches.
Listen for the topLeagueMatchesData event for the Game Coordinator's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client


#### dota2Client.createPracticeLobby(options, [callback])
Sends a message to the Game Coordinator requesting to create a lobby.
This will automatically make the bot join the first slot on radiant team. Listen for
practiceLobbyUpdate response for a
snapshot-update of the newly created lobby.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| options | Options | Configuration options for the lobby |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### ~~dota2Client._createPracticeLobby()~~
Deprecated

Kind: instance method of Dota2Client


#### ~~dota2Client.createTournamentLobby()~~
Deprecated

Kind: instance method of Dota2Client


#### dota2Client.configPracticeLobby(lobby_id, options, [callback])
Sends a message to the Game Coordinator requesting to configure some options of the active lobby.
Listen for practiceLobbyUpdate response
for a snapshot-update of the newly created lobby.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| lobby_id | Long | ID of the lobby |
| options | Options | The new option values |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.requestPracticeLobbyList([callback])
Requests a lists of joinable practice lobbies.
Provide a callback or listen for the practiceLobbyListData event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyListResponse |

#### dota2Client.requestFriendPracticeLobbyList([callback])
Requests a lists of joinable practice lobbies which have one of your friends in them.
Provide a callback or listen for the friendPracticeLobbyListData event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgFriendPracticeLobbyListResponse |

#### dota2Client.balancedShuffleLobby([callback])
Shuffles the lobby based on skill level. Requires you to be in a lobby and to be the host.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.flipLobbyTeams([callback])
Flips the radiant and dire team players. Requires you to be in a lobby and to be the host.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.inviteToLobby(steam_id)
Asks to invite a player to your lobby. This creates a new default lobby when you are not already in one.
Listen for the inviteCreated event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| steam_id | Long | The Steam ID of the player you want to invite. |

#### dota2Client.practiceLobbyKick(account_id, [callback])
Asks to kick someone from your current practice lobby. Requires you to be in a lobby and to be the host.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| account_id | number | The Dota2 account ID of the player you want to kick. |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.practiceLobbyKickFromTeam(account_id, [callback])
Asks to kick someone from his chosen team in your current practice lobby.
The player will be added to the player pool
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| account_id | number | The Dota2 account ID of the player you want to kick from his team. |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.joinPracticeLobby(id, password, [callback])
Sends a message to the Game Coordinator requesting to join a lobby.
Provide a callback or listen for the practiceLobbyJoinResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| id | externalLong | The ID of the lobby |
| password | number | The password of the lobby |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.leavePracticeLobby([callback])
Sends a message to the Game Coordinator requesting to leave the current lobby.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.abandonCurrentGame([callback])
Abandons the current game.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.launchPracticeLobby([callback])
Start the practice lobby. The bot will continue to receive lobby updates, but won't join the actual game.
Requires you to be in a lobby and to be the host.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.joinPracticeLobbyTeam(slot, team, [callback])
Sends a message to the Game Coordinator requesting to join a particular team in the lobby.
Requires you to be in a lobby.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Description |
| --- | --- | --- |
| slot | number | The slot you want to join |
| team | number | The team you want to join |
| [callback] | requestCallback | Called with err, CMsgPracticeLobbyJoinResponse |

#### dota2Client.joinPracticeLobbyBroadcastChannel([channel], [callback])
Sends a message to the Game Coordinator requesting to add a bot to the broadcast channel.
Requires you to be in a lobby.
Provide a callback or listen for the practiceLobbyResponse event for the GC's response.
Requires the GC to be ready.

Kind: instance method of Dota2Client

| Param | Type | Default | Description |
| --- | --- | --- | --- |
| [channel] | number | 1 | The channel slot you want to fill |
| [callback] | requestCallback | | Called with err, CMsgPracticeLobbyJoinResponse` |

#### dota2Client.addBotToPracticeLobby(slot, team, bot_difficulty, [callback])
Sends a message to the Game Coordinator requesting to add a bot to the given team in t