DarwinBotsManual
Open the app EspañolES

Your data

Where the app keeps your bots, runs, scenarios, tournaments and settings, how to export and import them again, how to delete them, and what makes you lose them.

The app has no accounts and no server: everything of yours is saved in your browser, on the computer you are using. That is convenient, because there is nothing to sign up for, but it has a consequence: if that browser loses its data, the app loses it too. This page explains what is saved, how to take a copy and how to bring it back.

What is saved and where

WhatWhere you create itDetail
Your own botsBots: library and profile, The DNA editorEach bot with all its versions.
MarksBots: library and profileFavorites, tags and notes, also on forum bots, and the named selections.
Your own scenariosExperimentThe ones you saved with Save as scenario.
Saved runsObserveThe world, its scenario, its seed, its events, the metrics history and the lineage. The last 20 are kept.
ReportsReportsThe reports you generated.
TournamentsCompeteRules, entrants with their DNA, seasons and all the matches.
JobsReportsReplicates, sweeps, tournament rounds and editor tests in the background, with their results.
Preferencesthe whole appTheme, language, basic or advanced mode, the workers cap, the tournaments' break screen and “When the fight ends” and other interface choices.
Editor draftsThe DNA editorThe unsaved changes of a DNA, so they survive a reload.

The forum bots (the Bestiary) are not yours: they come from the site and are loaded every time. The only thing of yours about them is your marks.

The policy for runs is this: when you save one, if there are more than 20, the oldest are deleted. If a run matters to you, download it (see below).

What it depends on

The browser stores data per site: what you saved on darwinbots-wasm.org is only seen by the app opened from that same address, in that same browser and with that same user profile. So:

The classic interface, at /classic/, is on the same site and saves in its own space. The app copies that data the first time it starts (see below).

Export: taking a copy

There is no button to back everything up at once: each thing is exported from its own screen.

WhatHowFile
Your own bots and marksIn Bots, the ⋯ button → Export my bots and marks (.json).json with all your bots (with their versions), favorites, tags, notes and selections
A scenarioIn Experiment, with the scenario open, Export.json of the scenario you are editing
A runIn Observe, Save → Download .dbsim.dbsim with the world at that cycle
A reportIn Analyze → Reports, Download .htmlself-contained .html, opens offline
A tournamentIn Compete, with the tournament open, Export.json with rules, entrants and matches

A few things worth knowing:

Formats of each file: File formats.

Import: bringing a copy back

  1. Open the app in the browser where you want the data.
  2. Import each file from its own screen:
    • Bots: ⋯ → Import library (.json)…. It adds without deleting: new bots are added, those already there receive the new versions, and a name that clashes is changed. It also accepts the inventory exported from the classic interface. Details in Bots: library and profile.
    • Scenarios: Experiment → Import .json. If you already have one with the same identifier, the imported one comes in as a new scenario, without overwriting yours.
    • Runs: Import .dbsim in Home, or Runs → Open a .dbsim file… in Observe. The world is loaded; for it to be in the list, save it with Save.
    • Tournaments: Compete → Import .json. It comes in as a new tournament, with “(imported)” if the name already existed.
  3. Read the notice each import leaves: it says what came in, what was already there and what could not be read.

The classic interface's data

The first time you open the app, it copies what you have in the classic interface in the same browser: the inventory (favorites, tags, notes and selections), the lab hybrids, which become your own bots, and the tournaments. The classic interface is not touched: it keeps its data, and what you do in one does not show up in the other.

If you kept using the classic interface afterwards, Import from the classic interface (in Bots, the ⋯ button) copies the inventory and the hybrids again, without duplicating what was already there. New tournaments from the classic interface are brought over by exporting them there (⬇) and importing them in Compete.

The Hall of Fame of the classic interface's old F1 channel has no match history and cannot be added to a tournament. If the app finds it, it offers to Download it as a file or Discard it.

Delete

Each thing is deleted from its own screen and the app asks for confirmation:

None of these actions can be undone. To start over completely, clear the site's data from your browser's settings; first, export whatever you want to keep.

When something fails