RANGE, REGIMENTS AND RENOWN REBALANCE  (for 0 A.D. 0.28.0)
==========================================================

ENABLE
  Main menu > Settings > Mod Selection > select "rrr_rebalance" > Enable > Save and Restart.
  It replaces the earlier "regiment_units" and "star_ranks" mods (both are inside it now).
  Works for every civilization, alone or together with "thebans" and "theban_legends".
  Start a new match after enabling it. Not multiplayer-safe unless every player runs it.

THREE PARTS
  RANGE      buildings and mounted troops share out their arrows instead of emptying them into one man;
             mounted archers and javelin throwers shoot on the move; missiles scatter against moving targets.
             Longer siege ranges; engines on every Fortress and artillery tower; garrisons shoot their own weapons.
  REGIMENTS  8, 20 or 40 soldiers as one unit with one health bar, formations, forming and disbanding.
  RENOWN     ranks beyond Elite: bronze, silver and gold stars, and the Gold Wreath for champions and heroes.
  To remove the mod: disable it in Mod Selection, then delete this "rrr_rebalance" folder.

=============
PART 1: RANGE
=============

ARROW VOLLEYS  (all civilizations)
  Buildings no longer empty every arrow into one target in a few tight bursts.
  Arrows are loosed one or two at a time over three quarters of the reload and shared out
  between the enemies in range; with few enemies the fire concentrates on them.
  A target you order by right-click still gets every arrow.
  Tower and Fortress arrows also scatter twice as much, so some miss.
  Knobs: volleyStagger and randomTargetChance at the top of simulation/components/BuildingAI.js;
  <Spread> in simulation/templates/template_structure_defensive_tower.xml (2.0, was 1.0)
  and template_structure_military_fortress.xml (2.5, was 1.25).
  To go back to the original behaviour delete those three files.

SIEGE RANGES  (all civilizations)
  Bolt Shooters reach 20 to 125 m (was 15 to 80), Stone Throwers 125 m (was 85), Onagers 125 m
  (was 60). Bolt Towers 20 to 125 m (was 30 to 90), Artillery Towers 125 m (was 80).
  Files: simulation/templates/template_unit_siege_boltshooter.xml, _stonethrower.xml,
  _stonethrower_onager.xml, template_structure_defensive_tower_bolt.xml, _artillery.xml.

ENGINES ON FORTRESSES AND ARTILLERY TOWERS  (all civilizations)
  Fortress         a Bolt Shooter, a Stone Thrower and a Fire Catapult fire on their own, beside
                   the arrows. Health 10,400 (was 5,200).
  Artillery Tower  a Stone Thrower and a Fire Catapult, beside its own stones. Health 2,800 (was 1,400).
  Bolt Tower       a Bolt Shooter, beside its own bolts. Health 2,800 (was 1,400).
  The engines have the range and reload of the siege engines: Bolt Shooter 20-125 m, 240 pierce
  every 7 s; Stone Thrower 5-125 m, 230 crush every 12 s; Fire Catapult 32-150 m, 75 crush +
  75 fire and a burning 3.5 m burst (30 crush + 45 fire, then 4 fire a second for 10 s) every
  17 s. They pick their own targets, cannot be selected or hurt, and go when the
  building goes. Ordinary Sentry, Defense and Wall Towers are unchanged.
  Still Iberian only: engines on their ordinary towers, the rapid Fortress Bolt Shooter, and the
  Citadel upgrade (15,600 health, a second set of engines, the Fire Projector). See below.
  Files: simulation/templates/units/engines/ (the three engines; change their numbers there),
  the <TurretHolder> block and <Health> in template_structure_military_fortress.xml,
  template_structure_defensive_tower_bolt.xml and _artillery.xml; simulation/components/TowerEngine.js.

IBERIAN TOWERS AND FORTRESS
  Iberian towers carry siege engines that fire on their own, on top of the normal arrows:
    Tier 1  Sentry Tower     Bolt Shooter (60 m)
    Tier 2  Defense Tower    Bolt Shooter + Lithobolos (60 m)
    Tier 3  Artillery Tower  Bolt Shooter + Lithobolos (125 m) + Fire Catapult (150 m)
    Wall Turret              no engine: only the missile troops garrisoned inside shoot
    Fortress                 Bolt Shooter at 4x speed (1.5 s) + Lithobolos + Fire Catapult (150 m)
    Citadel                  two of each Fortress engine, Fire Catapult burst doubled to 7 m, Fire Projector
  Upgrades: Sentry to Defense (Town Phase, 250 stone, unchanged),
            Defense to Artillery (City Phase, 300 wood 600 stone),
            Fortress to Citadel (City Phase, 1,600 stone 800 metal).
  Only the Citadel carries a Fire Projector (the towers and the Fortress no longer do): 0 to 20 m,
  one burst of fire a second (60 fire, 30 more in a 5 m splash, then burning), prefers siege engines.
  Engine ranges and reloads on buildings:
    Bolt Shooter   20 to 125 m, 7 s   (Fortress 1.5 s; Sentry and Defense Tower 10 to 60 m)
    Lithobolos      5 to 125 m, 12 s  (Defense Tower 5 to 60 m)
    Fire Catapult  32 to 150 m, 17 s  (the same on every civilization's Fortress)
  The 60 m engines are units/iber/tower_oxybeles_short.xml and tower_lithobolos_short.xml;
  change <MaxRange> there (and <Vision>) to give the ordinary towers more or less reach.
  The Iberian engines are in simulation/templates/units/iber/ (tower_oxybeles.xml, tower_lithobolos.xml and
  tower_firecatapult.xml are the engines every Fortress carries; tower_flamethrower.xml, fortress_oxybeles.xml,
  fortress_firecatapult.xml and the two _short ones are Iberian only).
  To change which building gets what, edit the <TurretHolder> block in
  simulation/templates/structures/iber/sentry_tower.xml, defense_tower.xml,
  tower_artillery.xml, wall_tower.xml, fortress.xml and fortress_citadel.xml.
  Upgrade prices are the <Upgrade><Cost> blocks in defense_tower.xml and fortress.xml.
  Hit points are doubled: Sentry 800, Defense 4,800, Artillery 6,720, Wall Turret 8,000,
  Fortress 10,400, Citadel 15,600.
  The walls Iberians start with on most maps have Wall Turrets; garrison missile infantry in them to defend the wall.

HAN TOWERS
  Hit points are four times the usual: Sentry 1,600, Defense 4,000, Great Tower 8,000.
  The Great Tower (up to three per player, was one; upgraded from a Defense Tower in City Phase, now
  200 wood 400 stone) shoots its arrows 170 m, 20 m further than any Fortress's Fire
  Catapult, and carries its own Fire Catapult: 32 to 170 m, one shot every 17 s
  (units/han/tower_firecatapult.xml).
  Files: simulation/templates/structures/han/sentry_tower.xml, defense_tower.xml, defense_tower_great.xml;
  the limit is <GreatTower> in simulation/templates/special/players/han.xml.

ROMAN FIRE CATAPULT  (Ballista Ignifera; was the Theban Fire Catapult)
  Built at the Roman Arsenal, for the price of a Ballista. Burning stones, 75 crush + 75 fire,
  a 3.5 m burst (30 crush + 45 fire) and 10 s of burning (4 fire a second); 32 to 150 m, same reload
  as the Ballista (7 s).
  Files: simulation/templates/units/rome/siege_firecatapult_packed.xml and _unpacked.xml;
  the <Trainer> line in simulation/templates/structures/rome/arsenal.xml. Thebans no longer build it.

GARRISONS SHOOT THEIR OWN WEAPONS  (all civilizations; towers, fortresses, Civic Centers, Siege Towers)
  Only troops with a missile weapon add to a building's fire. Each one shoots that weapon from
  the building: his own damage, missile, range and reload (an archer 60 m every 1.25 s, a slinger
  45 m, a javelineer 30 m but hitting hardest). Range is counted from the top of the building, so
  he reaches a little further than on the ground; upgrades and star ranks he has count.
  A longer-ranged man makes the building notice enemies further out. Spearmen, swordsmen and
  other melee troops add no arrows (they still hold the building against capture).
  The building's own arrows are unchanged. Bolt and Artillery Towers now take shooters too.
  The projectile limit of a Sentry Tower still caps how many may shoot. "Crenellations" and
  Caros (more arrows per garrisoned soldier) now make the garrison reload that much faster.
  Knob: garrisonShotJitter at the top of simulation/components/BuildingAI.js.

LEAVING AT THE LAST MOMENT  (towers, wall towers and fortresses)
  Troops thrown out when the building gives way (at 10% health for towers, 7.5% for fortresses,
  or destroyed with them inside) lose half the health they have left.
  Troops you pull out while the building is below 25% health and was hit in the last 10 seconds
  lose a quarter. Leaving earlier, or a damaged building nobody is attacking, costs nothing.
  Nobody dies of it. Knobs: the five values at the top of simulation/components/GarrisonCollapse.js.

MOUNTED ARCHERS AND JAVELINEERS  (all civilizations)
  They shoot or throw at any enemy in range while they ride, flee or stand, one missile per reload
  as before (the Siege Tower's mechanism). Horse and camel riders are animated doing it: the mount
  keeps trotting or galloping while the rider looses. Chariots are not animated this way.
  Mounted archers have 5 m less range than foot archers (55 m instead of 60 m).
  Both scatter more against moving targets. Javelins: <SpreadPerTargetSpeed> (0.33) is added to
  <Spread> for every meter per second the target moves. Archers: <SpreadPerTargetSpeedSquared>
  (0.0085) is added per (meter per second) squared, so cavalry are much harder to hit than infantry.
  Aimed at, for a lone target at full range: archers 9 in 10 standing, 6 in 10 walking infantry,
  4 in 10 riding cavalry; javelins 10 in 10, 5 in 10, 4 in 10. <SpreadCap> stops the scatter
  growing past a ceiling against men on foot (Infantry and Support), so even a running man is hit
  about 4 in 10 at full range. Stray missiles still hit whoever is
  standing where they land, so tight groups keep soaking them up.
  Files: simulation/templates/template_unit_cavalry_ranged_archer.xml and _javelineer.xml, the
  champion_ and hero_ versions of both, units/pers/champion_cavalry_archer.xml,
  units/iber/champion_cavalry.xml, units/brit/hero_boudicca_cavalry_javelineer.xml;
  simulation/components/Attack.js (three small changes) and BuildingAI.js; the walk_attack /
  run_attack lines in eleven files under art/variants (the speed= numbers set how fast the rider
  goes through the motion).

=================
PART 2: REGIMENTS
=================

  Regiments: a block of soldiers as ONE unit, with one health bar, one set of orders and one
  target search. Every civilization gets four, built from its own soldiers, trained at the
  Civic Center or the Barracks:
    melee regiment of 8 and of 20, ranged regiment of 8 and of 20
    civ    melee from             ranged from
    athen  Athenian Hoplite       Athenian Slinger Militia
    spart  Perioikoi Hoplite      Helot Skirmisher
    mace   Foot Companion         Agrianian Peltast
    theb   Theban Hoplite         Cretan Mercenary Archer
    rome   Roman Swordsman        Roman Skirmisher
    pers   Shield Bearer          Sogdian Archer
    cart   Libyan Spearman        Mauritanian Archer
    gaul   Spearman               Infantry Javelineer
    brit   Celtic Spearman        Celtic Slinger
    iber   Swordsman              Infantry Javelineer
    maur   Bamboo Spearman        Longbowman
    kush   Nubian Spearman        Nubian Archer
    ptol   Egyptian Pikeman       Judean Slinger
    sele   Phalangite             Arab Javelineer
    han    Spearman               Infantry Crossbowman
    germ   Cimbrian Spearman      Celto-Germanic Slinger
  (The Theban ones live in the "thebans" mod and need both mods enabled; their Cretan archers
  need Town Phase, like the soldier they are made of.)

  PRICE   The soldiers' own prices added up, with a bulk discount:
            8 men: 25% off the cost, 25% off the training time   (hoplites: 300 food 300 wood, 60 s)
           20 men: 35% off the cost, 50% off the training time   (hoplites: 650 food 650 wood, 100 s)
          Population is the full 8 or 20.
  HEALTH  The soldiers' health added up. A man falls dead where he stood each time the bar loses
          one man's worth, and the last men fall on the killing blow.
  ATTACK  Melee regiments hit less hard with fewer men. Ranged regiments loose one shot per
          surviving man each volley, and keep shooting while they move.
  DISBAND Select a regiment and click the soldier portrait in its panel (4 seconds, free).
          It breaks up into its surviving soldiers, each where he stood. They share the health the
          bar had left equally, and each has the regiment's rank and experience.
  FORM    Select 8 or more loose soldiers of a kind that has a regiment (the ones in the table,
          any rank) and click the "Form Regiment" button, first in the command row (two-figures icon).
          They merge into as many regiments of 40, 20 and 8 as they can fill, nearest men together;
          the rest stay as they are. Every man who joins is in the regiment: 20 men at half health
          make a regiment of 20 at half health (each man then falls after half the usual damage),
          not a regiment of 10. Free and instant. Soldiers of different ranks join the same regiment;
          its rank and experience are the average of theirs.
  RANKS   A regiment has the ranks of its soldier (Basic, Advanced, Elite; the chevron in its panel).
          It earns experience like a soldier does; the figure shown is the average per man.
          When it is promoted its men become the promoted soldier: their look, +25% health and
          +10% melee damage (ranged: tighter aim) per rank, exactly as for single soldiers.
          Formation, men standing and share of health are kept. Where the game promotes a soldier
          further (Athenian and Theban Elite hoplites into champions, Roman soldiers into
          legionaries after the reforms), the regiment follows.
  STAKES  A regiment behind Stakes is planted like a unit on a wall: it cannot move, ignores move
          orders, always stands its ground and shoots at everything in range. The stance it had
          (or one you pick meanwhile) comes back when it returns to Line.
  VOLLEYS A ranged regiment spreads each volley over the enemies in range. Only a target you
          order it to attack takes every arrow.
  FORGE   Forge (armour and weapon) technologies apply to regiments as to any soldier.
          The splash part of a melee regiment's blow is not raised by weapon technologies.
  They cannot gather, build, garrison or join the game's own formations (they have their own, below).
  The computer player does not train them.

REGIMENTS OF 40
  Every kind also exists as a regiment of 40 (8 across, 5 deep). It cannot be trained: it is only
  made with Form Regiment from 40 loose soldiers of one kind. With 40 or more selected, the button
  forms a 40 first; select 20 at a time if you want two 20s instead.

MORE REGIMENTS
  Champion infantry and cavalry (Stable), in 8 and 20,
  with the same pricing rule, casualties, Disband and Form Regiment as the others:
  Champion regiments are trained only where that champion is trained:
    Barracks: Britons, Gauls, Iberians, Macedonians, Mauryas, Persians, Ptolemies, Romans, Seleucids
    Gymnasium: Athenians, Thebans.  Syssition: Spartans.  Temple: Carthaginians.  Temple of Amun: Kushites.
    Great Hall: Germans.  Academy: Han.
    civ    champion infantry            melee cavalry                  ranged cavalry
    athen  City Guard                   Greek Cavalry                  Cavalry Javelineer
    brit   Brythonic Champion           Celtic Cavalry                 Raiding Cavalry
    cart   Sacred Band Infantry         Italic Cavalry                 Numidian Cavalry
    gaul   Champion Swordsman           Cavalry Swordsman              Cavalry Javelineer
    germ   Cimbri Raider                Cimbrian Spear Cavalry         Tigurinian Light Cavalry
    han    Tiger Guard Spearman         Cavalry Spearman               Cavalry Archer
    iber   Champion Swordsman           Cavalry Spearman               Cavalry Javelineer
    kush   Napatan Temple Guard         Meroitic Heavy Cavalry         Napatan Light Cavalry
    mace   Macedonian Shield Bearer     Thessalian Lancer              Odrysian Skirmish Cavalry
    maur   Warrior                      Indian Raiding Cavalry         Indian Light Cavalry
    pers   Persian Immortal             Cappadocian Cavalry            Parthian Horse Archer
    ptol   Royal Guard Infantry         Macedonian Settler Cavalry     Nabataean Camel Archer
    rome   Italic Heavy Infantry        Roman Cavalry                  Allied Cavalry
    sele   Silver Shield                Companion Cavalry              Dahae Horse Archer
    spart  Spartan Hoplite              Greek Allied Cavalry           Perioikoi Cavalryman
    theb   Theban Sacred Band Hoplite   Greek Cavalry                  Cavalry Javelineer

HOW A MELEE REGIMENT HITS
  Each swing is one blow. Its main target takes every surviving man's damage at once (a 20-man
  regiment hits like 20 soldiers); each other enemy within a few meters takes a small spill-over
  (1.5 soldiers' worth for a 20, in proportion for 8 and 40). So regiments fight single targets,
  buildings and each other at full strength. Ranged regiments loose one shot per man.
  Numbers: <Attack><Melee> in simulation/templates/units/<civ>/regiment_*.xml.

FORMATIONS
  Each formation button carries its own picture (a phalanx of hoplites, stakes with archers
  shooting over them, a torch-bearing mob before a burning house, a wedge of horsemen...).
  The pictures are in art/textures/ui/session/icons/regiment/.
  A regiment changes formation from its panel, next to Disband (4 seconds, free). The block changes
  shape, and where the soldiers have the animations they change pose. Line is the standard order.

  Melee infantry and champion infantry
    Phalanx      2.5x damage to cavalry on top of the soldiers' own bonus, 1.5x to elephants. Enemy infantry
                 and foot regiments within 12 m move at half speed. 25% slower, 3 pierce armour levels fewer
                 (about 37% more missile damage). Spear and pike regiments only; called Syntagma for pikemen,
                 Spear Wall where the soldiers have no phalanx drill.
    Testudo      ROMAN ONLY (swordsmen, skirmishers and champions). +8 pierce and +3 crush armour levels
                 (about 57% and 27% less damage). Half speed, 40% less attack.
    Shield Wall  CHAMPION INFANTRY of every other faction. A lighter Testudo: +4 pierce and +1 crush
                 armour levels (about 34% and 10% less damage). 30% slower, 20% less attack.
    Open Order   Burns buildings. Against a building the men throw torches from 16 m (one flaming
                 javelin drawn per man, at most 20): three times the damage the same men would do to it
                 as loose soldiers. Against units it fights hand to hand as usual. Cannot capture.
                 3 hack, 3 pierce and 5 crush armour levels fewer.

  Ranged infantry
    Volley Line  Volleys 25% faster, +8 m range. Cannot shoot while moving. 5 crush armour levels fewer.
    Skirmish     15% faster, +3 pierce armour levels. Volleys 35% slower.
    Stakes       +6 pierce armour levels; enemy cavalry within 10 m move at half speed and deal half melee
                 damage. Cannot move (and stands its ground) until it returns to Line.

  Cavalry
    Wedge        Melee cavalry. 4x damage to loose infantry and to foot regiments in Line, Open Order,
                 Volley Line or Skirmish, but three times as long between blows. No bonus against
                 Phalanx, Testudo, Shield Wall or Stakes.
    Circle       Ranged cavalry. The riders stand on a ring. 20% faster, +2 pierce armour levels,
                 3 hack armour levels fewer.

  Each formation is its own unit file: simulation/templates/units/<civ>/regiment_<kind>_<8|20>_<formation>.xml.
  Auras: simulation/data/auras/units/regiment_phalanx_slow.json, regiment_stakes.json.

HOW A REGIMENT PICKS TARGETS
  Stances work as for any unit, for the block as a whole (Aggressive by default). On top of that:
    - It goes for groups first. Every extra enemy standing within 12 m of a target is worth
      20 m of distance, up to 8 enemies, so a group of six 45 m away beats one man 6 m away.
    - It ignores a lone runner: an enemy with fewer than 3 units around it, faster than the
      regiment, and beyond 20 m (beyond bow range for archers). It will not start after him,
      and it breaks off if he rides out of that distance.
    - An attack you order yourself is never dropped.
  Knobs: GROUP_RADIUS, GROUP_SIZE, LONE_RADIUS, GROUP_WEIGHT at the top of
  simulation/components/RegimentUnit.js. Ordinary units are not affected.

WHAT TO LOOK AT
  1. Do bodies fall in the places where men disappear, and does a cavalry Wedge point forwards?
     If bodies fall on the opposite side of the block, or the wedge points backwards, tell Claude:
     both come from one assumption about which way the men face inside the block.
  2. Disband: does the regiment turn into the right number of soldiers?
  3. Ranged regiments: do the men shoot, and do javelins / sling stones / arrows fly?
  If something is wrong, the log is at %LOCALAPPDATA%\0ad\logs\interestinglog.html.

HOW IT IS BUILT
  art/meshes/props/regiment_block_8.pmd, _20.pmd   hand-written models: nothing visible, one standing position per man
  art/actors/units/regiment/<civ>_<melee|ranged>_<8|20>.xml   attach a soldier to each position; variant "men_N" shows N men
  simulation/components/RegimentUnit.js       men shown, bodies, attack scaling, disband, forming, target choice
  gui/session/unit_actions_regiment.js        the "Form Regiment" button (a new file; no game interface file is replaced)
  art/textures/ui/session/icons/regiment/*.png.cached.dds   the formation button pictures (Paul's pixel artwork, 64 x 64, sized for the small buttons)
  simulation/templates/units/<civ>/regiment_*.xml   the units (price, health, attack, footprint, which soldier)
      regiment_<kind>_<size>            made of the basic soldier (the one that is trained)
      regiment_<kind>_<size>_r1, _r2..  the same regiment at the soldier's next ranks
      ..._<formation>                   each of them in each formation
  Overrides these game files to add regiments to the training lists:
  simulation/templates/template_structure_civic_civil_centre.xml, template_structure_military_barracks.xml,
  template_structure_military_stable.xml, and 15 champion buildings (structures/<civ>/barracks.xml, gymnasium.xml, ...)

==============
PART 3: RENOWN
==============

THE LADDER
  Citizen soldiers:  Basic > Advanced > Elite (the game's chevrons), then
                     Bronze Star I, II, III > Silver Star I, II, III > Gold Star I, II, III
  Champions, heroes: start at Bronze Star I, climb to Gold Star III, then the Gold Wreath
  Siege engines that shoot (bolt shooters, stone throwers, siege towers...): start with nothing,
                     climb to Gold Star III. Rams have no ranks.
  Experience for each step: 125 for each bronze star, 150 for each silver, 200 for each gold,
  300 for the Gold Wreath (the chevrons before them take 100 each for infantry; a soldier
  killed is worth about 100, split by the damage each attacker did).
  The bar beside the portrait shows the progress; the star icon sits where the chevron was.
  Above the unit itself the star also replaces the chevron (shown whenever the chevrons are:
  when the unit is selected or hovered, or always with the status bars switched on), drawn one
  and a half times as large, with a thin bar for the progress to the next star.

TRAINING IN BUILDINGS
  The Barracks, Stable and Elephant Stable already give 1 experience a second to the troops
  garrisoned inside ("Rigorous Training"), but only up to Elite. Now Elite soldiers, champions
  and heroes go on earning it towards their stars: 125 seconds inside for a bronze star.
  A unit that changes form (an Elite hoplite joining the champions, a siege engine packing up)
  keeps its stars.

WHAT A STAR GIVES  (each star adds this again, so Gold Star III is nine times the figure)
  Ranged (archers, slingers, javelin throwers, on foot or mounted):
      +0.67 m range, +0.67 damage, shoots 0.83% faster          at nine stars: +6 m, +6, 7.8% faster
  Melee (infantry, cavalry, elephants):
      +1 damage, +1 armour of every kind, 1% faster movement and swing   at nine stars: +9, +9, 9.4% faster
  Siege engines:
      +1.33 m range, +1.67 damage, shoots 0.83% faster, +0.33 m splash   at nine stars: +12 m, +15, 7.8%, +3 m
  These are one third of the figures first asked for (2 m / 2.5% / 2; 3 / 3% / 3; 4 m / 2.5% / 5 / 1 m).
  For the full figures set SCALE to 1 in simulation/components/StarRanks.js.
  "+1 damage" is shared between the kinds of damage a weapon does (a spear: half hack, half pierce).

GOLD WREATH  (champions and heroes only)
  Double health, +1 health per second on top of any other healing, a golden tint,
  and a 1.5% chance on every hit to kill a human unit or a siege engine outright (heroes included).

HEROES
  Besides the bonuses above, a hero's auras grow by 2.5% for each rank above his first
  (a +20% aura is +20.5% at Bronze Star II and +24.5% at the Gold Wreath).

NOT YET
  Regiments have no star ranks yet: soldiers who form a regiment lose their stars,
  and a regiment disbands into soldiers without stars.

EVERY NUMBER
  is in the block at the top of simulation/components/StarRanks.js: COST (experience per rank), SCALE,
  BONUS (per star), HERO_AURA, the four WREATH_ values, and WORLD_ICON_SCALE (size of the star above a unit).

HOW IT IS BUILT
  simulation/components/StarRanks.js   one script that keeps every unit's rank and experience and gives the bonuses.
      No unit file is changed. It hooks into the game's attack, promotion-bar and aura code when a match starts.
  gui/session/zz_star_ranks.js         shows the star icon and the progress tooltip (a new file; nothing replaced)
  art/textures/ui/session/icons/ranks/ the ten icons
