Change target Owner on warhead impact

CREDITS.md

@@ -310,6 +310,7 @@ This page lists all the individual contributions to the project by their author.
   - Sound entry on unit's creation
   - Auto-deploy/Deploy block on ammo change
   - Flashing Technos on selecting
+  - Change target Owner on warhead impact
 - **ZivDero**
   - Allow giving ownership of buildings to players in Skirmish and MP using <Player @ A-H>
 - **Ares developers**

docs/New-or-Enhanced-Logics.md

@@ -1202,6 +1202,23 @@ In `rulesmd.ini`:
 NotHuman.DeathSequence=  ; integer (1 to 5)
 ```
 
+### Change target Owner on impact
+
+- Warheads can now change targets owner to warhead's owner.
+- `IsOwnerChanger.SetAsMindControl` sets control as PermanentMindControl, uses `MindControlRingOffset` for anim, respects `ImmuneToPsionics`.
+- `IsOwnerChanger.AffectElites` sets if elite veterancy units can be affected to owner change.
+- `IsOwnerChanger.HealthThreshold` sets target minimal health percentage to have owner changed.
+
+In `rulesmd.ini`:
+```ini
+[SOMEWARHEAD]                         ; Warhead
+IsOwnerChanger = yes                  ; boolean
+IsOwnerChanger.SetAsMindControl = no  ; boolean
+IsOwnerChanger.ControlAnim = SOMEANIM ; animation on target
+IsOwnerChanger.AffectElites = yes     ; boolean
+IsOwnerChanger.HealthThreshold = 1.0  ; float
+```
+
 ## Weapons
 
 ### AreaFire target customization

docs/Whats-New.md

@@ -349,6 +349,7 @@ New:
 - Customizable straight trajectory detonation & snap distance and pass-through option (by Starkku)
 - Airstrike & spy plane fixed spawn distance & height (by Starkku)
 - Allow enabling application of `Verses` and `PercentAtMax` for negative damage (by Starkku)
+- Change target Owner on warhead impact (by Fryone)
 - In addition to `PlacementGrid.Translucency`, allow to set the transparency of the grid when PlacementPreview is enabled, using the `PlacementGrid.TranslucencyWithPreview` tag (by Belonit).
 - Show briefing screen on singleplayer mission start (by Starkku)
 - Allow setting mission par times and related messages in `missionmd.ini` (by Starkku)

src/Ext/TechnoType/Body.h

@@ -182,6 +182,8 @@ class TechnoTypeExt
 		Nullable<Leptons> SpawnDistanceFromTarget;
 		Nullable<int> SpawnHeight;
 
+		NullableVector<int> ChangeOwnerImmunities;
+
 		struct LaserTrailDataEntry
 		{
 			ValueableIdx<LaserTrailTypeClass> idxType;
@@ -359,6 +361,8 @@ class TechnoTypeExt
 
 			, SpawnDistanceFromTarget {}
 			, SpawnHeight {}
+
+			, ChangeOwnerImmunities {}
 		{ }
 
 		virtual ~ExtData() = default;

src/Ext/WarheadType/Body.cpp

@@ -127,6 +127,11 @@ void WarheadTypeExt::ExtData::LoadFromINIFile(CCINIClass* const pINI)
 	this->DecloakDamagedTargets.Read(exINI, pSection, "DecloakDamagedTargets");
 	this->ShakeIsLocal.Read(exINI, pSection, "ShakeIsLocal");
 	this->ApplyModifiersOnNegativeDamage.Read(exINI, pSection, "ApplyModifiersOnNegativeDamage");
+	this->ChangeOwner.Read(exINI, pSection, "IsOwnerChanger");
+	this->ChangeOwner_MindControl.Read(exINI, pSection, "IsOwnerChanger.SetAsMindControl");
+	this->ChangeOwner_Anim.Read(exINI, pSection, "IsOwnerChanger.ControlAnim");
+	this->ChangeOwner_Threshold.Read(exINI, pSection, "IsOwnerChanger.HealthThreshold");
+	this->ChangeOwner_AffectElites.Read(exINI, pSection, "IsOwnerChanger.AffectElites");
 
 	// Crits
 	this->Crit_Chance.Read(exINI, pSection, "Crit.Chance");
@@ -242,6 +247,7 @@ void WarheadTypeExt::ExtData::LoadFromINIFile(CCINIClass* const pINI)
 		|| this->Convert_Pairs.size() > 0
 		|| this->InflictLocomotor
 		|| this->RemoveInflictedLocomotor
+		|| this->ChangeOwner
 	);
 }
 
@@ -270,6 +276,11 @@ void WarheadTypeExt::ExtData::Serialize(T& Stm)
 		.Process(this->DecloakDamagedTargets)
 		.Process(this->ShakeIsLocal)
 		.Process(this->ApplyModifiersOnNegativeDamage)
+		.Process(this->ChangeOwner)
+		.Process(this->ChangeOwner_MindControl)
+		.Process(this->ChangeOwner_Anim)
+		.Process(this->ChangeOwner_Threshold)
+		.Process(this->ChangeOwner_AffectElites)
 
 		.Process(this->Crit_Chance)
 		.Process(this->Crit_ApplyChancePerTarget)

src/Ext/WarheadType/Body.h

@@ -41,6 +41,11 @@ class WarheadTypeExt
 		Valueable<bool> DecloakDamagedTargets;
 		Valueable<bool> ShakeIsLocal;
 		Valueable<bool> ApplyModifiersOnNegativeDamage;
+		Valueable<bool> ChangeOwner;
+		Valueable<bool> ChangeOwner_MindControl;
+		Nullable<AnimTypeClass*> ChangeOwner_Anim;
+		Valueable<double> ChangeOwner_Threshold;
+		Valueable<bool> ChangeOwner_AffectElites;
 
 		Valueable<double> Crit_Chance;
 		Valueable<bool> Crit_ApplyChancePerTarget;
@@ -155,6 +160,11 @@ class WarheadTypeExt
 			, DecloakDamagedTargets { true }
 			, ShakeIsLocal { false }
 			, ApplyModifiersOnNegativeDamage { false }
+			, ChangeOwner { false }
+			, ChangeOwner_MindControl { false }
+			, ChangeOwner_Anim {}
+			, ChangeOwner_Threshold { 1.0 }
+			, ChangeOwner_AffectElites { true }
 
 			, Crit_Chance { 0.0 }
 			, Crit_ApplyChancePerTarget { false }
@@ -250,6 +260,7 @@ class WarheadTypeExt
 		void ApplyConvert(HouseClass* pHouse, TechnoClass* pTarget);
 		void ApplyLocomotorInfliction(TechnoClass* pTarget);
 		void ApplyLocomotorInflictionReset(TechnoClass* pTarget);
+		void ApplyOwnerChange(HouseClass* pHouse, TechnoClass* pTarget);
 
 	public:
 		void Detonate(TechnoClass* pOwner, HouseClass* pHouse, BulletExt::ExtData* pBullet, CoordStruct coords);

src/Ext/WarheadType/Detonate.cpp

@@ -135,6 +135,9 @@ void WarheadTypeExt::ExtData::DetonateOnOneUnit(HouseClass* pHouse, TechnoClass*
 	if (this->RemoveMindControl)
 		this->ApplyRemoveMindControl(pHouse, pTarget);
 
+	if (this->ChangeOwner)
+		this->ApplyOwnerChange(pHouse, pTarget);
+
 	if (this->Crit_Chance && (!this->Crit_SuppressWhenIntercepted || !bulletWasIntercepted))
 		this->ApplyCrit(pHouse, pTarget, pOwner);
 
@@ -250,6 +253,62 @@ void WarheadTypeExt::ExtData::ApplyRemoveDisguiseToInf(HouseClass* pHouse, Techn
 	}
 }
 
+void WarheadTypeExt::ExtData::ApplyOwnerChange(HouseClass* pHouse, TechnoClass* pTarget)
+{
+	const auto pExt = TechnoExt::ExtMap.Find(pTarget);
+	auto armorType = pTarget->GetTechnoType()->Armor;
+
+	if (pExt->Shield && pExt->Shield->IsActive() && !pExt->Shield->CanBePenetrated(this->OwnerObject()))
+		armorType = pExt->Shield->GetArmorType();
+
+	const auto pOwnerAnimType = this->ChangeOwner_Anim.Get(nullptr);
+	const double ownerChangeHealthThreshold = this->ChangeOwner_Threshold;
+	const bool isMindControl = this->ChangeOwner_MindControl;
+	const bool doesAffectElites = this->ChangeOwner_AffectElites;
+	const bool targetImmuneToPsionics = pTarget->GetTechnoType()->ImmuneToPsionics;
+	const bool isBld = pTarget->What_Am_I() == AbstractType::Building;
+
+	bool isImmune = (isMindControl && targetImmuneToPsionics) || (pTarget->GetHealthPercentage() > ownerChangeHealthThreshold) || (!doesAffectElites && pTarget->Veterancy.IsElite());
+
+	if (!isImmune)
+	{
+		if ((GeneralUtils::GetWarheadVersusArmor(this->OwnerObject(), armorType) != 0.0) && (!pTarget->IsMindControlled()))
+		{
+			pTarget->SetOwningHouse(pHouse, true);
+			if (pOwnerAnimType)
+			{
+				CoordStruct OwningAnimLocation = pTarget->Location;
+				if (isMindControl)
+					if (isBld)
+						OwningAnimLocation.Z += pTarget->GetTechnoType()->Height * Unsorted::LevelHeight;
+					else
+						OwningAnimLocation.Z += pTarget->GetTechnoType()->MindControlRingOffset;
+				if (auto pOwnerAnim = GameCreate<AnimClass>(pOwnerAnimType, OwningAnimLocation, 0, 1))
+				{
+					pOwnerAnim->Owner = pHouse;
+					if (isMindControl)
+					{
+						pTarget->MindControlRingAnim = pOwnerAnim;
+						pTarget->MindControlledByAUnit = true;
+					}
+					else
+					{
+						pOwnerAnim->Owner = pHouse;
+					}
+					pOwnerAnim->SetOwnerObject(pTarget);
+					if (isBld)
+						pOwnerAnim->ZAdjust = -1024;
+				}
+			}
+			else
+			{
+				if (isMindControl)
+					pTarget->MindControlledByAUnit = true;
+			}
+		}
+	}
+}
+
 void WarheadTypeExt::ExtData::ApplyCrit(HouseClass* pHouse, TechnoClass* pTarget, TechnoClass* pOwner)
 {
 	double dice;