Many places in the bot will allow you to specify heroes. The selection or list of heroes to be used will be referred to as the hero-string in various other places in this wiki.
You may list hero names individually, and/or exclude heroes with '!name', and/or include all heroes with 'any' or even use no hero at all with 'none'. For example,
valleyheroes Biggy this would allow only hero Biggy to attack valleys & flats
npcheroes !Smarty,!Biggy,any this would allow any hero except Smarty and except Biggy to hit npcs
npcheroes 10 Biggy,Polly,Smarty this would allow heroes Biggy, Polly, and Smarty to hit npc10s
reinforce 123,456 any c:100000 this would allow you to reinforce 123,456 with cav and any available hero
You may also use advanced filters in hero-strings in the format of hero:filter. The hero name list (or 'any') must be stated first, followed by the filter(s). Any filters listed will apply to the entire line. For example,
valleyheroes any:attack>180 this would allow any hero with an attack over 180 to attack valleys & flats
valleyheroes any:politics<200 this would allow any hero with politics under 200 to attack valleys & flats
npcheroes 8 any:politics=best this would allow the best politics hero to hit npc8s
npcheroes 5 farmer:attack<200 this would allow any hero named Farmer who's attack is under 200 to attack npc5s
npcheroes 10 any:attack>300,base>60 this would allow any attack hero with both an attack over 300 AND a base over 60 to hit npc10s
attack 111,222 !Biggy,any:attack>180 c:99k,s:1k this would attack coordinates 111,222 with any hero over 180 attack other than hero Biggy with 99k cavs, 1k scouts
attack 111,222 !Polly,any:attack<100 w:5k this would attack coordinates 111,222 with any hero under 100 attack other than hero Polly with 5k warriors
If you wish to apply separate filters to separate heroes, use multiple lines. For example,
npcheroes 5 any:base>60
npcheroes 5 any:attack<300
The above lines mean that npc5s can be farmed with any hero that has greater than 60 base OR any hero that has less than 300 attack.
If you wish to include heroes of specific names regardless of whether they meet the conditional filter for that line, put them on separate lines:
npcheroes 5 bob,fred,joe
npcheroes 5 any:attack>=60
The above lines mean that npc5s can be farmed by any hero named "bob", "fred", or "joe", OR any hero with 60+ base.
Multiple lines can be concatenated (combined) into a single line with the | symbol. For example,
npcheroes 5 bob,fred,joe|any:attack>=60
The above line means exactly the same thing as the 2 before it.
npcheroes 5 bob,any:attack>=60
If you were to instead use the line above, it would mean npc5s can be farmed with any hero that has both the name bob AND has an attack of 60+.
npcheroes 5 any:base>60,attack<300
With those rules standing, the above line would mean you can farm npc5s with any hero that has both a base higher than 60 AND an attack under 300.
All possible filters for use in hero-strings are:
All possible comparisons to use in filters are:
< (less than)
> (greater than)
<> (not equal to)
<= (less than or equal to)
>= (greater than or equal to)
"Best" and "Worst" can be used in place of values for comparisons, for example:
npcheroes 10 any:attack=best would allow npc10s to be farmed with the best attack hero.
npcheroes 5 any:attack<best would allow npc5s to be farmed with any hero lower than the best attack hero.
Stats can be compared to other stats in place of values, for example:
npcheroes 5 any:attack>politics would allow any hero with an attack score greater than its politics score.
npcheroes 5 any:politics>level would allow any hero with a politics score greater than its level.
Wildcards can be used for the hero list. * will represent 1 or more characters, ? will represent 1 character. For example,
npcheroes 5 att*:attack>200 would allow npc5s to be farmed with any hero over 200 attack that has "att" in its name.
npcheroes 5 *:base>60 would allow npc5s to be farmed with any hero that has a base over 60.
npcheroes 5 att??int:base>=69 would allow npc5s to be farmed with any hero named "att69int," "att70int," etc. who's base is 69+.
Hero strings cannot consist of only a single number. This is a safety precaution for people blindly replacing older goals of "herofirelimit 100" with "keepheroes 100" and unexpectedly losing a valuable hero. If you use heroes with pure number names, for example "100" you can still trick the hero string into accepting it, by adding something more than just that single number.
npcheroes 8 100,100 This would allow the hero named "100" (or the hero named "100" :P) to farm npc8s.