hegemony run

hegemony run

Watch a single match in the GUI. The war map and the leaderboard open as separate, coordinated windows.

hegemony run [flags]

---

Build requirement

The GUI lives behind the ebiten build tag. A plain go build or go install produces a headless binary, and hegemony run will not be available in it.

# from a checkout
just gui run --width 32 --height 32

# or build the tagged binary yourself
go build -tags ebiten ./cmd/hegemony

The Homebrew cask ships the GUI build; the Homebrew formula ships the headless CLI:

brew install --cask danielriddell21/tap/hegemony

---

Flags

Flag	Default	Description
--width <n>	32	Grid width in cells
--height <n>	32	Grid height in cells
--ticks <n>	2000	Maximum ticks before the match ends
--seed <n>	1	Match seed
--threshold <f>	0.6	Territory fraction to win outright (0 disables)
--cell-size <n>	18	Pixels per cell
--tps <n>	12	Simulation ticks per second
--strategies <list>	all registered	Strategies to enter

Plus the shared simulation parameters.

Documentation clips are produced by just demos (tools/demogen) rather than by flags on this command.

---

Examples

# Default match
just gui run

# Bigger board, larger cells
just gui run --width 48 --height 48 --cell-size 12

# Slow it down to follow the front line
just gui run --tps 4

# Watch a specific matchup, reproducibly
just gui run --strategies Blitzkrieg,Turtle,Bulwark --seed 7

---

Notes

--tps changes simulation speed only — it does not change the outcome. A match at --tps 4 and the same match at --tps 60 resolve identically for a given seed.

--cell-size is presentation only; --width and --height are the actual board dimensions and do affect play.