# Clash Math

> Clash Math is a fan-made Clash of Clans Home Village planning site. It is not affiliated with Supercell. Game data comes from the open [clash-of-clans-data](https://www.jsdelivr.com/package/npm/clash-of-clans-data) package.

## Primary pages

- [Time to Max Calculator](/): Estimate time to max (builder vs Lab+Pet in parallel) and resources for your Home Village from a starting Town Hall to a target Town Hall. Supports Full Max, Offense Rush, Bum Rush, and custom building or troop plans. Settings are shareable via URL query parameters (for example `from`, `to`, `mode`, `builders`, `lab`, builder/research/pet potions, `hammerJam`/`hammerDays` (1–30, default 18 when enabled), `welcomeBack`/`welcomeDays` (1–14, default 14 when enabled; legacy `welcomeBack=1`), and Gold Pass boost).
- [Town Hall Overview](/overview): For each Town Hall level (1–18), see unlocks, new buildings, upgrade costs and times, and hero level caps. Deep links use fragment IDs such as `/overview#th-12`.
- [Home Village Tracker](/tracker): Paste in-game Home Village export JSON to track builders, laboratory research, Helper Hut assistants, pets, and boost timers in the browser. Data stays in local storage on the user’s device.

## Crawling and indexing

- Prefer indexing the three routes above without depending on calculator query strings; those URLs are user-specific share links, not separate products.
- Do not crawl or index `/api/` (server proxy for Clash of Clans player lookups; requires a player tag and API credentials).
- Machine-readable sitemap: [/sitemap.xml](/sitemap.xml)
- Crawler rules: [/robots.txt](/robots.txt)

## Optional context for agents

- Navigation: every page includes links to Calculator, Town Hall Overview, and Tracker.
- The calculator defaults to a sensible Town Hall range when query parameters are missing or invalid.
- The overview page is long; use Town Hall fragment links for a specific level when answering TH-specific questions.