AITriggerTypes - Revision history

MarkJFox: 17 revisions imported

2025-03-31T19:34:45Z

17 revisions imported

← Older revision	Revision as of 21:34, 31 March 2025
(No difference)

en>Crimsonum: Removed unverified information.

2024-06-23T21:48:15Z

Removed unverified information.

← Older revision		Revision as of 23:48, 23 June 2024
Line 130:		Line 130:
	AI Triggers are given "weights" to define how important they are. Larger weight makes the AI Trigger more likely to get selected.		AI Triggers are given "weights" to define how important they are. Larger weight makes the AI Trigger more likely to get selected.

	Each time an AI controlled team is ~~checked* or~~ dissolved (when they complete their script or are destroyed), all AI Triggers using that TeamType as their primary ({{Tt\|Team1}}) get their weight modified:		Each time an AI controlled team is dissolved (when they complete their script or are destroyed), all AI Triggers using that TeamType as their primary ({{Tt\|Team1}}) get their weight modified:
	;if the Team has executed a [[ScriptTypes/ScriptActions#action_49\|Script Action 49, 0]] in this lifetime,		;if the Team has executed a [[ScriptTypes/ScriptActions#action_49\|Script Action 49, 0]] in this lifetime,
	:{{sl\|General\|AITriggerSuccessWeightDelta}} is added to its weight,		:{{sl\|General\|AITriggerSuccessWeightDelta}} is added to its weight,
Line 136:		Line 136:
	:{{sl\|General\|AITriggerFailureWeightDelta}} multiplied by {{sl\|General\|AITriggerTrackRecordCoefficient}} (the former is usually negative) is added.		:{{sl\|General\|AITriggerFailureWeightDelta}} multiplied by {{sl\|General\|AITriggerTrackRecordCoefficient}} (the former is usually negative) is added.
	Care is taken not to push the weight outside the limits set by MinimumWeight and MaximumWeight while doing so.		Care is taken not to push the weight outside the limits set by MinimumWeight and MaximumWeight while doing so.

	<nowiki>*</nowiki>'''Note:''' Testing suggests that an AI trigger is also considered to have "failed" if its team has not yet executed the aforementioned script action, even if the team is still in play. It seems this check is performed multiple times during the team's lifetime, possibly every time the computer [[TeamDelays\|checks available and existing teams]].

	=== Special Values ===		=== Special Values ===

en>Crimsonum: Weights are a flawed design

2024-06-23T14:25:14Z

Weights are a flawed design

← Older revision		Revision as of 16:25, 23 June 2024
Line 147:		Line 147:
	==== Weight 5000 ====		==== Weight 5000 ====
	In {{ra2}} and {{yr}}, <span id="weight_5000">A Weight equivalent to {{Tt\|5000.0}}</span> stands for "ignore all other AI Triggers and fire this one immediately, if its condition is met". It is originally used for Teams utilising minor SuperWeapons, the Iron Curtain or the ChronoSphere.		In {{ra2}} and {{yr}}, <span id="weight_5000">A Weight equivalent to {{Tt\|5000.0}}</span> stands for "ignore all other AI Triggers and fire this one immediately, if its condition is met". It is originally used for Teams utilising minor SuperWeapons, the Iron Curtain or the ChronoSphere.

			=== Flawed Design ===

			In the unmodified games, AI teams are typically configured to succeed after attacking a specific category of enemy targets ([[QuarryTypes\|a quarry]]). Unfortunately, this attack mission, [[ScriptTypes/ScriptActions\|{{tt\|#0 Attack...}}]], is only completed once ''all'' enemy objects matching the given quarry are destroyed. This means every such attack team has a slim to none chance of actually succeeding in its mission, causing their respective AI triggers to lose weight over time. The end result of this flawed design is that the production chances of AI triggers are almost entirely governed by their initial and minimum weights.

	== Global and Local ==		== Global and Local ==

en>Crimsonum: Results from testing

2024-06-23T14:09:12Z

Results from testing

← Older revision		Revision as of 16:09, 23 June 2024
Line 130:		Line 130:
	AI Triggers are given "weights" to define how important they are. Larger weight makes the AI Trigger more likely to get selected.		AI Triggers are given "weights" to define how important they are. Larger weight makes the AI Trigger more likely to get selected.

	Each time an AI controlled team is dissolved (when they complete their script or are destroyed), all AI Triggers using that TeamType as their primary ({{Tt\|Team1}}) get their weight modified:		Each time an AI controlled team is checked* or dissolved (when they complete their script or are destroyed), all AI Triggers using that TeamType as their primary ({{Tt\|Team1}}) get their weight modified:
	;if the Team has executed a [[ScriptTypes/ScriptActions#action_49\|Script Action 49, 0]] in this lifetime,		;if the Team has executed a [[ScriptTypes/ScriptActions#action_49\|Script Action 49, 0]] in this lifetime,
	:{{sl\|General\|AITriggerSuccessWeightDelta}} is added to its weight,		:{{sl\|General\|AITriggerSuccessWeightDelta}} is added to its weight,
Line 136:		Line 136:
	:{{sl\|General\|AITriggerFailureWeightDelta}} multiplied by {{sl\|General\|AITriggerTrackRecordCoefficient}} (the former is usually negative) is added.		:{{sl\|General\|AITriggerFailureWeightDelta}} multiplied by {{sl\|General\|AITriggerTrackRecordCoefficient}} (the former is usually negative) is added.
	Care is taken not to push the weight outside the limits set by MinimumWeight and MaximumWeight while doing so.		Care is taken not to push the weight outside the limits set by MinimumWeight and MaximumWeight while doing so.

			<nowiki>*</nowiki>'''Note:''' Testing suggests that an AI trigger is also considered to have "failed" if its team has not yet executed the aforementioned script action, even if the team is still in play. It seems this check is performed multiple times during the team's lifetime, possibly every time the computer [[TeamDelays\|checks available and existing teams]].

	=== Special Values ===		=== Special Values ===

en>Crimsonum: Information about special weight values

2024-06-23T13:58:03Z

Information about special weight values

← Older revision		Revision as of 15:58, 23 June 2024
Line 130:		Line 130:
	AI Triggers are given "weights" to define how important they are. Larger weight makes the AI Trigger more likely to get selected.		AI Triggers are given "weights" to define how important they are. Larger weight makes the AI Trigger more likely to get selected.

	Each time an AI controlled ~~TeamType~~ is dissolved (when they complete their ~~ScriptType~~ or are destroyed), all AI Triggers using that TeamType as their primary ({{Tt\|Team1}}) get their weight modified:		Each time an AI controlled team is dissolved (when they complete their script or are destroyed), all AI Triggers using that TeamType as their primary ({{Tt\|Team1}}) get their weight modified:
	;if the Team has executed a [[ScriptTypes/ScriptActions#action_49\|Script Action 49, 0]] in this lifetime,		;if the Team has executed a [[ScriptTypes/ScriptActions#action_49\|Script Action 49, 0]] in this lifetime,
	:{{sl\|General\|AITriggerSuccessWeightDelta}} is added to its weight,		:{{sl\|General\|AITriggerSuccessWeightDelta}} is added to its weight,
Line 137:		Line 137:
	Care is taken not to push the weight outside the limits set by MinimumWeight and MaximumWeight while doing so.		Care is taken not to push the weight outside the limits set by MinimumWeight and MaximumWeight while doing so.

	<span id="weight_5000">A Weight equivalent to {{Tt\|5000.0}}</span> stands for "ignore all other AI Triggers and fire this one immediately, if its condition is met". It is originally used for Teams utilising minor SuperWeapons, the Iron Curtain or the ChronoSphere.		=== Special Values ===

			==== Weight 0 ====

			If an AI trigger's weight drops to zero, it will not be considered for production. This can be used to remove certain AI triggers from play for the rest of the game if they fail too many times.

			==== Weight 5000 ====
			In {{ra2}} and {{yr}}, <span id="weight_5000">A Weight equivalent to {{Tt\|5000.0}}</span> stands for "ignore all other AI Triggers and fire this one immediately, if its condition is met". It is originally used for Teams utilising minor SuperWeapons, the Iron Curtain or the ChronoSphere.

	== Global and Local ==		== Global and Local ==

en>Crimsonum: Updated "Side" param info

2024-01-30T21:15:07Z

Updated "Side" param info

← Older revision		Revision as of 23:15, 30 January 2024
Line 34:		Line 34:
	\|-		\|-
	! {{Anchor\|OwnerHouse\|}}		! {{Anchor\|OwnerHouse\|}}
	\| The [[Countries\|Country]] that should use this AI Trigger. Defaults to {{Tt\|<none>}}, can be set to an individual country's name or to {{Tt\|<all>}}, indicating that all countries of the appropriate Side can use this AI Trigger.		\| The [[House]]/[[Countries\|Country]] that should use this AI Trigger. Defaults to {{Tt\|<none>}}, can be set to an individual house/country's name or to {{Tt\|<all>}}, indicating that all houses/countries of the appropriate Side can use this AI Trigger.
	\|-		\|-
	! {{Anchor\|TechLevel\|}}		! {{Anchor\|TechLevel\|}}
Line 99:		Line 99:
	\|-		\|-
	! {{anchor\|Side\|}}		! {{anchor\|Side\|}}
	\| Indicates the [[Sides\|Side]] that may use this AI Trigger. {{Tt\|0}} stands for "all sides", positive values indicate the owning side - Allied, Soviet, Yuri, ... .		\| Indicates the [[Sides\|Side]] that may use this AI Trigger. {{Tt\|0}} stands for "all sides", positive values indicate the owning side - Allied, Soviet, Yuri, etc.

			Note that in {{ts}}, this refers to the {{f\|ActsLike\|link}} setting of a [[house]], incremented by one. For example, if this value is {{Tt\|1}}, the AI Trigger is applicable to any houses with {{f\|ActsLike\|0}}. If this value is {{Tt\|2}}, it is applicable to houses with {{f\|ActsLike\|1}}. And so on.
	\|-		\|-
	! {{Anchor\|IsBaseDefense\|}}		! {{Anchor\|IsBaseDefense\|}}

en>E1 Elite at 11:48, 11 March 2023

2023-03-11T11:48:10Z

← Older revision		Revision as of 13:48, 11 March 2023
Line 118:		Line 118:

	== Condition check segment examples ==		== Condition check segment examples ==
	For simplicity only the segments of [[#ConditionType\|ConditionType]], [[#ComparisonObject\|ComparisonObject]] and first octet (amount) and second octet ([[#Comparator\|Comparator]]) are shown. An octet consists of 8 bytes~~, 2 bytes form a word here~~. Values are in hexadecimal and represented in little endian format. For a decimal value of 3, its hex value is 0x3, its octet representation becomes 03000000. For a decimal value of 500, its hex value is 0x1F4, its octet representation becomes F4010000.		For simplicity only the segments of [[#ConditionType\|ConditionType]], [[#ComparisonObject\|ComparisonObject]] and first octet (amount) and second octet ([[#Comparator\|Comparator]]) are shown. An octet consists of 8 hex digits (4 bytes). Values are in hexadecimal and represented in little endian format. For a decimal value of 3, its hex value is 0x3, its octet representation becomes 03000000. For a decimal value of 500, its hex value is 0x1F4, its octet representation becomes F4010000.
	<pre>-1,<none>,0000000000000000 - no condition check, always true. TechType and the two octets are irrelevant and can hold any valid values.		<pre>-1,<none>,0000000000000000 - no condition check, always true. TechType and the two octets are irrelevant and can hold any valid values.
	0,GAREFN,0400000003000000 - when AI's enemy owns greater or equal to 4 allied ore refineries.		0,GAREFN,0400000003000000 - when AI's enemy owns greater or equal to 4 allied ore refineries.

en>Brsajo: Clarity

2023-01-15T13:47:51Z

Clarity

← Older revision		Revision as of 15:47, 15 January 2023
Line 37:		Line 37:
	\|-		\|-
	! {{Anchor\|TechLevel\|}}		! {{Anchor\|TechLevel\|}}
	\| Minimum [[TechLevel]] required for this AI Trigger. Is recalculated internally to be the minimum TechLevel required to build all the units in this AI Trigger's first and second TeamTypes.		\| Minimum [[TechLevel]] (as in [[MultiplayerDialogSettings]]) required for this AI Trigger. Is recalculated internally to be the minimum TechLevel required to build all the units in this AI Trigger's first and second TeamTypes.
	\|-		\|-
	! {{Anchor\|ConditionType\|}}		! {{Anchor\|ConditionType\|}}

en>Crimsonum at 17:04, 20 June 2022

2022-06-20T17:04:02Z

← Older revision		Revision as of 19:04, 20 June 2022
Line 5:		Line 5:

	== Format ==		== Format ==
	{{HorizontalBar\|{{W}} This section is provided here mostly for completeness' sake. Editing this section, especially the comparator part, manually is not advised unless you really know what you are doing. Consider using [[FinalAlert 2]]'s AI Editor ~~or DCoder's [[AI Editor V2]]~~ instead.}}		{{HorizontalBar\|{{W}} This section is provided here mostly for completeness' sake. Editing this section, especially the comparator part, manually is not advised unless you really know what you are doing. Consider using [[C&C AI Editor]] or [[FinalAlert 2]]'s AI Editor instead.}}

	This section uses a convoluted and complex data format:		This section uses a convoluted and complex data format:

en>Crimsonum: Better formatting.

2022-06-20T16:28:45Z

Better formatting.

← Older revision		Revision as of 18:28, 20 June 2022
Line 8:		Line 8:

	This section uses a convoluted and complex data format:		This section uses a convoluted and complex data format:
	[AITriggerTypes]		<pre style="overflow: auto; white-space: pre;">
	;format example		[AITriggerTypes]
	ID=Name,Team1,OwnerHouse,TechLevel,ConditionType,ConditionObject,Comparator,StartingWeight,MinimumWeight,MaximumWeight,IsForSkirmish,unused,Side,IsBaseDefense,Team2,EnabledInE,EnabledInM,EnabledInH		;format example
			ID=Name,Team1,OwnerHouse,TechLevel,ConditionType,ConditionObject,Comparator,StartingWeight,MinimumWeight,MaximumWeight,IsForSkirmish,unused,Side,IsBaseDefense,Team2,EnabledInE,EnabledInM,EnabledInH

	~~;actual example triggers~~
	~~0CAD0C7C-G=Allied Anti-Weather,0A6E513C-G,<all>,9,0,GAWEAT,0100000003000000000000000000000000000000000000000000000000000000,70.000000,10.000000,70.000000,1,0,1,0,0CB246CC-G,0,1,1~~
	~~0D535EDC-G=Nation German Tank 1,0A87293C-G,Germans,2,4,<none>,0000000003000000000000000000000000000000000000000000000000000000,500.000000,10.000000,500.000000,1,0,1,0,<none>,1,1,1~~
	~~0D2769BC-G=Soviet Iron Curtain Easy,0D27E06C-G,<all>,2,5,<none>,0000000000000000000000000000000000000000000000000000000000000000,5000.000000,10.000000,5000.000000,1,0,2,0,<none>,1,0,0~~
	~~08B9767C-G=Yuri Capture Oil,08B97B3C-G,<all>,1,7,CAOILD,0100000003000000000000000000000000000000000000000000000000000000,70.000000,10.000000,70.000000,1,0,3,0,<none>,0,1,1~~

			;actual example triggers
			0CAD0C7C-G=Allied Anti-Weather,0A6E513C-G,<all>,9,0,GAWEAT,0100000003000000000000000000000000000000000000000000000000000000,70.000000,10.000000,70.000000,1,0,1,0,0CB246CC-G,0,1,1
			0D535EDC-G=Nation German Tank 1,0A87293C-G,Germans,2,4,<none>,0000000003000000000000000000000000000000000000000000000000000000,500.000000,10.000000,500.000000,1,0,1,0,<none>,1,1,1
			0D2769BC-G=Soviet Iron Curtain Easy,0D27E06C-G,<all>,2,5,<none>,0000000000000000000000000000000000000000000000000000000000000000,5000.000000,10.000000,5000.000000,1,0,2,0,<none>,1,0,0
			08B9767C-G=Yuri Capture Oil,08B97B3C-G,<all>,1,7,CAOILD,0100000003000000000000000000000000000000000000000000000000000000,70.000000,10.000000,70.000000,1,0,3,0,<none>,0,1,1
			</pre>
	{\| style="width: 90%" border=1 class="table_descrowdesccol"		{\| style="width: 90%" border=1 class="table_descrowdesccol"
	\|+ Meanings of each string		\|+ Meanings of each string