DarwinBotsManual
Open the app EspañolES

Observe

The live world screen: layouts and tabs, the camera, full screen, time, the three views, the Live panel with its chart and its events, seeding, saving, snapshots, tournaments and the Player Bot.

Observe is where you watch the simulation while it runs. It fills the screen in three parts:

If you enter Observe with no world in memory, the app starts the Primordial soup scenario on its own with a new seed and sets it running. To pick another, go to Home.

Layouts and tabs

Three buttons on the bottom bar, to the left of ⛶, share the space between the world and the side panel:

ButtonWhat you see
▣ Fieldthe world alone, without the side panel
◧ Mixedthe world and the side panel (the usual one)
▤ Datathe panel at full width, and the world as a thumbnail in a corner

The world is never hidden: in Data it keeps running in the thumbnail, and you can click a bot or zoom there too. The app remembers the layout in this browser. On a phone, Data leaves the world on top, shorter, and the panel below.

The side panel has tabs. Live is the usual one. Tournament appears while a tournament is in progress and opens by itself when it starts. Bot shows the inspector: picking a bot jumps to that tab, and letting it go returns to the previous one.

The camera

At the start you see the whole field. To zoom in:

What you wantWith the mouseWith the keyboard
Zoom inwheel forward (zooms toward the pointer) or the + button+
Zoom outwheel backward or the − button−
See the whole fieldthe [ ] button (Fit the whole field)0
Move arounddrag the world (only when zoomed in)the arrow keys

The keyboard shortcuts work when the world has focus: click once on the field, or get there with Tab. The zoom goes from 1 (the whole field) to 64 magnifications. At the bottom left, a scale bar says how many world units it spans and the size of the field.

At the top left, a label reminds you which view you're using (and the “color by”, in the enriched view).

Full screen

The ⛶ button, on the right of the bottom bar, or the F key put Observe in full screen, without the bottom bar and with the chosen layout: with ▣ Field, the field alone; with ◧ Mixed or ▤ Data, the side panel too. Esc or Exit full screen (Esc) go back to Observe as it was. Going in and out doesn't change the simulation or the tournament being played.

Picking and following a bot

A click on a bot picks it: it gets marked, the side panel jumps to the Bot tab, with its inspector, and the world draws its trail and its nine eyes. A click on an empty spot lets it go. While nothing is picked, the label says “Click a bot to inspect it”.

With a bot picked, the label at the top left shows its number and its species, plus two buttons:

If the bot dies while you're watching, the inspector says so and keeps its last data.

Time

The first three controls in the bar handle time:

To the right of the bar, a counter says how many cycles per second the simulation computes and how many frames per second it draws. With × 1 you see every cycle; with Max you let evolution move on without watching every step. What happens in each cycle is in The cycle and the order of actions.

The views

The View selector in the bar changes how the bots are drawn. It doesn't change the simulation: only the drawing and some of the panel's data.

Enriched (the starting one). Each animal is a circle with a “nose” that marks where it's facing; each vegetable, a hexagon. The hue is its species' color and the brightness follows its energy: a dim bot is about to run out of everything. A green tint gives away chloroplasts. When a bot does something, a brief colored ring surrounds it (reproducing, shooting, making a tie, making defenses, gaining energy…). As you zoom in, details appear: the thick rim of the shell, the halo of the slime, blue spikes of venom and yellow ones of poison, an inner circle on the ones that are part of a multibot, the eyes (the ones that see something, in white) and the status (paralyzed, poisoned, infected). Births flash with a line to the mother; the dead shrink and fade out, and one that leaves through a teleporter leaves a cyan ring.

Classic. The original interface's drawing: circles in the species' color, a line toward where it's facing, arrows with each bot's thrust and thin rings showing its reserves (energy, body, waste, venom, shell, slime, poison, virus and chloroplasts). It's the lightest.

Outline. Like the classic one, but the bots are just an outline, with no fill. It helps you see what's underneath when they're piled up.

In all three, the picked bot shows its trail and its vision grid: nine cyan arcs, the focus eye's in red (see Vision).

The tooltip

In the enriched view, hovering over a bot brings up a brief card: its species, its number, whether it's an animal, a vegetable or a corpse (and whether it's part of a multibot), its energy, body and age, its generation, mutations, DNA length, victims (.kills) and ties, and what it did in the last second.

Color by

In the enriched view, the Color by selector changes the bots' hue to show a piece of data instead of the species:

OptionWhat it paints
Specieseach species' color (the usual)
Energy (nrg).nrg
Body.body
Generationhow many generations are behind it
Mutationshow many mutations it has accumulated
Agecycles of life
DNA lengthhow many instructions its DNA has
Genetic distancehow much its DNA differs from the picked bot's

With any data that isn't the species, a legend appears with a color scale and the minimum and maximum values among the living. Genetic distance is measured against the picked bot; with no bot picked, the legend says so. The inspector has a button that turns it on in one go (The inspector).

The Live panel

The Live tab of the side panel shows the current cycle and four cards:

CardWhat it says
Live botshow many there are, and how much it has gone up or down in the last 1000 cycles
Specieshow many are alive and how many have gone extinct
Mean energythe average .nrg per bot
Max. generationthe highest generation among the living, and which species it's from

Population by species

Below, a stacked area chart shows how many bots of each species there were over the course of the run. It takes a point every 100 cycles, so it appears with the second point. When the run gets long, it merges the points two by two so the chart covers everything. With seven species or fewer it shows them all; with more, it draws the six that reached the most bots and merges the rest into Others. The legend says how many bots each one has now.

Events

The Events list notes what's important in the run, the newest on top and with its cycle:

The See full analysis link opens Analyze with a lot more: metrics, species, the family tree and reports.

Seeding

Seed adds bots of a species to the world that's running, without restarting it. It's useful for dropping a predator into a quiet world, restocking a species that went extinct or testing a new bot against the ones already there.

  1. Click Seed in the bar.
  2. Under Bot, pick where the DNA comes from:
    • A bot from the library…: look it up by name, file, tag or note. It takes its name, whether it's a vegetable, 5 copies (15 if it's a vegetable) and a color that isn't in use.
    • Animal Minimalis (simple animal) or Alga Minimalis (vegetable): the usual two minimal bots.
    • Paste the DNA…: a box appears for pasting the code.
  3. Check Species name, Count (from 1 to 500), Starting energy and Color, and tick Vegetable (photosynthesizes) if it applies (see Chloroplasts and vegetables).
  4. Click Seed.

The bots appear right away and the seeding is noted in Events. The seeded species mutate at the factory rates, like the ones from the scenario (see Mutations).

The World bar

World opens, over the field, a bar for placing and removing obstacles and teleporters while the simulation runs:

Every order is recorded in the run and repeated on the same cycle when you repeat it. How obstacles affect the bots is in The world.

Saving and resuming

Save opens a dialog with a Name and these options:

Runs opens the list of what's saved, with a thumbnail, the cycle, the bots and the date of each one. Resume loads it paused (click Start to go on), Delete removes it and Open a .dbsim file… loads one from your computer. The one that's loaded carries the current mark.

If the run on screen has unsaved changes, resuming another or opening a file asks you before discarding them. What each format saves is in File formats; where what you saved ends up, in Your data.

Find the best

Find the best picks the simulation's fittest bot and opens its inspector. Fitness combines its offspring with its energy and its body; how much each part weighs is set by the parameter Offspring weight. Vegetables don't count: if there are only vegetables, the app warns that there are no candidates.

Snapshot

The Snapshot menu downloads data from the run to your computer:

The two record-of-the-dead checkboxes are the parameters Record dead bots and Exclude vegetables, and clicking them is a live change: it's noted in the run. During an F1 match they can't be changed. The .snp format is in File formats.

Player Bot

From the inspector's Control tab you can drive a bot with the keyboard and the mouse (see The inspector). While the mode is on, an indicator over the world says Player Bot on and whom you're controlling, with an Exit button (or Esc). If no bot is under control, a click on one takes it.

What you do in this mode isn't kept in the run: when you repeat it, it isn't repeated.

Tournaments

A tournament's fights are played in Observe: you start them with ▶ Play in Compete. Before each fight, a break screen announces who fights whom. During the fight the score is shown. When it ends, a short pause shows the winner, and when the season closes, the champion.

The tournament controls are on the strip above and, in full screen (where the strip isn't shown), over the field, at the top:

While the tournament lasts, the Tournament tab of the side panel shows the tournament and how much of the season is left, the fight with its score, the cycle and, if the tournament has a cycle cap, a thin bar showing how far into the round it is (or, between fights, the next one, the champion or the error that stopped it), the season standings and the latest results, and links to the tournament in Compete. With ▤ Data, the standings are the full ones from Compete, and below them is the structure of the format (the matchdays, the cup bracket, the Swiss rounds…), read-only.

With ▣ Field, without a panel, the fight card goes over the field, at the bottom right: M hides or shows it, to watch with nothing on top. With ▤ Data, the thumbnail field doesn't carry the break screen or the controls: you follow the fight in the Tournament tab, and When the fight ends, Stop and Abandon the fight are on the tournament strip.

While the tournament lasts, Seed, World, Save, Runs and the Player Bot aren't shown: they would change the fight. In their place, the bottom bar has 🏆 Tournament controls, which takes you to the strip. Speed, pause, view, color, zoom, Find the best and Snapshot work as always. The rest of the app does the same with everything that would replace the simulation (see Compete).

The tournament strip

The tournament goes on even if you go to another section. While it lasts, a strip below the top bar shows, on every screen, the tournament, the edition, how much of the season is left and what's happening: the break screen, LIVE, the winner. It has Watch, which brings you to Observe, When the fight ends and the same buttons to stop or abandon the fight. The Tournament controls buttons on other screens bring you here, and the strip lights up for a moment.

On a phone the strip takes a single line: When the fight ends and the buttons to stop or abandon open with Controls ▾ (in Observe, together with Break (s)), and Tournament controls opens them by itself. The controls are drawn over the field only in full screen, where the strip isn't shown; otherwise they would be repeated and cover the field. The floating scoreboard of the other sections doesn't show up either: Watch brings you to watch the fight.

If you reload the page with a tournament in progress, the fight that was being played is cut off and isn't recorded. The tournament doesn't resume on its own: the strip offers Resume, which goes on from the next fight, or Dismiss.

If something goes wrong

Notices appear over the bottom bar. The informational ones (run saved, run resumed, DNA words that aren't recognized) go away by themselves after a few seconds; errors stay until you close them with ✕. If the simulation engine doesn't load, check your connection and reload the page. If the browser runs out of space to save, delete old runs from Runs.