El formato .txt

Cómo es por dentro el archivo .txt de un bot: líneas, comentarios, la cabecera '#, la codificación y qué cambia cuando el motor lo exporta.

Todos los bots se guardan como archivos de texto con extensión .txt: los del Bestiario, los que escribís vos y los que la app exporta desde una simulación. Esta página cuenta cómo lee ese archivo el cargador, línea por línea, y qué escribe el motor cuando lo saca de vuelta. La forma del ADN en sí (genes, tokens, def) está en La estructura de un bot; los otros formatos de la app, como las simulaciones guardadas, en Formatos de archivo.

Líneas

El cargador lee el archivo de a una línea por vez:

• Acepta fin de línea Windows (CR+LF) y Unix (LF solo), y mezclados. Un CR suelto, como en los archivos de los Mac viejos, no corta la línea: el archivo entero queda como una sola línea y el bot no hace nada.
• Los tabuladores valen como espacios, y los espacios de los bordes no importan. Podés sangrar el código como quieras.
• Una línea vacía se ignora.

Dentro de una línea, las palabras se separan por uno o más espacios. Los saltos de línea no tienen otro significado: dónde cortes el código es cosa tuya.

Lo que el cargador ignora

Ojo con dos detalles. La barra solo comenta al principio de la línea: un // en el medio son palabras que valen 0. Y toda línea que empiece con las letras def se toma como un def, aunque la palabra sea otra: defensa 50 define una variable llamada nsa.

Codificación

La app lee el archivo como texto UTF-8. En los comentarios podés escribir lo que quieras, con acentos y eñes. En el código, en cambio, solo cuentan los caracteres comunes del teclado inglés: una palabra con un carácter raro (un acento, un espacio duro copiado de una página web, un carácter invisible) no se reconoce y vale 0. Por ejemplo, un stop con un espacio duro en el medio deja de cerrar el gen. El El editor de ADN te avisa cuando encuentra una palabra así.

La cabecera '#

Las líneas que empiezan con '# (o con /#) llevan datos sobre el bot, con la forma '#nombre: valor. El cargador entiende cuatro:

Cualquier otra línea '#, o una con un valor que no se entiende, se ignora sin rechazar el bot. En la etiqueta, las letras fuera del inglés básico se vuelven signos de pregunta: '#tag: Acción queda como Acci??n.

El '#hash es un control contra la edición a mano. El motor lo calcula sobre todo el texto que viene antes, y al cargar lo vuelve a calcular. Si no coincide, la generación y las mutaciones vuelven a 0; el ADN carga igual. Por eso, si tocás algo de un archivo exportado (el código, la generación, o incluso si agregás un comentario arriba), el bot pierde su historia y vuelve a la generación 0. Cambiar los fines de línea de CR+LF a LF no la rompe. Un archivo sin '#hash conserva lo que diga su cabecera.

Cómo exporta el motor un bot

En la app, el texto de un bot vivo está en la pestaña ADN del El inspector, con el botón Copiar. Ese texto no es el archivo original: el motor lo reconstruye a partir de los tokens, igual que el DarwinBots original al guardar un bot. Si el bot mutó desde que lo abriste, Releer trae la versión actual.

Con este bot de partida:

'#generation: 7
'#mutations: 3
' Gira 10 por ciclo durante 5 ciclos
def pasos 50

cond
  *.pasos 5 <
start
  .aim * 10 add .setaim store
  .pasos inc   ' suma 1 a la dirección 50
stop

lo que exporta el motor es esto (las líneas de comillas son comentarios de gen que agrega él):

'#generation: 7
'#mutations: 3

 cond
 *50 5 <
 start
 18 * 10 add .setaim store
 50 inc
 stop
''''''''''''''''''''''''  Gene:  1 Ends at position  14  '''''''''''''''''''''''

'#hash: …

Comparalos y vas a ver todo lo que cambia:

• Los comentarios desaparecen. Los tuyos no se guardan en el ADN.
• Los def desaparecen y en su lugar quedan los números: *.pasos sale como *50.
• Las sysvars recuperan su nombre solo en dos lugares: después de un * (*.nrg) y justo antes de un store u otra palabra que escribe en memoria (.setaim store). En cualquier otro lugar sale el número: .aim quedó como 18.
• El formato es siempre el mismo: un espacio al principio de cada línea y un salto después de cada condición, cada operador lógico, cada escritura y cada marca de flujo.
• Se agregan comentarios de gen con la posición donde empieza y termina cada uno (las posiciones cuentan tokens, desde 1).
• Se agrega la cabecera: '#generation, '#mutations (las del bot más las que traía), una línea en blanco y el '#hash; y '#tag si el bot tiene etiqueta.

Volver a cargar ese texto da el mismo bot, con la misma generación. La única excepción viene de las Mutaciones: pueden dejar tokens que no tienen forma escrita, y el motor los exporta como VOID, una palabra que al recargar vale 0. Un ADN así no vuelve idéntico.

Tus bots, el Bestiario y los archivos

• Para traer un .txt a una simulación, en Inicio usá «Desde un archivo»: siembra el bot en un mundo con algas.
• Tus bots viven en la biblioteca de la app (Bots: biblioteca y ficha). El editor guarda el texto tal como lo escribiste, con comentarios y def, y cada versión por separado; la reconstrucción del motor es solo lo que copiás desde el inspector.
• Los bots del Bestiario son archivos publicados en el foro y el wiki de DarwinBots. Por eso algunos tienen comentarios de gen y una cabecera con '#hash: son bots que alguien exportó de una simulación.
• Para respaldar tu biblioteca entera, la app la exporta como un archivo .json (ver Tus datos).