====== Strategy: RatedFieldGrowth ======

^Purpose  |to increase the field levels while keeping a given proportion between resources  |
^When to use  |when you need some resources less than others  |
^When to avoid  |when you want to grow your village in the quickest possible way and your resource fields are balanced  |

The RatedFieldGrowth strategy will try to grow the fields while keeping the given proportion between resources. After a run, the strategy will be called again when the field level has been completed, when the needed resources have become available or after "checkTimeMinutes" has passed since the last check, whatever comes first. It is a good idea not to use a very short "checkTimeMinutes" value otherwise the nanny will hopelessly keep checking the fields while something is still growing or resources aren't available.

From version 2.3.0 there is an optional new parameter at top level sets max level for any field, once reached this field type will no longer be grown but others will so rate difference will not be maintained.

Individual resource types can have different maximums using an optional parameter line to specify individual types.

**Notes:**

  * The production rate doesn't have to be an integer, so you could use "0.5" or "1.27"

==== Syntax ====
<code xml>
<strategy class="RatedFieldGrowth" desc="DESCRIPTION" enabled="true" maxLevel="LEVEL"
          runWhile="RUNWHILE_UID" waitFor="WAITFOR_UID" uid="UID">
	<productionRate wood="WOOD_RATE" clay="CLAY_RATE" iron="IRON_RATE" 
    	crop="CROP_RATE" checkTimeMinutes="CHECKTIME"/>
       <whileProductionBelow wood="RES_PROD" clay="RES_PROD" crop="RES_PROD"/>
        <maxLevel RESTYPE="RESLEVEL" RESTYPE="RESLEVEL" />
</strategy>
</code>

==== Attributes and parameters ====

|DESCRIPTION  |some optional description of your choice  |
|WAITFOR_UID  |See [[index|"Strategies"]]  |
|RUNWHILE_UID  |See [[index|"Strategies"]]  |
|UID  |Unique IDentifier. See [[index|"Strategies"]]  |
|WOOD_RATE, CLAY_RATE, IRON_RATE, CROP_RATE  |resource proportion  |
|CHECKTIME  |sleep timeout  |
|RES_PROD |the production rate for one of the resource types, strategy will finish when reached  |
|LEVEL  |the maximum level to grow fields to, when reached the strategy will finish - default 999  |
|RESTYPE  |one of "clay"/"wood"/"iron"/"crop" |
|RESLEVEL  |the maximum level to grow individual resource field to - default LEVEL  |


==== Examples ====
<code xml>
<strategy class="RatedFieldGrowth" desc="Half Crop" enabled="true" uid="s9283">
	<productionRate wood="2" clay="2" iron="2" crop="1" 
    	checkTimeMinutes="240"/>
        <whileProductionBelow clay="1000" />
</strategy>
</code>

The example below grows WOOD and CLAY to level 9 but limits iron to 6 and crop to 5 which is the level at which a Grain Mill can be constructed.

<code xml>
<strategy class="RatedFieldGrowth" desc="Finetuned growth" enabled="true" uid="s2200" maxLevel="9">
	<productionRate wood="50" clay="65" iron="40" crop="35" 
    	checkTimeMinutes="180"/>
       <maxLevel iron="6" crop="5" />
</strategy>
</code>