DarwinBotsManual
Open the app EspañolES

Compete

Matches and tournaments between bots: the quick match, the tournament wizard, the six formats, the match rules, the standings with Elo, seasons, the Hall of Fame and how to play.

In Compete, bots fight each other under fixed rules and the app keeps count: who won each match, with which seed, the season standings and an Elo that carries over from one tournament to the next. It is for finding out whether your bot is better than another, and not just watching it for a while in Observe.

The screen has three columns:

Matches, rounds and seasons

Three words used throughout the section:

In every round, besides the entrants, the world starts with 15 algae (Alga Minimalis) seeded as vegetables, just like in the classic interface. The algae don't count as fighters, and vegetable bots can't be entered.

The quick match

The ⚡ Quick match is for trying things out without setting anything up: everyone together in one world, up to 20 bots. It isn't saved. If you reload the page, it is lost.

  1. Click ⚡ Quick match in the list.
  2. In the Entrants tab, click Add from the Library, search for the bots and click Add.
  3. In Play, click ▶ Play.

If you like the result, type a name and click Save as tournament: it moves to My tournaments with its matches. Clear removes the entrants and the matches.

You can also enter a bot from its profile, with Enter in a tournament (see Bots: library and profile).

Creating a tournament

New tournament opens a three-step wizard. At the bottom you have Back, Cancel and the button to continue.

  1. 1 · Format. Pick how they meet (see the table below) and fill in its options. The Name is optional: left empty, it becomes “Tournament N”.
  2. 2 · Entrants. Pick the mode:
    • Fixed list: the ones you pick. They carry over unchanged to the next season.
    • Drawn every season: N bots from the pool, drawn again every season.
    • Drawn every fight: the fighters come out of the pool when each fight is played. The World cup doesn't allow this mode.

The bots come from the Library: search them by name, filter by Origin (from the forum or my own), add a saved selection with Add a selection… or draw N with 🎲 Draw. The pool can be the whole Library, your favorites, the current selection, a tag or a named selection.

  1. 3 · Rules. Pick the world and the match values (see below).

Create the tournament saves it and opens it. The wizard warns you if something doesn't add up. For example, a World cup needs 8, 16 or 32 entrants, and in a round robin with many bots it tells you how many matches there will be.

The formats

FormatHow it is playedOptions
Single matchEveryone in the same world, up to 20. If there are more, the first 20 play. It is the usual F1 contest.—
King of the hillThe winner stays and meets the next challengers.Fighters per fight (2 to 20), The season ends, Champion retires after (5 wins in a row by default), No repeated challengers
Round robinEveryone against everyone else, using the circle method.Legs: 1, or 2 with the seeding order swapped
Step ladderThey enter one at a time, in joining order. The first takes rung 1; each newcomer challenges from the top down and, if it wins, takes that rung.—
World cupGroups of 4 play a round robin; the top 2 of each group go to a knockout bracket (1A–2B, 1B–2A…). 8, 16 or 32 bots.Group stage legs, Pots (by Elo or random), Third-place match
SwissRounds of duels between bots with the same score, never the same opponent twice. Meant for 16 to 32 bots.Rounds (0 = auto)

Some details of each one:

No format has draws: a void match is played again.

The match rules

The rules have two parts.

World: the world's parameters, without species.

Match values:

ValueDefaultWhat it does
Bots per species5How many bots of each entrant are seeded in each round. Each entrant can have its own number.
Starting energy3000The energy of each bot when the round starts.
Minimum rounds5The N of the √N + N/2 rule.
Wins to take the match (0 = off)3The first species to reach it takes the match. Useful with 3 species or more.
Cycle cap per round (0 = off)5000The longest a round can last.
At the cap, the round goes tothe species with the most botsOr the species with the most energy (nrg + body × 10).
Max bots per species (0 = off)500If a species goes over it, its poorest bots are removed. It keeps one that reproduces nonstop from slowing the match down.

In the tournament's Rules tab, See the changes lists how the world differs from its base. Open in Experiment opens it as a draft, to look at it or retouch it; the tournament doesn't change.

The world's parameters are explained one by one in Experiment: advanced mode. The ones for the F1 contest from the manual (F1 mode (species contest), Minimum rounds, Rounds-won cap (0 = off), Cycle cap per round (0 = off), Max population per species (0 = off)) are set by the tournament in every match; you don't need to touch them.

The leagues

A league is a world with its combat rules, named after one of DarwinBots' historical leagues. The League button under World picks one of the seven, and changing it changes the world and the fight rules. Like the other rules, it stays fixed from the season's first match.

LeagueWho entersWorldWhat it disqualifies
F1Any bot that isn't a vegetal.The base: costs, physics and a toroidal 9237 × 6928 field.Nothing.
F2The bots of the “F2 bots” and “F3 bots” boards.The base, with solar energy per cycle at 30.Eating through another species' tie, and viruses.
F3Only the bots of the “F3 bots” board.As F2.Ties, viruses, info shots, venom, poison, slime, shell, .delgene and sexrepro.
MBThe bots of the “Multi-Bots” board.Multi-bots, in the F2 world.Nothing.
SBThe bots of the “Short bots” and “Single store” boards.The base, with a 16000 × 12000 field.Nothing.
SSThe bots of the “Single store” board.The base, unchanged.Nothing.
F4Any bot that isn't a vegetal.The base, with the old-age upkeep (Age cost) at 1 and the field at twice the side (18474 × 13856).Nothing.

Where they come from. The values of F2, F3, MB and SB are the ones the original program set with its league buttons, and the disqualifications are the ones the community set for each league. SS uses the base unchanged.

F4 isn't in the original. It's an addition of this version: F1 with the old-age upkeep at 1 and the field at twice the side, toroidal like F1. At that cost, a bot that neither hunts nor eats runs out in about 3000 cycles, instead of living almost for free. When you pick it, the wizard proposes At the cap, the round goes to “the species with the most energy” and Max bots per species at 100. They're proposals: you change them in step 3.

Two quirks of the original, kept. A disqualification kills the whole species, and the species is the one of the bot that does the action, even if an info shot from another bot forced it. And in F2, sexrepro doesn't disqualify: it was a community rule that the program never enforced. See Differences from the original 2.48.32.

MB has no kill restrictions. The original had the MB kill restrictions, which this version doesn't include: the MB league is played without them. See Differences from the original 2.48.32.

Disqualifications show in Matches: a match row with a DQ carries the ⚖ DQ tag next to the fighters, and its tooltip says what happened. The disqualified species loses the round.

Who enters. Each league asks for a certain category of bots. It's checked when bots are entered (in step 2 of the wizard, against the league of step 3, and with Add from the Library in Entrants) and, afterwards, on each entrant. There are three checks, from the strictest to the softest:

CheckExampleWhen enteringA bot already entered
DNA shape (exact)SB: up to 6 genes. SS: a single store, inc or dec in the whole DNA.Error: the bot doesn't get in. The wizard won't create the tournament and Add is disabled.⚠ as an error. The bot stays on the list.
Category (forum board or a label in the name)F2 doesn't admit a bot from the “Multi-Bots” board, unless it's called “My bot (F2MB)”.⚠ as a warning.⚠ as a warning.
Banned actions (approximate)F3: a bot that writes .tie.⚠ as a warning.⚠ as a warning.

How each bot is judged. An own bot is judged by its DNA: the shape is exact, but it has no board, so its category isn't checked. Its actions come from a static analysis: it looks at which sysvars the DNA writes, doesn't follow the stack, and doesn't see the targets computed while it runs. That's why it's approximate. A forum bot doesn't carry its DNA in the index: while you pick it, it's judged by its board, by the actions the core computed for its profile, and by the number of genes in that profile. When it's entered, the app downloads its DNA and checks the shape again against the real DNA: if it fails, it doesn't get in and a notice says why. For example, “One Man Bucket (SS)(F2)” is in the SS category thanks to the label in its name, but its DNA has 20 store. The same goes for draws: a bot that fails is skipped and another one is drawn.

Name labels count for the category only when they are in parentheses and spell an F followed by a digit, MB, SB or SS: “(F2)”, “(F2MB)”, “(SS)”. A forum bot from the “Multi-Bots” board named “My bot (F2MB)” gets into F2 with no warning; “My bot (Passive)” doesn't, because Passive isn't a label.

Why ⚠ also marks errors. The league can be changed until the season's first match, so an entrant that fitted can stop fitting. That shows as ⚠ next to its name: it isn't taken off the list.

The pool “the bots F2 admits” in Entrants uses the first two checks (shape and category) and leaves out the bots that fail them. Banned actions don't exclude a bot: the referee is the disqualification. See Compete.

None of this existed in the original: it's an addition of the app (see Differences from the original 2.48.32).

Entrants

The Entrants tab shows each bot with its Color, its Origin (from the forum, own, hybrid or built-in), its number of Bots and the fingerprint of its frozen DNA. There you can also:

⚠ appears next to the name of the entrants that the rules' league wouldn't admit, or that do actions with a warning. The reason is in the ⚠ itself (hover over it) and, on small screens, under the name. On a bot already entered the ⚠ only warns. When adding more, though, the errors and warnings of the picked bots show under the list, and a shape error disables Add, as in the wizard.

In the draw modes, the pool also offers the bots the rules' league admits (for example, “the bots F2 admits”). It only appears here: in the wizard the league is picked after the pool. See Compete.

Once the season has started, the draw is locked until the next season.

Play

The Play column says how much of the season is left and who fights next. There are two ways to move forward.

▶ Play launches the next match in the app's simulation and takes you to Observe, with a break screen before each fight (5 seconds by default, adjustable from 0 to 60). Below it, When the fight ends chooses how far it goes:

OptionWhat it does
stopPlays one fight and stops.
go on until the end of the seasonGoes on with the remaining fights and stops after announcing the champion. It's the default.
go on with new editionsWhen the season ends, it starts another one and goes on, in a loop. The new edition follows the entrants mode: a Fixed list carries over whole; with a draw, it is drawn again.

Every fight is recorded in the tournament. The choice is remembered in this browser and can be changed while playing, from the caption in Observe (see Observe). Stop when the fight ends and Abandon the fight are there too. The tournament goes on even if you go to another section: a strip below the top bar shows it on every screen (see Observe).

▶ Play plays the open season with the entrants it has, even if it hasn't started yet: it doesn't draw them again. The new editions of go on with new editions do the same as New season: a fixed list carries over whole and the modes with a draw take entrants from the pool. To watch it like on TV, Observe has full screen.

While a match is in play, this column shows the score with the round, the cycle (with a thin bar if the format has a cycle cap), the Bots alive and the Rounds won of each one. Watch in Observe takes you to watch it, and Abandon cuts it without recording it. In the other sections, a floating scoreboard shows the same; you can collapse it, or go back with Go to Compete (on a phone it starts collapsed and, with a tournament in progress, gives way to the strip). With a tournament in progress, Abandon asks for confirmation and also stops the tournament, like Abandon the fight in the strip.

Background round plays at once all the matches the format lets you play without waiting for other results. For example, the whole pending schedule of a round robin or the current round of the Swiss. The matches run without drawing, at top speed and on several workers at once. Since each match uses its own seed, the result is the same as watching them. It notifies you when it finishes. While it runs, the season is locked. Cancel the round stops it. The quick match doesn't play background rounds.

With a tournament in progress

While a tournament plays, the app's simulation is its fight and the open tournament is that one. So, until you stop it (from the strip or with Abandon):

Standings, structure and matches

The tournament's tabs are Standings, the format's view, Matches, Entrants, Rules and Seasons.

Standings: position, matches played (P), won (W), lost (L), percentage, By cap (the share of the rounds won that were decided by the cycle cap), Avg. cycles, Elo and the Last results. The Swiss adds Pts and Buchholz, and the endless hill, the 👑. Below, the format's tiebreak order and, with up to 14 entrants, the Head to head table.

The Elo starts at 1500. In a fight of N, the winner beats each of the others with K = 32 / (N − 1). That way a fight with many entrants isn't worth more than a duel.

The format's view changes its name:

FormatTabWhat it shows
SwissRoundsEach round with its pairings and the bye
World cupGroups and bracketThe pots, the group tables and the bracket
King of the hillFights and crownsThe king, its streak and the crowns
Step ladderLadderThe rungs and who is challenging
Round robinFixturesThe matchdays

Matches lists each match with its winner, cycles, rounds by cap and Seed. Two actions:

The seed is what makes a match repeatable: see Seeds and reproducibility.

Seasons

When the season ends, Play shows the champion and a button to Start season N, which asks for confirmation. If the tournament draws entrants, it says “(new draw)”. The Seasons tab has the same thing with New season, the list of seasons (with See to open a past one) and the All-time table of the tournament: seasons played, seasons won, P, W and an Elo that carries over from one season to the next.

A new season unlocks format, values and rules. The entrants carry over unchanged or are drawn again, depending on the mode.

Hall of Fame

The Hall of Fame gathers all the saved tournaments. There is one row per DNA: the same bot under another name in another tournament is the same row. It shows seasons won (🏆), tournaments, seasons played, P, W, percentage and a single Elo calculated over all the matches, in date order. Refresh recalculates it.

Report, export and import

The first time you open the new app, it copies the tournaments from the classic interface in this browser, and Compete tells you what it brought. Where everything is stored and how to back it up is in Your data.

For ideas on how to build a bot that wins tournaments, see Tournament bots.