The script commands in this section pertain to your heroes and managing them.

ChangeHeroName

Usage:

changeheroname oldName newName

Example:

changeheroname ken henry

Used to rename a hero.

FindHero

Usage:

findhero stat

Example:

findhero atk

Arguments:

power or atk
management or pol
stratagem or int

This command will recruit the best hero of the type specified that is available in the inn at the time.

FireHero

Usage:

firehero hero_string

Example 1:

firehero Ken

Example 2:

firehero any:level<50

Used to fire a hero specifically by name from the feasting hall. The hero's status must be either idle, mayor, or captured, i.e., is not on a mission away from town.

In Example 1 the hero "Ken" Will be fired if it is in the town.

In Example 2 all heroes under the level of 50 will be fired.

GetSpamHero

Usage:

getspamhero [optional type of hero]

Example:

getspamhero

Options:

power or atk
management or pol
stratagem or int

Used to get the best hero currently available in the inn. Optionally you can provide the type of hero you want to get the best for either attack, politics, or intelligence, as specified.

HeroRoute

Usage:

heroroute

Example:

heroroute

This command is used to display the movement route for the TrainingHero. The output will display each city you own, and the next destination from that city.

ListAllHeroes

Usage:

ListAllHeroes

Example:

ListAllHeroes

Displays a list of all heroes, their stats, and their experience totals for every city.

Example Output:

  • 10:29:24 CityA Queen Lvl:193 [P:254 A:67 I:21] exp:4737560/3724900
    10:29:24 CityA Farmer1 Lvl:297 [P:27 A:363 I:21] exp:10180331/8820900
    10:29:24 CityA Farmer2 Lvl:272 [P:40 A:347 I:29] exp:6284228/7398400
    10:29:24 CityA Farmer3 Lvl:232 [P:25 A:301 I:32] exp:9425996/5382400
    10:29:24 CityB Queen Lvl:189 [P:246 A:6 I:41] exp:6928622/3572100
    10:29:24 CityB Farmer1 Lvl:321 [P:54 A:389 I:25] exp:7885243/10304100
    10:29:24 CityB Farmer2 Lvl:285 [P:47 A:354 I:18] exp:12535167/8122500
    10:29:24 CityB Farmer4 Lvl:254 [P:26 A:323 I:47] exp:8160739/6451600
    10:29:24 CityC Queen Lvl:210 [P:272 A:22 I:46] exp:8125870/4410000
    10:29:24 CityC BigGuy Lvl:346 [P:21 A:414 I:46] exp:8467980/11971600
    10:29:24 CityC Farmer1 Lvl:219 [P:14 A:288 I:25] exp:8049178/4796100
    10:29:24 CityC Farmer2 Lvl:213 [P:26 A:282 I:33] exp:9054832/4536900

PersuadeHero

Usage:

persuadehero hero

Example:

persuadehero Ken

Persuade the captured hero named Ken. The medals required for the persuasion, if any, are shown in the hero tab.

ReleaseHero

Usage:

releasehero heroName or herostring

Example:

releasehero Bob
releasehero any:level<100

Used to dismiss a captive hero from the feasting hall. This script command is compatible with hero strings.

For more information about what hero strings can be used with this command, check out HeroString.

RenameHero

Usage:

renamehero oldName newName

Example:

renamehero ken henry

Used to rename a hero. This script is identical to ChangeHeroName.

RewardHeroes

Usage:

rewardheroes

Example:

rewardheroes

Finds and rewards all heroes with loyalty below 100, using gold.

SetMayor

Usage:

setmayor attribute

Example:

setmayor pol

Valid Arguments:

  • att or atk or attack
    pol or politics
    int or intel or intelligence
    none or remove

This command will change your current mayor for one of the specified attributes or will demote the mayor completely. It automatically selects the highest level of the attribute that you specify. This is very useful when creating, upgrading and demolishing buildings via script, as you can specify the highest level politic hero you have to go into office. Capturing a npc10 and only have a level 9 Feasting hall in one city? You can remove the mayor with this command to make sure he marches with the rest of the troops.

examples:

  • // appoints highest politic hero to mayor
    setmayor pol
    
    // appoints highest attack hero to mayor
    setmayor att
    
    // appoints highest intel hero to mayor
    setmayor int
    
    // demotes current mayor
    setmayor remove
    setmayor none

SetMayorByName

Usage:

setMayorbyname HeroName

Example:

setMayorbyname Henry

This command will allow you to specify the Mayor you wish to assign by hero name.

UpLevelHeroes

Usage:

uplevelheroes

Example:

uplevelheroes

Upgrades all heroes in current city (unless named in the NoLevelHeroes goal). Each hero is upgraded only one level and its best attribute is increased. Config hero must be set to 1 or higher for this script to function.

UseHeroItem

Usage:

useheroitem heroname itemname

Example:

useheroitem BigGuy on war
useheroitem BigGuy anabasis
useheroitem BigGuy nation medal

Used to apply hero buff items and medals to the specified hero. NOTE: Cannot be applied to a captured hero.

WaitHero

Usage:

waithero hero

Example:

waithero ken
waithero any:attack>=200

This command will have the script wait until a specific hero or match for a hero-string is in the city and available. In the 1st example above, the script would wait until a hero named ken was available. In the 2nd example above, the script would wait until any hero with 200 or higher attack is available.

For more information about what hero strings can be used with this command, check out HeroString.

WaitHeroLost

Usage:

waitherolost hero1,hero2,...

Example:

waitherolost ken,henry

Pause script until one of the heroes specified is captured.

WaterHero

Usage:

waterhero heroName

Example:

waterhero BigGuy
waterhero Smarty /heropoints="att"

Used to apply holy water to a hero in the feasting hall. After the hero is watered, points will be reassigned automatically to the highest stat.

The following feature is available starting in NeatBot 3354T

You can also opt to water a hero into another type of hero, ie - take your politics hero to attack so that it can hit npc10s. The /heropoints switch will allow you to do this. The rules for the /heropoints switch are the same as for the HeroPoints goal. In the above example, you could water your (for instance) intel hero named Smarty and assign all points into attack. Here are some more examples:

  • // reassign all points to attack attribute
    waterhero billybob /heropoints="att"
    
    // increase both politics to 300 and intel to 100 (pro-rate if there is not enough points); then add the remaining points to attack attribute
    waterhero Robert1 /heropoints="pol:300,int:100 att"
    
    // increase politics to 300; increase intel to 100; add the remaining points to attack attribute
    waterhero Robert2 /heropoints="pol:300 int:100 att"


CategoryCommands

ScriptHero (last edited 2014-02-10 18:05:41 by Inanna)