New EVA voice after deploying a building

CREDITS.md

@@ -144,6 +144,7 @@ This page lists all the individual contributions to the project by their author.
   - Map Events 604 & 605 for checking if a specific Techno enters in a cell
   - Warhead that can not kill
   - `Pips.HideIfNoStrength` and `SelfHealing.EnabledBy` additions for shields
+  - New EVA voice after deploying a building
 - **Starkku**:
   - Misc. minor bugfixes & improvements
   - AI script actions:

docs/User-Interface.md

@@ -27,6 +27,24 @@ IngameScore.WinTheme=  ; Soundtrack theme ID
 IngameScore.LoseTheme= ; Soundtrack theme ID
 ```
 
+### New EVA voice after deploying a building
+
+- You can now replace the current EVA voice when a specific structure is placed/deployed.
+- `NewEVAVoice.Index` is the index of the new EVA voice. Ares is hightly recomended because these indexes are readed the new section `[EVATypes]` at `evamd.ini` created by Ares. Look at Ares documentation for more information.
+- In case of multiple structures with different EVA voices `NewEVAVoice.Priority` establish a priority queue, being the highest value the selected one.
+- `NewEVAVoice.RecheckOnDeath` re-checks a new EVA voice after the destruction/undeployment of of of these buildings.
+- `NewEVAVoice.InitialMessage` plays an EVA message to the player when a different EVA has been selected.
+
+In `rulesmd.ini`:
+```ini
+[SOMEBUILDING]                    ; BuildingType
+NewEVAVoice=                      ; boolean
+NewEVAVoice.Index=0               ; integer
+NewEVAVoice.Priority=1            ; integer
+NewEVAVoice.RecheckOnDeath=false  ; boolean
+NewEVAVoice.InitialMessage=       ; EVA entry
+```
+
 ## Battle screen UI/UX
 
 ### Digital display

docs/Whats-New.md

@@ -389,6 +389,7 @@ New:
 - Customize whether `Crater=yes` animation would destroy tiberium (by TaranDahl)
 - Weapon target filtering by health percentage (by NetsuNegi)
 - Turretless vehicles with `Voxel=no` support use `FireUp` like infantry (by FlyStar)
+- New EVA voice after deploying a building (by FS-21)
 
 Vanilla fixes:
 - Fixed sidebar not updating queued unit numbers when adding or removing units when the production is on hold (by CrimRecya)

src/Ext/Building/Body.cpp

@@ -3,6 +3,9 @@
 #include <BitFont.h>
 
 #include <Utilities/EnumFunctions.h>
+#include <Ext/Side/Body.h>
+#include <Ext/Scenario/Body.h>
+#include <Ext/House/Body.h>
 
 BuildingExt::ExtContainer BuildingExt::ExtMap;
 
@@ -446,6 +449,90 @@ const std::vector<CellStruct> BuildingExt::GetFoundationCells(BuildingClass* con
 	return foundationCells;
 }
 
+void BuildingExt::ExtData::UpdateMainEvaVoice()
+{
+	const auto pTypeExt = this->TypeExtData;
+
+	if (!pTypeExt->NewEvaVoice.Get(false))
+		return;
+
+	const auto pThis = this->OwnerObject();
+	const auto pHouse = pThis->Owner;
+
+	if (!pHouse->IsControlledByCurrentPlayer())
+		return;
+
+	int newPriority = -1;
+	int newEvaIndex = VoxClass::EVAIndex;
+
+	for (const auto pBuilding : pHouse->Buildings)
+	{
+		// Special case that must be avoided here because can be the current EVA changer
+		if (pBuilding->CurrentMission == Mission::Selling)
+			continue;
+
+		auto const pBuildingTypeExt = BuildingTypeExt::ExtMap.Find(pBuilding->Type);
+
+		// The first highest priority takes precedence over lower ones
+		if (pBuildingTypeExt->NewEvaVoice.Get(false) && pBuildingTypeExt->NewEvaVoice_Priority > newPriority)
+		{
+			newPriority = pBuildingTypeExt->NewEvaVoice_Priority;
+			newEvaIndex = pBuildingTypeExt->NewEvaVoice_Index;
+		}
+	}
+
+	if (pThis->CurrentMission != Mission::Selling && pTypeExt->NewEvaVoice_Priority > newPriority)
+	{
+		newPriority = pTypeExt->NewEvaVoice_Priority;
+		newEvaIndex = pTypeExt->NewEvaVoice_Index;
+	}
+
+	if (newPriority > 0 && VoxClass::EVAIndex != newEvaIndex)
+	{
+		VoxClass::EVAIndex = newEvaIndex;
+
+		// Greeting of the new EVA voice
+		int idxPlay = pTypeExt->NewEvaVoice_InitialMessage.Get(-1);
+
+		if (idxPlay != -1)
+			VoxClass::PlayIndex(idxPlay);
+	}
+	else if (newPriority < 0)
+	{
+		// Restore the original EVA voice of the owner's side
+		const auto pSide = SideClass::Array.GetItem(pHouse->SideIndex);
+		const auto pSideExt = SideExt::ExtMap.Find(pSide);
+		newEvaIndex = 0; // By default is set the "Allies" EVA voice
+
+		if (pSideExt->EVA_Tag.isset())
+		{
+			const auto evaTag = pSideExt->EVA_Tag.Get();
+
+			for (size_t i = 0; i < RulesExt::Global()->EVAIndexList.size(); i++)
+			{
+				const auto item = RulesExt::Global()->EVAIndexList[i].c_str();
+
+				if (_strcmpi(item, evaTag) == 0)
+				{
+					newEvaIndex = i;
+					break;
+				}
+			}
+		}
+		else
+		{
+			if (pHouse->SideIndex == 0)
+				newEvaIndex = 0; // Allied
+			if (pHouse->SideIndex == 1)
+				newEvaIndex = 1; // Russian
+			else if (pHouse->SideIndex == 2)
+				newEvaIndex = 2; // Yuri
+		}
+
+		VoxClass::EVAIndex = newEvaIndex;
+	}
+}
+
 // =============================
 // load / save
 

src/Ext/Building/Body.h

@@ -59,6 +59,7 @@ class BuildingExt
 		bool HasSuperWeapon(int index, bool withUpgrades) const;
 		bool HandleInfiltrate(HouseClass* pInfiltratorHouse, int moneybefore);
 		void UpdatePrimaryFactoryAI();
+		void UpdateMainEvaVoice();
 		virtual ~ExtData() = default;
 
 		// virtual void LoadFromINIFile(CCINIClass* pINI) override;

src/Ext/Building/Hooks.cpp

@@ -248,6 +248,11 @@
 {
 	enum { ContinueCheck = 0x440B58, SkipSetShouldRebuild = 0x440B81 };
 
+	auto const pTypeExt = BuildingTypeExt::ExtMap.Find(pThis->Type);
+
+	if (pTypeExt->NewEvaVoice.Get(false))
+		BuildingExt::ExtMap.Find(pThis)->UpdateMainEvaVoice();
+
 	if (SessionClass::IsCampaign())
 	{
 		GET(BuildingClass* const, pThis, ESI);
@@ -432,6 +437,9 @@
 		}
 	}
 
+	if (pTypeExt->NewEvaVoice.Get(false) && pTypeExt->NewEvaVoice_RecheckOnDeath)
+		BuildingExt::ExtMap.Find(pThis)->UpdateMainEvaVoice();
+
 	return 0;
 }
 

src/Ext/BuildingType/Body.cpp

@@ -201,6 +201,12 @@ void BuildingTypeExt::ExtData::LoadFromINIFile(CCINIClass* const pINI)
 	this->BunkerWallsUpSound.Read(exINI, pSection, "BunkerWallsUpSound");
 	this->BunkerWallsDownSound.Read(exINI, pSection, "BunkerWallsDownSound");
 
+	this->NewEvaVoice.Read(exINI, pSection, "NewEVAVoice");
+	this->NewEvaVoice_Index.Read(exINI, pSection, "NewEVAVoice.Index");
+	this->NewEvaVoice_Priority.Read(exINI, pSection, "NewEVAVoice.Priority");
+	this->NewEvaVoice_RecheckOnDeath.Read(exINI, pSection, "NewEVAVoice.RecheckOnDeath");
+	this->NewEvaVoice_InitialMessage.Read(exINI, pSection, "NewEVAVoice.InitialMessage");
+
 	if (pThis->NumberOfDocks > 0)
 	{
 		this->AircraftDockingDirs.clear();
@@ -333,6 +339,11 @@ void BuildingTypeExt::ExtData::Serialize(T& Stm)
 		.Process(this->BuildingOccupyROFMult)
 		.Process(this->BuildingBunkerDamageMult)
 		.Process(this->BuildingBunkerROFMult)
+		.Process(this->NewEvaVoice)
+		.Process(this->NewEvaVoice_Index)
+		.Process(this->NewEvaVoice_Priority)
+		.Process(this->NewEvaVoice_RecheckOnDeath)
+		.Process(this->NewEvaVoice_InitialMessage)
 		;
 }
 

src/Ext/BuildingType/Body.h

@@ -93,6 +93,12 @@ class BuildingTypeExt
 		NullableIdx<VocClass> BunkerWallsUpSound;
 		NullableIdx<VocClass> BunkerWallsDownSound;
 
+		Nullable<bool> NewEvaVoice;
+		Valueable<int> NewEvaVoice_Index;
+		Valueable<int> NewEvaVoice_Priority;
+		Valueable<bool> NewEvaVoice_RecheckOnDeath;
+		NullableIdx<VoxClass> NewEvaVoice_InitialMessage;
+
 		ExtData(BuildingTypeClass* OwnerObject) : Extension<BuildingTypeClass>(OwnerObject)
 			, PowersUp_Owner { AffectedHouse::Owner }
 			, PowersUp_Buildings {}
@@ -152,6 +158,11 @@ class BuildingTypeExt
 			, BuildingBunkerROFMult {}
 			, BunkerWallsUpSound {}
 			, BunkerWallsDownSound {}
+			, NewEvaVoice {}
+			, NewEvaVoice_Index { 0 }
+			, NewEvaVoice_Priority { 0 }
+			, NewEvaVoice_RecheckOnDeath { false }
+			, NewEvaVoice_InitialMessage { }
 		{ }
 
 		// Ares 0.A functions

src/Ext/Rules/Body.cpp

@@ -274,6 +274,9 @@ void RulesExt::ExtData::LoadBeforeTypeData(RulesClass* pThis, CCINIClass* pINI)
 
 	this->AnimCraterDestroyTiberium.Read(exINI, GameStrings::General, "AnimCraterDestroyTiberium");
 
+	// Reading Ares section [EVATypes] at evamd.ini
+	LoadEvaVoices();
+
 	// Section AITargetTypes
 	int itemsCount = pINI->GetKeyCount("AITargetTypes");
 	for (int i = 0; i < itemsCount; ++i)
@@ -313,6 +316,10 @@ void RulesExt::ExtData::LoadBeforeTypeData(RulesClass* pThis, CCINIClass* pINI)
 	}
 }
 
+namespace EVAIndexListTemp
+{
+	std::vector<std::string> EVAIndexList;
+}
 // this runs between the before and after type data loading methods for rules ini
 void RulesExt::ExtData::InitializeAfterTypeData(RulesClass* const pThis)
 {
@@ -501,6 +508,7 @@ void RulesExt::ExtData::Serialize(T& Stm)
 		.Process(this->DamagedSpeed)
 		.Process(this->HarvesterScanAfterUnload)
 		.Process(this->AnimCraterDestroyTiberium)
+		.Process(this->EVAIndexList)
 		;
 }
 
@@ -543,6 +551,49 @@ void RulesExt::ExtData::ReplaceVoxelLightSources()
 		Game::DestroyVoxelCaches();
 }
 
+void RulesExt::ExtData::LoadEvaVoices()
+{
+	CCFileClass pEvamdFile("evamd.ini");
+
+	if (pEvamdFile.Exists() && pEvamdFile.Open(FileAccessMode::Read))
+	{
+		CCINIClass iniEva;
+		iniEva.ReadCCFile(&pEvamdFile, true);
+		iniEva.CurrentSection = nullptr;
+		iniEva.CurrentSectionName = nullptr;
+		const auto pEvaSection = "EVATypes";
+
+		if (iniEva.GetSection(pEvaSection))
+		{
+			this->EVAIndexList.clear();
+
+			// Default EVA voices
+			this->EVAIndexList.emplace_back(GameStrings::Allied);
+			this->EVAIndexList.emplace_back(GameStrings::Russian);
+			this->EVAIndexList.emplace_back(GameStrings::Yuri);
+
+			// New EVA voices due to a new Ares section in evamd.ini
+			const auto count = iniEva.GetKeyCount(pEvaSection);
+
+			for (std::size_t i = 0; i < count; i++)
+			{
+				const auto pEvaKey = iniEva.GetKeyName(pEvaSection, i);
+
+				if (iniEva.ReadString(pEvaSection, pEvaKey, "", Phobos::readBuffer) > 0)
+				{
+					std::string buffer = Phobos::readBuffer;
+					bool found = std::find(this->EVAIndexList.begin(), this->EVAIndexList.end(), buffer) != this->EVAIndexList.end();
+
+					if (!found)
+						this->EVAIndexList.emplace_back(buffer);
+				}
+			}
+		}
+	}
+
+	pEvamdFile.Close();
+}
+
 // =============================
 // container hooks
 

src/Ext/Rules/Body.h

@@ -227,6 +227,8 @@ class RulesExt
 
 		Valueable<bool> AnimCraterDestroyTiberium;
 
+		std::vector<std::string> EVAIndexList;
+
 		ExtData(RulesClass* OwnerObject) : Extension<RulesClass>(OwnerObject)
 			, Storage_TiberiumIndex { -1 }
 			, HarvesterDumpAmount { 0.0f }
@@ -399,6 +401,8 @@ class RulesExt
 			, HarvesterScanAfterUnload { false }
 
 			, AnimCraterDestroyTiberium { true }
+
+			, EVAIndexList {}
 		{ }
 
 		virtual ~ExtData() = default;
@@ -415,6 +419,7 @@ class RulesExt
 		virtual void SaveToStream(PhobosStreamWriter& Stm) override;
 
 		void ReplaceVoxelLightSources();
+		void LoadEvaVoices();
 
 	private:
 		template <typename T>

src/Ext/Side/Body.cpp

@@ -47,6 +47,11 @@ void SideExt::ExtData::LoadFromINIFile(CCINIClass* pINI)
 	this->SuperWeaponSidebar_TopPCX.Read(pINI, pSection, "SuperWeaponSidebar.TopPCX");
 	this->SuperWeaponSidebar_CenterPCX.Read(pINI, pSection, "SuperWeaponSidebar.CenterPCX");
 	this->SuperWeaponSidebar_BottomPCX.Read(pINI, pSection, "SuperWeaponSidebar.BottomPCX");
+
+	pINI->ReadString(pSection, "EVA.Tag", "", Phobos::readBuffer);
+
+	if (std::strlen(Phobos::readBuffer) > 0)
+		this->EVA_Tag = _strdup(Phobos::readBuffer);
 }
 
 // =============================
@@ -81,6 +86,7 @@ void SideExt::ExtData::Serialize(T& Stm)
 		.Process(this->SuperWeaponSidebar_TopPCX)
 		.Process(this->SuperWeaponSidebar_CenterPCX)
 		.Process(this->SuperWeaponSidebar_BottomPCX)
+		.Process(this->EVA_Tag)
 		;
 }
 

src/Ext/Side/Body.h

@@ -41,6 +41,7 @@ class SideExt
 		PhobosPCXFile SuperWeaponSidebar_TopPCX;
 		PhobosPCXFile SuperWeaponSidebar_CenterPCX;
 		PhobosPCXFile SuperWeaponSidebar_BottomPCX;
+		Nullable<char*> EVA_Tag;
 
 		ExtData(SideClass* OwnerObject) : Extension<SideClass>(OwnerObject)
 			, ArrayIndex { -1 }
@@ -68,6 +69,7 @@ class SideExt
 			, SuperWeaponSidebar_TopPCX {}
 			, SuperWeaponSidebar_CenterPCX {}
 			, SuperWeaponSidebar_BottomPCX {}
+			, EVA_Tag { }
 		{ }
 
 		virtual ~ExtData() = default;