Criar um cérebro

O que é um cérebro

O computador do próprio motor continua a ser a predefinição e continua no motor. Um cérebro joga num lugar de computador, e só num lugar em que um jogador o tenha colocado. Um id de cérebro vazio é esse jogador integrado. Um lugar sem cérebro, um cérebro incompatível e um cérebro que para são todos jogados por esse mesmo jogador. O Classic está escrito em Lua e joga como esse jogador. É documentação desse jogador, não um substituto.

Só a máquina que coloca o computador no lugar corre o script, por isso os outros jogadores não precisam de ter nada instalado. As máquinas deles espelham as unidades do lugar. Uma gravação reproduzida não corre o script. Um cérebro é código-fonte Lua e dados. Não tem código nativo, ficheiros, rede nem relógio. A visão total é uma marca no manifesto. Um cérebro pode defini-la e pode jogar com ela numa partida em rede, e o lugar mostra a marca.

O pacote

Um cérebro é um ficheiro .oabrain, ou a pasta para onde esse ficheiro se descompacta. O manifesto usa o YAML estrito de um perfil de mod: um documento, um único mapeamento de nível superior, sem âncoras nem escalares de bloco. O topo do pacote contém o oabrain.yaml. Ao lado dele, cada ficheiro é um dos seguintes. Um ficheiro fora desta lista é recusado.

A comparação ignora maiúsculas e minúsculas nas letras ASCII, exceto onde a norma diz que os bytes têm de coincidir. brain.lua fica fora da lista quando entry indica outro ficheiro. Um ficheiro Lua tem no máximo 1 MiB. O ícone é um PNG quadrado, com no máximo 256 píxeis de lado e 256 KiB. O OA instala um cérebro em Brains/ com o id do manifesto.

O manifesto

O leitor recolhe todas as regras infringidas e deixa o manifesto inalterado quando alguma regra é infringida. Uma chave que a norma não lista é recusada. Uma chave de perfil pertence a um mod. Uma chave de mutador é recusada como chave de mutador. Ponha uma versão entre aspas, porque um 1.0 simples é um número, e ponha um asterisco entre aspas, porque um asterisco simples é um alias de YAML.

As nove etiquetas

Uma etiqueta é uma destas nove, comparada byte a byte. Mais de quatro, quando a regra comum das etiquetas já foi cumprida, é um problema à parte. Uma etiqueta que não seja uma das nove é recusada.

Níveis e dificuldade

levels é uma lista de 1 a 6 mapeamentos. Cada um tem exatamente id, name e difficulty, todos obrigatórios. id está em kebab-case minúsculo, de 1 a 32 bytes, e nenhum id se repete. name tem de 1 a 64 bytes, sem caracteres de controlo. difficulty é easy, medium ou hard, byte a byte.

Esses três nomes correspondem aos valores 0, 1 e 2. Um lugar que escolha o nível usa esse valor como regras de rendimento, a mesma dificuldade que o jogo já usa.

Visão total

fullAwareness é true ou false. Se faltar, é false. Um cérebro com a marca vê unidades que um lugar no nevoeiro não veria, tal como o computador integrado, e as suas verificações de local não precisam de um jogador que coloque. A marca é permitida numa partida em rede. A Biblioteca mostra Vê todas as unidades do mapa, como o computador do próprio Total Annihilation. A marca pertence ao próprio manifesto. Não é concedida pelo id do pacote, nem é uma das coisas que só o Classic recebe.

Onde um cérebro corre

Só a máquina que coloca o computador no lugar precisa do pacote, e só essa máquina corre o script. Um lugar é um computador desta máquina. Um lugar humano é recusado. game.mode é skirmish, campaign ou network.

O cérebro que um lugar joga não entra no hash da simulação. Duas partidas que só difiram no cérebro colocado mantêm o mesmo hash do estado da partida. Os valores dos ajustes ai.* do mod fazem parte do perfil do mod que esse hash abrange, por isso continuam a chegar a todas as máquinas.

As quotas do runtime

Um cérebro corre como Lua numa sandbox. Dois cérebros não partilham módulos, variáveis globais nem quotas. O script não tem ficheiros, relógio, ambiente, processo nem rede. Todos os chunks são carregados como texto. pcall e xpcall não conseguem manter viva uma fase esgotada. Um turno é uma chamada que gasta do saldo acumulado, no ponto de controlo do lugar, depois da varredura de unidades. As ordens que um hook dá produzem efeito no tick seguinte.

Quando um cérebro falha

Um cérebro para por um erro num hook ou num temporizador, por esgotar a quota de instruções, pelo limite de segurança de tempo real, pelo limite de memória do Lua, por uma cadeia de texto com mais de 65 536 bytes ou por um carregamento que o lugar recusa. Um turno falhado fecha a sandbox e limpa os hooks antes de esse turno terminar. O turno que falhou conta na mesma como jogado. O tick de ordens seguinte já não tem hooks, por isso é o computador integrado que o joga. Um cérebro que é recusado, que não consegue arrancar ou que é incompatível nunca tem hooks, por isso esse jogador joga desde o início. O aviso usa o nome do manifesto e o 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`

Quando o lugar não tem um motivo próprio, o motivo é the brain could not be seated. Um jogador derrotado deixa simplesmente de ser chamado. A sandbox fecha-se com a partida.