Buffs

Adds up the speed boosts and other buffs that everything you have gives, and lists the sources of each. You describe what you have in a profile: hero skill levels, research and Alliance Tech levels, the VIP level, building levels, experts, Chief Gear, Chief Charms, skins, island decorations, and so on. The result gives the same numbers in two views: by stat, with every source listed, and by source, with the total of each stat that the source gives.

Signature

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

calculateBuffs(profile?: BuffProfile): BuffCalculation

Input

BuffProfile

Every section of the profile is optional. A section that is left out adds nothing. The one exception is the March Queue of the account: every profile has the starting March Queue of 1, so an empty profile gives one category, march-queue.

A level of 0 means that you do not have it, and adds nothing.

Result

BuffCalculation

The result has three lists of the same numbers.

BuffCategory

Categories are in the order of their names. A stat that has both a percent source and a flat source has two categories, because the two cannot be added. Sources are listed by type, in the order of the sources table below, and then in the order of the profile.

BuffSourceGroup

An entry of bySource has an id, a name, and stats. A stat has statKey, name, unit, and total, and the stats are in the order of the groups. The totals of a stat over all the entries add up to the total of its category. The id is a source type, with three differences: research is split in two, and the Tree of Life and the island decorations are one entry.

The research entries are split by the research queue: the nodes of the Research Center queue are in research, and the T11 and T12 nodes are in warAcademyResearch. An entry with nothing is left out.

Groups

groups lists the categories in six groups, in this order. A group with no category is left out. Each group has an id, a name, and its categories.

The stats in Other have no group yet. Move one into a group by adding its key to the list of that group.

Sources

How it works

Each source gives the bonus that it has at the level in the profile, and the calculator adds the amounts of the same stat. The amount of a level is the total at that level and not a step, so a research node at level 3 gives its total of 3 levels. The total is rounded to 4 decimals, so a sum has no floating point noise.

Heroes

Hero skills give only the effects that change a city stat: Training Speed, Research Speed, Healing Speed, Building Upgrade Speed (the construction-speed category), the gathering speeds, the mine, Sawmill, and Hunter's Hut outputs, the Hunting and Wilderness march speeds, Stamina Cost Reduction, and Resource Consumption Reduction. A skill that only helps in battle adds nothing. A skill that only applies while you use the hero adds nothing either. These are the mine, sawmill, and Hunter's Hut output skills of Smith, Eugene, Charlie, and Cloris, Endurance Training and Quick Paced of Gina, and Emerald Warrior of Lumak Bokan. BUFF_HERO_ONLY_SKILLS lists them. The gathering speed skills of Smith, Eugene, Charlie, and Cloris count, and so do the skills of Ling Xue, Jasser, Seo-yoon, and Zinman.

Resource Gathering Speed

A stat that is general to the four resources has no category of its own. The Resource Gathering Speed of an Alliance Facility, an Alliance Prestige Building, or a skin counts in each of meat-gathering-speed, wood-gathering-speed, coal-gathering-speed, and iron-gathering-speed. The source is listed in all four categories, and it adds to the speed of that resource from heroes, research, and the other sources.

Tundra Albums and the collection

A Tundra Album gives its buff only when all 9 of its puzzles are done, so you list an album in tundraAlbums when it is complete. The buff is the one of the album in tundraAlbum(): Crystalline Mysteries and Explore the World give 2% Troops Attack, Daybreak Island gives 2% Troops Defense, Song of Heroes gives 5% Resource Gathering Speed, and Rekindled Flames gives 5% Resource Production Speed. The Resource Gathering Speed counts in each of the four resources, as above.

The collection gives the buffs of the medallion that you hold at your collectionLevel, from level 1 to level 51. The level picks the medallion in collectionMedallionAt(), and the buffs of a medallion are the totals that the game lists for it, so the buffs of the medallions before it do not add on top. Bronze Medallion I gives 2% Troops Attack, and Light Medallion IV gives 6% Troops Attack, Defense, and Lethality and 4% Troops Health. A level of 0 adds nothing.

Expert affinity

An expert also gives a base bonus that grows with the affinity level. The bonus is the statBonus of that level in experts(), from 3% at level 1 up to 30% at level 100 for Gareth, and it goes to each stat of the expert: Gareth, Romulus, Valeria, Fabian, and Kathy give Troops Lethality and Troops Health, Holger, Ronne, and Baldur give Troops Attack and Troops Defense, Cyrille gives Troops Attack, and Agnes gives Troops Defense. You give the affinity in expertAffinity, separate from the skill levels in experts. An expert that is not listed adds nothing.

An expert must advance at the levels 10, 20, up to 100. The statBonus of those levels is the bonus after the advancement, so it jumps from the level before. Until the expert advances, the bonus of the level before counts: level 60 gives the bonus of level 59, and level 60 with advanced: true gives the bonus of level 60. advanced has no effect at the other levels.

Alliance buildings

An Alliance Prestige Building gives its Resource Gathering Speed for the tier that you give. Each building has four tiers: the Championship Statue has Silver, Gold, Diamond, and Ultimate, and the other five have Tier 1 to Tier 4. You give one tier for each building, and the buildings add up. The tier must be one of the tiers of the building.

An Alliance Facility gives its booster percent to one stat: Construction to construction-speed, Defense to troops-defense, Expedition to troops-march-speed, Gathering to the general resource-gathering-speed (see above), Production to resource-production-speed, Tech to research-speed, Training to training-speed, and Weapons to troops-attack. You give the levels that your alliance holds, and the boosters of the levels add up: Construction at levels 1 and 3 gives 5% and 8%, so 13% Construction Speed. Each level must be one that the facility has on the map, and you can list it once. The heavily injured and losses percentages of a facility level are not stats and are not in the result.

Account and buildings

The account gives march-queue as a flat number. The starting March Queue is 1 for every profile, and the pack adds 1 more when marchQueuePack is true. Research and VIP add to the same category.

The Research Center gives its research speed to research-speed. The War Academy gives its research speed to the same research-speed. Each camp gives its training speed to the general training-speed, so the three camps add to the Training Speed of research, heroes, and the other sources. The Embassy gives ally-assists, ally-help-time in seconds, and reinforce-capacity. The Command Center gives rally-capacity and its march capacity as troops-deployment-capacity, so it adds to the same category as research and the other sources. The Infirmary gives infirmary-capacity, the Storehouse gives storehouse-capacity, and each camp gives its training capacity to the general training-capacity, next to its training speed. Each of the nine entertainment buildings, such as the Cafe and the Gym, gives 100 troops-deployment-capacity at its one level. BUFF_ENTERTAINMENT_BUILDINGS lists them. A Fire Crystal sub-level, such as 30-1 or FC 3-2, has no stats of its own and keeps the stats of the full level before it. The Command Center has the same capacity in the data on every sub-level.

Attack, Defense, Lethality, and Health

Attack, Defense, Lethality, and Health come in two kinds of category. A troop type has its own (infantry-lethality, lancer-health, marksman-attack, and so on), which research and Alliance Tech give. All troops have a general one (troops-lethality, troops-health, and so on), which the VIP level, a castle position, skins, and some decorations give. The calculator keeps them as separate categories and does not add the general one to each troop type, so add them in an app to get the Lethality of Infantry.

Tree of Life and decorations

Every level of the Tree of Life gives its own buff, and the buffs of the lower levels stay. At level 7 the tree gives Healing Speed from levels 1, 3, 5, and 7, which is 120%, and also the Deployment Capacity of level 2, the Defense of level 4, and the Attack of level 6. Each level is its own source.

A decoration or Tree of Life buff that names several stats gives each stat the full amount. For example the 2% of Serpent Sanctuary at level 1 is 2% of Troops Attack, Defense, Health, and Lethality. A level whose buff is not known yet adds nothing, and neither does a decoration that has no levels.

Experts

Experts give only the skills and talents whose text states a stat that always applies. These are Porcupine, Undefeated Will, Fearsome Reputation, and the talent Rallying Cry of Gareth, and Last Line, One Heart, Spirit of Aeetis, and the talent Commander's Crest of Romulus, and Project Management of Agnes. BUFF_EXPERT_SKILLS lists the skills that count. A skill that only applies in an event, such as the Bear Hunt or State of Power skills, adds nothing.

Rallying Cry gives Healing Speed and Infirmary Capacity, so Gareth at talent level 3 adds 10% Healing Speed and 70,000 Infirmary Capacity. Last Line gives Troops Attack and Defense, and Spirit of Aeetis gives Troops Lethality and Health, each at the same amount. Commander's Crest gives 300 to 10,000 Troops Deployment Capacity. One Heart gives 5,000 to 100,000 Rally Capacity. Project Management gives Research Speed from 1% to 5%, and the hours that it saves on every new build, from 2 to 8, as the stat Construction Speed Boost in hours.

Chief Gear and Chief Charms

A Chief Gear piece gives Attack and Defense to the troop type of its slot, each at the stat percent of its level: Cap and Watch to Lancer, Coat and Pants to Infantry, and Ring and Weapon to Marksman. The set bonuses come from chiefGearSetBonus(), with the pieces that you list. Three pieces of one tier add the Defense bonus of the tier, and six pieces of one tier also add the Attack bonus, each for Infantry, Lancer, and Marksman.

Each gear slot holds 3 Chief Charms. A charm gives Lethality and Health to the troop type of the gear slot that holds it, each at the stat percent of its level, so the two Marksman slots, Ring and Weapon, hold 6 charms for Marksman troops. List the level id of each charm that you have, up to 3 for each slot. The package owner states these stats for gear and charms.

Pets

A pet can have a refinement for each of six stats: Lethality and Health of Infantry, Lancer, and Marksman. Pass refinement as an object with the key of each stat, such as infantry-lethality or marksman-health. A value is a percent from 0 to the maximum refinement of the pet, which is maxRefinementPercent in pets(): 6.7 for Cave Hyena, up to 58.1 for Frostscale Chameleon. A stat that is left out counts as 0, and the refinement of a pet at level 0 adds nothing. The refinement adds to the same stat of the other sources, so a refined Infantry Lethality adds to the one of research.

Timed buffs

Chief Orders and President skills last for a limited time. The calculator adds one only when you list it, so list the ones that are active when you want the buffs of now.

Constants

buffGroupOf()

buffGroupOf(statKey: string): BuffGroupId

Returns the group of a stat. A stat that a group lists belongs to that group, and a stat whose key starts with alliance- or enemy-alliance- belongs to alliance. Every other stat is in other.

buffGroupOf('training-speed') // 'military'
buffGroupOf('ally-assists') // 'alliance'

Errors

Examples

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

const result = calculateBuffs({
  heroSkills: [{ heroId: 'ling-xue', skills: { 'Total Control': 4 } }],
  researchLevels: { 'trainer-tools-i': 3 },
  allianceTech: { 'advanced-training-i': 2 },
  buildingLevels: { 'research-center': '30' },
  vipLevel: 12,
})

By stat: groups, then categories with the name and the total, then the sources.

const military = result.groups.find((group) => group.id === 'military')!
const training = military.categories.find(
  (category) => category.statKey === 'training-speed',
)!

training.name // 'Training Speed'
training.total // 25.4
training.sources
// [
//   { type: 'hero', id: 'ling-xue', label: 'Hero: Ling Xue, Skill: Total Control Lv 4', amount: 16 },
//   { type: 'research', id: 'trainer-tools-i', label: 'Research: Trainer Tools I Lv 3', amount: 7.4 },
//   { type: 'allianceTech', id: 'advanced-training-i', label: 'Alliance Tech: Advanced Training I Lv 2', amount: 2 },
// ]

By source: the name and the total of each stat, with no source lists.

const heroes = result.bySource.find((group) => group.id === 'hero')!

heroes.name // 'Heroes'
heroes.stats // [{ statKey: 'training-speed', name: 'Training Speed', unit: 'percent', total: 16 }]

An empty profile gives the starting March Queue:

calculateBuffs().categories
// [
//   {
//     statKey: 'march-queue',
//     group: 'military',
//     name: 'March Queue',
//     unit: 'flat',
//     total: 1,
//     sources: [{ type: 'account', id: 'starting-march-queue', label: 'Account: Starting March Queue', amount: 1 }],
//   },
// ]

Expert skills, expert affinity, and the collection:

const experts = calculateBuffs({
  experts: [{ expertId: 'gareth', skills: { 'Rallying Cry': 3 } }],
  expertAffinity: { gareth: { level: 60, advanced: true } },
  collectionLevel: 1,
  marchQueuePack: true,
})

experts.categories.map((category) => [category.statKey, category.total])
// [
//   ['healing-speed', 10],
//   ['infirmary-capacity', 70000],
//   ['march-queue', 2],
//   ['troops-attack', 2],
//   ['troops-health', 19.2],
//   ['troops-lethality', 19.2],
// ]

Alliance Facility levels add up:

const facilities = calculateBuffs({
  allianceFacilities: { construction: [1, 3] },
})

facilities.categories.find(
  (category) => category.statKey === 'construction-speed',
)!.total // 13

The Tree of Life adds the buffs of every level up to the one you give:

const tree = calculateBuffs({ treeOfLifeLevel: 7 })

tree.categories.find((category) => category.statKey === 'healing-speed')!.total // 120

Data and assumptions

The skills that only apply in an event are not in the result. The troop attack and defense of a pet is a percent. The buffs of two sources of one stat add up, and the calculator does not model a cap or a rule that only the highest source counts.

Next steps

• See the calculators overview for the shared conventions
• Browse Experts, Pets, and Tundra Album for the source data
• Use Research to plan the research levels that this calculator reads