feat(stats): Store match stats with last replay

Author: bill-rich

Generals/Code/GameEngine/CMakeLists.txt

@@ -105,6 +105,7 @@ set(GAMEENGINE_SRC
     Include/Common/StackDump.h
     Include/Common/StateMachine.h
     Include/Common/StatsCollector.h
+    Include/Common/StatsExporter.h
 #    Include/Common/STLTypedefs.h
 #    Include/Common/StreamingArchiveFile.h
 #    Include/Common/SubsystemInterface.h
@@ -586,6 +587,7 @@ set(GAMEENGINE_SRC
     Source/Common/SkirmishBattleHonors.cpp
     Source/Common/StateMachine.cpp
     Source/Common/StatsCollector.cpp
+    Source/Common/StatsExporter.cpp
 #    Source/Common/System/ArchiveFile.cpp
 #    Source/Common/System/ArchiveFileSystem.cpp
 #    Source/Common/System/AsciiString.cpp

Generals/Code/GameEngine/Include/Common/ScoreKeeper.h

@@ -96,6 +96,15 @@ class ScoreKeeper : public Snapshot
 	// for battle honor calculation.  done once at the end of each online game
 	Int getTotalUnitsBuilt( KindOfMaskType validMask, KindOfMaskType invalidMask );
 
+	// TheSuperHackers @feature hrich 10/03/2026 Public accessors for game stats export.
+	typedef std::map<const ThingTemplate *, Int> ObjectCountMap;
+	Int getUnitsDestroyedByPlayer( Int idx ) const { return m_totalUnitsDestroyed[idx]; }
+	Int getBuildingsDestroyedByPlayer( Int idx ) const { return m_totalBuildingsDestroyed[idx]; }
+	const ObjectCountMap& getObjectsBuilt() const { return m_objectsBuilt; }
+	const ObjectCountMap* getObjectsDestroyedArray() const { return m_objectsDestroyed; }
+	const ObjectCountMap& getObjectsLost() const { return m_objectsLost; }
+	const ObjectCountMap& getObjectsCaptured() const { return m_objectsCaptured; }
+
 protected:
 
 	// snapshot methods
@@ -119,7 +128,6 @@ class ScoreKeeper : public Snapshot
 
 	Int m_myPlayerIdx;								///< We need to not score kills on ourselves... so we need to know who we are
 
-	typedef std::map<const ThingTemplate *, Int> ObjectCountMap;
 	typedef ObjectCountMap::iterator ObjectCountMapIt;
 	ObjectCountMap m_objectsBuilt;			///< How many and what kinds of objects did we build
 	ObjectCountMap m_objectsDestroyed[MAX_PLAYER_COUNT];		///< How many and what kinds and who's did we kill

Generals/Code/GameEngine/Include/Common/StatsExporter.h

@@ -0,0 +1,35 @@
+/*
+**	Command & Conquer Generals(tm)
+**	Copyright 2026 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/>.
+*/
+
+// TheSuperHackers @feature hrich 10/03/2026 Game stats JSON exporter.
+
+#pragma once
+
+class AsciiString;
+
+/// Export game statistics as a JSON file alongside the replay file.
+/// @param replayDir Directory containing replays (e.g. "[UserDataPath]/Replays/")
+/// @param replayFileName Replay filename with extension (e.g. "LastReplay.rep")
+void ExportGameStatsJSON(const AsciiString& replayDir, const AsciiString& replayFileName);
+
+/// Collect a time-series snapshot of all players' stats (called every game logic frame).
+/// Snapshots are taken every 30 frames (~1 second) and stored in memory.
+void StatsExporterCollectSnapshot();
+
+/// Clear all stored time-series snapshots (called at game start/reset).
+void StatsExporterClearSnapshots();

Generals/Code/GameEngine/Source/Common/Recorder.cpp

@@ -47,6 +47,8 @@
 #include "Common/CRCDebug.h"
 #include "Common/OptionPreferences.h"
 #include "Common/version.h"
+// TheSuperHackers @feature hrich 10/03/2026 Export game stats as JSON alongside replay file.
+#include "Common/StatsExporter.h"
 
 constexpr const char s_genrep[] = "GENREP";
 constexpr const UnsignedInt replayBufferBytes = 8192;
@@ -731,6 +733,9 @@ void RecorderClass::stopRecording() {
 		if (m_archiveReplays)
 			archiveReplay(m_fileName);
 	}
+	// TheSuperHackers @feature hrich 10/03/2026 Export game stats as JSON alongside replay file.
+	if (!m_fileName.isEmpty())
+		ExportGameStatsJSON(getReplayDir(), m_fileName);
 	m_fileName.clear();
 }