DarwinBotsManual
Open the app EspañolES

Parameters: Game modes (F1 / rounds)

The contest rules of the original: rounds that restart, the F1 mode where species compete until one wins, the cycle and population caps, and disqualification.

This group holds the rules the original DarwinBots used to make species compete: a simulation played in rounds, each one won by the last species left standing, and a contest that ends when a species has collected enough victories. This is the F1 mode, the one used for bot leagues.

In the app, you normally leave all of this alone and compete from Compete (see Compete): that is where you set up matches, fix these values for each one and keep the standings. This group is for setting up a contest by hand from Experiment, or a simulation that restarts on its own.

What a round is

When a round ends, the app rebuilds the world from scratch with a new seed: it seeds the species from the start again, with the scenario's count and energy. The options carry over just as they were when the round ended, including the changes the simulation itself made (for example, the multiplier moved by the adjustment in Parameters: Dynamic costs). Nothing from the previous round is inherited: no bots, no mutations, no energy. The cycle counter goes back to 0 in the rounds of an F1 contest; in the rounds of Restart round with no heterotrophs it keeps counting from where it was.

There are two ways for a new round to start: with Restart round with no heterotrophs, when the animals go extinct, or with F1 mode.

How an F1 contest is decided

With F1 mode on, when the simulation starts the engine takes note of the species that are not vegetables, and every 10 cycles it counts how many bots each one has left. When only one is left, that species wins the round and another begins. The contest ends in one of two ways:

  1. By win cap. If the cap on rounds won is greater than 0, the first species to win that many rounds takes the contest right away.
  2. By margin. When the minimum rounds are completed (call that number N), the species with more than √N + N/2 victories wins. If none gets there, it is a statistical tie and one more round is played, with the same count for N + 1.

The margin rule is demanding on purpose: with N = 5 you need all 5 victories; with N = 8, 7 out of 8; with N = 10, 9 out of 10. With N below 5, winning them all is not enough, so, unless someone reaches the win cap first, the contest lasts at least 5 rounds. A 4–1 lead after 5 rounds keeps the contest going, and it is settled only in the eighth round if the leader wins the next three.

When there is a winner, the simulation stops in the final world.

Restart round with no heterotrophs

If only vegetables remain, a new round starts.

Default
no
Usual range
yes / no
Variable
Restart
Key
opt:90
Live
can be changed while the simulation runs
Mode
advanced only

If the bots that are not vegetables run out, the app starts a new round with a new seed and the same species as at the start. It is useful for leaving a long search running: if a seed goes badly and the animals go extinct, another one is tried without you having to restart by hand. With F1 mode (species contest) on it does nothing, because the contest handles its own rounds.

F1 mode (species contest)

Rounds until one species wins.

Default
no
Usual range
yes / no
Variable
F1
Key
opt:91
Live
can be changed while the simulation runs
Mode
advanced only
Note
The contest starts with a new sim or from Compete: turning it on in a running sim does not start the species census.

Turns on the round-based contest described above. It needs at least two species that are not vegetables: with only one, the engine turns the mode off. The contest is set up when a new simulation starts; turning it on in a simulation that is already running does not start it (the parameter's note says so). Species are told apart by their name, so two species with the same name count as one. With the F1 rules the costs are usually on (Parameters: Costs), but this mode does not touch them.

Minimum rounds

Contest rounds (also writes optMinRounds).

Default
5
Usual range
1 to 32000
Variable
MinRounds
Key
opt:97
Live
can be changed while the simulation runs
Mode
advanced only

The rounds after which the app checks whether someone won by margin (the N in the rule √N + N/2). It is 5 by default, the minimum with which the rule can be met. More rounds make the result more reliable, because a species that got lucky on one seed is not enough. Each statistical tie adds 1 to it during the contest. Writing it also writes Configured minimum rounds.

Rounds-won cap (0 = off)

Whoever reaches this many wins takes it.

Default
0
Usual range
0 to 32000
Variable
Maxrounds
Key
opt:98
Live
can be changed while the simulation runs
Mode
advanced only

If it is greater than 0, the first species to win this many rounds takes the contest, without waiting for the margin rule. With 0 (the default) only the margin counts. It is useful with three or more species, where reaching the margin can take many rounds.

Cycle cap per round (0 = off)

Ends the round after N cycles. Duels only: with more than 2 species it is turned off.

Default
0
Usual range
0 to 2147483647
Variable
MaxCycles
Key
opt:99
Live
can be changed while the simulation runs
Mode
advanced only

A cycle cap per round, meant for duels: when the round goes past this many cycles, the species with fewer bots dies out entirely and the other one wins the round. If they are tied, nothing happens. The cap can stretch on its own: every 1000 cycles, if the losing species has been growing faster than the other one, the engine gives it more time. With more than two species the engine turns it off at the start. Compete matches do not use it: they have their own cap, which works for any number of species.

Max population per species (0 = off)

Bot cap per species in the contest. Duels only: with more than 2 species it is turned off.

Default
0
Usual range
0 to 32000
Variable
MaxPop
Key
opt:100
Live
can be changed while the simulation runs
Mode
advanced only

Another control for duels: if one of the two species goes over this number of bots, the engine kills the weakest ones (those with the least energy, counting the body) of both, in proportion: the one that went over ends up below the cap and the other loses the same fraction. It keeps a duel from getting stuck with thousands of bots. With more than two species it is turned off at the start, like the cycle cap.

Disqualification

Which actions disqualify in the contest. Only active with F1 or with restart mode 1.

Default
0
Values
0 = off · 1 = level 1 (viruses; giving or taking through ties to another species) · 2 = level 2 (defenses, ties, viruses, deleting genes, memory shots, sexual)
Variable
Disqualify
Key
opt:93
Live
can be changed while the simulation runs
Mode
advanced only

Forbids certain actions during the contest. A species that does a forbidden action is disqualified: all its bots die on the spot. It only acts with F1 mode (species contest) on, or with Restart mode set to 1 (the seeding mode of Parameters: Evolution mode).

LevelDisqualifies the species that…
1makes a virus (.mkvirus), or passes energy or body to a bot of another species through a tie, or takes them from it
2makes a virus, shell, slime, venom or poison; ties with .tie; shoots at another bot's memory (a positive shot); attempts sexual reproduction (.sexrepro); or deletes a gene (.delgene)

Level 2 does not repeat level 1's tie rule, but since it forbids tying, only birth ties are left, and those join bots of the same species. It is useful for tournaments of “clean” bots, which compete only by eating and moving.

Configured minimum rounds

Value MinRounds goes back to when a contest ends.

Default
0
Usual range
0 to 32000
Variable
optMinRounds
Key
opt:101
Live
can be changed while the simulation runs
Mode
advanced only
Note
Writing «Minimum rounds» also writes it: unless set on its own, it equals them.

The value that Minimum rounds goes back to when a contest ends, since statistical ties keep raising it. Since writing the minimum rounds writes this one too, you almost never need to touch it separately.