[ZH] Simulate Replays with CSV files

GeneralsMD/Code/GameEngine/CMakeLists.txt

@@ -94,6 +94,7 @@ set(GAMEENGINE_SRC
     Include/Common/RAMFile.h
     Include/Common/RandomValue.h
     Include/Common/Recorder.h
+    Include/Common/ReplayListCsv.h
 #    Include/Common/ReplaySimulation.h
     Include/Common/Registry.h
     Include/Common/ResourceGatheringManager.h
@@ -609,6 +610,7 @@ set(GAMEENGINE_SRC
     Source/Common/PerfTimer.cpp
     Source/Common/RandomValue.cpp
     Source/Common/Recorder.cpp
+    Source/Common/ReplayListCsv.cpp
 #    Source/Common/ReplaySimulation.cpp
     Source/Common/RTS/AcademyStats.cpp
     Source/Common/RTS/ActionManager.cpp

GeneralsMD/Code/GameEngine/Include/Common/GlobalData.h

@@ -354,6 +354,8 @@ class GlobalData : public SubsystemInterface
 	std::vector<AsciiString> m_simulateReplays; ///< If not empty, simulate this list of replays and exit.
 	Int m_simulateReplayJobs; ///< Maximum number of processes to use for simulation, or SIMULATE_REPLAYS_SEQUENTIAL for sequential simulation
 
+	AsciiString m_writeReplayList; ///< If not empty, write out list of replays in this subfolder into a csv file (TheSuperHackers @feature helmutbuhler 24/05/2025)
+
 	Int m_maxParticleCount;						///< maximum number of particles that can exist
 	Int m_maxFieldParticleCount;			///< maximum number of field-type particles that can exist (roughly)
 	WeaponBonusSet* m_weaponBonusSet;

GeneralsMD/Code/GameEngine/Include/Common/ReplayListCsv.h

@@ -0,0 +1,23 @@
+/*
+**	Command & Conquer Generals Zero Hour(tm)
+**	Copyright 2025 TheSuperHackers
+**
+**	This program is free software: you can redistribute it and/or modify
+**	it under the terms of the GNU General Public License as published by
+**	the Free Software Foundation, either version 3 of the License, or
+**	(at your option) any later version.
+**
+**	This program is distributed in the hope that it will be useful,
+**	but WITHOUT ANY WARRANTY; without even the implied warranty of
+**	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+**	GNU General Public License for more details.
+**
+**	You should have received a copy of the GNU General Public License
+**	along with this program.  If not, see <http://www.gnu.org/licenses/>.
+*/
+
+#pragma once
+
+
+bool WriteOutReplayList(AsciiString relativeFolder);
+bool ReadReplayListFromCsv(AsciiString filename, std::vector<AsciiString>* replayList);

GeneralsMD/Code/GameEngine/Source/Common/CommandLine.cpp

@@ -32,6 +32,7 @@
 #include "Common/Recorder.h"
 #include "Common/version.h"
 #include "GameClient/ClientInstance.h"
+#include "Common/ReplayListCsv.h"
 #include "GameClient/TerrainVisual.h" // for TERRAIN_LOD_MIN definition
 #include "GameClient/GameText.h"
 #include "GameNetwork/NetworkDefs.h"
@@ -442,6 +443,40 @@ Int parseReplay(char *args[], int num)
 	return 1;
 }
 
+Int parseSimReplayList(char *args[], int num)
+{
+	if (num > 1)
+	{
+		AsciiString filename = args[1];
+		bool success = ReadReplayListFromCsv(filename, &TheWritableGlobalData->m_simulateReplays);
+		if (!success)
+		{
+			printf("Cannot open csv file: \"%s\"\n", filename.str());
+			exit(1);
+		}
+		TheWritableGlobalData->m_playIntro = FALSE;
+		TheWritableGlobalData->m_afterIntro = TRUE;
+		TheWritableGlobalData->m_playSizzle = FALSE;
+		TheWritableGlobalData->m_shellMapOn = FALSE;
+
+		// Make replay playback possible while other clients (possible retail) are running
+		rts::ClientInstance::setMultiInstance(TRUE);
+		rts::ClientInstance::skipPrimaryInstance();
+		return 2;
+	}
+	return 1;
+}
+
+Int parseWriteReplayList(char *args[], int num)
+{
+	if (num > 1)
+	{
+		TheWritableGlobalData->m_writeReplayList = args[1];
+		TheWritableGlobalData->m_headless = TRUE;
+	}
+	return 1;
+}
+
 Int parseJobs(char *args[], int num)
 {
 	if (num > 1)
@@ -1162,6 +1197,18 @@ static CommandLineParam paramsForStartup[] =
 	// (If you have 4 cores, call it with -jobs 4)
 	// If you do not call this, all replays will be simulated in sequence in the same process.
 	{ "-jobs", parseJobs },
+
+	// TheSuperHackers @feature helmutbuhler 28/04/2025
+	// Pass in a csv file to play back multiple replays. The file must be in the replay folder.
+	{ "-replayList", parseSimReplayList },
+
+	// TheSuperHackers @feature helmutbuhler 28/04/2025
+	// Write out information about all replays in a folder to a csv file.
+	// Call it with -writeReplayList . for all replays in the replay folder.
+	// Call it with -writeReplayList folder for all replays in the folder subfolder.
+	// The result will be saved in replay_list.csv in that folder.
+	// todo: this is a bit unintuitive. Maybe use ReplaySimulation::resolveFilenameWildcards for this?
+	{ "-writeReplayList", parseWriteReplayList },
 };
 
 // These Params are parsed during Engine Init before INI data is loaded

GeneralsMD/Code/GameEngine/Source/Common/GameMain.cpp

@@ -30,6 +30,7 @@
 
 #include "Common/GameEngine.h"
 #include "Common/ReplaySimulation.h"
+#include "Common/ReplayListCsv.h"
 
 
 /**
@@ -46,6 +47,11 @@ Int GameMain()
 	{
 		exitcode = ReplaySimulation::simulateReplays(TheGlobalData->m_simulateReplays, TheGlobalData->m_simulateReplayJobs);
 	}
+	else if (!TheGlobalData->m_writeReplayList.isEmpty())
+	{
+		bool success = WriteOutReplayList(TheGlobalData->m_writeReplayList);
+		exitcode = success ? 0 : 1;
+	}
 	else
 	{
 		// run it

GeneralsMD/Code/GameEngine/Source/Common/GlobalData.cpp

@@ -960,6 +960,8 @@ GlobalData::GlobalData()
 	m_simulateReplays.clear();
 	m_simulateReplayJobs = SIMULATE_REPLAYS_SEQUENTIAL;
 
+	m_writeReplayList = "";
+
 	for (i = LEVEL_FIRST; i <= LEVEL_LAST; ++i)
 		m_healthBonus[i] = 1.0f;