Goal

Destroy every enemy base. Your base must survive. Enemies are red/orange/purple; you and your allies share the player team.

Core Loop (the Git workflow)

1. Branch — git checkout -b plan1 creates and switches to a planning branch.
2. Plan — queue actions: create soldier 3, attack, defend.
3. Stage — git add stages your planned actions.
4. Commit — git commit -m "rush" saves the plan as a commit.
5. Merge — git checkout main then git merge plan1 executes the plan in the real world.

Tip: nothing happens in the world until a commit is merged into main.

Local vs Remote

Your repo is local. Allies push their plans to origin/<ally>. To use an ally's plan:

• git fetch — see what allies have pushed.
• git pull ally1 — merge origin/ally1 into your current branch.
• git push — publish your branch to the remote (optional, for show).

Planning Commands

• create <unit> [count] — queue unit builds (worker, fast_worker, heavy_worker, soldier, archer, defender, knight).
• attack — order all units to assault the nearest enemy base.
• defend — order all units to fall back and guard your base.

Git Commands

• git init, git status, git log --oneline
• git branch <name>, git checkout [-b] <name>
• git add, git commit -m "msg", git merge <branch>
• git push, git fetch, git pull <branch>
• git help in the terminal for the full list.

Merge Conflicts

Builds always combine. Conflicts only happen when two branches give opposing tactical orders (one says attack, the other defend). A modal will let you pick which order wins per branch.

Camera & Controls

• Right-click drag — pan the world camera.
• Mouse wheel — zoom in/out.
• Click your base — open the build modal (also queues actions on the current branch).
• Source Control panel (left) — VS Code-style commit UI + hamburger menu of common commands.
• Branch Graph panel (right) — drag, resize, zoom. Dashed = remote branches.

Units (cost in resources)

• worker — gathers resources.
• fast_worker / heavy_worker — variants (speed vs capacity).
• soldier — balanced fighter.
• archer — ranged, fragile.
• defender — tanky, slow.
• knight — elite, expensive.

Owner color = team. Inner dot color = unit role.

Tips

• Build workers first — no resources, no army.
• Use a fresh branch per "what-if" plan; merge only the ones you want.
• Allies push every ~12s. Pull regularly to combine forces.
• Hard CPUs build faster and pick stronger units — defend early.