MapBot is a bot-base to farm endgame maps.
It is highly recommended to read the following tutorial:
Map types
Settings description
Unsupported
Known issues
Note to developers
If you want to report a bug/issue, please attach a full log.
It is highly recommended to read the following tutorial:
Map types
Regular
A map that consists of one single area.
Bossroom
A map that consists of one big area and a small separate room where boss resides.
Multilevel
A map that consists of multiple small areas connected with each other linearly. Every level leads to a next one. Boss is located on the last level.
Complex
A multilevel map where areas are connected non-linearly. This type incorporates many maps with completely different layouts. Backtracking to previous levels is usually required to fully explore such map.
A map that consists of one single area.
Bossroom
A map that consists of one big area and a small separate room where boss resides.
Multilevel
A map that consists of multiple small areas connected with each other linearly. Every level leads to a next one. Boss is located on the last level.
Complex
A multilevel map where areas are connected non-linearly. This type incorporates many maps with completely different layouts. Backtracking to previous levels is usually required to fully explore such map.
Settings description
General
Upgrading
Maps
Affixes
Statistics
Global
Max map tier - bot will never run maps with tier higher than specified value (unique maps are not affected by this setting).
Monster remaining - bot will finish current map beforehand if monster remaining is equal or less than specified value AND map boss was killed AND there are no monsters nearby.
Exploration percent - only for Regular and Bossroom maps. Bot will finish current map beforehand if exploration percent is equal or greater than specified value AND map boss was killed AND there are no monsters nearby.
Use hideout - bot will use Zana's Map Device in your hideout to open maps. Otherwise The Templar Laboratory will be used.
Monster tracking - bot will memorize all seen monsters and return to them if they move outside the combat range. This option greatly improves map clear quality, its not recommended to disable it unless you know what you are doing.
Fast transition - only for Multilevel and Complex Maps. Bot will proceed to the next level as soon as entrance is found (and all seen monsters are killed if Monster tracking is enabled). If this option is disabled bot will 100% explore current level before going to the next one. For Bossroom maps, bot will internally use Fast transition once Monster remaining or Exploration percent is reached.
Run unid maps - bot will run unidentified maps.
Ignore hidden auras - bot automatically applies all auras and summons golems before entering a map. If this option is enabled bot will ignore auras that are not present on the skillbar.
Strict monster remaining - removes boss kill requirement from Monster remaining. Bot will leave current map as soon as Monster remaining is reached and there are no monsters nearby.
Strict exploration percent - removes boss kill requirement from Exploration percent. Bot will leave current map as soon as Exploration percent is reached and there are no monsters nearby.
Stop after current map - bot will stop after finishing current map. Simple as it is.
Trials - bot will enter specified Map Trial and stop.
Atlas
Please note that all priorities here stack additively with priorities you specify in Map Settings.
Shaped maps priority - additional priority for shaped maps.
Shaper influence priority - additional priority for maps under Shaper influence.
Elder influence priority - additional priority for maps under Elder influence.
Atlas exploration mode - bot will prioritize unfinished maps on atlas over all. Bot will also automatically use Alchemy orbs on unfinished 6+ tier maps and Vaal orbs on 11+ tier (bonus objective requirement). Does not work on bossroom maps if bossroom is ignored. Does not bypass standard map pool limitations such as "Max map tier" and ignored maps.
Selling
Enabled - bot will sell 3 maps of the same kind. Works only on the first tab specified for maps since checking all tabs is time consuming and in most cases redundant.
Sell ignored maps - bot will sell ignored maps regardless of all the restrictions provided below.
Max map tier - bot will never sell maps with tier higher than specified value.
Max map priority - bot will never sell maps with priority higher than specified value.
Min map amount - bot will not sell maps if total map amount in a stash tab for maps is less than specified value (excluding uniques).
Some more clarification is required for this option because many users misunderstand it's purpose.
First of all - this option is legacy, its was ported from MapRunner to MapBot just for the convenience. Nowadays it has a very small practical use. Do not edit this option unless you know what you are doing, default value of 7 is perfectly fine. Original purpose of Min Map Amount was to prevent the bot from selling the last few maps you have. Back in the past, map drops in PoE were much lower than now and it was possible to just run out of them.
This option does exactly what is stated in the description, it counts all your maps in a stash tab (excluding uniques) and compares with Min Map Amount value. If total map count in a stash tab is lower then Min Map Amount - bot will not sell any maps. By setting this option to an absurdly large values you effectively disable the map selling. For example, if you set Min Map Amount to 100 you need at least 103 maps in a stash tab for bot to sell at least one map group (3).
Max map tier - bot will never run maps with tier higher than specified value (unique maps are not affected by this setting).
Monster remaining - bot will finish current map beforehand if monster remaining is equal or less than specified value AND map boss was killed AND there are no monsters nearby.
Exploration percent - only for Regular and Bossroom maps. Bot will finish current map beforehand if exploration percent is equal or greater than specified value AND map boss was killed AND there are no monsters nearby.
Use hideout - bot will use Zana's Map Device in your hideout to open maps. Otherwise The Templar Laboratory will be used.
Monster tracking - bot will memorize all seen monsters and return to them if they move outside the combat range. This option greatly improves map clear quality, its not recommended to disable it unless you know what you are doing.
Fast transition - only for Multilevel and Complex Maps. Bot will proceed to the next level as soon as entrance is found (and all seen monsters are killed if Monster tracking is enabled). If this option is disabled bot will 100% explore current level before going to the next one. For Bossroom maps, bot will internally use Fast transition once Monster remaining or Exploration percent is reached.
Run unid maps - bot will run unidentified maps.
Ignore hidden auras - bot automatically applies all auras and summons golems before entering a map. If this option is enabled bot will ignore auras that are not present on the skillbar.
Strict monster remaining - removes boss kill requirement from Monster remaining. Bot will leave current map as soon as Monster remaining is reached and there are no monsters nearby.
Strict exploration percent - removes boss kill requirement from Exploration percent. Bot will leave current map as soon as Exploration percent is reached and there are no monsters nearby.
Stop after current map - bot will stop after finishing current map. Simple as it is.
Trials - bot will enter specified Map Trial and stop.
Atlas
Please note that all priorities here stack additively with priorities you specify in Map Settings.
Shaped maps priority - additional priority for shaped maps.
Shaper influence priority - additional priority for maps under Shaper influence.
Elder influence priority - additional priority for maps under Elder influence.
Atlas exploration mode - bot will prioritize unfinished maps on atlas over all. Bot will also automatically use Alchemy orbs on unfinished 6+ tier maps and Vaal orbs on 11+ tier (bonus objective requirement). Does not work on bossroom maps if bossroom is ignored. Does not bypass standard map pool limitations such as "Max map tier" and ignored maps.
Selling
Enabled - bot will sell 3 maps of the same kind. Works only on the first tab specified for maps since checking all tabs is time consuming and in most cases redundant.
Sell ignored maps - bot will sell ignored maps regardless of all the restrictions provided below.
Max map tier - bot will never sell maps with tier higher than specified value.
Max map priority - bot will never sell maps with priority higher than specified value.
Min map amount - bot will not sell maps if total map amount in a stash tab for maps is less than specified value (excluding uniques).
Some more clarification is required for this option because many users misunderstand it's purpose.
First of all - this option is legacy, its was ported from MapRunner to MapBot just for the convenience. Nowadays it has a very small practical use. Do not edit this option unless you know what you are doing, default value of 7 is perfectly fine. Original purpose of Min Map Amount was to prevent the bot from selling the last few maps you have. Back in the past, map drops in PoE were much lower than now and it was possible to just run out of them.
This option does exactly what is stated in the description, it counts all your maps in a stash tab (excluding uniques) and compares with Min Map Amount value. If total map count in a stash tab is lower then Min Map Amount - bot will not sell any maps. By setting this option to an absurdly large values you effectively disable the map selling. For example, if you set Min Map Amount to 100 you need at least 103 maps in a stash tab for bot to sell at least one map group (3).
Upgrading
Contains various map upgrading options, you can specify minimum map tier and/or priority for every option.
Magic - bot will use Transmutation Orbs on normal maps and reroll them with Alteration Orbs. Augmentation Orbs will be used if resulting map has only one affix.
Rare - bot will use Alchemy Orbs on normal maps and reroll them according to "Rare reroll" settings.
Chisel - bot will use Cartographer Chisels on normal maps until they have at least 18 quality.
Vaal - bot will use Vaal Orbs on maps after all previous upgrades are done.
Fragments - bot will place Sacrifice Fragment along with a map into the Map Device.
Rare to Magic - bot will use Scouring+Alchemy orbs on magic maps and reroll them according to "Rare reroll" settings.
Existing rare maps - main purpose of this option is to give a user more control over rare maps that drop from monsters.
Rare map is considered "existing" if it does not fall under any of the rare upgrade options (normal to rare or magic to rare).
For example, if you have set minimum tier for Rare upgrade to 10 - all rare maps below tier 10 will be considered "existing". If all rare upgrade options are disabled - all rare maps are "existing".
● Run - bot will run existing rare maps normally.
● Do not run - bot will not run existing rare maps. Can be used in conjunction with disabling all rare upgrades to prohibit the bot from running all rare maps.
● Do not run if reroll is required - bot will run existing rare maps without ignored affixes only. Use this option if you do not want to spend any currency on existing rare maps.
● Downgrade to magic if reroll is required - bot will downgrade existing rare maps with ignored affixes to magic via Scouring+Transmutation. If bot is out of Scouring or Transmutation orbs this option is the same as "Do not run if reroll is required".
If there is not enough currency for certain upgrade, bot will internally set it as unavailable, and then restore it once there is enough currency.
Magic - bot will use Transmutation Orbs on normal maps and reroll them with Alteration Orbs. Augmentation Orbs will be used if resulting map has only one affix.
Rare - bot will use Alchemy Orbs on normal maps and reroll them according to "Rare reroll" settings.
Chisel - bot will use Cartographer Chisels on normal maps until they have at least 18 quality.
Vaal - bot will use Vaal Orbs on maps after all previous upgrades are done.
Fragments - bot will place Sacrifice Fragment along with a map into the Map Device.
Rare to Magic - bot will use Scouring+Alchemy orbs on magic maps and reroll them according to "Rare reroll" settings.
Existing rare maps - main purpose of this option is to give a user more control over rare maps that drop from monsters.
Rare map is considered "existing" if it does not fall under any of the rare upgrade options (normal to rare or magic to rare).
For example, if you have set minimum tier for Rare upgrade to 10 - all rare maps below tier 10 will be considered "existing". If all rare upgrade options are disabled - all rare maps are "existing".
● Run - bot will run existing rare maps normally.
● Do not run - bot will not run existing rare maps. Can be used in conjunction with disabling all rare upgrades to prohibit the bot from running all rare maps.
● Do not run if reroll is required - bot will run existing rare maps without ignored affixes only. Use this option if you do not want to spend any currency on existing rare maps.
● Downgrade to magic if reroll is required - bot will downgrade existing rare maps with ignored affixes to magic via Scouring+Transmutation. If bot is out of Scouring or Transmutation orbs this option is the same as "Do not run if reroll is required".
If there is not enough currency for certain upgrade, bot will internally set it as unavailable, and then restore it once there is enough currency.
Maps
Contains a list of all maps available in the game, except unsupported uniques. Supported unique maps are located at the bottom of the list, all of them are ignored by default.
You can specify settings individually for every map. Many column headers are shortened to abbreviations for the sake of saving space. You can mouseover an abbreviation to get a description.
First three columns are pretty self explanatory.
Priority - the most important factor for map selection. Bot will run maps with highest priority first. Unique maps priority is shared only among other unique maps. All unique maps internally have a higher priority than non-unique ones.
Ignore - bot will never run this map.
IB (Ignore bossroom) - bot will never enter a bossroom in this map.
MR (Monster remaining) - monster remaining for this map (-1 to use the global value).
S (Strict monster remaining) - strict monster remaining for this map.
E% (Exploration percent) - exploration percent for this map (-1 to use the global value).
S (Strict exploration percent) - strict exploration percent for this map.
MT (Monster tracking) - monster tracking for this map. Undefined state (hyphen sign) means global value will be used.
FT (Fast transition) - fast transition for this map. Undefined state (hyphen sign) means global value will be used.
You can specify settings individually for every map. Many column headers are shortened to abbreviations for the sake of saving space. You can mouseover an abbreviation to get a description.
First three columns are pretty self explanatory.
Priority - the most important factor for map selection. Bot will run maps with highest priority first. Unique maps priority is shared only among other unique maps. All unique maps internally have a higher priority than non-unique ones.
Ignore - bot will never run this map.
IB (Ignore bossroom) - bot will never enter a bossroom in this map.
MR (Monster remaining) - monster remaining for this map (-1 to use the global value).
S (Strict monster remaining) - strict monster remaining for this map.
E% (Exploration percent) - exploration percent for this map (-1 to use the global value).
S (Strict exploration percent) - strict exploration percent for this map.
MT (Monster tracking) - monster tracking for this map. Undefined state (hyphen sign) means global value will be used.
FT (Fast transition) - fast transition for this map. Undefined state (hyphen sign) means global value will be used.
Affixes
Contains a list of all map affixes. You can specify affixes to reroll on Magic and/or Rare maps.
Statistics
Contains various statistics about maps.
Maps entered- total amount of entered maps during this session.
Maps finished - total amount of finished maps during this session. Map is considered "finished" only if bot left it naturally. Abandoned maps (too many deaths, too many loot) are not included.
Average tier entered - self explanatory.
Maps found - total amount of found (picked up) maps.
Map income - "Maps found" minus "Maps entered".
Average tier found - self explanatory.
Total uptime - self explanatory.
Time in current map - shows time you spent in current map and only in map, this excludes time spent for town routines (id/sell/stash), returning to a map after death/chicken etc.
Maps entered- total amount of entered maps during this session.
Maps finished - total amount of finished maps during this session. Map is considered "finished" only if bot left it naturally. Abandoned maps (too many deaths, too many loot) are not included.
Average tier entered - self explanatory.
Maps found - total amount of found (picked up) maps.
Map income - "Maps found" minus "Maps entered".
Average tier found - self explanatory.
Total uptime - self explanatory.
Time in current map - shows time you spent in current map and only in map, this excludes time spent for town routines (id/sell/stash), returning to a map after death/chicken etc.
Unsupported
Vault Map - requires additional logic to handle levers and to add doors as pathfinding obstacles.
Bossrooms: Laboratory, Belfry, Core, Lava Lake, Sunken City, Reef.
Bossrooms: Laboratory, Belfry, Core, Lava Lake, Sunken City, Reef.
Known issues
- Problems and issues caused by high latency and/or desync. All of those can screw the bot up unpredictably.
- Bot can fail to pick up an item if its on the other side of some big object (Strongbox, Tribal Chest). This is more related to the game itself which does not automatically pathfind around such objects.
- Error spam in log "[DefaultPlayerMover::MoveTowards] ExilePather.FindPath failed". Happens a lot in maps where bossroom/next level is close to current level (Ramparts, Villa). This is completely normal and nothing to worry about. Bot detects monsters from another level and, obviously, cannot reach them.
- User intervention can mess up exploration of multilevel maps. Do not stop bot on one level and then start on another.
- Stuck issues. Some maps have them more often than others:
- Bot can fail to pick up an item if its on the other side of some big object (Strongbox, Tribal Chest). This is more related to the game itself which does not automatically pathfind around such objects.
- Error spam in log "[DefaultPlayerMover::MoveTowards] ExilePather.FindPath failed". Happens a lot in maps where bossroom/next level is close to current level (Ramparts, Villa). This is completely normal and nothing to worry about. Bot detects monsters from another level and, obviously, cannot reach them.
- User intervention can mess up exploration of multilevel maps. Do not stop bot on one level and then start on another.
- Stuck issues. Some maps have them more often than others:
- maps based on Aqueduct tileset (stairs)
- maps based on Docks tileset (stairs)
- maps based on Weaver's Chambers tileset (narrow paths)
- maps based on Fellshrine Ruins tileset (ruined church)
Note to developers
MapBot relies on "item_stashed_event" to update currency amounts in stash tabs. This event is provided by default StashTask (EXtensions/CommonTasks/StashTask).
If you want to write your own stashing logic, consider providing that event as well, otherwise MapBot will not be able to restore Upgrading options that were disabled due to lack of certain currency.
If you want to write your own stashing logic, consider providing that event as well, otherwise MapBot will not be able to restore Upgrading options that were disabled due to lack of certain currency.
If you want to report a bug/issue, please attach a full log.
Last edited:
