clash-of-clans-data

The builder() factory function is the entry point for every piece of Builder Base data: defenses, troops, heroes, buildings, and league progression.

Namespaces

builder() returns a BuilderBase object with one method per category:

import { builder } from 'clash-of-clans-data'

builder().defenses() // BuilderBaseDefenses
builder().traps() // BuilderBaseTraps
builder().walls() // BuilderBaseWalls
builder().troops() // BuilderBaseTroops
builder().heroes() // BuilderBaseHeroes
builder().resourceBuildings() // BuilderBaseResourceBuildings
builder().armyBuildings() // BuilderBaseArmyBuildings
builder().otherBuildings() // BuilderBaseOtherBuildings
builder().builderHall() // BuilderBaseBuilderHall
builder().leagues() // BuilderBaseLeagues

Namespace	Category page	Content
`defenses()`	Defenses & traps	15 stationary defenses
`traps()`	Defenses & traps	4 traps (Push Trap, Spring Trap, Mine, Mega Mine)
`walls()`	Defenses & traps	Wall tiers and hitpoints per level
`troops()`	Troops & heroes	12 troops trained in the Builder Barracks
`heroes()`	Troops & heroes	2 heroes (Battle Machine, Battle Copter)
`resourceBuildings()`	Buildings & leagues	6 resource buildings
`armyBuildings()`	Buildings & leagues	Builder Barracks, Army Camp, Star Laboratory, hero altars, and the Reinforcement Camp
`otherBuildings()`	Buildings & leagues	The Clock Tower
`builderHall()`	Buildings & leagues	Builder Hall level data
`leagues()`	Buildings & leagues	Builder Base league tiers with trophy ranges and star bonuses

Quick start

import { builder } from 'clash-of-clans-data'

const cannon = builder().defenses().cannon().first()!
const battleMachine = builder().heroes().battleMachine().first()!
const bh9Defenses = builder().defenses().byBuilderHall(9).get()

Level-count totals

builder() exposes a helper that totals every category's upgrade cost at a given Builder Hall level:

import { builder } from 'clash-of-clans-data'

const counts = builder().levelCountAtBuilderHall(9)

console.log(counts.structures) // defenses + army buildings + resource buildings
console.log(counts.traps)
console.log(counts.starLab) // troop levels unlocked via Star Laboratory
console.log(counts.heroes)
console.log(counts.walls)
console.log(counts.total)

Next steps

Defenses & traps: the full Builder Base defense, trap, and wall list
Troops & heroes: every unit and hero available in the Builder Base
Buildings & leagues: support buildings, the Builder Hall, and league progression