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:
- On the left, the list: New tournament, the ⚡ Quick match, My tournaments and, at the bottom, the Hall of Fame, with Import .json and Export.
- In the middle, the open tournament: its name, the format, how many bots and which season it is in, and its tabs.
- On the right, Play: the next fight, the buttons to play it and the last match.
Matches, rounds and seasons
Three words used throughout the section:
- A round is a new world with the fighters seeded. The last species standing wins it. If the round reaches the cycle cap, the species with the most bots or the most energy wins it, depending on the rule you pick.
- A match is a series of rounds. With N minimum rounds, whoever collects more than √N + N/2 round wins takes the match. If nobody gets there, another round is played. With Wins to take the match, the first species to reach that number takes the match right away.
- A season is one full pass of the format: all the matches needed to have a champion. A tournament can have many seasons.
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.
- Click ⚡ Quick match in the list.
- In the Entrants tab, click Add from the Library, search for the bots and click Add.
- 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 · 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 · 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.
- 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
| Format | How it is played | Options |
|---|---|---|
| Single match | Everyone in the same world, up to 20. If there are more, the first 20 play. It is the usual F1 contest. | — |
| King of the hill | The 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 robin | Everyone against everyone else, using the circle method. | Legs: 1, or 2 with the seeding order swapped |
| Step ladder | They 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 cup | Groups 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 |
| Swiss | Rounds 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:
- King of the hill. The first to win the number of wins in a row you asked for retires undefeated and takes the season. If nobody manages it, the season ends at 3 × N fights and the one with the best Elo wins. With The season ends: never (endless hill), each retirement adds a 👑 and the hill opens up again. Whoever collects the most crowns leads. With retirement at 0, the champion stays until it loses.
- World cup. Pots by Elo uses the tournament's all-time Elo (1500 for those with no history): one bot from each pot per group. The groups are drawn when the first match is launched, or earlier with Draw the groups in Entrants. Tiebreakers in the groups: head to head, group Elo, fewer rounds won at the cap, fewer cycles and the draw order.
- Swiss. In auto mode, ⌈log2 N⌉ + 1 rounds are played: 4 with 8 bots, 5 with 16 and 6 with 17 to 32. A win is 1 point. With an odd number of bots, the lowest one that hasn't had it yet gets a bye, worth 1 point. Tiebreakers: Buchholz (the sum of the opponents' points), Elo and rounds won by extinction. Bots that join after the season has started play from the next 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.
- League: the world and the combat rules of one of the seven leagues: F1 (the base), F2, F3, MB, SB, SS and F4. You pick it from the list, and below it you read what changes. See The leagues.
- No costs: the F1 base with every cost at 0. Bots spend no energy.
- From Experiment: the options and objects of a scenario (built-in, your own or the Experiment draft), without its species. See Scenarios.
Match values:
| Value | Default | What it does |
|---|---|---|
| Bots per species | 5 | How many bots of each entrant are seeded in each round. Each entrant can have its own number. |
| Starting energy | 3000 | The energy of each bot when the round starts. |
| Minimum rounds | 5 | The N of the √N + N/2 rule. |
| Wins to take the match (0 = off) | 3 | The first species to reach it takes the match. Useful with 3 species or more. |
| Cycle cap per round (0 = off) | 5000 | The longest a round can last. |
| At the cap, the round goes to | the species with the most bots | Or the species with the most energy (nrg + body × 10). |
| Max bots per species (0 = off) | 500 | If 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.
| League | Who enters | World | What it disqualifies |
|---|---|---|---|
| F1 | Any bot that isn't a vegetal. | The base: costs, physics and a toroidal 9237 × 6928 field. | Nothing. |
| F2 | The 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. |
| F3 | Only the bots of the “F3 bots” board. | As F2. | Ties, viruses, info shots, venom, poison, slime, shell, .delgene and sexrepro. |
| MB | The bots of the “Multi-Bots” board. | Multi-bots, in the F2 world. | Nothing. |
| SB | The bots of the “Short bots” and “Single store” boards. | The base, with a 16000 × 12000 field. | Nothing. |
| SS | The bots of the “Single store” board. | The base, unchanged. | Nothing. |
| F4 | Any 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:
| Check | Example | When entering | A 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:
- enter more with Add from the Library;
- change the color or the number of one (empty = the format's);
- remove one with Remove, if it hasn't played yet in this season;
- change the Entrants mode and, in the modes with a draw, the pool and How many; Draw replaces the list with a new draw.
⚠ 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:
| Option | What it does |
|---|---|
| stop | Plays one fight and stops. |
| go on until the end of the season | Goes on with the remaining fights and stops after announcing the champion. It's the default. |
| go on with new editions | When 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):
- The tournament is read-only: entrants, rules, draws, the name, the new season, ↻ and Replay and analyze, Clear and Delete. A notice at the top explains it, with Tournament controls.
- No other tournament opens: the others show in the list, dimmed, but don't open, because opening another would cut off the one being played. You can't create one with New tournament or import a .json either (both open the new one).
- Nothing else is played: you can't ask for a Background round of this tournament. A round of another tournament requested earlier keeps running.
- In Home and Experiment, what would replace the simulation (starting a scenario, resuming a run, opening a file, New simulation, Apply to current) is off, with the notice “A tournament is in progress: stop it to use the simulation” and Tournament controls. In Bots: library and profile the same goes for Seed into the current run.
- In the The inspector the Player Bot doesn't show up, the eye designer only reads the eyes and builds the gene, and the console doesn't send the commands that change the fight (
set,energy,cycle,execrob,playandpause). - Bots: library and profile and Analyze stay free. Enter in a tournament doesn't offer the tournament in progress, and enters the bot in the others without opening them.
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:
| Format | Tab | What it shows |
|---|---|---|
| Swiss | Rounds | Each round with its pairings and the bye |
| World cup | Groups and bracket | The pots, the group tables and the bracket |
| King of the hill | Fights and crowns | The king, its streak and the crowns |
| Step ladder | Ladder | The rungs and who is challenging |
| Round robin | Fixtures | The matchdays |
Matches lists each match with its winner, cycles, rounds by cap and Seed. Two actions:
- ↻ Replay plays the match again with the same rules, entrants, seeding order and seed, and warns you if the result doesn't match.
- Replay and analyze runs it again as a run and opens it in Analyze. It isn't recorded.
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
- Tournament report generates an
.htmlreport of the last season: standings, format structure, Elo and matches with their seeds. It is also kept in Analyze → Reports (see Reports). - Export downloads the open tournament as a
.json, with its rules, its entrants with their DNA and its matches. - Import .json loads it as a new tournament. It also accepts the tournament and league files from the classic interface.
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.