Ein Gehirn machen

Was ein Gehirn ist

Der eigene Computerspieler der Engine bleibt der Standard und bleibt in der Engine. Ein Gehirn spielt einen Computersitz, und nur einen Sitz, den ein Spieler auf dieses Gehirn gesetzt hat. Eine leere Gehirn-Kennung ist dieser eingebaute Spieler. Ein Sitz ohne Gehirn, ein Gehirn, das nicht passt, und ein Gehirn, das anhält, werden alle von demselben Spieler gespielt. Classic ist in Lua geschrieben und spielt so, wie dieser Spieler spielt. Es ist die Dokumentation dieses Spielers, kein Ersatz.

Nur die Maschine, die den Computerspieler einsetzt, führt das Skript aus, darum brauchen die anderen Spieler nichts installiert. Ihre Maschinen spiegeln die Einheiten des Sitzes. Eine abgespielte Aufnahme führt das Skript nicht aus. Ein Gehirn ist Lua-Quelltext und Daten. Es hat keinen nativen Code, keine Datei, kein Netz und keine Uhr. Volle Sicht ist ein Flag im Manifest. Ein Gehirn darf es setzen, darf damit in einem Netzwerkspiel spielen, und der Sitz zeigt das Flag.

Das Paket

Ein Gehirn ist eine .oabrain-Datei oder der Ordner, in den diese Datei entpackt wird. Das Manifest ist das strikte YAML, das ein Mod-Profil nutzt: ein Dokument, eine Abbildung auf oberster Ebene, keine Anker und keine Blockskalare. Oben im Paket liegt oabrain.yaml. Daneben ist eine Datei eine von diesen. Eine Datei außerhalb dieser Liste wird abgelehnt.

Der Vergleich ignoriert die Großschreibung von ASCII-Buchstaben, außer wo der Standard sagt, dass die Bytes übereinstimmen müssen. brain.lua liegt außerhalb, wenn entry eine andere Datei nennt. Eine Lua-Datei hat höchstens 1 MiB. Das Icon ist ein quadratisches PNG, jede Seite höchstens 256 Pixel, höchstens 256 KiB. OA installiert ein Gehirn nach Brains/ und die Kennung aus dem Manifest.

Das Manifest

Der Leser sammelt jede verletzte Regel und lässt das Manifest unverändert, wenn irgendeine Regel verletzt ist. Ein Schlüssel, den der Standard nicht aufführt, wird abgelehnt. Ein Profilschlüssel gehört in einen Mod. Ein Mutatorschlüssel wird als Schlüssel eines Mutators abgelehnt. Setze eine Version in Anführungszeichen, denn eine nackte 1.0 ist eine Zahl, und setze einen Stern in Anführungszeichen, denn ein nackter Stern ist ein YAML-Alias.

Die neun Tags

Ein Tag ist eines dieser neun, Byte für Byte verglichen. Mehr als vier, wenn die gemeinsame Tag-Regel schon bestanden hat, ist ein eigenes Problem. Ein Tag, das keines der neun ist, wird abgelehnt.

Stufen und Schwierigkeit

levels ist eine Liste von 1 bis 6 Abbildungen. Jede ist genau id, name und difficulty, alle Pflicht. id ist Kebab-Schreibweise in Kleinbuchstaben, 1 bis 32 Bytes lang, und keine id wird wiederholt. name ist 1 bis 64 Bytes, kein Steuerzeichen. difficulty ist easy, medium oder hard, Byte für Byte.

Diese drei Namen sind die Werte 0, 1 und 2. Ein Sitz, der die Stufe wählt, nutzt diesen Wert als seine Einkommensregeln, dieselbe Schwierigkeit, die das Spiel schon nutzt.

Volle Sicht

fullAwareness ist true oder false. Fehlt der Schlüssel, gilt false. Ein Gehirn mit dem Flag sieht Einheiten, die ein Sitz im Nebel nicht sehen würde, so wie der eingebaute Computerspieler, und seine site-Prüfungen brauchen keinen platzierenden Spieler. Das Flag ist in einem Netzwerkspiel erlaubt. Die Bibliothek zeigt Sieht jede Einheit auf der Karte, so wie der Computerspieler von Total Annihilation.. Das Flag ist das eigene des Manifests. Die Paketkennung verleiht es nicht, und es gehört nicht zu dem, was nur Classic bekommt.

Wo ein Gehirn läuft

Nur die Maschine, die den Computerspieler einsetzt, braucht das Paket, und nur diese Maschine führt das Skript aus. Ein Sitz ist ein Computerspieler dieser Maschine. Ein menschlicher Sitz wird abgelehnt. game.mode ist skirmish, campaign oder network.

Das Gehirn, das ein Sitz spielt, ist keine Eingabe des Simulationshashs. Zwei Matches, die sich nur darin unterscheiden, welches Gehirn eingesetzt ist, behalten denselben Hash des Matchzustands. Die ai.*-Regelwerte des Mods gehören zum Mod-Profil, das dieser Hash abdeckt, darum erreichen sie trotzdem jede Maschine.

Die Budgets der Laufzeit

Ein Gehirn läuft als Lua in einer Sandbox. Zwei Gehirne teilen keine Module, keine Globals und keine Budgets. Das Skript hat keine Datei, keine Uhr, keine Umgebung, keinen Prozess und kein Netz. Jeder Block wird als Text geladen. pcall und xpcall können eine aufgebrauchte Phase nicht am Leben halten. Ein Zug ist ein Aufruf aus der Bank, am Controller-Punkt des Sitzes, nach dem Durchlauf der Einheiten. Befehle, die ein Hook gibt, wirken im nächsten Tick.

Wenn ein Gehirn scheitert

Ein Gehirn stoppt bei einem Fehler in einem Hook oder einem Timer, einem aufgebrauchten Befehlskontingent, dem Echtzeit-Rückhalt, der Lua-Speichergrenze, einer Zeichenkette über 65.536 Bytes oder einem Ladevorgang, den der Sitz ablehnt. Ein gescheiterter Zug schließt die Sandbox und löscht die Hooks, bevor dieser Zug zurückkehrt. Der scheiternde Zug zählt trotzdem als gespielt. Der nächste Befehls-Tick hat keine Hooks, darum übernimmt ihn der eingebaute Computerspieler. Ein Gehirn, das abgelehnt wird, nicht startet oder nicht passt, hat nie Hooks, darum spielt dieser Spieler von Anfang an. Der Hinweis verwendet den Namen aus dem Manifest und den Grund, auf 160 Bytes gekürzt:

- `{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`

Wenn der Sitz keinen eigenen Grund hat, ist der Grund the brain could not be seated. Ein besiegter Spieler wird einfach nicht mehr aufgerufen. Die Sandbox schließt mit dem Match.