DotA 2 Frequently Asked Questions (FAQ) about the Dota 2 editor


Forum Administrator
Staff member
Here are common questions many users have with the Editor.

Keep in mind that this is a Work in Progress. More questions will be added in the future.

  • What should I do to get started?
  • How do I place a unit on my map?
  • How do I set icons to my custom abilities?
  • How do I set icons to my custom items?
  • Can I edit/add heroes in my map?
  • Can I add more teams than just the Radiant and the Dire? For instance, a free for all map?
  • How do I add tooltips to my abilities?

What should I do to get started?

Visit this page

For complete beginners, here is the actual "getting started" tutorial

And here is a good tutorial on the basics of the Editor.

How do I place a unit on my map?

You have 2 options. The first option is to place a prefab unit on the map (short for pre-fabricated). Here is where it is located:

prefab pannel.jpg

Locate the neutral unit you want in there, and simply place it on the map. Note that you can only place default dota units with this, such as neutrals, towers, barracks, etc.

The second option is to place the entity named "npc_dota_base" into your map. This enables you to place custom units of your making. To place this entity, we need the entity tool, which can be accessed with [SHIFT + E] and looks like a light bulb. Once there, scroll down the list to find npc_dota_base.


Place a new unit, and within the "Unit Name" drop list, find your custom unit. Mine is called npc_dota_creature_gate_keeper. It should be right at the bottom. Note: you can also place all kinds of units with this, including brewmaster spirits (his ultimate).

Visit this page for a tutorial on making custom units.


Done! The object properties allow you to edit this placed unit a bit, like changing its color, or spawning angle. The "Use Neutral Creep Behavior" option will make your unit behave, unsurprisingly, like a neutral creature in Dota 2. Which means that it will mostly only aggro when someone gets very close to it (about 200 range), and will chase only for a while, and will then return to its spot.

How do I set icons to my custom abilities?

There are 2 things you need to do. First of all, you need your actual icon, and it has to be at the right place. Ability icons have to be .png files, and their dimensions should be 128x128 pixels.

Furthermore, they should be located within the following folders (replace zergling_madness with the name of your mod):


Second, the ability needs to be told what icon it is. Let's say your spell is named gatekeeper_bloodlust, here is the line you should add in your spell under npc_abilities_custom.txt:

"AbilityTextureName"             "gatekeeper_bloodlust"

To find more information on how to create an actual custom unit, follow this tutorial

How do I set icons to my custom items?

It's quite similar to the abilities icons, but with a twist (of course).

First, Item icons have to be .png files, and their dimensions should be 124x64 pixels, again with a twist. Indeed, the item's picture should be 88 pixels wide, 64 large. The remaining 36x64 pixels should be transparent.

When that is done, the icon should be placed into the following folder (replace zergling_madness with the name of your mod):


Second, the item needs to be told what icon it is. Let's your item's name is item_ice_mastery, here is the should add under your item in npc_items_custom.txt

"AbilityTextureName"            "item_ice_mastery"

To find more information on how to create an actual custom unit, follow this tutorial

Can I edit/add heroes in my map?

It is possible, but for now, limited.

  • You can edit any heroes using the file npc_heroes_custom.txt located in your scripts folder. However, it will replace the default hero from Dota 2 in your map.
  • Therefore, it is impossible (right now) to create new heroes and give them a unique ID. It might be possible in the future though.
  • Apparently, there are 2 unused Hero IDs in the Editor. id = 105, and id = 24. Those two do not correspond to any default heroes in Dota 2 and can thus theoretically be changed without altering any of the base heroes. This is yet untested as of August 24th, 2014.
  • All of this is subject to change in the upcoming Workshop patches.

Can I add more teams than just the Radiant and the Dire? For instance, a free for all map?

Right now, you can't. Valve designed Dota 2 with the philosophy that 2 teams would battle it out, so at the very core, the game is 5v5. However, Valve might patch the Workshop in the future to enable more teams.

For now, the most unconventional setup is 5 vs 0, which means a sort of Co-operative mode vs the computer (The Neutrals team).

How do I add tooltips to my abilities?

Tooltips aren't defined in either custom unit files, abilities files, or even item files. They're in a separate file named "addon_english.txt" in your addon's folder. Here is the file's path:


As usual, replace "zergling_madness" with the name of your addon. Opening up this file should feel somewhat unimpressive. This is what it looks like, vanilla:

    "Language"        "English"
        "addon_game_name"            "YOUR ADDON NAME"

It is time to add some tooltips to this!

Here is what the file looks like with an example item made by Valve, named Arcane Boots 2, on a map named Zergling Madness with nothing in it except the boots:

    "Language"        "English"
        "addon_game_name"            "Zergling Madness!"
        "game_mode_15_desc"         "Fight. Die. Fight again!"

        // Arcane Boots 2
        "DOTA_Tooltip_Ability_item_arcane_boots2"            "Arcane Boots 2"
        "DOTA_Tooltip_ability_item_arcane_boots2_Description"                    "Active: Replenish Mana - Restores mana in an area around the hero.\n\nFlat movement speed bonuses from multiple pairs of boots do not stack."
        "DOTA_Tooltip_ability_item_arcane_boots2_Lore"                        "Magi equipped with these boots are valued in battle."
        "DOTA_Tooltip_ability_item_arcane_boots2_Note0"                            "Does not work on Meepo clones."
        "DOTA_Tooltip_ability_item_arcane_boots2_replenish_amount"                "MANA RESTORED:"
        "DOTA_Tooltip_ability_item_arcane_boots2_bonus_movement"                    "+$move_speed"
        "DOTA_Tooltip_ability_item_arcane_boots2_bonus_mana"                        "+$mana"

Note: " \n\n " serves the purpose of jumping a line.
For abilities, it should read the same but without the "item" part, so:

As usual, the best way to learn in this editor is to play with it a little and see what happens!
Good luck!
Last edited:


† Ғσſ ŧħə ѕαĸε Φƒ ~Ğ䣚~ †
hi sim, glad to see you're the forum staff already.

i'm back to learn the d2 editor, this post made great help, thanks!
  • Like
Reactions: Sim
General chit-chat
Help Users
  • No one is chatting at the moment.
  • The Helper The Helper:
    but yeah man you should come to Houston there is so much more opportunity here than San Antonio. Just look at all the homeless people on the Riverwalk and downtown there you cannot even walk down the street without getting mobbed them
  • The Helper The Helper:
    check out this place apparently it is the best roommate site out there lol
  • Varine Varine:
    The homeless people reminded me of New York
  • Varine Varine:
    I'll check it out, my lease expires in like a few months so I need to figure something out.
  • Varine Varine:
    I tried to open a food truck in Sandpoint a few years ago but the city said no, then like two years later they passed new laws to encourage it and gave them all fucking tax breaks and shit. And at that point I didn't have enough money to go buy one so I was way too late to the game once other cities realized they could just bring their existing truck there, or sell their brick and mortar.
  • Varine Varine:
    I do like food trucks though, they're way more fun than restaurants and usually I also get some of that tip money there.
  • Varine Varine:
    Restaurants are really hard if you don't have a back up source of income to fund them sometimes, in my experience most owners either got really really lucky, had existing money that allowed them to buy an already successful one, or they have family money to fall back on for loans. It's few and far between to see very inspiring success stories where the person actually got it through hard work and perseverance. I thought about opening one lots and I always just end up not thinking it'll work. I would much rather just find someone that has that money and go work for them
  • The Helper The Helper:
    i am not talking about opening a brick and mortar I am talking about food trucks though I have seen some brick and mortar mexican places open up during covid that are doing good because there food is awesome!
  • The Helper The Helper:
    Food trucks are killing out here because Bars cannot open unless they sell food and the governor ok'd the use of a food truck in front as serving food
  • The Helper The Helper:
    Just not enough food trucks
  • The Helper The Helper:
    a buddy of mine just opened up a food truck and he is killing it but he is a great cook and has awesome food right in the middle of the pandemic too food trucks are immune to pandemic because they are take out in Texas you will always be able to get take out or delivery
  • The Helper The Helper:
    He is in the different food facebook groups in houston and posts videos of him making his food
  • The Helper The Helper:
    he is killing it
  • jonas jonas:
    @Varine with the restaurants, there surely is a lot of luck and hard work but most restaurants fail because they suck. Flair isn't right, economics not well thought through, food is mediocre or sucks, location is bad, etc. If you're thinking about opening one, make sure you're looking at the stories of those that would be playing at your level, don't let your hopes be dragged down by all the subpar restaurants out there.
  • jonas jonas:
    I'm a bit worried about the future of data science, there's an influx of incompetent people hired by incompetent managers, that can't last. But I'm sure smart data scientists will always be useful and hireable. Same as smart security people.
  • jonas jonas:
    My sister in law worked in a vegan food truck, the owners were also making a killing, added several trucks and opened two restaurants over 5 years
  • Ghan Ghan:
    The CompTIA stuff is pretty much crap unfortunately. The places that ask for those low-level certs aren't likely places you want to work. For IT you really want a degree, but in the meantime you need to figure out some way to learn the skills. Cybersecurity is really hot right now so competition is fierce.
  • tom_mai78101 tom_mai78101:
    I realized I don't have anything much to say, other than "Good luck!". Compared to other places, I'm just very lucky we didn't have a lot of surges of cases coming in.
  • The Helper The Helper:
    My daughter just got back from school at Georgetown TX, outside of Austin and said there were 100 cases in the last week but she also said nobody was wearing a mask anywhere so people mask up and stay safe!
  • thewrongvine thewrongvine:
    happy thanksgiving folks!
  • Ralle Ralle:
  • Varine Varine:
    @Gyah Yeah I figured they aren't particularly valuable, but they'll at the least act as a baseline for some entry level work somewhere.
  • Varine Varine:
    I now see how horribly I spelled @Ghan
  • Varine Varine:
    I had a rough morning
  • The Helper The Helper:
    that field is going to explode and though there is competition there is going to be room for all levels in the coming years imho.

    Members online

    No members online now.


    Hive Workshop