This is an old revision of the document!


VilloNanny Strategy Manual

Available Strategies

FieldGrowth Increases the level of all fields
GrowItem Makes new buildings or increases the level of any field or building up to a given value
CapacityIncreaser Increases the level of the warehouse and/or the granary automatically when they get too full
RatedFieldGrowth Increases the field levels while keeping a given proportion between resources
Farmizzator Attacks, raids or spies enemy villages
ResourceSender Sends resources periodically
TroopMaker Trains troops
QuestSolver Completes the initial quests
CropFinder Looks for crops in the map
FarmRotator Attacks a group of villages in sequence
DestroyBuilding Demolishes a building
MultiFarmRotator Attacks nearby villages automatically
UpgradeTroop Upgrades troops

About Strategies

VilloNanny is built around the concept of “Strategy”: a strategy is a “plugin” that performs some actions. For example, a strategy can grow your crop, another strategy can attack a given village every hour, another strategy can send you an email when attacked. As you see, the meaning of “strategy” goes beyond the military term.

An important concept is that strategies are generally independent from one another and can be enabled only when needed. To enable a strategy, you modify the “configuration.xml” file and add a <strategy> tag inside a <village> tag. Any village can contain any number of strategies of any type… as long as it makes sense to you: it wouldn't be clever to insert a strategy to build the Palace and another one to destroy it!

Since VilloNanny v2.3.0 it is possible to run a strategy after another strategy has completed, or while another strategy has not completed yet (see below).

Syntax

A strategy tag has the following general form:

<strategy class="NAME" desc="DESCRIPTION" enabled="true" 
          runWhile="RUNWHILE_UID" waitFor="WAITFOR_UID" uid="UID">
    <SOMEPARAMETERS/>
</strategy>

There is also a shorter form for strategies without parameters:

<strategy class="NAME" desc="DESCRIPTION" enabled="true" 
          runWhile="RUNWHILE_UID" waitFor="WAITFOR_UID" uid="UID"/>

Notice how the tag is closed with a slash at the end.

Attributes and parameters

NAME specifies the name of the strategy
DESCRIPTION optional description: you can write anything you like to identify the purpose of the strategy
UID an alphanumeric string that uniquely identifies the strategy in the configuration file. It is mandatory, but if you forget about it the program will insert one for you at startup
WAITFOR_UID the uid of a strategy that must complete before this one starts
RUNWHILE_UID the uid of a strategy that must be active for this one to run

uid

You must ensure that all uid's are unique, so there must not be more than one uid=“xxx” with the same value for “xxx”. The value of a uid can be any alphanumeric string of any length, like:

uid="s23433"
uid="1"
uid="a"
uid="dog1"

When the program starts, it checks that all uid's are present and that they don't repeat. If some uid is missing, it will be added to the configuration file. A backup file will be created in such a case. The format of the configuration file will remain quite similar to the original, but not the same.

enabled

You can disable a strategy, without removing it from the configuration, by setting

enabled="false"

even while the program is running.

waitFor and runWhile

You can specify that a strategy can only start after another strategy is done for good. For example, start a UpgradeTroop only after the GrowItem for the barracks has reached the maxLevel. This is done with the “waitFor” attribute: you specify the uid of the strategy that must be executed before this one starts. You can also specify that a strategy must be active only if another one is still active. For example, you can run the ResourceSender while the GrowItem is running and make it automatically stop when the GrowItem has reached the maxLevel. This is done with the “runWhile” attribute: you specify the uid of the strategy that must be running for this one to be executed.

Examples

The following example shows two villages with different strategies:

<village desc="my village 01" enabled="true" uid="v342525">
    <url>http://speed.travian.com/dorf1.php?33455</url>
    <strategy class="FieldGrowth" desc="Grow Cheapest Field" enabled="true" uid="s552345"/>
</village>
<village desc="my village 02" enabled="true" uid="v329425">
    <url>http://speed.travian.com/dorf1.php?463435</url>
    <strategy class="RatedFieldGrowth" desc="Grow Half Crop" enabled="true" uid="s934823">
        <productionRate wood="10" clay="10" iron="10" crop="5"/>
    </strategy>
</village>

The following example shows one village with two strategies:

<village desc="my village 01" enabled="true" uid="v342525">
    <url>http://speed.travian.com/dorf1.php?33455</url>
    <strategy class="FieldGrowth" desc="Grow Cheapest Field" enabled="true" uid="s123435"/>
    <strategy class="RatedFieldGrowth" desc="Grow Half Crop" enabled="true" uid="s423512">
        <productionRate wood="10" clay="10" iron="10" crop="5"/>
    </strategy>
</village>


Personal Tools