How the Upgrade Planner works
The Build, Lab, and Pet planners turn your village into a real schedule: every remaining upgrade with accurate costs and times, assigned across your builders, with real finish dates you can plan around. Here's what's happening under the hood — and why the dates are trustworthy.
Where the numbers come from
Every upgrade cost and time is pulled from Clash of Clans' own game data, refreshed regularly and automatically checked for drift against the live game. So the times and costs you see match what's in your village, not a stale spreadsheet. Import with your player tag (via the official Supercell API) or paste a village export, and the planner reads your real levels, in-progress upgrades, heroes, pets, equipment, and helpers.
Real finish dates, in your timezone
Most tools just add up upgrade times. We place each upgrade on a builder in actual clock time, in your timezone, so instead of “41 days of build time” you get “done Fri, Aug 1, 3:00 PM.” That's a date you can actually plan around.
It knows when you sleep
A builder that comes free at 3 AM can't be re-tapped until you wake up, so it sits idle until morning. Set your sleep hours and the schedule accounts for that overnight idle: upgrades that finish while you're asleep are flagged (🌙), and the optimizer tries to land shorter upgrades before bed so a builder isn't wasted overnight.
The optimizer finds the fastest plan
Optimize schedule assigns your upgrades across all your builders to finish everything as early as possible — it minimizes the latest finish, not just the total, keeps in-progress upgrades where they are, and respects your sleep window. “Auto-assign” is the quick version that just fills the least-loaded builder; “Optimize” is the one that actually reshuffles for the earliest completion.
Gold Pass boost, modeled properly
The Gold Pass builder and research boosts are locked in when an upgrade starts, but the boost resets monthly. The planner models exactly that: an upgrade begun while the boost is active keeps its reduced time even as it runs into next month, while one started after the reset pays full time. The reset shows as a purple line on the timeline, and the optimizer front-loads your long upgrades before it — which is why starting big upgrades late in the month is worth it.
Goblin Builder & Researcher
When Supercell runs the event, you get a temporary extra builder and/or a second lab lane. The planner adds it as its own lane at the bottom of your schedule. Because it leaves on a set date, the planner won't schedule an upgrade that can't start before it goes (an upgrade already running finishes fine) — that cutoff is the red line.
Apprentice, Lab Assistant, potions & bites
Your Builder's Apprentice and Lab Assistant are read from your import, including their cooldowns, and the schedule accounts for the time they shave. You can also preview builder potions and bites to see how much they'd pull a finish date forward — a what-if view, not a saved change.
Reading the timeline
Each colored block is one upgrade level, positioned at its real start and finish. Shaded vertical bands are your sleep hours; an orange right edge means that level finishes overnight; the red line marks when a Goblin lane leaves and the purple line marks the Gold Pass reset. Scroll or pinch to zoom, shift-scroll to pan, and use the 1 week / 1 month / 3 months presets to change the view. Hover the small ? marks anywhere in the planner for an in-context explanation.
Your plan saves and syncs
Sign in (optional, via Google) and your village and plan save to your account and sync across devices. Re-import whenever you play — the planner carries your plan forward and shows a diff of exactly what changed since last time. Nothing auto-saves over you: edits stay local until you hit Save.
Ready to plan?
Import your village and see your real finish dates.