Contents

  1. Create an Account
  2. Start a Settlement
  3. Found Your Town
  4. Study the Board
  5. Queue Actions
  6. Use the Toolbar
  7. Buy Tools in the Shop
  8. Patron Gods & Superpowers
  9. End the Turn
  10. Win, Lose, or Score
  11. High Scores
  12. Skirmish Mode
  13. Arena Mode
  14. Tile Reference
  15. Tools Reference
  16. Random Events
  17. Scoring System
1

Create an Account

Open the app and either Register (new player) or Log In with existing credentials. You are taken to the Mode Select screen after authentication.

2

Start a Settlement

From Mode Select, tap ⬡ Classic to reach the Lobby. Type a settlement name and tap ⬡ New Game. You are taken straight into the map — no town has been placed yet.

3

Found Your Town

Tap any hex tile on the board to select it. A panel slides up from the bottom showing the tile's terrain and stats. Tap ⚑ Found Here to place your town on that tile.

Choose wisely. The town tile becomes permanent and cannot be moved. Tiles closer to your town produce more resources — distance matters.
4

Study the Board

Each turn your surrounding tiles passively generate (or drain) resources based on their terrain type. The resource bar at the top shows your current stockpiles.

IconResourceNotes
👥PopulationGrows when food & housing allow; dies if food hits 0
😊HappinessAffects population growth rate
🍞FoodConsumed each turn by population
💧WaterConsumed by population; some tiles drain it
🪵WoodRequired for many tools & actions
🪨StoneRequired for construction tools
💊MedicineReduces disease events; helps with happiness
🏠HousingCaps maximum population growth

The counter in the top bar shows Turn X / 10 — you have 10 turns to maximise your score.

Distance & Influence

Tiles closer to your town produce more resources. The influence multiplier drops with distance:

Distance from TownResource Multiplier
0 (town tile)1.0×
1 hex0.8×
2 hexes0.5×
3+ hexes0.3×
Tip: Random events only fire on tiles ≤ 2 hexes from your town — risky terrain (Swamp, Forest) is less dangerous when placed far away.
5

Queue Actions

Tap a tile to open the Tile Info Panel. If a compatible tool is available, you will see action buttons (e.g. 🪓 Chop Wood). Tap an action to queue it — the tile shows a countdown badge.

When the countdown reaches 0 the tile transforms (e.g. Forest → Plains). Queued actions can be cancelled from the same panel — no resource refund is given on cancel.

6

Use the Toolbar

The dark grey panel on the right edge shows your tool inventory. Numbers indicate how many of each tool you have in stock. Tap the 🛒 button to open the Shop.

7

Buy Tools in the Shop

The Shop lists all tools with their resource buy cost. Tap Buy to purchase; a green ✓ Bought toast confirms the transaction. Tools are consumed when you queue an action.

Note: Each purchase gives you 1 tool. Buy multiple times to stock up.
8

Patron Gods & Superpowers

Every game begins with a god selection. Your patron god applies permanent cost multipliers to tool purchases — favoured tools are discounted, others cost more.

GodStyleFavoursPenalises
🔱 PoseidonWater & medicineWater tools, herbalismFarming, stone, forest
🌾 DemeterFarming & growthHoe, seed bag, scythe, axeWater engineering, swamp
⚡ ZeusBalancedAll tools at base costNone
🔥 HephaestusFire & sabotageVolcanic/ruins tools, sabotageWater tools, farming, forest

One-Time Superpowers

Each god may use their superpower once per game by tapping the god button in the bottom bar, then selecting a target tile.

GodSuperpowerEffect
🔱 PoseidonTidal SurgeChosen tile → Lake; one neighbour → Riverbed
🌾 DemeterBountiful BloomChosen tile → Fields; one neighbour → Plains
⚡ ZeusWrath of OlympusAny tile → Plains; +10 stone
🔥 HephaestusVolcanic EruptionAny tile → Volcanic Rock; +8 stone +3 medicine
Tip: The superpower cancels any pending work on the target tile. Use it strategically to deny your opponent an action in Skirmish mode.
9

End the Turn

Tap ⚡ End Turn (bottom bar) to process the turn. The engine runs in order:

1. Pending action countdowns tick — completed actions transform their tile 2. Every tile applies its base resource delta (× influence multiplier) 3. Random events fire (tiles ≤ 2 hexes from town only) 4. Terrain spread rules run (forest encroaches, sand expands, etc.) 5. Town health updates (food consumption, population growth, happiness drift) 6. Win / loss evaluated

A Turn Result modal appears summarising resource changes and any events. Dismiss it to continue.

10

Win, Lose, or Score

OutcomeCondition
🏆 WinSurvive all 10 turns with population > 0
💀 LosePopulation reaches 0 at any turn

When the game ends a Final Score screen displays a full resource breakdown. Tap ← Back to Lobby to return — the finished game is removed from your active list and your score is saved automatically.

11

High Scores

The Lobby shows your Personal Best — up to 5 highest scores across all completed runs, with rank medals, settlement name, turns survived, outcome, and score.


Skirmish Mode 1v1 vs CPU

Skirmish is a fast-paced 1v1 Player vs CPU mode on a shared hex board. Select ⚔️ Skirmish from Mode Select to reach the Skirmish Lobby.

Key Differences from Classic

AspectClassicSkirmish
Turns107
OpponentsNone — survive the landCPU opponent
BoardYour board onlyShared board with two towns
Win conditionSurvive 10 turnsHigher score after turn 7, or opponent's population hits 0

How Skirmish Rounds Work

Each round consists of two turns — yours, then the CPU's:

1. Your turn — queue tile actions, buy tools, tap ⚡ End Turn 2. CPU turn — AI picks the best action automatically (accompanied by a 🤖 "CPU is thinking…" animation) 3. Round counter increments

Town Placement (Setup Phase)

Before the first turn, both towns must be placed. You place yours first; the CPU then automatically chooses a spot on the opposite side of the board.

Dual Resource Bar

The Skirmish screen shows a side-by-side panel with both towns' current stats so you can track your opponent's progress at a glance.

Skirmish Outcomes

StatusCondition
🏆 Player WonCPU population hits 0, or player score > CPU score after turn 7
🤖 CPU WonPlayer population hits 0, or CPU score > player score after turn 7
🤝 DrawScores are equal after turn 7

CPU AI

Each CPU turn the engine scans all tiles within influence range of the CPU town, scores available tool actions by expected resource gain, and queues the best action — or passes if nothing is beneficial.

Sabotage tools (Rot Spores 🍄, Mud Dump 🪣, Plague Thatch ☠️, Siege Catapult ⚔️, Lava Bomb 💣) are designed for Skirmish mode — they convert high-value opponent tiles into something hostile, crippling their food, water, or housing supply.

🏆

Arena Mode Real PvP

Arena Mode is HexForge’s competitive Player vs Player experience. You are matched against a real opponent via a global matchmaking queue organised by league. Turns are asynchronous — play when you have time; push notifications alert you when it is your move.

Key Differences from Skirmish

AspectSkirmishArena
OpponentCPU AIReal player
MatchmakingInstantQueue-based (matched by league)
Turns77
Turn timeoutNone3 days — inactive player forfeits
RankingNoneLeague medals (Bronze → Masters)

Joining the Queue

From Mode Select, tap ⚔️ Arena to open the Arena Lobby. Choose your Patron God and tap ⚔️ Enter Arena Queue. The backend immediately tries to match you with a player in the same or adjacent league. On match, a shared board is generated and the opponent receives a push notification.

League System

All Arena players belong to a league: 🥉 Bronze → 🥈 Silver → 🥇 Gold → 🏆 Platinum → 💎 Diamond → 👑 Masters. Win Arena games to earn medals and climb. Your league rank and position among all players in your league are shown in the Lobby leaderboard.

Outcomes

StatusCondition
🏆 You WinOpponent’s population hits 0, or your score > opponent after Round 7
💀 You LoseYour population hits 0, or opponent’s score > yours after Round 7
🤝 DrawScores equal after Round 7
⏱️ Timeout WinOpponent makes no move for 3 days
Full Arena guide: For matchmaking flow, league table, sabotage tips, and winning strategies see the dedicated Arena Mode page.

Tile Reference

Per-turn resource delta before the distance multiplier is applied.

Tile 🍞 Food 🪵 Wood 💧 Water 🪨 Stone 💊 Med. 🏠 Housing 😊 Hap.
🌲 Forest+1+2+1–1+1
🏞️ Lake+2+3+1–2+2
🌊 Riverbed+1+2+1+1+1
🌾 Plains+1+2+1
🌽 Fields+4–1+1
🏜️ Sand–1–2+2+1–2
🐊 Swamp–1+1+1–1–3
⛰️ Mountain–1+3–2+1
🏛️ Ancient Ruins+2+1+1–3
🌋 Volcanic Rock–1–2+4–2–2

Terrain Spread

Each turn, certain terrains can convert adjacent tiles:

SourceTargetChance
🌲 ForestPlains5% per neighbour
🏜️ SandPlains7%
🏜️ SandFields5%
🐊 SwampPlains4%
🐊 SwampFields6%
🏞️ LakePlains4%
🌋 Volcanic RockPlains6%
🌋 Volcanic RockFields4%

Tools Reference

All tools cost 1 from inventory per use. Each purchase gives 1 tool.

Forest Tools

ToolUse On → ResultTurnsBuy CostQueue Bonus
🪓 AxeForest → Plains15 stone · 3 wood+3 wood
🪚 SawForest → Fields210 stone · 6 wood+2 wood
🔥 TorchForest → Plains16 wood · 3 food+2 wood · ⚠️ 20% fire spread
🍄 Rot Spores (sabotage)Forest → Swamp310 food · 7 water · 5 wood

Farming Tools

ToolUse On → ResultTurnsBuy CostQueue Bonus
🌱 Seed BagPlains → Forest58 food · 5 water · 2 wood
🌾 HoePlains → Fields25 wood · 4 stone · 3 food
🌿 ScytheFields → Plains16 stone · 5 wood+4 food
☠️ Plague Thatch (sabotage)Fields → Swamp412 food · 6 water · 6 stone

Terrain Shaping

ToolUse On → ResultTurnsBuy CostQueue Bonus
🪣 ShovelPlains → Lake38 wood · 6 stone · 4 food
⛏️ PickaxeMountain → Sand112 stone · 8 wood+5 stone
🪨 Boulder KitPlains → Mountain415 stone · 10 wood · 3 food

Ruins Tools

ToolUse On → ResultTurnsBuy CostQueue Bonus
🔩 Excavation DrillRuins → Plains210 stone · 8 wood · 4 food+6 stone +3 medicine
⚔️ Siege Catapult (sabotage)Plains → Ruins214 wood · 10 stone · 6 food

Volcanic Tools

ToolUse On → ResultTurnsBuy CostQueue Bonus
⛏️ Quarry DrillVolcanic → Plains210 stone · 10 wood · 3 food+8 stone
💣 Lava Bomb (sabotage)Fields → Volcanic212 stone · 8 wood · 6 food

Water & Swamp Tools

ToolUse On → ResultTurnsBuy CostQueue Bonus
🚰 Drainage PumpSwamp → Plains210 wood · 8 stone · 3 medicine+2 water
💧 Water PumpSand → Plains26 wood · 5 stone · 4 food+3 water
🏗️ Dam KitLake → Plains314 stone · 10 wood · 5 food
🛡️ Levee KitPlains → Plains (levee flag)112 wood · 10 stone · 4 food
🌊 Riverbed ScoopPlains → Riverbed26 wood · 5 stone · 4 food+4 water
🪣 Mud Dump (sabotage)Lake → Swamp312 stone · 8 wood · 5 food

Medicine

ToolUse On → ResultTurnsBuy CostQueue Bonus
🌿 Herbalist KitSwamp → Swamp (unchanged)110 food · 6 water · 3 wood+4 medicine

Random Events

Each tile within 2 hexes of the town rolls independently every turn. A sample of events:

TileEventChanceEffect
🌲 ForestAnimal Attack8%–population growth, –happiness
🌲 ForestRich Hunt12%+food, +happiness
🌲 ForestForest Fire3%tile → Plains, –happiness
🏞️ LakeFlooding10%–food, –happiness
🏞️ LakeAbundant Fishing15%+food, +happiness
🏞️ LakeDrought — Lake Shrinks4%tile → Riverbed
🌊 RiverbedFlood Season12%–food, –happiness
🌊 RiverbedFertile Silt Deposit15%+food
🌊 RiverbedRiver Runs Dry5%tile → Sand
🌾 PlainsDust Storm6%–happiness, –food
🌾 PlainsBeautiful Meadow Season10%+happiness, +population growth
🌽 FieldsPest Infestation10%–food, –happiness
🌽 FieldsBumper Harvest15%+food, +happiness
🌽 FieldsSoil Exhaustion5%tile → Plains
🌽 FieldsWaterlogged Fields5%tile → Swamp
🏜️ SandSandstorm10%–food, –happiness, –housing
🏜️ SandHidden Oasis4%+water, +happiness
🐊 SwampDisease Outbreak15%–population growth, –happiness, –medicine
🐊 SwampRare Medicinal Herbs10%+medicine, +happiness
🐊 SwampToxic Gas Venting8%–happiness, –population growth
⛰️ MountainRockslide6%–housing, –happiness, –population growth
⛰️ MountainRich Ore Vein8%+stone, +happiness
🏛️ Ancient RuinsTreasure Cache8%+stone, +medicine, +happiness
🏛️ Ancient RuinsAncient Plague Pit12%–population growth, –happiness, –medicine
🏛️ Ancient RuinsStructural Collapse6%tile → Plains, +stone
🌋 Volcanic RockVolcanic Tremor10%–happiness, –housing; spreads to neighbour Plains
🌋 Volcanic RockRich Mineral Seam8%+stone, +medicine, +happiness
🌋 Volcanic RockLava Flow Subsides5%tile → Plains, +stone

Scoring System

Scores are calculated at game end (win or loss) and saved to your personal leaderboard.

ResourceWeight
🍞 Food×1
💧 Water×1
🪵 Wood×1
🪨 Stone×1
💊 Medicine×2
🏠 Housing Capacity×2
😊 Happiness×3
👥 Population×5

Your top 5 scores are stored and displayed in the Lobby.