How scoring works: position, travel, and direction
Every claim decision is one live score blending where a property sits, how far it is to drive, and your chosen direction.
One number, recomputed constantly
Everything the swarm does comes down to a single score it computes for each open property, for each tractor, on every GPS ping. The machine claims the highest-scoring property it can. Understanding the score is understanding the engine.
The two halves of the score
The score blends two weighted parts:
- A position part — how well-placed is this property? This is where direction control lives (outside-in, inside-out, or nearest-first, measured from the depot anchor) and where density cohesion adds its same-block and close-pair pull. It answers "is this the right property to be at, given where the fleet and the storm are?"
- A travel part — how quick is it to get there? This uses the real road travel time from OpenRouteService, so genuinely reachable properties beat ones that merely look near.
Conceptually: score = (direction weight × position) + (travel weight × travel). The two
weights are what let the fleet both spread out and sweep — turn up position and it favors
strategy and cohesion; turn up travel and it favors raw proximity.
The behaviors are all the same score
The behaviors described elsewhere in this section aren't separate systems bolted on — they are all expressed inside this one score:
- Start-spread adds a fan-out preference on the opening move.
- Density cohesion boosts properties on the block you're already sweeping.
- Anti-steal holds back a property a peer is already working beside.
- Direction tilts the position part toward or away from the depot.
Then the claim
Once the best property is chosen, the tractor claims it with the atomic database operation — so scoring picks the best property and claiming guarantees only one machine gets it. If the claim is lost to a peer, the engine simply re-scores and offers the next best property.
Updated 2026-08-09
In this topic
- How swarm dispatch works
- Atomic claiming: two tractors never clear the same lot
- Start-spread: the fleet fans out from the yard
- Density cohesion: sweep the block before you leave it
- Anti-steal: don't grab a property a peer is already sweeping
- Direction control: outside-in, inside-out, or nearest-first
- Real road travel times, not straight-line guesses
- Self-healing: claims that recover on their own
- Plow-ridge recheck: sending someone back after the city re-buries an entrance
- FAQ: Can I override the swarm and assign a property myself?
- FAQ: What happens if a tractor loses signal or goes offline?