How do you run the Combat Simulator utility?

Saber Cherry · #1 April 13th, 2005, 06:20 PM

The documentation is in the Readme.txt file, along with usage examples. You have to have Java installed in order to use it (which may or may not be pre-installed on your computer, but either way, it is free from Sun).

Readme.txt and UnitTypes.txt are both in the "data" folder. The names of units that you can use are in UnitTypes.txt. Not all 1100 units are included, and most units have different names from Dominions II, because the names are all unique in the combat sim. For example, in Dominions II, Abysian Infantry are all called Abysian Infantry, even though they have different equipment. In the combat sim, "Abysia" is abbreviated AB, and the infantry are renamed: AB_Inf_Battleaxe, AB_Inf_Flail, AB_Inf_Axe, AB_Inf_Morningstar. So you generally have to consult UnitTypes.txt, but it's very easy, since all of the units are grouped by nation.

The simplest way to use it is the "Fight" command, which is used something like this:

Code:



C:\Projects\Java\Dominions>java Fight militia ab_slayer



'Militia' versus 'AB Slayer'  in 40000 bouts.



 ~ Attacker's Deathmatch Statistics ~



Score: ----------------------    3

Wins: -----------------------     .33%

Losses: ---------------------   99.63%

Ties: -----------------------     .05%

Deaths by poison: -----------    3.73%

Kills per battle: -----------     .01

Kills per round: ------------     .01

Deaths per battle: ----------    1.00

Life expectancy (rounds): ---     .62

Life expectancy (battles): --     .56

Avg. Rounds Elapsed: --------    1.11

Avg. Rounds to Win: ---------    1.21

Avg. Rounds to Lose: --------    1.11

Avg. Rounds to Tie: ---------    1.95

Hit Rate: -------------------   38.06%

Evade Rate: -----------------   13.43%

Repel Rate: -----------------    7.57%

Damage done per swing: ------    1.51

Damage done per hit: --------    3.95

Damage taken per hit: -------   13.04

Hit damage taken per life: --   15.85

Poison dam. taken per life: -     .18

Total damage taken per life:    16.02



 ~ Attacker's Gauntlet Statistics ~



Score: ----------------------   72

Wins: -----------------------    7.22%

Losses: ---------------------   92.71%

Ties: -----------------------     .08%

Deaths by poison: -----------    4.18%

Kills per fresh team: -------     .08

Kills per battle: -----------     .08

Kills per round: ------------     .07

Deaths per battle: ----------     .93

Life expectancy (rounds): ---     .72

Life expectancy (battles): --     .64

Avg. Rounds Elapsed: --------    1.13

Avg. Rounds to Win: ---------    1.16

Avg. Rounds to Lose: --------    1.13

Avg. Rounds to Tie: ---------    1.81

Hit Rate: -------------------   53.96%

Evade Rate: -----------------   16.48%

Repel Rate: -----------------   10.94%

Damage done per swing: ------    2.30

Damage done per hit: --------    4.26

Damage taken per hit: -------   13.03

Hit damage taken per life: --   15.75

Poison dam. taken per life: -     .20

Total damage taken per life:    15.95

This simulates battles between a single Militia and an Abysian Slayer.

To simulate fights between groups, put a multiplier (like 5*) in front of the unit name:

Code:



C:\Projects\Java\Dominions>java Fight 5*pan_centaur_warrior 10*ca_storm_guard



'5*Pan Centaur Warrior' versus '10*CA Storm Guard'  in 40000 bouts.



 ~ Attacker's Deathmatch Statistics ~



Score: ----------------------  913

Wins: -----------------------   97.23%

Losses: ---------------------    2.78%

Kills per battle: -----------    9.82

Kills per round: ------------     .96

Deaths per battle: ----------     .78

Life expectancy (rounds): ---  369.62

Life expectancy (battles): --   35.99

Avg. Rounds Elapsed: --------   10.28

Avg. Rounds to Win: ---------   10.26

Avg. Rounds to Lose: --------   10.86

Hit Rate: -------------------   51.84%

Evade Rate: -----------------   76.05%

Damage done per swing: ------    1.49

Damage done per hit: --------    2.87

Damage taken per hit: -------    2.77

Hit damage taken per life: --   60.75

Total damage taken per life:    61.45



 ~ Attacker's Gauntlet Statistics ~



Score: ----------------------  596

Wins: -----------------------   60.19%

Losses: ---------------------   39.82%

Kills per fresh team: -------   15.12

Kills per battle: -----------    6.02

Kills per round: ------------     .88

Deaths per battle: ----------    2.00

Life expectancy (rounds): ---   16.78

Life expectancy (battles): --    2.44

Avg. Rounds Elapsed: --------    6.88

Avg. Rounds to Win: ---------    7.66

Avg. Rounds to Lose: --------    5.71

Hit Rate: -------------------   50.73%

Evade Rate: -----------------   67.00%

Damage done per swing: ------    1.53

Damage done per hit: --------    3.02

Damage taken per hit: -------    3.08

Hit damage taken per life: --   24.94

Total damage taken per life:    25.27

That shows the results of 5 Pangaean Centaur Warriors against 5 Caelian Storm Guards.

The more important results are "Deathmatch mode," where the two sides fight to the death, and it is very obvious how to interpret the result. "Gauntlet Mode" is more like Arena battles, where the winner goes through multiple fights without being allowed to heal - you can pretty much ignore that.