Reset timer for Super Weapons

[FS-21]

• When this super weapon is clicked forces a countdown restart.
• To make Warhead or Weapon detonation at target cell tags work with this feature is needed to set SW.FirstClickRestartsTimer.ForceDetonations=yes.
• The cost of the super weapon can be substracted in the first click by setting SW.FirstClickRestartsTimer.Cost so Money.Amount isn't recommended here.
• SW.FirstClickRestartsTimer.AutoFire launchs the super weapon at the end of the first counter restart. Don't use the tag SW.AutoFire.
• SW.FirstClickRestartsTimer.RefundIfAborted refunds the paid cost if the SW is no longer available if the restarted countdown haven't finished.
• Designed with upgrades (or research) in mind, simplifying the number of workarounds. Probably some Ares tags are still recommended for this job.

In rulesmd.ini:

[SOMESW] ; Super Weapon
SW.FirstClickRestartsTimer=no ; boolean
SW.FirstClickRestartsTimer.AutoFire=no ; boolean
SW.FirstClickRestartsTimer.Cost=0 ; integer, always substract money
SW.FirstClickRestartsTimer.RefundIfAborted=no ; boolean
Message.InsufficientFunds= ; CSF entry key
Message.RestartedTimer= ; CSF entry key
EVA.RestartedTimer= ; EVA entry

[github-actions]

Nightly build for this pull request:

• compiled-dll-48bd937002a6b16cc59f5c0456fa02672ad33b55.zip
  These artifacts will expire in 90 days and will not be available for download after that time.

This comment is automatic and is meant to allow guests to get latest nightly builds for this pull request without registering. It is updated on every successful build.

[FS-21]

If you want a model for testing it I posted an example in action of what I'm going to use in my case:
Initially starts "ready" to be clicked, then it starts the SW timer and substracts the money and when the counter reaches 0:00 auto-launchs the upgrade SW. Once upgraded all units will be converted into the new model and in the sidebar the old model will be replaced by the new upgraded one thanks to the "LimboDelivery" tags in Prerequisite tags.

[LimboUpgrade_SW01]
UIName=NAME:LimboUpgrade_SW01
UIDescription=UID:LimboUpgrade_SW01
Name=Devout upgrade
SidebarPCX=limboupgrade_sw01.pcx
IsPowered=false
DisableableFromShell=no
FlashSidebarTabFrames=0
RechargeTime=5
SW.InitialReady=yes
Type=GenericWarhead
Action=Custom
AIDefendAgainst=no
SW.CreateRadarEvent=no
ShowTimer=no
Range=1
LineMultiplier=1
EVA.Ready=EVA_UpgradeComplete
Text.Ready=NOSTR:
Text.Preparing=NOSTR:
RechargeVoice=;
ChargingVoice=;
ImpatientVoice=;
EVA.Impatient=EVA_UpgradeInProgress
SuspendVoice=;
SW.MaxCount=1
SW.Shots=1
SW.UseAITargeting=yes
SW.AITargeting.Constraints=none
SW.AITargeting=Self
Cursor=GenericGreen ; No cursor will be used here!
NoCursor=NoGenericGreen ; No cursor will be used here!
SW.FireIntoShroud=yes
; Make new upgraded object the new default unit in the sidebar
LimboDelivery.Types=LIMBOUPGRADE_01 ; List of BuildingTypes that will use in "Prerequisites" tag the new upgraded unit
LimboDelivery.IDs=1
;LimboDelivery.RollChances=100%
SW.NegBuildings=LIMBOUPGRADE_01 ; Once upgraded this can't be upgraded again using this SW
; Convert existing old objects in the battlefield
Convert.From=DEVOUT ; Old unit
Convert.To=DEVOUT2 ; New unit
Convert.AffectedHouses=owner
; Tags related to SW timer reset
SW.FirstClickRestartsTimer=yes
SW.FirstClickRestartsTimer.AutoFire=yes
SW.FirstClickRestartsTimer.Cost=-10000 ; Pay for starting the upgrade process...
Message.InsufficientFunds=;
Message.RestartedTimer=;
EVA.RestartedTimer=EVA_UpgradeInProgress

[Metadorius]

SW.FirstClickRestartsTimer.AutoFire.ForceDetonations=yes

holy mother of god

[FS-21]

SW.FirstClickRestartsTimer.AutoFire.ForceDetonations=yes

holy mother of god

Mistake, I left it as SW.FirstClickRestartsTimer.ForceDetonations=yes in the code. I updated the comments and the docs

[MortonPL]

• Use false instead of no in documentation.
• SW.FirstClickRestartsTimer.Cost should accept both negative and positive values, like in vanilla (also positive/negative refunds).
• EVA.RestartedTimer, Message.InsufficientFunds and Message.RestartedTimer should be mentioned in the documentation.

[FS-21]

Applied feedback.

[FS-21]

I'll close this pull request because there is a desync I can't fix in the hook at 0x6CBCD4 .