XComStrategyGame.UPK (EU2012) - Revision history

Hpoe: Fixed the previous edit that pointed to the incorrect links.

2023-04-25T17:47:46Z

Fixed the previous edit that pointed to the incorrect links.

← Older revision		Revision as of 17:47, 25 April 2023
Line 1:		Line 1:
	XComStrategyGame.UPK is a Unreal Engine 3 file used to determine several functions of [[XCOM: Enemy Unknown (2012)\|XCOM: Enemy Unknown]] related to the strategic layer of the game. XComStrategyGame.UPK is divided into several classes, each related to different aspects of the Geoscape/HQ view and described below. The contents of this file can be visualized using [http://eliotvu.com/portfolio/view/21/ue-explorer UE Explorer].		XComStrategyGame.UPK is a Unreal Engine 3 file used to determine several functions of [[XCOM: Enemy Unknown (2012)\|XCOM: Enemy Unknown]] related to the strategic layer of the game. XComStrategyGame.UPK is divided into several classes, each related to different aspects of the Geoscape/HQ view and described below. The contents of this file can be visualized using [http://eliotvu.com/portfolio/view/21/ue-explorer UE Explorer].

	A complete catalog of the file can be found here: [~~http~~://wiki.~~nexus~~.com/index.php/XComStrategyGame.UPK.Catalog_-_XCOM:EU_2012 Nexusmods wiki page on XComStrategyGame.UPK].		A complete catalog of the file can be found here: [https://wiki.nexusmods.com/index.php/XComStrategyGame.UPK.Catalog_-_XCOM:EU_2012 Nexusmods wiki page on XComStrategyGame.UPK].

	This page will focus on the practical aspects of the file and how they affect playing the game. For details on how to mod the game, you're advised to check the [~~http~~://wiki.~~nexus~~.com/index.php/~~Category:~~XCOM XCOM section] at the Nexusmods wiki.		This page will focus on the practical aspects of the file and how they affect playing the game. For details on how to mod the game, you're advised to check the [https://wiki.nexusmods.com/index.php/XCOM XCOM section] at the Nexusmods wiki.

	==XGStrategyAI==		==XGStrategyAI==

Hpoe: Fixed the links pointing to Nexusmods to point to the correct domain.

2023-04-25T17:42:54Z

Fixed the links pointing to Nexusmods to point to the correct domain.

← Older revision		Revision as of 17:42, 25 April 2023
Line 1:		Line 1:
	XComStrategyGame.UPK is a Unreal Engine 3 file used to determine several functions of [[XCOM: Enemy Unknown (2012)\|XCOM: Enemy Unknown]] related to the strategic layer of the game. XComStrategyGame.UPK is divided into several classes, each related to different aspects of the Geoscape/HQ view and described below. The contents of this file can be visualized using [http://eliotvu.com/portfolio/view/21/ue-explorer UE Explorer].		XComStrategyGame.UPK is a Unreal Engine 3 file used to determine several functions of [[XCOM: Enemy Unknown (2012)\|XCOM: Enemy Unknown]] related to the strategic layer of the game. XComStrategyGame.UPK is divided into several classes, each related to different aspects of the Geoscape/HQ view and described below. The contents of this file can be visualized using [http://eliotvu.com/portfolio/view/21/ue-explorer UE Explorer].

	A complete catalog of the file can be found here: [http://wiki.~~tesnexus~~.com/index.php/XComStrategyGame.UPK.Catalog_-_XCOM:EU_2012 Nexusmods wiki page on XComStrategyGame.UPK].		A complete catalog of the file can be found here: [http://wiki.nexus.com/index.php/XComStrategyGame.UPK.Catalog_-_XCOM:EU_2012 Nexusmods wiki page on XComStrategyGame.UPK].

	This page will focus on the practical aspects of the file and how they affect playing the game. For details on how to mod the game, you're advised to check the [http://wiki.~~tesnexus~~.com/index.php/Category:XCOM XCOM section] at the Nexusmods wiki.		This page will focus on the practical aspects of the file and how they affect playing the game. For details on how to mod the game, you're advised to check the [http://wiki.nexus.com/index.php/Category:XCOM XCOM section] at the Nexusmods wiki.

	==XGStrategyAI==		==XGStrategyAI==

Hobbes: /* IsGoodOverseerTarget */

2014-04-21T13:16:31Z

IsGoodOverseerTarget

← Older revision		Revision as of 13:16, 21 April 2014
Line 413:		Line 413:
	===SortUFOTargets===		===SortUFOTargets===
	===IsGoodOverseerTarget===		===IsGoodOverseerTarget===
	Used to ensure that Overseers will be generated over countries located in continents with Firestorms assigned. Used by [[XComStrategyGame.UPK (EU2012)#DetermineBestOverseerTargets\|DetermineBestOverseerTargets]] and [[XComStrategyGame.UPK (EU2012)#~~OverseerUpdate~~\|XGAlienObjective.~~OverseerUpdate~~]]		Used to ensure that Overseers will be generated over countries located in continents with Firestorms assigned. Used by [[XComStrategyGame.UPK (EU2012)#DetermineBestOverseerTargets\|DetermineBestOverseerTargets]] and [[XComStrategyGame.UPK (EU2012)#LaunchUFO\|XGAlienObjective.LaunchUFO]]

	* If kCountry has SatelliteCoverage it then:		* If kCountry has SatelliteCoverage it then:

Hobbes: /* DetermineBestOverseerTargets */

2014-04-21T13:15:11Z

DetermineBestOverseerTargets

← Older revision		Revision as of 13:15, 21 April 2014
Line 421:		Line 421:

	===DetermineBestOverseerTargets===		===DetermineBestOverseerTargets===
			Used by [[XComStrategyGame.UPK (EU2012)#ChooseOverseerTarget\|ChooseOverseerTarget]] and [[XComStrategyGame.UPK (EU2012)#OverseerUpdate\|XGAlienObjective.OverseerUpdate]].

	*Checks each country with the [[XComStrategyGame.UPK (EU2012)#IsGoodOverseerTarget\|IsGoodOverseerTarget]] function		*Checks each country with the [[XComStrategyGame.UPK (EU2012)#IsGoodOverseerTarget\|IsGoodOverseerTarget]] function
	*If true, it adds the eTargetCountry to arrTargets		*If true, it adds the eTargetCountry to arrTargets
	*After it finishes and if arrTargets length is 0, it determines arrTargets = DetermineBestVisibleTargets(true)		*After it finishes and if arrTargets length is 0, it determines arrTargets = DetermineBestVisibleTargets(true)
	*Returns arrTargets		*Returns arrTargets

	===DetermineBestVisibleTargets===		===DetermineBestVisibleTargets===
	Used by [[XComStrategyGame.UPK (EU2012)#DetermineBestOverseerTargets\|DetermineBestOverseerTargets]], [[XComStrategyGame.UPK (EU2012)#AIAddNewObjectives\|AIAddNewObjectives]] and [[XComStrategyGame.UPK (EU2012)#AddNewOverseers\|AddNewOverseers]].		Used by [[XComStrategyGame.UPK (EU2012)#DetermineBestOverseerTargets\|DetermineBestOverseerTargets]], [[XComStrategyGame.UPK (EU2012)#AIAddNewObjectives\|AIAddNewObjectives]] and [[XComStrategyGame.UPK (EU2012)#AddNewOverseers\|AddNewOverseers]].

Hobbes at 13:05, 21 April 2014

2014-04-21T13:05:44Z

@@ Line 323: / Line 323: @@
 ===AIAddNewMission===
 Used by [[XComStrategyGame.UPK (EU2012)#OnUFOShotDown|OnUFOShotDown]] to generate the UFO crash mission after its interception and by [[XComStrategyGame.UPK (EU2012)#UpdateObjectives|UpdateObjectives]] and [[XComStrategyGame.UPK (EU2012)#OnObjectiveEnded|OnObjectiveEnded]].
 ===AIUpdateMissions===
 Used by Geoscape.
@@ Line 344: / Line 354: @@
 ===LaunchBlitz===
 ===GetAbductionDifficulty===
 ===CheckForAbductionBlitz===

Hobbes: /* AddNewOverseers */

2014-04-21T12:40:21Z

AddNewOverseers

← Older revision		Revision as of 12:40, 21 April 2014
Line 154:		Line 154:

	Addendum:		Addendum:
	When the Overseer is detected by the Hyperwave Relay, it will have the eObjective = 7 "Final Preparations" rather than eObjective = 3 "Target Reconnaissance". This change is made on [[XComStrategyGame.UPK (EU2012)#Init\|XGAlienObjective.Init]]		When the Overseer is detected by the Hyperwave Relay, it will have the eObjective = 7 "Final Preparations" rather than eObjective = 3 "Target Reconnaissance". This change is made on [[XComStrategyGame.UPK (EU2012)#XGAlienObjective.Init\|XGAlienObjective.Init]]

	===OnEtherealFlyby===		===OnEtherealFlyby===

Hobbes at 12:37, 21 April 2014

2014-04-21T12:37:58Z

← Older revision		Revision as of 12:37, 21 April 2014
Line 318:		Line 318:
	Used by [[XComStrategyGame.UPK (EU2012)#OnObjectiveEnded\|OnObjectiveEnded]], causes a targeted country to leave the Council, with the corresponding Geoscape alert.		Used by [[XComStrategyGame.UPK (EU2012)#OnObjectiveEnded\|OnObjectiveEnded]], causes a targeted country to leave the Council, with the corresponding Geoscape alert.
	===AIAddNewUFO===		===AIAddNewUFO===
	Adds item kUFO to arrUFOs.		Adds item kUFO to arrUFOs. Used by [[XComStrategyGame.UPK (EU2012)#LaunchUFO\|XGAlienObjective.LaunchUFO]].

	Not used by any other function on XGStrategyAI.		Not used by any other function on XGStrategyAI.
Line 371:		Line 371:

	The game never generates missions of Objective 7 type.		The game never generates missions of Objective 7 type.



	===DetermineBestAbductionTargets===		===DetermineBestAbductionTargets===
Line 391:		Line 389:
	===SortUFOTargets===		===SortUFOTargets===
	===IsGoodOverseerTarget===		===IsGoodOverseerTarget===
	Used to ensure that Overseers will be generated over countries located in continents with Firestorms assigned. Used by [[XComStrategyGame.UPK (EU2012)#OverseerUpdate\|XGAlienObjective.OverseerUpdate]]		Used to ensure that Overseers will be generated over countries located in continents with Firestorms assigned. Used by [[XComStrategyGame.UPK (EU2012)#DetermineBestOverseerTargets\|DetermineBestOverseerTargets]] and [[XComStrategyGame.UPK (EU2012)#OverseerUpdate\|XGAlienObjective.OverseerUpdate]]

	* If kCountry has SatelliteCoverage it then:		* If kCountry has SatelliteCoverage it then:
	** Checks if arrJets > 0 and if iJet = Firestorm, if positive returns true value		** Checks if arrJets > 0 and if iJet = Firestorm, if positive returns true value
	** Otherwise returns false and keeps checking for all continents with countries that have sats deployed		** Otherwise returns false and keeps checking for all continents with countries that have sats deployed
			* Otherwise Returns false

	===DetermineBestOverseerTargets===		===DetermineBestOverseerTargets===
			*Checks each country with the [[XComStrategyGame.UPK (EU2012)#IsGoodOverseerTarget\|IsGoodOverseerTarget]] function
			*If true, it adds the eTargetCountry to arrTargets
			*After it finishes and if arrTargets length is 0, it determines arrTargets = DetermineBestVisibleTargets(true)
			*Returns arrTargets
	===DetermineBestVisibleTargets===		===DetermineBestVisibleTargets===
			Used by [[XComStrategyGame.UPK (EU2012)#DetermineBestOverseerTargets\|DetermineBestOverseerTargets]], [[XComStrategyGame.UPK (EU2012)#AIAddNewObjectives\|AIAddNewObjectives]] and [[XComStrategyGame.UPK (EU2012)#AddNewOverseers\|AddNewOverseers]].
			* Checks each eTargetCountry with HasSatelliteCoverage
			* If true, it adds eTargetCountry to a random position on arrTargets
			* After all eTargetsCountry are checked, it sees if boolean bUnsorted is negative, if so, it sorts arrTargets
			*Returns arrTargets
	===DetermineBestHuntTargets===		===DetermineBestHuntTargets===
	===GetNumResistingContinents===		===GetNumResistingContinents===

Hobbes: /* IsGoodOverseerTarget */

2014-04-21T12:22:54Z

IsGoodOverseerTarget

← Older revision		Revision as of 12:22, 21 April 2014
Line 391:		Line 391:
	===SortUFOTargets===		===SortUFOTargets===
	===IsGoodOverseerTarget===		===IsGoodOverseerTarget===
			Used to ensure that Overseers will be generated over countries located in continents with Firestorms assigned. Used by [[XComStrategyGame.UPK (EU2012)#OverseerUpdate\|XGAlienObjective.OverseerUpdate]]

			* If kCountry has SatelliteCoverage it then:
			** Checks if arrJets > 0 and if iJet = Firestorm, if positive returns true value
			** Otherwise returns false and keeps checking for all continents with countries that have sats deployed

	===DetermineBestOverseerTargets===		===DetermineBestOverseerTargets===
	===DetermineBestVisibleTargets===		===DetermineBestVisibleTargets===

Hobbes: /* AddNewOverseers */

2014-04-21T12:16:42Z

AddNewOverseers

← Older revision		Revision as of 12:16, 21 April 2014
Line 142:		Line 142:
	*Randomly chooses 1 target from the array		*Randomly chooses 1 target from the array
	===AddNewOverseers===		===AddNewOverseers===
	~~The propose of this function is a bit confusing.~~ It is run by [[XComStrategyGame.UPK (EU2012)#AIAddNewObjectives\|AIAddNewObjectives]] to add Overseer UFOs each month but with a different mission than the one revealed once the Hyperwave Relay is built.		It is run by [[XComStrategyGame.UPK (EU2012)#AIAddNewObjectives\|AIAddNewObjectives]] to add Overseer UFOs each month but with a different mission than the one revealed once the Hyperwave Relay is built.
	* Checks if Storage ever had item 180 (Psi Link). If positive, it doesn't add any Overseers.		* Checks if Storage ever had item 180 (Psi Link). If positive, it doesn't add any Overseers.
	* Uses DetermineBestVisibleTargets to create an array of targets (arrVisible)		* Uses DetermineBestVisibleTargets to create an array of targets (arrVisible)
Line 152:		Line 152:
	** Finally, adds entry using [[XComStrategyGame.UPK (EU2012)#AIAddNewObjective\|AIAddNewObjective]] with the following values (3, 5 + (10 * iMission), Country(eTargetCountry).GetCoords(), eTargetCountry, 9) and adds 1 to iMission		** Finally, adds entry using [[XComStrategyGame.UPK (EU2012)#AIAddNewObjective\|AIAddNewObjective]] with the following values (3, 5 + (10 * iMission), Country(eTargetCountry).GetCoords(), eTargetCountry, 9) and adds 1 to iMission
	* Repeats until iMission = number of added Overseers.		* Repeats until iMission = number of added Overseers.

			Addendum:
			When the Overseer is detected by the Hyperwave Relay, it will have the eObjective = 7 "Final Preparations" rather than eObjective = 3 "Target Reconnaissance". This change is made on [[XComStrategyGame.UPK (EU2012)#Init\|XGAlienObjective.Init]]

	===OnEtherealFlyby===		===OnEtherealFlyby===

Hobbes: /* GetEvents */

2014-04-21T11:51:02Z

GetEvents

← Older revision		Revision as of 11:51, 21 April 2014
Line 18:		Line 18:

	It checks for several conditions:		It checks for several conditions:
	* If iCouncilCounter > 0, it adds a Council mission to the array (11, m_iCouncilCounter / 2, 0)		* If iCouncilCounter > 0, it adds a Council mission to the array using AddAIEvent (11, m_iCouncilCounter / 2, 0)
	* If the all the entries on the array of objectives (arrObjectives) are marked as completed it does nothing, otherwise for each uncompleted objective it adds a mission (eMission):		* If the all the entries on the array of objectives (arrObjectives) are marked as completed it does nothing, otherwise for each uncompleted objective it adds a mission (eMission):
	** If objective is 0 (Recon) it doesn't add a mission.		** If objective is 0 (Recon) it doesn't add a mission.