Anatomia de um pacote de mapas
O zip .oamap, o seu manifesto oamap.yaml, o índice de mapas que o empacotador escreve, e como o tamanho e os elementos de um mapa decidem se é compatível com uma partida.
O pacote
Um .oamap é um zip da pasta do pacote, com o oamap.yaml no topo ou na única pasta que o topo contém (a opção Comprimir do Finder cria um ficheiro assim). As regras do arquivo são as do pacote de mod: entradas armazenadas ou comprimidas com deflate, sem ligações, nomes de dispositivos, caminhos absolutos nem .., sem dois nomes que difiram apenas em maiúsculas e minúsculas, e no máximo 4 GiB descompactado.
my-maps.oamapo ficheiro que um jogador transfere ou abre├─ oamap.yamlobrigatório o manifesto: id, nome, versão, autor, empacotamento e o índice de mapas├─ Ridge.tnt · Ridge.otaum mapa: o seu terreno (.tnt) e as suas definições (.ota)├─ Long Lakes.tnt · Long Lakes.otaoutro; um pacote contém de 1 a 256 mapas└─ READMEtudo o resto é transportado e ignoradoO manifesto
YAML estrito: um documento, um único mapeamento de nível superior, sem âncoras nem escalares de bloco. O id está em kebab-case minúsculo, tem de 1 a 32 bytes e é a pasta onde o pacote se instala. Uma chave que a norma não lista é recusada.
oamap: 1 id: my-maps # kebab-case, de 1 a 32 bytes; o nome da pasta de instalação name: My Maps version: "1.0" # texto livre, nunca ordenado 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"} # ponha o intervalo do motor entre aspas: um > sem aspas inicia um escalar de bloco, que é recusado # maps: é escrito automaticamente pelo oa-tool pack (o índice abaixo)
O índice
O oa-tool pack escreve uma entrada maps para cada mapa da pasta que tenha um esquema Network, pela ordem dos bytes do seu caminho. Uma pasta pode listar ela própria as entradas, para definir o nome, a descrição ou o número de jogadores de um mapa. O resto é sempre calculado.
| Chave | Regra |
|---|---|
stem | O nome do ficheiro do mapa, sem extensão. Um que a pasta não contenha é um erro. |
name, description | Definido pela lista da pasta ou retirado do mapa, com as mesmas regras de uma entrada empacotada. |
players | O número de jogadores para que o mapa foi feito, de 2 a 10. |
size, preview, files | Sempre calculados pelo empacotador, mesmo quando a pasta os define. |
Compatibilidade de um mapa
Um mapa é compatível com uma partida quando o jogo tem o tileset, os elementos e as unidades que o mapa indica. A biblioteca de conteúdos verifica cada pacote com o jogo base e com cada mod e regista os veredictos: é daí que vêm a contagem “Joga-se em” da página de um mod e a lista de mods de um mapa.
Um pacote que precisa de uma expansão indica-o em requiredExpansions. Um mapa que não seja compatível só com o jogo base continua listado, e o jogo explica por que razão não o carrega.
Onde se instala
Em Documentos/Open Annihilation/Maps/