🗺 Quick Start
💡Pick a tool: Place [D] drops buildings · Select [S] moves & edits · Erase [E] removes. Select a building type in the sidebar, then click the map.
📂For lots of buildings, it's much faster to type coordinates into a spreadsheet and ↓ Import a CSV than to place each one manually.
💾Save your work with ↑ Export (CSV file backup) and/or 🔗 Share (cloud link).
🎮Use the game selector in the top toolbar to switch between Kingshot and Whiteout Survival — building names, resource labels (Bread↔Meat, Stone↔Coal), and permanent structures change accordingly.
✏ Tools & Editing
🛠Place / Select / Erase — pick from the toolbar or press D / S / E.
🖱Right-click erases a single building in Select or Erase mode — no need to switch tools.
▭Rectangle erase — in Erase mode, right-click-drag a box, then right-click again to confirm the removal.
☑Multi-select — in Select mode, left-drag over empty space to box-select multiple buildings. Drag the selected group to multi-move them as one unit.
✏Double-click a selected building to rename it.
📋Ctrl+C copies the selected building; Ctrl+V places a new copy with the same label and color.
↩Ctrl+Z undo · Ctrl+Y (or Ctrl+Shift+Z) redo.
🔍Pan: middle-click-drag, or Alt+drag. Zoom: scroll wheel. Jump to coordinates: click the coord pill at the bottom of the map to enter an X,Y.
🏰 Alliance Banners & Territory
⚠Use your 3-letter alliance tag as the label for Banners and HQ (e.g. PHZ). Territory merges by label — same label = shared territory.
🔢Placement sequence matters — banners and HQ placed first take priority where territories would overlap, just like in-game.
🔴Cities marked with a red ✕ sit outside all alliance territory and don't get alliance bonuses.
📏Limits per alliance: 285 banners, 2 HQs. You can override placement warnings, but the game won't honor anything beyond these.
📊Open Alliance Summary from the toolbar to see counts (HQ · banners · cities), validation warnings, resource production per hour, and territory broken down by zone. Each row also shows the city count attributed by ownership (≥3 of 4 cells inside the alliance's territory).
🪖Each summary row exposes two action buttons: Hive Plan (only when the alliance has 10+ cities clustered together) opens the isolated Hive View; Export Cities opens the city export modal scoped to that alliance's territory. See the Hive View tab for the full feature.
🌾Resource nodes (Bread/Meat · Wood · Stone/Coal · Iron) are fixed and match the in-game map. Select a node and click 📝 Report Issue if a location is wrong (requires a published cloud map).
🪖 Hive View
👀Isolated alliance view — focus the map on one alliance's hive (HQ + banners + cities + bear trap) with every other alliance's buildings hidden. Useful for sharing a clean snapshot or for scouting an enemy hive.
▶Open it from Alliance Summary: the Hive Plan button appears on any row whose alliance has at least 10 cities clustered together.
🔗Share a direct link: use the 🔗 Copy Link button inside the view — recipients open straight into the same hive view.
🏙🏙 Export Cities (top bar) opens the city export scoped to just this hive — handy for sending relocation messages to your players.
🖱Pan with left-drag, zoom with the scroll wheel. Hive View is read-only. Press Esc to exit.
⚡ Banner Optimizer
🚀Open with the ⚡ Banner Optimizer button in the toolbar. It finds the minimum number of banners needed to connect your HQ to a set of outposts.
1️⃣Step 1 — Starting point: pick your HQ or an existing banner, either by clicking the map or by selecting from the alliance dropdown.
2️⃣Step 2 — Target outposts: pick the outposts you want to capture (Builder's Guild, Armory, Scholar's, Frontier, etc.). Tick Auto-pick closest to grab the nearest of each type automatically.
3️⃣Step 3 — Options: Same alliance only keeps the solution inside one alliance's territory. Capture resource nodes also connects nearby resources.
▶Click Run to compute. Use Previous / Next to flip through alternate solutions, then Apply to drop the banners on the map.
🏙️ Hive Optimizer
🚀Open with the 🏙️ Hive Optimizer button in the sidebar. It auto-places cities inside an alliance's territory to minimize bear-trap march time.
⚠Before you run: the alliance's HQ and at least one Bear Trap must already be on the map. The optimizer places cities only — not banners, HQ, or bear traps.
▶Pick an alliance, enter the number of cities (1–100), then click ▶ Run Optimizer. The map switches into isolated Hive View and shows the city preview.
🎨Preview: deep-orange cities rally to B1, lighter-orange to B2 (the chosen traps are outlined in gold). Use ◀ ▶ to compare variants — Closest (shortest total march time) and Balanced (split evenly between the two traps).
🔢Change Cities to place on the preview to re-run live. If you ask for more cities than fit, you'll be offered the maximum that fits.
✓Apply places the cities (labeled [TAG] N) and exits. ✕ cancels without placing anything.
📐 Hive Templates
🏗Browse & stamp (🏗 button): filter templates by sort (popular / newest), trap count, or city count. Click a template to select it, then click the map to stamp.
🔄While stamping: Q rotate left · E rotate right · X flip across X · Y flip across Y · Esc cancel. Clicking commits the stamp — you'll be asked to confirm before overwriting any existing buildings.
📐Create (📐 button): opens a 99×99 grid editor with an anchor point. Use the tool palette or press number keys 1–4 to swap between City, Banner, HQ, Bear Trap, Erase, and Pan tools.
🧭In the editor, middle-click or Alt+drag to pan, scroll to zoom. Validation: max 2 bear traps, max 1 HQ, max 100 cities per template.
📤Save with a name and description, then submit for approval. Approved templates show up in everyone's picker.
🗺 Map & Display
🗺Map tab (sidebar) — toggle terrain overlays (Lakes, Mountains, Fertile, Badlands, etc.), resource nodes, and per-outpost type filters (Fortress, Sanctuary, Construction, Defense, Research, Resource, Gathering, Attack, Training).
🧱Allow build over terrain & resources — bypasses placement warnings for restricted zones. Useful when you're planning around terrain rather than dodging it.
📋Placed list tab — full inventory of every building you've placed. Click an entry to select it on the map; trash icon to delete.
📍Coordinate jump — click the coord pill at the bottom-right of the map to jump to any X,Y. The pill also shows your live hover coordinates.
🌐Language selector (top right) — EN · TL · ES · PT · VI · ID · ZH.
📱Mobile — a touch-friendly layout is available at mobile.html (auto-redirected on small screens).
📦 Import, Export & Sharing
📄CSV format: type,X,Y,label,#color,seq
Types: city · beartrap · banner · resource · hq · obs1 · obs2 · obs3
Label, color, and seq are optional.
↓Import — paste CSV text or drag a file into the import modal.
↑Export — full map as CSV (copy to clipboard or download). 🏙 Cities Export exports only city coordinates, with optional custom-template formatting or plain text.
🔗Cloud sharing (🔗 Share): publishes your map and gives you a read link (share with everyone) and a private edit token (share only with trusted R4s / Hive Planners). You can update or unpublish from the same modal anytime.
🪖Hive-view share link: append &tag=ABC to the read link to send people straight into a single alliance's hive view. See the Hive View tab.
⚠Cloud is a convenience — always keep a CSV backup. Cloud maps may be lost due to service interruptions or expiry. The developer is not liable for any data loss.
⌨ Keyboard Shortcuts
D Place tool
Ctrl+C Copy selected
S Select tool
Ctrl+V Paste copy
E Erase tool
Del Delete selected
Ctrl+Z Undo
Esc Deselect / close
Ctrl+Y Redo
Dbl-click Rename building
Ctrl+Shift+Z Redo (alt)
Scroll Zoom
1–4 Template tools (in editor)
Alt+drag / Middle-drag Pan
Q / E Rotate template (stamping)
Right-click Erase single / rect-erase
X / Y Flip template (stamping)