Empires BattleBoard

UI

There is a custom 3d UI object for displaying an animated battle board. It can be added to a UI by adding a "CUSTOM" type object to a UI with the additional tag "BATTLEBOARD" and a number of optional parameters to control formatting and behaviour. For example:

[BattleSummary3D]
TYPE Custom
BattleBoard
WIDTH 868
HEIGHT 618
DX 0
DY 0
COLOUR 0f200f
MINLINES 3
MINLINELENGTH 4
UNITSPACING 8
CENTERGAP 12
ASSETSCALE 7
EVENTFRAMES 60
EVENTATTACKFRAME 10
EVENTDAMAGEFRAME 18
HITSTEXTCOLOUR $COL_RED
EFFECTEXTCOLOUR $COL_YELLOW
TEXTSTEP 2.5
FONT LARGEFONT

• COLOUR controls the background colour, use 0 for transparent
• MINLINES is the minimum number of battle lines per side to show on the battle board regardless of the number of units present (the view will zoom out to show additional lines if required)
• MINLINELENGTH is the minimum number of slots per wing to show on the battle board regardless of the number of units present (the view will zoom out to show additional lines if required)
• UNITSPACING is the distance between units
• CENTERGAP is an additional space between the front lines of opposing armies
• ASSETSCALE is a scale factor for the units (the scale used the AssetScale from UNITS.CSV in thousandths, divided by this value)
• EVENTFRAMES is the number of logical frames (1/30 s) used to display each battle event
• EVENTATTACKFRAME is the frame within a battle event where the attack animation starts
• EVENTDAMAGEFRAME is the frame within a battle event where the damage is applied
• HITSTEXTCOLOUR is the colour used for hit damage text
• EFFECTEXTCOLOUR is the colour used for effec damage text
• FONT is the font used for pop up text