Aufbau eines Kartenpakets
Das .oamap-Zip, sein Manifest oamap.yaml, der Kartenindex, den der Packer schreibt, und wie Größe und Elemente einer Karte entscheiden, ob sie zu einem Spiel passt.
Das Paket
Eine .oamap ist ein Zip des Paketordners mit oamap.yaml obenauf oder in dem einen Ordner, den die Wurzel enthält (so packt der Finder-Befehl „Komprimieren“). Die Archivregeln sind die des Mod-Pakets: gespeicherte oder deflate-komprimierte Einträge; keine Links, Gerätenamen, absoluten Pfade oder ..; keine zwei Namen, die sich nur in der Schreibung unterscheiden; höchstens 4 GiB entpackt.
my-maps.oamapdie Datei, die ein Spieler lädt oder öffnet├─ oamap.yamlerforderlich das Manifest: Kennung, Name, Version, Autor, Paketierung und der Kartenindex├─ Ridge.tnt · Ridge.otaeine Karte: ihr Gelände (.tnt) und ihre Einstellungen (.ota)├─ Long Lakes.tnt · Long Lakes.otaeine weitere; ein Paket enthält 1 bis 256 Karten└─ READMEalles Übrige wird mitgenommen und ignoriertDas Manifest
Striktes YAML: ein Dokument, eine Tabelle auf oberster Ebene, keine Anker, keine Blockskalare. Die Kennung ist kebab-case in Kleinbuchstaben, 1 bis 32 Bytes, und benennt den Installationsordner des Pakets. Ein Schlüssel, den der Standard nicht kennt, wird abgelehnt.
oamap: 1 id: my-maps # kebab-case, 1 bis 32 Bytes; der Name des Installationsordners name: My Maps version: "1.0" # freier Text, nie sortiert description: Two maps for four and ten players author: {name: A. Mapper} packaging: {revision: 1, date: 2026-10-18, packager: A. Mapper} requires: {engine: ">= 0.8.0"} # setze den Engine-Bereich in Anführungszeichen: ein nacktes > beginnt einen Blockskalar und wird abgelehnt # maps: schreibt oa-tool pack für dich (der Index unten)
Der Index
oa-tool pack schreibt für jede Karte im Ordner mit Network-Schema einen maps-Eintrag, in Byte-Reihenfolge ihres Pfads. Ein Ordner kann die Einträge selbst auflisten, um Name, Beschreibung oder Spielerzahl einer Karte zu setzen; der Rest wird immer berechnet.
| Schlüssel | Regel |
|---|---|
stem | Der Dateistamm der Karte; einer, den der Ordner nicht enthält, ist ein Fehler. |
name, description | Von der Liste des Ordners gesetzt oder aus der Karte genommen; dieselben Regeln wie ein gepackter Eintrag. |
players | Die Spielerzahl, für die die Karte gemacht ist, 2 bis 10. |
size, preview, files | Immer vom Packer berechnet, auch wenn der Ordner sie setzt. |
Wann eine Karte passt
Eine Karte passt zu einem Spiel, wenn das Spiel das Tileset, die Elemente und die Einheiten hat, die sie nennt. Die Inhaltsbibliothek prüft jedes Paket gegen das Grundspiel und jeden Mod und hält die Urteile fest; daher kommen die Zahl „läuft auf“ einer Mod-Seite und die Mod-Liste einer Karte.
Ein Paket, das eine Erweiterung braucht, sagt es in requiredExpansions; eine Karte, die zum Grundspiel allein nicht passt, bleibt gelistet, und das Spiel sagt, warum sie nicht lädt.
Wohin es installiert wird
Nach Dokumente/Open Annihilation/Maps/