AiWML - Revision history

Shiki: /* See Also */ link to AI recruitment

2026-10-28T09:59:36Z

Egallager: /* Filtering Combat with the attacks Aspect */ make "See Also" its own section

2024-10-21T06:38:03Z

Filtering Combat with the attacks Aspect: make "See Also" its own section

← Older revision		Revision as of 06:38, 21 October 2024
Line 331:		Line 331:
	</syntaxhighlight>		</syntaxhighlight>

			== See Also ==
			* [[Wesnoth AI]]
			* [[ReferenceWML]]

	~~'''See also:''' [[Wesnoth AI]]~~
	[[Category: WML Reference]]		[[Category: WML Reference]]
	[[Category:AI]]		[[Category:AI]]

Celtic Minstrel: /* List of AI Aspects */ fix template

2024-02-25T01:32:10Z

List of AI Aspects: fix template

← Older revision		Revision as of 01:32, 25 February 2024
Line 115:		Line 115:
	*{{anchor\|retreat_factor\|'''retreat_factor'''}}=0.25 (double) {{DevFeature1.15\|11}} Affects ''retreat-injured'' CA only. Determines how injured AI units have to be before they attempt retreating. This is approximately the fraction of the units' hitpoints, but other factors play a role also, such as the terrain the units are on, and leaders and poisoned units retreat somewhat earlier. Setting this to 0 (or negative values) disables retreating. Note that even setting this to very large values still requires units to be somewhat injured before they start retreating.		*{{anchor\|retreat_factor\|'''retreat_factor'''}}=0.25 (double) {{DevFeature1.15\|11}} Affects ''retreat-injured'' CA only. Determines how injured AI units have to be before they attempt retreating. This is approximately the fraction of the units' hitpoints, but other factors play a role also, such as the terrain the units are on, and leaders and poisoned units retreat somewhat earlier. Setting this to 0 (or negative values) disables retreating. Note that even setting this to very large values still requires units to be somewhat injured before they start retreating.

	*{{~~anchor_retreat_enemy_weight~~\|'''retreat_enemy_weight'''}}=1.0 (double) {{DevFeature1.15\|11}} Affects ''retreat-injured'' CA only. When deciding where to retreat to, the AI considers how much healing a location provides and weighs it against the threat of all the enemies that can get there (balanced by the own units that can get there). In this evaluation, it multiplies the enemy threat rating by ''retreat_enemy_weight'', meaning that the larger its value is, the more a unit tries to move away from enemies. There are three regimes for this aspect:		*{{anchor\|retreat_enemy_weight\|'''retreat_enemy_weight'''}}=1.0 (double) {{DevFeature1.15\|11}} Affects ''retreat-injured'' CA only. When deciding where to retreat to, the AI considers how much healing a location provides and weighs it against the threat of all the enemies that can get there (balanced by the own units that can get there). In this evaluation, it multiplies the enemy threat rating by ''retreat_enemy_weight'', meaning that the larger its value is, the more a unit tries to move away from enemies. There are three regimes for this aspect:
	** Positive values: Only locations that provide healing (both from terrain and from adjacent healers which have no MP left) are considered. For regenerating units, all hexes are treated as if they provide healing.		** Positive values: Only locations that provide healing (both from terrain and from adjacent healers which have no MP left) are considered. For regenerating units, all hexes are treated as if they provide healing.
	** Zero: Enemy threats are ignored		** Zero: Enemy threats are ignored

Celtic Minstrel: /* List of AI Aspects */ Add anchors for other pages to link to

2024-02-25T01:31:16Z

List of AI Aspects: Add anchors for other pages to link to

Show changes

Mattsc: /* List of AI Aspects */ add allow_ally_villages aspect

2022-06-22T23:20:03Z

List of AI Aspects: add allow_ally_villages aspect

← Older revision		Revision as of 23:20, 22 June 2022
Line 64:		Line 64:
	*** The rating for damage received in an attack actually becomes a positive contribution to the score for values of aggression larger than 1. This usually does not result in sensible behavior and values greater than 1 should therefore not be used.		*** The rating for damage received in an attack actually becomes a positive contribution to the score for values of aggression larger than 1. This usually does not result in sensible behavior and values greater than 1 should therefore not be used.
	** Note: ''aggression'' is always set to 1.0 for attacks on units that pose a direct threat to the AI's leader. Currently this only means units adjacent to the leader.		** Note: ''aggression'' is always set to 1.0 for attacks on units that pose a direct threat to the AI's leader. Currently this only means units adjacent to the leader.

			*'''allow_ally_villages'''=no (bool) {{DevFeature1.17\|6}} Affects ''retreat-injured'' CA only. Normally, the AI is not allowed to take villages from an ally. If this is set to 'yes', the AI may retreat injured units to allied villages (and thereby capture them).

	*'''[attacks]''': Filters the units considered for combat, both on the AI and the enemy sides. Applies to the ''combat'', ''high_xp_attacks'' and ''spread_poison'' CAs only. It cannot be set in the same way as the other aspects and is therefore described in a [[#Filtering_Combat_with_the_attacks_Aspect\|separate section]] below.		*'''[attacks]''': Filters the units considered for combat, both on the AI and the enemy sides. Applies to the ''combat'', ''high_xp_attacks'' and ''spread_poison'' CAs only. It cannot be set in the same way as the other aspects and is therefore described in a [[#Filtering_Combat_with_the_attacks_Aspect\|separate section]] below.

Mattsc: /* The [goal] Tag */ add id=

2022-06-13T02:39:01Z

The [goal] Tag: add id=

← Older revision		Revision as of 02:39, 13 June 2022
Line 163:		Line 163:

	* '''protect_radius'''=20: (int) The protection radius. Applies to ''protect_location'', ''protect_unit'' and ''protect_my_unit''.		* '''protect_radius'''=20: (int) The protection radius. Applies to ''protect_location'', ''protect_unit'' and ''protect_my_unit''.

			* '''id'''="": (string) Optional ID used for [[Modifying_AI_Components#Modifying_Goals\|modifying the goal]].

	===Examples of [goal] Tag Usage===		===Examples of [goal] Tag Usage===

Mattsc: /* Removed AI Aspects */ attack_depth is removed also

2021-06-30T14:00:13Z

Removed AI Aspects: attack_depth is removed also

← Older revision		Revision as of 14:00, 30 June 2021
Line 130:		Line 130:
	=== Removed AI Aspects ===		=== Removed AI Aspects ===

	The following AI parameters (aspects) can still be set, their values can be retrieved, and they can be viewed in the gamestate inspector dialog, but they do not have an effect in the RCA AI code any more. Some other parameters will also likely be removed in the future. We will update this list accordingly. {{DevFeature1.13\|5}} Except for attack_depth, these have now all been removed.		The following AI parameters (aspects) can still be set, their values can be retrieved, and they can be viewed in the gamestate inspector dialog, but they do not have an effect in the RCA AI code any more. Some other parameters will also likely be removed in the future. We will update this list accordingly. {{DevFeature1.13\|5}} Except for attack_depth, these have now all been removed. {{DevFeature1.15\|0}} attack_depth is now removed as well.

	* '''attack_depth'''=5: (int)		* '''attack_depth'''=5: (int)

Egallager: /* Customizing the Default AI Using WML */ more links to related pages

2021-04-25T01:58:21Z

Customizing the Default AI Using WML: more links to related pages

← Older revision		Revision as of 01:58, 25 April 2021
Line 9:		Line 9:
	* Instructions for setting them up at the beginning of the scenario in a [side] tag		* Instructions for setting them up at the beginning of the scenario in a [side] tag

	This page does not contain:		This page does '''not''' contain:
	* Instructions for [[LuaAI#Dynamic_Lua_Aspects\|setting up aspects dynamically using Lua]].		* Instructions for [[LuaAI#Dynamic_Lua_Aspects\|setting up aspects dynamically using Lua]].
	* Instructions for [[Modifying_AI_Components#Modifying_Standard_Aspects\|changing aspects and goals mid scenario]], although for many of them (for example, for all [[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects\|standard aspects]]) the methods are almost identical		* Instructions for [[Modifying_AI_Components#Modifying_Standard_Aspects\|changing aspects and goals mid scenario]], although for many of them (for example, for all [[Wesnoth_AI_Framework#The_.5Bai.5D_Tag_.E2.80.94_Aspects\|standard aspects]]) the methods are almost identical
	* Instructions for some of the [[Modifying_AI_Components\|more complex AI customization tasks]].		* Instructions for some of the [[Modifying_AI_Components\|more complex AI customization tasks]].
			* Anything about [[Micro_AIs\|MicroAIs]]
			* [[AI_Recruitment\|Advanced recruitment details]]

	== Defining Aspects and Goals of the RCA AI ==		== Defining Aspects and Goals of the RCA AI ==

Mattsc: /* List of AI Aspects */ Minor wording update to retreat aspects

2021-02-27T16:41:04Z

List of AI Aspects: Minor wording update to retreat aspects

← Older revision		Revision as of 16:41, 27 February 2021
Line 109:		Line 109:
	*'''recruitment_diversity''', '''recruitment_instructions''', '''recruitment_more''', '''recruitment_pattern''', '''recruitment_randomness''', '''recruitment_save_gold''': These aspects can be used to customize recruiting with the new recruitment CA introduced in Wesnoth 1.11. They are described on a [[AI_Recruitment\|separate page]].		*'''recruitment_diversity''', '''recruitment_instructions''', '''recruitment_more''', '''recruitment_pattern''', '''recruitment_randomness''', '''recruitment_save_gold''': These aspects can be used to customize recruiting with the new recruitment CA introduced in Wesnoth 1.11. They are described on a [[AI_Recruitment\|separate page]].

	*'''retreat_factor'''=0.25 (double) {{DevFeature1.15\|11}} Determines how injured AI units have to be before they attempt retreating. This is approximately the fraction of the units' hitpoints, but other factors play a role also, such as the terrain the units are on, and leaders and poisoned units retreat somewhat earlier. Setting this to 0 (or negative values) disables retreating. Note that even setting this to very large values still requires units to be somewhat injured before they start retreating~~. Affects ''retreat-injured'' CA only~~.		*'''retreat_factor'''=0.25 (double) {{DevFeature1.15\|11}} Affects ''retreat-injured'' CA only. Determines how injured AI units have to be before they attempt retreating. This is approximately the fraction of the units' hitpoints, but other factors play a role also, such as the terrain the units are on, and leaders and poisoned units retreat somewhat earlier. Setting this to 0 (or negative values) disables retreating. Note that even setting this to very large values still requires units to be somewhat injured before they start retreating.

	*'''retreat_enemy_weight'''=1.0 (double) {{DevFeature1.15\|11}} When deciding where to retreat to, the AI considers how much healing a location provides and weighs it against the threat of all the enemies that can get there (balanced by the own units that can get there). In this evaluation, it multiplies the enemy threat rating by ''retreat_enemy_weight'', meaning that the larger its value is, the more a unit tries to move away from enemies. There are three regimes for this aspect:		*'''retreat_enemy_weight'''=1.0 (double) {{DevFeature1.15\|11}} Affects ''retreat-injured'' CA only. When deciding where to retreat to, the AI considers how much healing a location provides and weighs it against the threat of all the enemies that can get there (balanced by the own units that can get there). In this evaluation, it multiplies the enemy threat rating by ''retreat_enemy_weight'', meaning that the larger its value is, the more a unit tries to move away from enemies. There are three regimes for this aspect:
	** Positive values: Only locations that provide healing (both from terrain and from adjacent healers which have no MP left) are considered. For regenerating units, all hexes are treated as if they provide healing.		** Positive values: Only locations that provide healing (both from terrain and from adjacent healers which have no MP left) are considered. For regenerating units, all hexes are treated as if they provide healing.
	** Zero: Enemy threats are ignored		** Zero: Enemy threats are ignored
	** Negative values: All hexes are considered for retreating. Thus, if very negative values are used (e.g. -100), this can be used to make units run away from enemies with little consideration for anything else.		** Negative values: All hexes are considered for retreating. The enemy threat rating is multiplied by the absolute value of the aspect value. Thus, if very negative values are used (e.g. -100), this can be used to make units run away from enemies with little consideration for anything else.
	~~Affects ''retreat-injured'' CA only~~.

	* '''scout_village_targeting'''=3: (double) The AI multiplies the value of village [[#AI_Targets_and_Goals\|targets]] for scouts by this value. Affects ''move-to-targets'' CA only.		* '''scout_village_targeting'''=3: (double) The AI multiplies the value of village [[#AI_Targets_and_Goals\|targets]] for scouts by this value. Affects ''move-to-targets'' CA only.

Mattsc: /* List of AI Aspects */ add retreat_factor and retreat_enemy_weight aspects

2021-02-27T16:35:27Z

List of AI Aspects: add retreat_factor and retreat_enemy_weight aspects

← Older revision		Revision as of 16:35, 27 February 2021
Line 70:		Line 70:

	* '''caution'''=0.25: (double) Defines how cautious the AI is in several ways. It determines whether the leader should move toward [leader_goal], if attacks are worth moving onto less favorable terrain, whether units should retreat, and whether the AI should move units toward targets individually, as groups or not at all. Affects several CAs (listed in the order of their [[RCA_AI#The_Candidate_Actions_.28CAs.29_of_the_main_loop_Stage_in_the_RCA_AI\|evaluation scores]]):		* '''caution'''=0.25: (double) Defines how cautious the AI is in several ways. It determines whether the leader should move toward [leader_goal], if attacks are worth moving onto less favorable terrain, whether units should retreat, and whether the AI should move units toward targets individually, as groups or not at all. Affects several CAs (listed in the order of their [[RCA_AI#The_Candidate_Actions_.28CAs.29_of_the_main_loop_Stage_in_the_RCA_AI\|evaluation scores]]):
	** {{DevFeature1.15\|3}} ''Retreat-injured'' CA:
	*** Units only retreat if caution is greater than 0. Thus, this CA can be disabled simply by setting caution to zero or negative values.
	*** For a unit to be considered for retreating, its hitpoints need to be below a certain threshold that depends on the terrain the unit is on and its level. In addition, there is also a multiplier that depends (non-linearly) on caution. The higher the caution the higher the hitpoint threshold. Or in other words, units start retreating with more hitpoints left when caution is higher.
	** ''Move-leader-to-goals CA'': If ''max_risk'' is not set in [leader_goal], its default value is '1-caution'. This determines whether the leader takes the next step toward his goal. See description of [leader_goal].		** ''Move-leader-to-goals CA'': If ''max_risk'' is not set in [leader_goal], its default value is '1-caution'. This determines whether the leader takes the next step toward his goal. See description of [leader_goal].
	** ''Combat'' CA:		** ''Combat'' CA:
Line 111:		Line 108:

	*'''recruitment_diversity''', '''recruitment_instructions''', '''recruitment_more''', '''recruitment_pattern''', '''recruitment_randomness''', '''recruitment_save_gold''': These aspects can be used to customize recruiting with the new recruitment CA introduced in Wesnoth 1.11. They are described on a [[AI_Recruitment\|separate page]].		*'''recruitment_diversity''', '''recruitment_instructions''', '''recruitment_more''', '''recruitment_pattern''', '''recruitment_randomness''', '''recruitment_save_gold''': These aspects can be used to customize recruiting with the new recruitment CA introduced in Wesnoth 1.11. They are described on a [[AI_Recruitment\|separate page]].

			*'''retreat_factor'''=0.25 (double) {{DevFeature1.15\|11}} Determines how injured AI units have to be before they attempt retreating. This is approximately the fraction of the units' hitpoints, but other factors play a role also, such as the terrain the units are on, and leaders and poisoned units retreat somewhat earlier. Setting this to 0 (or negative values) disables retreating. Note that even setting this to very large values still requires units to be somewhat injured before they start retreating. Affects ''retreat-injured'' CA only.

			*'''retreat_enemy_weight'''=1.0 (double) {{DevFeature1.15\|11}} When deciding where to retreat to, the AI considers how much healing a location provides and weighs it against the threat of all the enemies that can get there (balanced by the own units that can get there). In this evaluation, it multiplies the enemy threat rating by ''retreat_enemy_weight'', meaning that the larger its value is, the more a unit tries to move away from enemies. There are three regimes for this aspect:
			** Positive values: Only locations that provide healing (both from terrain and from adjacent healers which have no MP left) are considered. For regenerating units, all hexes are treated as if they provide healing.
			** Zero: Enemy threats are ignored
			** Negative values: All hexes are considered for retreating. Thus, if very negative values are used (e.g. -100), this can be used to make units run away from enemies with little consideration for anything else.
			Affects ''retreat-injured'' CA only.

	* '''scout_village_targeting'''=3: (double) The AI multiplies the value of village [[#AI_Targets_and_Goals\|targets]] for scouts by this value. Affects ''move-to-targets'' CA only.		* '''scout_village_targeting'''=3: (double) The AI multiplies the value of village [[#AI_Targets_and_Goals\|targets]] for scouts by this value. Affects ''move-to-targets'' CA only.

← Older revision		Revision as of 09:59, 28 October 2026
Line 333:		Line 333:
	== See Also ==		== See Also ==
	* [[Wesnoth AI]]		* [[Wesnoth AI]]
			* [[AI Recruitment]]
	* [[ReferenceWML]]		* [[ReferenceWML]]

	[[Category: WML Reference]]		[[Category: WML Reference]]
	[[Category:AI]]		[[Category:AI]]