• Log InLog In
  • Register
Liquid`
Team Liquid Liquipedia
EDT 12:52
CEST 18:52
KST 01:52
  • Home
  • Forum
  • Calendar
  • Streams
  • Liquipedia
  • Features
  • Store
  • EPT
  • TL+
  • StarCraft 2
  • Brood War
  • Smash
  • Heroes
  • Counter-Strike
  • Overwatch
  • Liquibet
  • Fantasy StarCraft
  • TLPD
  • StarCraft 2
  • Brood War
  • Blogs
Forum Sidebar
Events/Features
News
Featured News
Serral wins Maestros of the Game 210ByuL, and the Limitations of Standard Play3Team Liquid Map Contest #22: Results and Winners7Code S Season 2 (2026): RO4 and Finals Preview12TL.net Map Contest #22 - Voting & Ladder Map Selection7
Community News
MC vs IdrA, Boxer vs Nal_rA to be Legacy Matches @ BlizzCon315.0.16 Hotfix (June 30) - Balance + Bug Fixes35Weekly Cups (June 22-28): Zergs thrive in new patch4[TLMC] Summer 2026 Ladder Map Rotation05.0.16 patch for SC2 goes live (8 worker start)99
StarCraft 2
General
Serral wins Maestros of the Game 2 Weekly Cups (June 22-28): Zergs thrive in new patch MC vs IdrA, Boxer vs Nal_rA to be Legacy Matches @ BlizzCon 5.0.16 Hotfix (June 30) - Balance + Bug Fixes HomeStory Cup In Early July
Tourneys
HomeStory Cup 29 Douyu Cup 2026: $20,000 Legends Event (June 26-28) Vespene Cup #1 — $300+ USD, July 10 Crank Gathers Season 4: BW vs SC2 Team League RSL Revival: Season 6 - Qualifiers and Main Event
Strategy
[G] Having the right mentality to improve
Custom Maps
New Map Maker - Looking for Advice - Love or Hate Work In Progress Melee Maps [D]RTS in all its shapes and glory <3
External Content
The PondCast: SC2 News & Results Mutation # 532 Nuclear Family Mutation # 531 Experimental Artillery Mutation # 530 One For All
Brood War
General
BGH Auto Balance -> http://bghmmr.eu/ BW General Discussion ASL 22 Proposed Map Pool Starcraft vs Retro Category on Twitch First season(s) of tastosis gomtv gsl vods?
Tourneys
The Casual Games of the Week Thread [Megathread] Daily Proleagues [ASL21] Grand Finals [BSL22] GosuLeague Casts - Tue & Thu 22:00 CEST
Strategy
Simple Questions, Simple Answers Creating a full chart of Zerg builds Relatively freeroll strategies Why doesn't anyone use restoration?
Other Games
General Games
Stormgate/Frost Giant Megathread Nintendo Switch Thread Dawn of War IV Summer Games Done Quick 2026! ZeroSpace at Steam NextFest - Last free demo
Dota 2
Looking for a Dota Mentor Official 'what is Dota anymore' discussion
League of Legends
Heroes of the Storm
Simple Questions, Simple Answers Heroes of the Storm 2.0
Hearthstone
Deck construction bug
TL Mafia
NeO.D_StephenKing vs This Guy From 1 Million Dance TL Mafia Community Thread TL Mafia Power Rank Vanilla Mini Mafia
Community
General
Russo-Ukrainian War Thread Canadian Politics Mega-thread US Politics Mega-thread The Games Industry And ATVI Men's Fashion Thread
Fan Clubs
The HerO Fan Club! The herO Fan Club!
Media & Entertainment
Movie Discussion! Series you have seen recently... [Req][Books] Good Fantasy/SciFi books [TV/BOOK] *SPOILERS* Game of Thrones Discussion
Sports
2024 - 2026 Football Thread TeamLiquid Health and Fitness Initiative For 2023 Formula 1 Discussion McBoner: A hockey love story Cricket [SPORT]
World Cup 2022
Tech Support
How to clean a TTe Thermaltake keyboard? Computer Build, Upgrade & Buying Resource Thread
TL Community
The Automated Ban List
Blogs
Listen To The Coaches!
TrAiDoS
An Exploration of th…
waywardstrategy
I'm an arrogant trash talke…
FlaShFTW
Gauntlet SC2: A Retrospectiv…
Ctone23
ramps on octagon
StaticNine
Funny Nicknames
LUCKY_NOOB
Evil Gacha Games and the…
ffswowsucks
Customize Sidebar...

Website Feedback

Closed Threads



Active: 18322 users

Dota 2 Bot API: The (glut)Initial step

Blogs > LetaBot
Post a Reply
LetaBot
Profile Blog Joined June 2014
Netherlands557 Posts
February 09 2016 21:20 GMT
#1
Creating a Dota 2 Bot API Part 1: The (glut)Initial step
I decided to take a small break from creating my StarCraft bot (Wiki)LetaBot to see how well bots perform in other e-sport titles. While checking the subreddit, I found out that Dota 2 has an offline LAN mode. This got me interested in checking if it was possible to create a bot API for Dota 2 like the one that Matthew Fisher did for StarCraft 2 ( https://graphics.stanford.edu/~mdfisher/GameAIs.html ). The advantages for using this method over the build-in scripting language is that a build-in scripting language is significantly slower than C++ code, and you cannot store/retrieve as much information as your hard drive can handle ( haven't used Dota 2 script, so correct me if I am wrong about Dota 2 script limitations).

The problem with using DirectX interception to create a bot for StarCraft 2 is that you have to use battle.net to play against other players, and Blizzard won't like it if you use DirectX interception on battle.net . After all, DirectX interception allows you to do stuff like this:

[image loading]

Or even more outlandish stuff like this.

But with an offline LAN mode, you don't have to worry about this sort of stuff getting you banned and leaving you with no other options to play versus other players.

The first attempt to get the graphics interceptor was to use the Matthew Fisher's DirectX interceptor on Dota 2, since the interception part of the code doesn't care about the program it is used on ( placing the modified d3d9.dll in the dota2.exe folder makes it load that one instead of the one in system32 ). This doesn't seem to work since dota 2 crashes when it tries to start up the main menu ( probably something involving the shaders that dota 2 uses, as you will see in apitrace below. ). It did manage to store the load screen textures:

[image loading]

So when I contacted Matthew Fisher, he directed me to a different program called apitrace. That one does manage to collect all the directX API calls, but for some reason it has problems with the shaders as well, causing the frame replay to look mostly black ( with only the top/bottom GUI, healthbars and some flame effects visible). So instead I switched to OpenGL. One driver update later I was capable of getting apitrace to record and replay the OpenGL calls.


Some pictures of the success below:


[image loading]

This is the texture of (Wiki)tiny IIRC.

[image loading]

Scene rendering in progress. Notice the checkerboard textures below each hero (and the spells), and the fact that this image is flipped ( vertically, the original image was upside down ).



Since apitrace is open source, this can be use as an initial starting point to use the same technique that Matthew Fisher used to make his StarCraft 2 bot.
Very ( very very ) simply put, the following needs to be added to the apitrace to make it usable for a Dota 2 Bot API:

- Know which texture belongs to which hero. You can look at Matthew Fisher's texture table for StarCraft 2 to see an example of this.

- Know when these textures are drawn, and where on the screen the texture/hero is located ( as in, not on the XY coordinates of the dota 2 map, but the XY coordinates of your monitor ).

- Use the information above to determine when/where to click on the screen. You are basically sending click commands instead of using a physical mouse, just like AutoIt and other related programs do. The difference is that you aren't relying on the color of certain pixels like a simple runescape bot, but on the information that is send through the graphics pipeline (getting this information purely based on the pixels on the screen is too complex for a game like Dota 2: it would take too much time to process and dota 2 is too fast paced for that).


Besides hero location you ofc also need things like the location of creeps, your/ally/enemy health and all that sort of stuff.


Anyway, I am going back to my StarCraft bot now. I still have to wrap up my master thesis on it. If anyone is interested in already starting on developing such an API, you can pm me and I can give you some (OpenGL, graphic pipeline) guides that can help you get started. In general you will need to know about C++ and OpenGL ( general 3d graphics knowledge should suffice as well, it is mainly about extracting information, not programming OpenGL ). I myself will start digging more into this stuff next month (March).
If you cannot win with 100 apm, win with 100 cpm.
Birdie
Profile Blog Joined August 2007
New Zealand4438 Posts
February 09 2016 22:38 GMT
#2
Are you not able to just memory scan for on-screen hero locations and minimap hero locations? Surely this would be far easier than graphics hooks.
Red classic | A butterfly dreamed he was Zhuangzi | 4.5k, heading to 5k as support!
Sn0_Man
Profile Blog Joined October 2012
Tebellong44238 Posts
February 09 2016 22:41 GMT
#3
Interesting

Just out of curiosity, are you aware that valve wrote some of their own bots?

Which of course are quite different since they don't seek to simulate human interaction with the client in any way of course, but still something worth thinking about.
LiquidDota StaffSCIENTISTS BAFFLED | 3275929302
LetaBot
Profile Blog Joined June 2014
Netherlands557 Posts
Last Edited: 2016-02-09 23:19:33
February 09 2016 23:18 GMT
#4
On February 10 2016 07:38 Birdie wrote:
Are you not able to just memory scan for on-screen hero locations and minimap hero locations? Surely this would be far easier than graphics hooks.


That is what the BWAPI does for StarCraft Brood War. However, one update could change all the relevant opcodes, which means that you have to redo the process. Whereas the textures tend to stay the same for each hero after an update. And even if it changes it is just a matter of finding the right texture again instead of having to go trough the entire program looking for the memory adress.

On February 10 2016 07:41 Sn0_Man wrote:
Interesting

Just out of curiosity, are you aware that valve wrote some of their own bots?

Which of course are quite different since they don't seek to simulate human interaction with the client in any way of course, but still something worth thinking about.


Yes, I know about the build-in bots. But those are very easy to defeat. I don't recall them releasing an API to control these bots directly.
If you cannot win with 100 apm, win with 100 cpm.
Ler
Profile Blog Joined August 2012
Germany543 Posts
February 10 2016 08:13 GMT
#5
I am also kinda in bot programming and I was kinda impressed when I read about the Sc2 bot Matthews released. If you continue your work, write about it please
Twitter: @Ler_GG | Facebook: lergg | youtube: lerlolgg | Twitch.tv/gg_nore | #ArtOfSupport
misirlou
Profile Joined June 2010
Portugal3304 Posts
February 10 2016 12:31 GMT
#6
Is it not possible to code bots on dota 2 tools for custom maps?
evanthebouncy!
Profile Blog Joined June 2006
United States12796 Posts
February 10 2016 12:46 GMT
#7
well lemme know once you finished writing an api wrapper

is there a way to canonicalize hero appearance? I imagine it'll be much easier if all the hero appeared the same and not altered by the costumes they wear.
Life is run, it is dance, it is fast, passionate and BAM!, you dance and sing and booze while you can for now is the time and time is mine. Smile and laugh when still can for now is the time and soon you die!
LetaBot
Profile Blog Joined June 2014
Netherlands557 Posts
February 10 2016 13:46 GMT
#8
On February 10 2016 21:31 misirlou wrote:
Is it not possible to code bots on dota 2 tools for custom maps?



It is. But as I mentioned, the scripting language is a lot slower compared to native C++ code. Also you can store/retrieve more data between matches using file I/O . I don't even know if file input/output is possible with the scripting language.

Since dota 2 is quite complex, I don't think that simple scripts are going to be enough to create bots that can defeat top level human players.
If you cannot win with 100 apm, win with 100 cpm.
spamduck101
Profile Joined August 2015
United States8 Posts
February 10 2016 16:19 GMT
#9
Very cool! Keep us posted. I didn't know about Matt's SC2 stuff. That was a fun read.
misirlou
Profile Joined June 2010
Portugal3304 Posts
February 10 2016 20:27 GMT
#10
On February 10 2016 22:46 LetaBot wrote:
Show nested quote +
On February 10 2016 21:31 misirlou wrote:
Is it not possible to code bots on dota 2 tools for custom maps?



It is. But as I mentioned, the scripting language is a lot slower compared to native C++ code. Also you can store/retrieve more data between matches using file I/O . I don't even know if file input/output is possible with the scripting language.

Since dota 2 is quite complex, I don't think that simple scripts are going to be enough to create bots that can defeat top level human players.

I didn't think that was what you meant by "built in scripting language" but it makes sense now. Yeah I guess the scripts are limited that way and I don't see valve adding file I/O support for it since you could basically start distributing a bunch of crap that would harm a system via the workshop.
evanthebouncy!
Profile Blog Joined June 2006
United States12796 Posts
February 11 2016 13:47 GMT
#11
On February 10 2016 22:46 LetaBot wrote:
Show nested quote +
On February 10 2016 21:31 misirlou wrote:
Is it not possible to code bots on dota 2 tools for custom maps?



It is. But as I mentioned, the scripting language is a lot slower compared to native C++ code. Also you can store/retrieve more data between matches using file I/O . I don't even know if file input/output is possible with the scripting language.

Since dota 2 is quite complex, I don't think that simple scripts are going to be enough to create bots that can defeat top level human players.


do we know if the scripting language is turing complete or is it actually very primitive like that of starcraft map editor?
Life is run, it is dance, it is fast, passionate and BAM!, you dance and sing and booze while you can for now is the time and time is mine. Smile and laugh when still can for now is the time and soon you die!
Torte de Lini
Profile Blog Joined September 2010
Germany38463 Posts
January 06 2017 21:45 GMT
#12
Bumping this. Is Letabot still around?
https://twitter.com/#!/TorteDeLini (@TorteDeLini)
Please log in or register to reply.
Live Events Refresh
HomeStory Cup
11:00
XXIX - Group Stage Day 1
TaKeTV3390
ComeBackTV 985
SteadfastSC338
TaKeSeN 286
IndyStarCraft 261
Rex122
Liquipedia
[ Submit Event ]
Live Streams
Refresh
StarCraft 2
SteadfastSC 338
IndyStarCraft 261
Rex 122
StarCraft: Brood War
Britney 36488
Shuttle 1028
Mini 918
Soma 294
Snow 171
actioN 162
Rush 146
ToSsGirL 129
BeSt 123
hero 93
[ Show more ]
Free 39
Aegong 34
scan(afreeca) 31
910 22
Barracks 21
JYJ 21
IntoTheRainbow 18
HiyA 17
Sharp 17
GoRush 15
Bale 14
Rock 14
Dota 2
qojqva2364
Counter-Strike
fl0m1739
kRYSTAL_46
Super Smash Bros
Mew2King103
Heroes of the Storm
Trikslyr103
Other Games
singsing4315
Hui .179
XcaliburYe174
KnowMe127
C9.Mang0102
B2W.Neo64
ArmadaUGS50
Organizations
Dota 2
PGL Dota 2 - Main Stream168
StarCraft 2
Blizzard YouTube
StarCraft: Brood War
BSLTrovo
[ Show 17 non-featured ]
StarCraft 2
• StrangeGG 74
• mYiSmile130
• LaughNgamezSOOP
• sooper7s
• AfreecaTV YouTube
• intothetv
• Kozan
• IndyKCrew
• Migwel
StarCraft: Brood War
• FirePhoenix12
• Michael_bg 12
• STPLYoutube
• ZZZeroYoutube
• BSLYoutube
League of Legends
• Nemesis4367
• TFBlade1113
Other Games
• Shiphtur309
Upcoming Events
Replay Cast
7h 8m
HomeStory Cup
18h 8m
Replay Cast
1d 7h
HomeStory Cup
1d 18h
OSC
1d 20h
WardiTV Weekly
3 days
The PondCast
4 days
Replay Cast
5 days
CrankTV Team League
5 days
Replay Cast
6 days
[ Show More ]
CrankTV Team League
6 days
Liquipedia Results

Completed

YSL S3
Douyu Cup 2026
Murky Cup 2026

Ongoing

IPSL Spring 2026
Acropolis #4
CSL Season 21: Qualifier 2
Escore Tournament S3: W1
SCTL 2026 Spring
HSC XXIX
XSE Pro League 2026
IEM Cologne Major 2026
Stake Ranked Episode 2
CS Asia Championships 2026
Asian Champions League 2026
IEM Atlanta 2026
PGL Astana 2026
BLAST Rivals Spring 2026

Upcoming

CSL 2026 Summer (S21)
Escore Tournament S3: W2
ASL Season 22:Wild Card Qualifier
CSLAN 4
Blizzard Classic Cup 2026
SC4ALL II: StarCraft II
Kung Fu Cup 2026 Grand Finals
RSL Revival: Season 6
CranK Gathers Season 4: BW vs SC2 Team League
Light Tournament 2026
Eternal Conflict S2 Finale
Eternal Conflict S2 E3
Eternal Conflict S2 E2
Heroes Pulsing #3
Eternal Conflict S2 E1
FISSURE Playground #5
BLAST Open Fall 2026
Esports World Cup 2026
BLAST Bounty Summer 2026
BLAST Bounty Summer Qual
Stake Ranked Episode 3
TLPD

1. ByuN
2. TY
3. Dark
4. Solar
5. Stats
6. Nerchio
7. sOs
8. soO
9. INnoVation
10. Elazer
1. Rain
2. Flash
3. EffOrt
4. Last
5. Bisu
6. Soulkey
7. Mini
8. Sharp
Sidebar Settings...

Advertising | Privacy Policy | Terms Of Use | Contact Us

Original banner artwork: Jim Warren
The contents of this webpage are copyright © 2026 TLnet. All Rights Reserved.