🗺 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, validation warnings, resource production per hour, and territory broken down by zone.
🌾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).
⚡ 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 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.
⚠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)