Battle Points economy for super weapons

[FS-21]

• This system displayes a new currency to be used (optionally) in Super Weapons.
• The new currency will be modified by the kills against other players and the system is enabled.
• If set BattlePointsCollector in any structure then the system will be enabled if the structure is built.
• If set BattlePoints in houses they will have the system enabled by default.
• If set [General] -> BattlePoints enables/disables the system for every player in the scenario, overriding the country preferences & BattlePointsCollector setting.
• If set [General] -> BattlePoints.DefaultValue and the enemy destroyed object doesn't have a value then this generic value will be used instead.
• If set [General] -> BattlePoints.DefaultFriendlyValue and the friendly destroyed object doesn't have a value then this generic value will be used instead. This tag doesn't work with the own objects of the player.
• If is set BattlePoints.CanUseStandardPoints and the destroyed object doesn't have the BattlePoints value then the points are obtained from the Points tag of the destroyed object. If BattlePoints.DefaultValue is present then this will be ignored.
• If set BattlePoints in the destroyed object the calculation is made with this value. Self-Kills done by the own player doesn't count in this system.
• If BattlePoints.Amount is set with a value different from 0 then the super weapon is influenced by this system. If the value is positive then this super weapon won't be launched until the affected player gathered the required ammount.

In uimd.ini:

[Sidebar]
BattlePointsSidebar.Label=<none>                ; CSF entry key `★ <VALUE>`, code U+2605
BattlePointsSidebar.Label.InvertPosition=false  ; bool, `<VALUE> ★`, code U+2605

[ToolTips]
BattlePoints.Label=<none>                       ; CSF entry key, default to `★: <VALUE>`, code U+2605

In rulesmd.ini:

[General]
BattlePoints=                            ; bool
BattlePoints.DefaultValue=               ; int
BattlePoints.DefaultFriendlyValue=       ; int

[SOMESIDE]                               ; Side
Sidebar.BattlePoints.Offset=0,0          ; X,Y, pixels relative to default
Sidebar.BattlePoints.Color=              ; integer - R,G,B
Sidebar.BattlePoints.Align=Left          ; Left, Right, Center/Centre

[SOMECOUNTRY]                            ; HouseType
BattlePoints=false                       ; bool
BattlePoints.CanUseStandardPoints=false  ; bool

[SOMEBUILDING]                           ; BuildingType
BattlePointsGenerator=                   ; bool

[SOMETECHNO]                             ; TechnoType
BattlePoints=                            ; int

[SOMESW]
BattlePoints.Amount=0                    ; int

[FS-21]

Tested in online and AI respect the points requisite.
I painted this symbol for the code U+2605 for the test in the game.fnt file:

[github-actions]

Nightly build for this pull request:

• compiled-dll-d94fc59dc837471af98e733304531cf80c2bc6ff.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]

Renamed tag from BattlePointsGenerator to BattlePointsCollector and updated docs and first message

[TaranDahl]

It would be best if it could optionally display a FlyingString when obtaining BattlePoints, just like the bounty of Ares.

[FS-21]

It would be best if it could optionally display a FlyingString when obtaining BattlePoints, just like the bounty of Ares.

I prefer keeping the base foundation of the feature simple for a faster merge and in new PRs adding other features (or let other devs to develop them), like:

• Oil Derrick style for generating points overtime.
• Points in crates
• Map Events/Actions for checking & manipulating values.
• Support for non-SW (structures & units like if it was "money")
• Flying strings as you suggested
• ...

[TaranDahl]

LGTM.

[ayylmaoRotE]

These 2 tags are not working:

BattlePointsCollector=true
BattlePointsGenerator=true

Is not working for me at the Techno level (building), can only get it to work at [General] with BattlePoints=true, the documentation states otherwise that you can enable this system with a building instead - can you please confirm. Side also does not work with BattlePoints=true

[FS-21]

I just tested now in my mod and it works.

With default settings, if you want a structure that enables the logic just put in teh structure:
BattlePointsCollector=yes

As soon as it is built your value indicator appears in the sidebar.
AAAAAAAND, by default you get no points, unlike Ares bounty logic that forces you to put the value in all objects here just put a default value in:
[General]
BattlePoints.DefaultValue= ; int
And done (if you wanted it a bit simple for testing purposes)
For example 100:
[General]
BattlePoints.DefaultValue=100

So the counter will appear and enable the count after new kills (+100 each enemy kill) when the structure is built.
If the collector structure is sold or destroyed the counter dissappears from the sidebar (and resumed the counter) when built again.

If you want it always enabled in a specific house istead of waiting to build a structure then:
[SOMECOUNTRY]
BattlePoints=true

With my mod settings (when the collector is built the system is enabled):
https://github.com/user-attachments/assets/f7148390-a727-41b6-9bfc-b07497f48740

[FS-21]

What I missed is the updated documentation here in the first post so I'll update because it isn't called generator, now is collector

[Coronia]

Increase the rank of this PR to T3, since the essential of this is about adding a 'secondary resource' to the game, which need careful design for its functionality, interaction with various things and method of implementation first. We could indeed merge this PR first, but a rough structure of its future development needs to be decided I think. Hope @Metadorius and others could give some thought about it