User:Flixx/Configuration Specifications - Revision history

Flixx: /* Other, less important */

2013-09-10T15:59:09Z

‎Other, less important

Flixx: /* recruitment_level_pattern */

2013-09-10T15:58:09Z

‎recruitment_level_pattern

Flixx: /* recruitment_save_money */

2013-09-10T12:58:20Z

‎recruitment_save_money

Flixx: /* recruitment_diversity */

2013-09-10T12:36:14Z

‎recruitment_diversity

Flixx: /* recruitment-instructions */

2013-08-29T22:29:34Z

‎recruitment-instructions

Flixx: /* recruitment-instructions */

2013-08-29T16:08:11Z

‎recruitment-instructions

Flixx: /* recruitment-instructions */

2013-08-28T14:45:13Z

‎recruitment-instructions

Flixx: /* recruitment-instructions */

2013-08-27T13:57:05Z

‎recruitment-instructions

Flixx: /* recruitment-instructions */

2013-08-27T08:18:59Z

‎recruitment-instructions

Flixx: /* recruitment-instructions */

2013-08-25T22:19:14Z

‎recruitment-instructions

@@ Line 85: / Line 85: @@
 ==Other, less important==
-===recruitment_unit_threshold===
+===<strike>recruitment_unit_threshold</strike>===
   recruitment_unit_threshold = 5 (int)
 When the enemy has less then this much units, the AI will place fake units of all possible unit-types the enemy can recruit at the leaders location.
-===recruitment_combat_diversity===
+===<strike>recruitment_combat_diversity</strike>===
   recruitment_combat_diversity = 1. (positive double)
 Used for combat analysis.
@@ Line 98: / Line 98: @@
 ===recruitment_randomness===
-  recruitment_randomness = 5. (double)
+  recruitment_randomness = 15 (int)
 To each score a random value between 0 and <code>recruitment_randomness</code> will be added.

@@ Line 61: / Line 61: @@
 is possible to add 50.
-===recruitment_level_pattern===
+===<strike>recruitment_level_pattern</strike>===
   recruitment_level_pattern = "0111223" (string)
 ''unseparated list of numbers (levels)''

@@ Line 68: / Line 68: @@
 '''recruitment_level_pattern will internally expand to a recruitment-instruction (see above)'''
-===recruitment_save_money===
+===recruitment_save_gold===
-  recruitment_save_money = no (boolean)
+  recruitment_save_gold = no (boolean)
 When this flag is activated the AI will not always recruit when money is available.
 The AI will always keep track of the ratio <code>our_total_unit_costs / enemy_total_unit_costs</code>
 whereas the costs are the sum of the cost of all units on the map weighted by their HP.
 When this ratio is bigger then...
-  recruitment_save_money_begin = 1.0 (double)
+  recruitment_save_gold_begin = 1.0 (double)
 ...the AI will stop recruiting units until the ratio is less then...
-  recruitment_save_money_end = 0.7 (double)
+  recruitment_save_gold_end = 0.7 (double)
 This leads to wave-like recruiting. Also if the enemy hasn't recruited any units yet, the AI will only recruit a few units (with default begin/end usually one).
-  recruitment_spend_all_gold = 110 (int)
+  recruitment_spend_all_gold = -1 (int)
 Only important when recruitment_save_money=yes.
-When the AI have earned this much gold, the AI will start spending all money to start a big offensive wave.
+When the AI have earned this much gold, the AI will start spending all money to start a big offensive wave. If recruitment_spend_all_gold is -1, this value will be set to the AIs start gold + 1.
 ==Other, less important==

@@ Line 48: / Line 48: @@
 ===recruitment_diversity===
-  recruitment_diversity = 0.2 (double)
+  recruitment_diversity = 1.0 (double)
 When this value is high, the AI will recruit more units which are currently rare on the map.
-(<code>recruitment_diversity * 50</code> will be added to each score)
+(<code>recruitment_diversity * 25</code> will be added to each score)
 ===recruitment_more===

@@ Line 33: / Line 33: @@
 * '''total=no: (boolean)''' Sometimes it could be useful to define how many units of one type should be on the map. When total is set to ''yes'' the AI will count the own units on the map and will then recruit the difference between ''number'' and the counted amount.
 * '''blocker=yes: (boolean)''' If set to ''yes'', the AI will stop recruiting when this job cannot be done (because the wished leader is not on a keep for example). If set to ''no'' the AI will skip this job and continue with less important ones.
 Notes:

@@ Line 11: / Line 11: @@
   [ai]
     [aspect]
-      id=recruitment-instructuions
+      id=recruitment-instructions
       [facet]
         turns=1,2

@@ Line 30: / Line 30: @@
 * '''turns="": (string)''' Outside [recruit]. This key takes a comma separated list containing number specifying the turn. '-' can be used between two values to define a range. A empty String means ''all turns''.
 * '''importance=1: (integer)''' The importance of a recruitment tells the AI to firstly recruit units with the highest importance. If gold is lacking or the castle is full, only the most important units will be recruited, the other will be dropped. This is useful when we want to do something like "recruit 3 scouts and if there is still money left recruit fighters".
-* '''leader_id="": (string)''' If the AI plays with multiple leaders who can recruit we may target only one of them. Empty sting means ''all leaders''.
+* '''leader_id="": (string)''' If the AI plays with multiple leaders who can recruit we may target only one of them. Empty sting means ''all leaders''. (Note: Because of current implementation, leader_id is only a recommendation for the AI. If the specified leader has no free hexes the AI will use other leaders to do the job)
 * '''total=no: (boolean)''' Sometimes it could be useful to define how many units of one type should be on the map. When total is set to ''yes'' the AI will count the own units on the map and will then recruit the difference between ''number'' and the counted amount.
 * '''blocker=yes: (boolean)''' If set to ''yes'', the AI will stop recruiting when this job cannot be done (because the wished leader is not on a keep for example). If set to ''no'' the AI will skip this job and continue with less important ones.

@@ Line 14: / Line 14: @@
       [facet]
         turns=1,2
-        [recruit]
+        [value]
-         type=scout
+         [recruit]
-         number=2
+           type=scout
-        [/recruit]
+           number=2
       [/facet]
     [/aspect]

@@ Line 35: / Line 35: @@
 * By default when recruitment is specified for a turn, the AI will not recruit any other unit. (So if we say recruit 1 scout in turn 1 then the ai will only recruit 1 scout and not more). To prevent this behavior one can do this:
   [recruit]
      importance=0
   [/recruit]