The ClashClock user guide

What ClashClock does

The game shows you one timer at a time, inside the game. ClashClock puts them side by side: every builder in both villages, the Laboratory and the Pet House at home and the Star Laboratory in the Builder Base, each with its finish time, and a plan for what to start next.

It is a web app. You open it in a browser or add it to your home screen, paste an export of your village, and it knows your levels and your running upgrades as of that moment. It never asks for your Supercell ID or password and cannot start, cancel or speed up anything in the game. You start every upgrade in the game yourself, and tell ClashClock what you did.

It is free, and you do not need an account. Your villages stay in your browser unless you create an account to sync them between devices. Without an account, two things still reach a server: your player tag, when you add a village or look up league and clan, and, if you switch push on, your device's push address and the text and time of your reminders, which name the building and the village. How ClashClock works lists everything that leaves your device, and the privacy policy is the binding text.

Get started in a minute

1. Copy your village export

   In the game, open Settings → More Settings, scroll down to Data Export and tap Copy on the row Export Village data in JSON format. Chapter 1 shows each screen.

2. Paste it into ClashClock

   Open the tracker, tap Paste export, paste the data and check the preview of what will be imported. Save the village when it looks right.

3. Read Home

   Home shows the next free builder as one big number and a card for every running upgrade, with its level, progress and finish time.

4. Add your offline hours

   Open the Plan tab and enter when you sleep and work. The planner then starts upgrades while you are awake and prefers the ones that hand a builder back before you are away.

The five tabs

• Home: your next free builder and every running upgrade. Home and Base: timers and buildings
• Base: every building by category, with the cost and time of its next level, and a button to start an upgrade. Covered in the same chapter as Home.
• Plan: the schedule. Strategies, offline hours, the builder lanes, boosts and potions. The Plan tab and Gold Pass, potions and magic items
• Progress: how much of a maxed village you have, hall by hall, and how many builder days are left. Progress: how far to max
• Profile: language, reminders, sync, backups and installing the app. Profile: reminders, sync and install

The Builder Base has its own set of builders, resources and plan. You switch between the two villages in the header, and the Builder Base chapter covers the path to the 6th builder.

Two things to know first

The export is a snapshot. It is a picture of your village at one moment. After you play, import again, or correct single entries by hand. With an account, heroes, laboratory research, pets, equipment and hall levels also refresh from the game's API once a day, but buildings, walls and running timers still come from the export.

The game is the reference. If ClashClock and the game disagree, trust the game and correct ClashClock. When a timer looks wrong explains why small differences happen, usually a potion, helper or book used after the export, and how to correct a single timer by hand.

If you want to know how the numbers are produced and how the planner decides, read How ClashClock works.

Chapters

1. Import your village: Copy the export in the game, paste it into ClashClock and check the preview before you save.
2. Home and Base: timers and buildings: Read the next free builder and the running upgrades, browse every building, and confirm what has finished.
3. The Plan tab: your upgrade timeline: Strategies, offline hours, the builder lanes and how to move, pin or remove a step.
4. Progress: how far to max: The Town Hall road, builder days left, hero equipment and the ore calculator.
5. Gold Pass, potions and magic items: How boosts shorten every duration and how the plan uses potions, books and hammers.
6. Builder Base and the 6th builder: Switch villages, plan the Builder Base and follow the path to B.O.B.
7. Profile: reminders, sync and install: Get notified when an upgrade finishes, sync between devices and add the app to your home screen.
8. When a timer looks wrong: Why ClashClock can differ from the game by a few minutes, and how to correct it.