Troops

Calculates the troops that the infantry, lancer, and marksman camps train or promote, with the resources, the time, the power, and the event points.

Signature

import { calculateTroops } from 'whiteout-survival-data'

calculateTroops(input: TroopCalculatorInput): TroopCalculation

Input

TroopCalculatorInput

TroopCampConfig

TroopRun

A camp can train and promote, so it can have several runs, each with its own count and batches.

Result

TroopCalculation

How it works

All three camps share one capacity: the capacity of the three camp levels added together, plus researchCapacity and the ministerOfEducation capacity, times 3 with capacityBoost. The boost applies after the bonuses are added.

Training adds troops at its tier. Promotion takes them from fromTier and adds them to toTier, so a promotion adds none to the total. A run changes the tiers by count times batches.

The cost of a run is the cost of one troop from troops() times the troops, less costReductionPercent for that troop type. A promotion adds up the steps from tier to tier. A step costs the difference of the two training costs, or the promotionCost of the tier when the data has one (tier 12). The seconds of a promotion step are the difference of the two training times.

The seconds of a batch are the training time of one troop times the troops, divided by 1 plus the training speed, rounded down. The speed is trainingSpeedPercent plus the buffs. A run multiplies the batch seconds by its batches, and a camp adds up its runs. The resources are rounded once per resource at the end, not per run.

Power

The power of a tier row is the change in troops times the power of one troop, from troopPower(). Training adds power at its tier. A promotion takes the power of the lower tier away and adds the power of the higher tier, so tierPower can be negative at the lower tier, like tiers.

Tiers 10 and 11 change with the Fire Crystal level. The calculator reads the level from the level of the camp: FC 3 and its steps FC 3-1 to FC 3-4 are level 3, and every level before FC 1 is level 0, the base power. Every other tier has the same power at any level. The power does not use any bonus, such as the stat bonuses of research or gear.

Event points

Speedups are not an input. The result gives speedupMinutesNeeded and speedupPointsPerMinute, and the interface multiplies the points with the minutes the user spends.

eventPoints scores the "Train 1 Lv. N troop" rows of events() for the troops trained in training runs, at the tier of each run. A promotion gives no points here. The "Raise 1 Power by training or promoting troops" rows of Hall of Chief, Power Up, and Tundra Games are not scored, so totalPower is not turned into event points. A tier that an event has no row for gives 0, such as tier 12 in King of Icefield and tiers 11 and 12 in Hall of Chief. hallOfChief is the points for one season, because stage 3 of both seasons gives the same points.

Constants

TROOP_CALCULATOR

Use it so an app can offer the same choices.

campFireCrystalLevel()

campFireCrystalLevel(level: string): number

Returns the Fire Crystal level of one camp label, the same way the calculator reads it. campFireCrystalLevel('FC 3-2') is 3, and campFireCrystalLevel('30') is 0.

Errors

Examples

Train two full batches of tier 10 infantry:

import { calculateTroops } from 'whiteout-survival-data'

const result = calculateTroops({
  camps: {
    infantry: {
      level: '30',
      runs: [
        { action: { mode: 'training', tier: 10 }, count: 'max', batches: 2 },
      ],
    },
    lancer: { level: '30' },
    marksman: { level: '30' },
  },
})

result.capacity // 627
result.totals // { infantry: 1254, lancer: 0, marksman: 0, total: 1254 }
result.resources
// [
//   { itemId: 'meat', amount: 3496152 },
//   { itemId: 'wood', amount: 2622114 },
//   { itemId: 'coal', amount: 611952 },
//   { itemId: 'iron', amount: 127908 },
// ]
result.totalSeconds // 190608
result.speedupMinutesNeeded // 3177
result.speedupPointsPerMinute // { svs: 30, allianceShowdown: 18, kingOfIcefield: 30 }
result.totalPower // { infantry: 82764, lancer: 0, marksman: 0, total: 82764 }
result.eventPoints.svs // 75240

Promote 100 troops from tier 9 to tier 10 with speed buffs and a cost reduction:

const promotion = calculateTroops({
  camps: {
    infantry: {
      level: 'FC 3',
      runs: [
        { action: { mode: 'promotion', fromTier: 9, toTier: 10 }, count: 100 },
      ],
    },
    lancer: { level: '30' },
    marksman: { level: '30' },
  },
  mobilize: true,
  trainingSpeedPercent: 100,
  costReductionPercent: { infantry: 10 },
})

promotion.capacity // 702
promotion.trainingSpeedPercent // 130
promotion.fireCrystalLevels // { infantry: 3, lancer: 0, marksman: 0 }
promotion.tiers.filter((row) => row.total !== 0)
// [
//   { tier: 9, infantry: -100, lancer: 0, marksman: 0, total: -100 },
//   { tier: 10, infantry: 100, lancer: 0, marksman: 0, total: 100 },
// ]
promotion.totalSeconds // 913
promotion.totalPower.total // 3300
promotion.eventPoints.svs // 0

Data and assumptions

Camp capacity comes from trainingCapacity of the camp levels in buildings(). Costs and training times come from troops(). The buff values come from the game and live in TROOP_CALCULATOR. The calculator does not check that the research capacity or the training speed match your account. Pass the values the game shows.

Next steps

• See the calculators overview for the shared conventions
• Browse Troops for the cost and time data
• Use Buildings to plan the camp levels