fix(input): Fix double-click fast drive timing in ParticleUplinkCannon

GeneralsMD/Code/GameEngine/Include/GameClient/CommandXlat.h

@@ -56,6 +56,11 @@ class CommandTranslator : public GameMessageTranslator
 	UnsignedInt m_mouseRightDown;	// when the mouse down happened
 	UnsignedInt m_mouseRightUp;		// when the mouse up happened
 
+#if !RETAIL_COMPATIBLE_CRC
+	// TheSuperHackers @feature bobtista 01/08/2026 Double-click detection for fast beam mode
+	UnsignedInt m_lastSpecialPowerOverrideClickTime;	// real time of last special power override destination click
+#endif
+
 	GameMessage::Type createMoveToLocationMessage( Drawable *draw, const Coord3D *dest, CommandEvaluateType commandType );
 	GameMessage::Type createAttackMessage( Drawable *draw, Drawable *other, CommandEvaluateType commandType );
 	GameMessage::Type createEnterMessage( Drawable *enter, CommandEvaluateType commandType );

GeneralsMD/Code/GameEngine/Include/GameLogic/AI.h

@@ -959,7 +959,7 @@ class AIGroup : public MemoryPoolObject, public Snapshot
 	void groupDoCommandButtonUsingWaypoints( const CommandButton *commandButton, const Waypoint *way, CommandSourceType cmdSource );
 	void groupDoCommandButtonAtObject( const CommandButton *commandButton, Object *obj, CommandSourceType cmdSource );
 	void groupSetEmoticon( const AsciiString &name, Int duration );
-	void groupOverrideSpecialPowerDestination( SpecialPowerType spType, const Coord3D *loc, CommandSourceType cmdSource );
+	void groupOverrideSpecialPowerDestination( SpecialPowerType spType, const Coord3D *loc, CommandSourceType cmdSource, Bool useFastDrive = FALSE ); ///< TheSuperHackers @feature bobtista 01/08/2026 Added useFastDrive parameter
 
 	void setAttitude( AttitudeType tude );	///< set the behavior modifier for this agent
 	AttitudeType getAttitude( void ) const;				///< get the current behavior modifier state

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/BattlePlanUpdate.h

@@ -141,7 +141,7 @@ class BattlePlanUpdate : public SpecialPowerUpdateModule
 	virtual SpecialPowerUpdateInterface* getSpecialPowerUpdateInterface() { return this; }
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const { return false; } //Is it active now?
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const { return false; }	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc ) {}
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ) {}
 	virtual Bool isPowerCurrentlyInUse( const CommandButton *command = NULL ) const;
 
 	//Returns the currently active battle plan -- unpacked and ready... returns PLANSTATUS_NONE if in transition!

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/MissileLauncherBuildingUpdate.h

@@ -106,7 +106,7 @@ class MissileLauncherBuildingUpdate : public SpecialPowerUpdateModule
 	SpecialPowerTemplate* getTemplate() const;
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const { return false; } //Is it active now?
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const { return false; }	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc ) {}
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ) {}
 
 	virtual SpecialPowerUpdateInterface* getSpecialPowerUpdateInterface() { return this; }
 	virtual CommandOption getCommandOption() const { return (CommandOption)0; }

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/ParticleUplinkCannonUpdate.h

@@ -182,7 +182,7 @@ class ParticleUplinkCannonUpdate : public SpecialPowerUpdateModule
 
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const; //Is it active now?
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const { return true; }	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc );
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ); ///< TheSuperHackers @feature bobtista 01/08/2026 Added useFastDrive parameter
 
 	// Disabled conditions to process (termination conditions!)
 	virtual DisabledMaskType getDisabledTypesToProcess() const { return MAKE_DISABLED_MASK4( DISABLED_SUBDUED, DISABLED_UNDERPOWERED, DISABLED_EMP, DISABLED_HACKED ); }
@@ -239,4 +239,7 @@ class ParticleUplinkCannonUpdate : public SpecialPowerUpdateModule
 	Bool						m_manualTargetMode;
 	Bool						m_scriptedWaypointMode;
 	Bool						m_clientShroudedLastFrame;
+#if !RETAIL_COMPATIBLE_CRC
+	Bool						m_useFastDrive; ///< TheSuperHackers @feature bobtista 01/08/2026 Fast beam mode from explicit message
+#endif
 };

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/SpecialAbilityUpdate.h

@@ -184,7 +184,7 @@ class SpecialAbilityUpdate : public SpecialPowerUpdateModule
 	virtual Bool isActive() const { return m_active; }
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const { return false; } //Is it active now?
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const { return false; }	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc ) {}
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ) {}
 	virtual Bool isPowerCurrentlyInUse( const CommandButton *command = NULL ) const;
 
 //	virtual Bool isBusy() const { return m_isBusy; }

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/SpecialPowerUpdateModule.h

@@ -46,7 +46,7 @@ class SpecialPowerUpdateInterface
 	virtual CommandOption getCommandOption() const = 0;
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const = 0; //Is it active now?
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const = 0;	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc ) = 0;
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ) = 0; ///< TheSuperHackers @feature bobtista 01/08/2026 Added useFastDrive parameter
 	virtual Bool isPowerCurrentlyInUse( const CommandButton *command = NULL ) const = 0;
 };
 
@@ -74,7 +74,7 @@ class SpecialPowerUpdateModule : public UpdateModule, public SpecialPowerUpdateI
 	virtual CommandOption getCommandOption() const = 0;
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const = 0; //Is it active now?
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const = 0;	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc ) = 0;
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ) = 0; ///< TheSuperHackers @feature bobtista 01/08/2026 Added useFastDrive parameter
 	virtual Bool isPowerCurrentlyInUse( const CommandButton *command = NULL ) const = 0;
 
 };

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/SpectreGunshipDeploymentUpdate.h

@@ -129,7 +129,7 @@ class SpectreGunshipDeploymentUpdate : public SpecialPowerUpdateModule
 
   virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const { return FALSE; };
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const { return FALSE; }	//Does it have it, even if it's not active?
-  virtual void setSpecialPowerOverridableDestination( const Coord3D *loc ) {};
+  virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE ) {};
 
 	// Disabled conditions to process (termination conditions!)
 	virtual DisabledMaskType getDisabledTypesToProcess() const { return MAKE_DISABLED_MASK4( DISABLED_SUBDUED, DISABLED_UNDERPOWERED, DISABLED_EMP, DISABLED_HACKED ); }

GeneralsMD/Code/GameEngine/Include/GameLogic/Module/SpectreGunshipUpdate.h

@@ -116,7 +116,7 @@ class SpectreGunshipUpdate : public SpecialPowerUpdateModule
 
 	virtual Bool doesSpecialPowerHaveOverridableDestinationActive() const;
 	virtual Bool doesSpecialPowerHaveOverridableDestination() const { return true; }	//Does it have it, even if it's not active?
-	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc );
+	virtual void setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive = FALSE );
 
 	// Disabled conditions to process (termination conditions!)
 	virtual DisabledMaskType getDisabledTypesToProcess() const { return MAKE_DISABLED_MASK4( DISABLED_SUBDUED, DISABLED_UNDERPOWERED, DISABLED_EMP, DISABLED_HACKED ); }

GeneralsMD/Code/GameEngine/Source/GameClient/MessageStream/CommandXlat.cpp

@@ -1462,6 +1462,9 @@ CommandTranslator::CommandTranslator() :
 	m_teamExists(false),
 	m_mouseRightDown(0),
 	m_mouseRightUp(0)
+#if !RETAIL_COMPATIBLE_CRC
+	, m_lastSpecialPowerOverrideClickTime(0)
+#endif
 {
 	m_mouseRightDragAnchor.x = 0;
 	m_mouseRightDragAnchor.y = 0;
@@ -1836,11 +1839,23 @@ GameMessage::Type CommandTranslator::evaluateContextCommand( Drawable *draw,
 				msgType = GameMessage::MSG_DO_SPECIAL_POWER_OVERRIDE_DESTINATION;
 				if( type == DO_COMMAND )
 				{
+#if !RETAIL_COMPATIBLE_CRC
+					// TheSuperHackers @feature bobtista 01/08/2026 Double-click detection for fast beam mode.
+					// Detect double-clicks using real time instead of frame-based logic for consistent timing.
+					const UnsignedInt DOUBLE_CLICK_DELAY_MS = 500;
+					UnsignedInt nowMs = timeGetTime();
+					Bool isDoubleClick = (nowMs - m_lastSpecialPowerOverrideClickTime) < DOUBLE_CLICK_DELAY_MS;
+					m_lastSpecialPowerOverrideClickTime = nowMs;
+#endif
+
 					GameMessage *gameMsg = TheMessageStream->appendMessage( msgType );
 
 					gameMsg->appendLocationArgument( *pos );
 					gameMsg->appendIntegerArgument( SPECIAL_INVALID );
 					gameMsg->appendObjectIDArgument( INVALID_ID );	// no specific source
+#if !RETAIL_COMPATIBLE_CRC
+					gameMsg->appendBooleanArgument( isDoubleClick );	// TheSuperHackers @feature bobtista 01/08/2026 Fast beam mode flag
+#endif
 
 				}
 

GeneralsMD/Code/GameEngine/Source/GameLogic/AI/AIGroup.cpp

@@ -3297,7 +3297,9 @@ void AIGroup::groupSetEmoticon( const AsciiString &name, Int duration )
 }
 
 //-----------------------------------------------------------------------------
-void AIGroup::groupOverrideSpecialPowerDestination( SpecialPowerType spType, const Coord3D *loc, CommandSourceType cmdSource )
+// TheSuperHackers @feature bobtista 01/08/2026 Added useFastDrive parameter
+//-----------------------------------------------------------------------------
+void AIGroup::groupOverrideSpecialPowerDestination( SpecialPowerType spType, const Coord3D *loc, CommandSourceType cmdSource, Bool useFastDrive )
 {
 	std::list<Object *>::iterator i;
 	for( i = m_memberList.begin(); i != m_memberList.end(); ++i )
@@ -3308,7 +3310,7 @@ void AIGroup::groupOverrideSpecialPowerDestination( SpecialPowerType spType, con
 			SpecialPowerUpdateInterface *spuInterface = object->findSpecialPowerWithOverridableDestinationActive( spType );
 			if( spuInterface )
 			{
-				spuInterface->setSpecialPowerOverridableDestination( loc );
+				spuInterface->setSpecialPowerOverridableDestination( loc, useFastDrive );
 			}
 		}
 	}

GeneralsMD/Code/GameEngine/Source/GameLogic/Object/Update/ParticleUplinkCannonUpdate.cpp

@@ -188,6 +188,9 @@ ParticleUplinkCannonUpdate::ParticleUplinkCannonUpdate( Thing *thing, const Modu
 	m_lastDrivingClickFrame = 0;
 	m_2ndLastDrivingClickFrame = 0;
 	m_clientShroudedLastFrame = FALSE;
+#if !RETAIL_COMPATIBLE_CRC
+	m_useFastDrive = FALSE;
+#endif
 
 	for( Int i = 0; i < MAX_OUTER_NODES; i++ )
 	{
@@ -369,14 +372,19 @@ Bool ParticleUplinkCannonUpdate::isPowerCurrentlyInUse( const CommandButton *com
 }
 
 //-------------------------------------------------------------------------------------------------
-void ParticleUplinkCannonUpdate::setSpecialPowerOverridableDestination( const Coord3D *loc )
+// TheSuperHackers @feature bobtista 01/08/2026 Added useFastDrive parameter
+//-------------------------------------------------------------------------------------------------
+void ParticleUplinkCannonUpdate::setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive )
 {
 	if( !getObject()->isDisabled() )
 	{
 		m_overrideTargetDestination = *loc;
 		m_manualTargetMode = TRUE;
 		m_2ndLastDrivingClickFrame = m_lastDrivingClickFrame;
 		m_lastDrivingClickFrame = TheGameLogic->getFrame();
+#if !RETAIL_COMPATIBLE_CRC
+		m_useFastDrive = useFastDrive;
+#endif
 	}
 }
 
@@ -568,7 +576,14 @@ UpdateSleepTime ParticleUplinkCannonUpdate::update()
 			else
 			{
 				Real speed = data->m_manualDrivingSpeed;
+
+				// TheSuperHackers @feature bobtista 01/08/2026 Use explicit fast drive flag in non-retail builds.
+				// In retail builds, use the original frame-based double-click detection.
+#if !RETAIL_COMPATIBLE_CRC
+				if( m_scriptedWaypointMode || m_useFastDrive )
+#else
 				if( m_scriptedWaypointMode || m_lastDrivingClickFrame - m_2ndLastDrivingClickFrame < data->m_doubleClickToFastDriveDelay )
+#endif
 				{
 					//Because we double clicked, use the faster driving speed.
 					speed = data->m_manualFastDrivingSpeed;

GeneralsMD/Code/GameEngine/Source/GameLogic/Object/Update/SpectreGunshipUpdate.cpp

@@ -284,7 +284,7 @@ Bool SpectreGunshipUpdate::isPowerCurrentlyInUse( const CommandButton *command )
 }
 
 //-------------------------------------------------------------------------------------------------
-void SpectreGunshipUpdate::setSpecialPowerOverridableDestination( const Coord3D *loc )
+void SpectreGunshipUpdate::setSpecialPowerOverridableDestination( const Coord3D *loc, Bool useFastDrive )
 {
 	Object *me = getObject();
 	if( !me->isDisabled() )

GeneralsMD/Code/GameEngine/Source/GameLogic/System/GameLogicDispatch.cpp

@@ -1209,11 +1209,19 @@ void GameLogic::logicMessageDispatcher( GameMessage *msg, void *userData )
 
 			ObjectID sourceID = msg->getArgument(2)->objectID;
 			Object* source = findObjectByID(sourceID);
+
+#if !RETAIL_COMPATIBLE_CRC
+			// TheSuperHackers @feature bobtista 01/08/2026 Fast beam mode from bool argument
+			Bool useFastDrive = msg->getArgumentCount() > 3 ? msg->getArgument(3)->boolean : FALSE;
+#else
+			Bool useFastDrive = FALSE;
+#endif
+
 			if (source != NULL)
 			{
 				AIGroupPtr theGroup = TheAI->createGroup();
 				theGroup->add(source);
-				theGroup->groupOverrideSpecialPowerDestination( spType, loc, CMD_FROM_PLAYER );
+				theGroup->groupOverrideSpecialPowerDestination( spType, loc, CMD_FROM_PLAYER, useFastDrive );
 #if RETAIL_COMPATIBLE_AIGROUP
 				TheAI->destroyGroup(theGroup);
 #else
@@ -1224,7 +1232,7 @@ void GameLogic::logicMessageDispatcher( GameMessage *msg, void *userData )
 			{
 				if( currentlySelectedGroup )
 				{
-					currentlySelectedGroup->groupOverrideSpecialPowerDestination( spType, loc, CMD_FROM_PLAYER );
+					currentlySelectedGroup->groupOverrideSpecialPowerDestination( spType, loc, CMD_FROM_PLAYER, useFastDrive );
 				}
 			}