Anatomia di un pacchetto di mappe
Lo zip .oamap, il suo manifesto oamap.yaml, l'indice delle mappe scritto dal pacchettizzatore, e come dimensione ed elementi di una mappa decidono se si adatta a un gioco.
Il pacchetto
Un .oamap è uno zip della cartella del pacchetto, con oamap.yaml in cima o nell'unica cartella contenuta nella radice (così fa Comprimi nel Finder). Le regole dell'archivio sono quelle del pacchetto mod: voci memorizzate o compresse; niente link, nomi di dispositivo, percorsi assoluti o ..; niente nomi che differiscono solo per maiuscole; al massimo 4 GiB decompressi.
my-maps.oamapil file che un giocatore scarica o apre├─ oamap.yamlobbligatorio il manifesto: identificativo, nome, versione, autore, pacchettizzazione e l'indice delle mappe├─ Ridge.tnt · Ridge.otauna mappa: il suo terreno (.tnt) e le sue impostazioni (.ota)├─ Long Lakes.tnt · Long Lakes.otaun'altra; un pacchetto contiene da 1 a 256 mappe└─ READMEtutto il resto viene portato dentro e ignoratoIl manifesto
YAML rigoroso: un documento, una mappa di primo livello, niente ancore né scalari a blocco. L'identificativo è kebab-case minuscolo, da 1 a 32 byte, e dà il nome alla cartella di installazione del pacchetto. Una chiave che lo standard non elenca viene rifiutata.
oamap: 1 id: my-maps # kebab-case, da 1 a 32 byte; il nome della cartella di installazione name: My Maps version: "1.0" # testo libero, mai ordinato 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"} # metti l'intervallo del motore tra virgolette: un > nudo apre uno scalare a blocco, rifiutato # maps: lo scrive oa-tool pack per te (l'indice qui sotto)
L'indice
oa-tool pack scrive una voce maps per ogni mappa della cartella con uno schema Network, in ordine di byte del percorso. Una cartella può elencare le voci da sé per impostare nome, descrizione o numero di giocatori di una mappa; il resto viene sempre calcolato.
| Chiave | Regola |
|---|---|
stem | La radice del file della mappa; una che la cartella non contiene è un errore. |
name, description | Impostati dall'elenco della cartella o presi dalla mappa; le stesse regole di una voce pacchettizzata. |
players | Il numero di giocatori per cui la mappa è fatta, da 2 a 10. |
size, preview, files | Sempre calcolati dal pacchettizzatore, anche se la cartella li imposta. |
Quando una mappa si adatta
Una mappa si adatta a un gioco quando il gioco ha il tileset, gli elementi e le unità che nomina. La libreria dei contenuti controlla ogni pacchetto contro il gioco base e ogni mod e registra i verdetti; da lì vengono il conteggio «funziona su» di una mod e l'elenco delle mod di una mappa.
Un pacchetto che richiede un'espansione lo dice in requiredExpansions; una mappa che non si adatta al solo gioco base resta elencata, e il gioco dice perché non si caricherà.
Dove si installa
In Documenti/Open Annihilation/Maps/