Crear un cerebro

Qué es un cerebro

El jugador de ordenador del propio motor sigue por defecto y sigue en el motor. Un cerebro juega un asiento de ordenador, y solo un asiento que un jugador le asignó. Un identificador de cerebro vacío es ese jugador de ordenador integrado. Un asiento sin cerebro, un cerebro que no encaja y un cerebro que se detiene los juega todos ese mismo jugador. Classic está escrito en Lua y juega como lo hace ese jugador. Es la documentación de ese jugador, no un sustituto.

Solo la máquina que sienta al jugador de ordenador ejecuta el script, así que los demás jugadores no necesitan tener nada instalado. Sus máquinas reflejan las unidades del asiento. Una grabación reproducida no ejecuta el script. Un cerebro es fuente Lua y datos. No tiene código nativo, ni archivo, ni red, ni reloj. La visión total es una bandera del manifiesto. Un cerebro puede ponerla, puede jugar con ella en una partida en red, y el asiento muestra la bandera.

El paquete

Un cerebro es un archivo .oabrain, o la carpeta a la que se descomprime ese archivo. El manifiesto es el YAML estricto que usa un perfil de mod: un documento, un mapeo de nivel superior, sin anclas ni escalares de bloque. En la raíz del paquete está oabrain.yaml. A su lado, un archivo es uno de estos. Un archivo fuera de esa lista se rechaza.

La comparación no distingue mayúsculas de minúsculas en las letras ASCII, salvo donde el estándar dice que los bytes tienen que coincidir. brain.lua queda fuera cuando entry nombra otro archivo. Un archivo Lua es como mucho 1 MiB. El icono es un PNG cuadrado, cada lado como mucho 256 píxeles, como mucho 256 KiB. OA instala un cerebro en Brains/ y el identificador del manifiesto.

El manifiesto

El lector reúne cada regla rota y deja el manifiesto sin cambios cuando se rompe alguna. Una clave que el estándar no lista se rechaza. Una clave de perfil pertenece a un mod. Una clave de mutador se rechaza como clave de mutador. Entrecomilla una versión, porque un 1.0 suelto es un número, y entrecomilla una estrella, porque una estrella suelta es un alias de YAML.

Las nueve etiquetas

Una etiqueta es una de estas nueve, comparada byte a byte. Más de cuatro, cuando la regla compartida de etiquetas ya ha pasado, es un problema propio. Una etiqueta que no es una de las nueve se rechaza.

Niveles y dificultad

levels es una lista de 1 a 6 mapeos. Cada uno es exactamente id, name y difficulty, todos obligatorios. id es kebab-case en minúsculas, de 1 a 32 bytes, y ningún id se repite. name es de 1 a 64 bytes, sin carácter de control. difficulty es easy, medium o hard, byte a byte.

Esos tres nombres son los valores 0, 1 y 2. Un asiento que elige el nivel usa ese valor como sus reglas de ingresos, la misma dificultad que el juego ya usa.

Visión total

fullAwareness es true o false. Si falta, es false. Un cerebro con la bandera ve unidades que un asiento en la niebla no vería, como lo hace el jugador de ordenador integrado, y sus comprobaciones de sitio no necesitan un jugador que coloca. La bandera se permite en una partida en red. La Biblioteca muestra Ve todas las unidades del mapa, como el jugador de ordenador de Total Annihilation. La bandera es la del propio manifiesto. No la concede el identificador del paquete, y no es una de las cosas que solo se dan a Classic.

Dónde corre un cerebro

Solo la máquina que sienta al jugador de ordenador necesita el paquete, y solo esa máquina ejecuta el script. Un asiento es un jugador de ordenador de esta máquina. Un asiento humano se rechaza. game.mode es skirmish, campaign o network.

El cerebro que juega un asiento no es una entrada del hash de la simulación. Dos partidas que solo difieren en qué cerebro está sentado conservan el mismo hash del estado de la partida. Los valores hack ai.* del mod forman parte del perfil de mod que cubre ese hash, así que siguen llegando a cada máquina.

Las asignaciones de la ejecución

Un cerebro corre como Lua en un aislamiento. Dos cerebros no comparten módulos, ni globales, ni asignaciones. El script no tiene archivo, ni reloj, ni entorno, ni proceso, ni red. Cada fragmento se carga como texto. pcall y xpcall no pueden mantener viva una fase agotada. Un turno es una llamada con cargo al banco, en el punto del controlador del asiento, tras el barrido de unidades. Las órdenes que da un hook tienen efecto en el siguiente tick.

Cuando un cerebro falla

Un cerebro se detiene por un error en un hook o en un temporizador, una asignación de instrucciones agotada, el respaldo de tiempo real, el tope de memoria de Lua, una cadena de más de 65.536 bytes, o una carga que el asiento rechaza. Un turno fallido cierra el aislamiento y quita los hooks antes de que ese turno vuelva. El turno que falla cuenta igual como jugado. El siguiente tick de órdenes no tiene hooks, así que lo toma el jugador de ordenador integrado. Un cerebro que se rechaza, que no arranca o que no encaja nunca tiene hooks, así que ese jugador juega desde el principio. El aviso usa el nombre del manifiesto y el motivo, cortado a 160 bytes:

- `{brain} stopped ({reason}); the engine plays this seat on`
- `{brain} could not start ({reason}); the engine plays this seat`
- `{brain} does not fit this game ({reason}); the engine plays this seat`

Cuando el asiento no tiene un motivo propio, el motivo es the brain could not be seated. A un jugador derrotado simplemente ya no se le llama. El aislamiento se cierra con la partida.