DarwinBotsManual
Open the app EspañolES

Bots: library and profile

The Bots section: the library with the forum bots and your own, how to search, mark and seed them, and each bot's profile with its summary, its DNA and its history.

The Bots section of the top bar is your collection of bots. On the left is the Library, with all the bots you can use; on the right, the profile of the bot you picked. From here you create new bots, copy forum bots to modify them, seed them into a simulation and enter them in tournaments.

If you haven't picked one yet, the right side invites you to: “Pick a bot from the library to see its summary, its DNA and where it took part”.

Two kinds of bots

The library gathers two kinds of bots:

From the forum (the Bestiary)Your own
Where they come fromThe 684 bots published on the DarwinBots forum and wiki, which come with the appThe ones you create, duplicate or import
Can be editedNo: they are read onlyYes, and each saved change is a new version
The list showsThe source forum and the genes (F1 bots · 6 genes)mine, the version and the genes (mine · v3 · 4 genes)
Capability profileYes, computed in advanceNo
Where they are storedThey come with the appIn this browser

To change a forum bot you have to duplicate it: the copy is yours and you can edit it without touching the original (see Duplicate).

Your own bots and everything you mark (favorites, tags, notes, selections) are stored in this browser. To move them to another computer or to have a backup, export them (see Import and export and Your data).

Search and filter

Above the list you have, from top to bottom:

Inside Filters:

ControlWhat it does
ForumOnly the bots of one forum (F1 bots, Veggies, Multi-Bots…).
ArchetypeMulticellular, vegetable, predator, defensive or passive.
SizeSmall (up to 5 genes), medium (6 to 20), large (21 to 60) or huge (more than 60).
TagOne of your tags, or “(no tags)”.
Sort byBy name, by number of genes or by number of capabilities.
Picked onlyLeaves in the list only the bots you marked.
CapabilitiesOne chip per capability, with how many bots have it.

Capability chips have three states. One click requires it (a + appears: only the bots that have it remain), another excludes it (a −: the ones that don't have it remain) and a third takes it out of the filter. That way you can ask, for example, for bots that reproduce sexually and don't use venom.

Clear filters puts everything back to zero.

At the bottom of the list you see how many bots remain (“120 of 684 bots”) and how many you have picked.

Some forum files have exactly the same DNA. When that happens, the footer shows an ⓘ that explains it: those files share favorite, tags and notes, and are picked together.

Favorites, tags and notes

There are three ways to mark a bot, so you can find it later. They work the same for forum bots and for yours:

Picking several bots

Each row has a checkbox. The picked bots can be marked, seeded or saved together with the buttons at the bottom of the library:

ButtonWhat it does
Pick visiblePicks all the ones the current filter lets you see.
NoneUnpicks everything.
★Marks the picked bots as favorites.
+ tag and − tagAdd to or remove from all the picked bots the tag you type in the Tag… field.
Seed batchOpens the seeding dialog with all the picked ones (see Seed).
Save selectionSaves the picked ones under a name.

Saved selections appear at the top, next to Selections:, with their name and how many bots they have. A click on one picks those bots again; the × deletes it (the bots are not touched). If you save one under a name that already exists, the app asks whether you want to replace it.

Selections are useful for putting together the lineup of an experiment or a tournament and coming back to it with one click.

A bot's profile

When you pick a bot in the list, its profile opens. At the top are the name and a line of data: whether it is your own and where it came from (“copy of…”, “imported”), the forum, whether it is a vegetable, the archetype, the number of genes and instructions, the version and, for forum bots, a link to the forum topic where it was published.

Next to it, the profile's buttons:

ButtonWhat it does
SeedPuts it into a simulation (see Seed).
Duplicate (or Duplicate to edit, for forum bots)Creates a copy of your own.
Enter in a tournamentEnters it in the quick match or in a tournament (see below).
DetailsOnly on your own: changes the name, whether it is a vegetable and the description.
DeleteOnly on your own: deletes it with all its versions, after asking you. It can't be undone.
☆Favorite.

Underneath there are three tabs: Summary, DNA and History. The ? next to them opens in the manual the page for the tab you are looking at (Bots: library and profile or the editor).

Summary

The summary tells you what the bot is without having to read the DNA:

DNA

The DNA tab is the editor: the bot's text with colors, the warnings about what the engine will read differently than it looks, the gene-by-gene view, the panel to Test the bot, Evolve to take variants from it (only on your own bots) and the Lab to add genes from the Bestiary to it. All of that is in The DNA editor.

On forum bots the text can be read and tested, but not modified.

History

The history gathers everything you did with the bot in this browser, in three tables:

The bot is recognized by its DNA hash, that of any of its versions. If you seeded the same DNA in a run under another name, it shows up too.

Creating a new bot

  1. In the library, click + New bot.
  2. Type the Name. Check It is a vegetable (photosynthesizes) if it is going to live off light (see Chloroplasts and vegetables).
  3. If you want, type a Description.
  4. DNA comes with an empty gene. You can leave it like that or paste a whole DNA, for example the one from a .txt you have.
  5. Click Create. The app opens the bot in the DNA tab, ready to edit.

The empty gene it starts with is this one:

cond
start
stop
end

There can't be two of your own bots with the same name. If you pick the name of a forum bot, the app warns you that in scenarios and runs the two will be told apart only by their source, and lets you use it anyway with Use that name anyway.

The Open in the app button on the DNA blocks of this manual uses the same dialog: it opens the app at the address #/bots/nuevo?adn=… with that DNA already loaded, and you only pick the name.

Duplicate

Duplicate creates a copy of your own of the bot, with the same DNA. It is the way to modify a forum bot and also to try a variant of one of yours without touching the original.

  1. In the profile, click Duplicate (on forum bots it says Duplicate to edit).
  2. Type the Name of the copy, or leave it empty: the app uses the same name with a number.
  3. Click Duplicate. The copy opens in the DNA tab.

The copy remembers where it came from: in its profile it says “copy of” and the name of the original.

Seed

Seed (in the profile) and Seed batch (with several picked) open the same dialog. First you define how each species enters:

More than 500 bots per species is a lot and the app warns you, but it seeds them anyway.

Then you pick where they go:

OptionWhat it does
Seed into the current runAdds the species to the world that is running in Observe. Each seeding is recorded as an event of the run. If none is open, the button is off and Go to Observe appears.
New scenario with theseCreates a scenario of your own with those species in the default world, with the Scenario name you choose, and opens it in Experiment. From there you can adjust it and launch it.

The scenario stays saved among your scenarios (see Scenarios), so you can repeat the experiment whenever you want.

Entering a tournament

Enter in a tournament opens a list with the quick match and your tournaments, each with its season and how many entrants it has. You pick one and click Enter; the app opens that tournament in Compete. With a tournament in progress, that one isn't on the list and the app enters the bot in the chosen one without opening it (see Compete).

Two things to keep in mind:

If the tournament has a round running, or its format no longer accepts new entrants, the app doesn't enter it and tells you why.

Import and export

The ⋯ button, next to + New bot, has three actions:

The hybrids you built in the classic interface's lab arrive as your own bots, and their profile says “lab hybrid”. In this app the lab is part of the editor (see The DNA editor).

For single-bot .txt files (see The .txt format):

If something fails