feat(headless): Implement ParticleSystemManagerDummy (#2247)

Author: bobtista

Core/GameEngine/Include/GameClient/ParticleSys.h

@@ -835,6 +835,21 @@ class ParticleSystemManager : public SubsystemInterface,
 	ParticleSystemIDMap m_systemMap; ///< a hash map of all particle systems
 };
 
+// TheSuperHackers @feature bobtista 31/01/2026
+// ParticleSystemManager that does nothing. Used for Headless Mode.
+class ParticleSystemManagerDummy : public ParticleSystemManager
+{
+public:
+	Int getOnScreenParticleCount() override { return 0; }
+	void doParticles(RenderInfoClass &rinfo) override {}
+	void queueParticleRender() override {}
+
+protected:
+	void crc( Xfer *xfer ) override {}
+	void xfer( Xfer *xfer ) override {}
+	void loadPostProcess() override {}
+};
+
 /// The particle system manager singleton
 extern ParticleSystemManager *TheParticleSystemManager;
 

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

@@ -95,7 +95,7 @@ class GameEngine : public SubsystemInterface
 	virtual FunctionLexicon *createFunctionLexicon() = 0;	///< Factory for Function Lexicon
 	virtual Radar *createRadar() = 0;											///< Factory for radar
 	virtual WebBrowser *createWebBrowser() = 0;						///< Factory for embedded browser
-	virtual ParticleSystemManager* createParticleSystemManager() = 0;
+	virtual ParticleSystemManager* createParticleSystemManager(Bool dummy) = 0;
 	virtual AudioManager *createAudioManager() = 0;				///< Factory for Audio Manager
 
 	Real m_logicTimeAccumulator; ///< Frame time accumulated towards submitting a new logic frame

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

@@ -455,7 +455,7 @@ void GameEngine::init()
 		initSubsystem(TheCaveSystem,"TheCaveSystem", MSGNEW("GameEngineSubsystem") CaveSystem(), nullptr);
 		initSubsystem(TheRankInfoStore,"TheRankInfoStore", MSGNEW("GameEngineSubsystem") RankInfoStore(), &xferCRC, nullptr, "Data\\INI\\Rank");
 		initSubsystem(ThePlayerTemplateStore,"ThePlayerTemplateStore", MSGNEW("GameEngineSubsystem") PlayerTemplateStore(), &xferCRC, "Data\\INI\\Default\\PlayerTemplate", "Data\\INI\\PlayerTemplate");
-		initSubsystem(TheParticleSystemManager,"TheParticleSystemManager", createParticleSystemManager(), nullptr);
+		initSubsystem(TheParticleSystemManager,"TheParticleSystemManager", createParticleSystemManager(TheGlobalData->m_headless), nullptr);
 		initSubsystem(TheFXListStore,"TheFXListStore", MSGNEW("GameEngineSubsystem") FXListStore(), &xferCRC, "Data\\INI\\Default\\FXList", "Data\\INI\\FXList");
 		initSubsystem(TheWeaponStore,"TheWeaponStore", MSGNEW("GameEngineSubsystem") WeaponStore(), &xferCRC, nullptr, "Data\\INI\\Weapon");
 		initSubsystem(TheObjectCreationListStore,"TheObjectCreationListStore", MSGNEW("GameEngineSubsystem") ObjectCreationListStore(), &xferCRC, "Data\\INI\\Default\\ObjectCreationList", "Data\\INI\\ObjectCreationList");

Generals/Code/GameEngineDevice/Include/Win32Device/Common/Win32GameEngine.h

@@ -33,6 +33,7 @@
 #pragma once
 
 #include "Common/GameEngine.h"
+#include "GameClient/ParticleSys.h"
 #include "GameLogic/GameLogic.h"
 #include "GameNetwork/NetworkInterface.h"
 #include "MilesAudioDevice/MilesAudioManager.h"
@@ -78,7 +79,7 @@ class Win32GameEngine : public GameEngine
 	virtual Radar *createRadar();											///< Factory for radar
 	virtual WebBrowser *createWebBrowser();						///< Factory for embedded browser
 	virtual AudioManager *createAudioManager();				///< Factory for audio device
-	virtual ParticleSystemManager* createParticleSystemManager();
+	virtual ParticleSystemManager* createParticleSystemManager(Bool dummy);
 
 
 protected:
@@ -93,7 +94,7 @@ inline ThingFactory *Win32GameEngine::createThingFactory() { return NEW W3DThing
 inline FunctionLexicon *Win32GameEngine::createFunctionLexicon() { return NEW W3DFunctionLexicon; }
 inline LocalFileSystem *Win32GameEngine::createLocalFileSystem() { return NEW Win32LocalFileSystem; }
 inline ArchiveFileSystem *Win32GameEngine::createArchiveFileSystem() { return NEW Win32BIGFileSystem; }
-inline ParticleSystemManager* Win32GameEngine::createParticleSystemManager() { return NEW W3DParticleSystemManager; }
+inline ParticleSystemManager* Win32GameEngine::createParticleSystemManager(Bool dummy) { return dummy ? static_cast<ParticleSystemManager*>(NEW ParticleSystemManagerDummy) : NEW W3DParticleSystemManager; }
 
 inline NetworkInterface *Win32GameEngine::createNetwork() { return NetworkInterface::createNetwork(); }
 inline Radar *Win32GameEngine::createRadar() { return NEW W3DRadar; }

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

@@ -94,7 +94,7 @@ class GameEngine : public SubsystemInterface
 	virtual FunctionLexicon *createFunctionLexicon() = 0;	///< Factory for Function Lexicon
 	virtual Radar *createRadar() = 0;											///< Factory for radar
 	virtual WebBrowser *createWebBrowser() = 0;						///< Factory for embedded browser
-	virtual ParticleSystemManager* createParticleSystemManager() = 0;
+	virtual ParticleSystemManager* createParticleSystemManager(Bool dummy) = 0;
 	virtual AudioManager *createAudioManager() = 0;				///< Factory for Audio Manager
 
 	Real m_logicTimeAccumulator; ///< Frame time accumulated towards submitting a new logic frame

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

@@ -548,7 +548,7 @@ void GameEngine::init()
 		initSubsystem(TheCaveSystem,"TheCaveSystem", MSGNEW("GameEngineSubsystem") CaveSystem(), nullptr);
 		initSubsystem(TheRankInfoStore,"TheRankInfoStore", MSGNEW("GameEngineSubsystem") RankInfoStore(), &xferCRC, nullptr, "Data\\INI\\Rank");
 		initSubsystem(ThePlayerTemplateStore,"ThePlayerTemplateStore", MSGNEW("GameEngineSubsystem") PlayerTemplateStore(), &xferCRC, "Data\\INI\\Default\\PlayerTemplate", "Data\\INI\\PlayerTemplate");
-		initSubsystem(TheParticleSystemManager,"TheParticleSystemManager", createParticleSystemManager(), nullptr);
+		initSubsystem(TheParticleSystemManager,"TheParticleSystemManager", createParticleSystemManager(TheGlobalData->m_headless), nullptr);
 
 	#ifdef DUMP_PERF_STATS///////////////////////////////////////////////////////////////////////////
 	GetPrecisionTimer(&endTime64);//////////////////////////////////////////////////////////////////

GeneralsMD/Code/GameEngineDevice/Include/Win32Device/Common/Win32GameEngine.h

@@ -33,6 +33,7 @@
 #pragma once
 
 #include "Common/GameEngine.h"
+#include "GameClient/ParticleSys.h"
 #include "GameLogic/GameLogic.h"
 #include "GameNetwork/NetworkInterface.h"
 #include "MilesAudioDevice/MilesAudioManager.h"
@@ -78,7 +79,7 @@ class Win32GameEngine : public GameEngine
 	virtual Radar *createRadar();											///< Factory for radar
 	virtual WebBrowser *createWebBrowser();						///< Factory for embedded browser
 	virtual AudioManager *createAudioManager();				///< Factory for audio device
-	virtual ParticleSystemManager* createParticleSystemManager();
+	virtual ParticleSystemManager* createParticleSystemManager(Bool dummy);
 
 
 protected:
@@ -93,7 +94,7 @@ inline ThingFactory *Win32GameEngine::createThingFactory() { return NEW W3DThing
 inline FunctionLexicon *Win32GameEngine::createFunctionLexicon() { return NEW W3DFunctionLexicon; }
 inline LocalFileSystem *Win32GameEngine::createLocalFileSystem() { return NEW Win32LocalFileSystem; }
 inline ArchiveFileSystem *Win32GameEngine::createArchiveFileSystem() { return NEW Win32BIGFileSystem; }
-inline ParticleSystemManager* Win32GameEngine::createParticleSystemManager() { return NEW W3DParticleSystemManager; }
+inline ParticleSystemManager* Win32GameEngine::createParticleSystemManager(Bool dummy) { return dummy ? static_cast<ParticleSystemManager*>(NEW ParticleSystemManagerDummy) : NEW W3DParticleSystemManager; }
 
 inline NetworkInterface *Win32GameEngine::createNetwork() { return NetworkInterface::createNetwork(); }
 inline Radar *Win32GameEngine::createRadar() { return NEW W3DRadar; }