Anatomía de un paquete de mapas
El zip .oamap, su manifiesto oamap.yaml, el índice de mapas que escribe el empaquetador, y cómo el tamaño y los elementos de un mapa deciden si encaja en un juego.
El paquete
Un .oamap es un zip de la carpeta del paquete, con oamap.yaml en la raíz o en la única carpeta que contiene la raíz (así lo hace Comprimir en el Finder). Las reglas del archivo son las del paquete de mod: entradas almacenadas o comprimidas; sin enlaces, nombres de dispositivo, rutas absolutas ni ..; sin dos nombres que solo difieran en mayúsculas; como mucho 4 GiB descomprimidos.
my-maps.oamapel archivo que un jugador descarga o abre├─ oamap.yamlobligatorio el manifiesto: identificador, nombre, versión, autor, empaquetado y el índice de mapas├─ Ridge.tnt · Ridge.otaun mapa: su terreno (.tnt) y sus ajustes (.ota)├─ Long Lakes.tnt · Long Lakes.otaotro; un paquete contiene de 1 a 256 mapas└─ READMEtodo lo demás viaja dentro y se ignoraEl manifiesto
YAML estricto: un documento, un mapa de nivel superior, sin anclas ni escalares de bloque. El identificador es kebab-case en minúsculas, de 1 a 32 bytes, y nombra la carpeta donde se instala el paquete. Una clave que el estándar no lista se rechaza.
oamap: 1 id: my-maps # kebab-case, de 1 a 32 bytes; el nombre de la carpeta de instalación name: My Maps version: "1.0" # texto libre, 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"} # entrecomilla el rango de motor: un > sin comillas abre un escalar de bloque, que se rechaza # maps: lo escribe oa-tool pack por ti (el índice de abajo)
El índice
oa-tool pack escribe una entrada maps por cada mapa de la carpeta que tenga esquema Network, en orden de bytes de su ruta. Una carpeta puede listar las entradas para fijar el nombre, la descripción o el número de jugadores de un mapa; el resto siempre se calcula.
| Clave | Regla |
|---|---|
stem | La raíz del archivo del mapa; una que la carpeta no contenga es un error. |
name, description | Fijados por la lista de la carpeta o tomados del mapa; las mismas reglas que una entrada empaquetada. |
players | El número de jugadores para el que está hecho el mapa, de 2 a 10. |
size, preview, files | Siempre los calcula el empaquetador, aunque la carpeta los fije. |
Cuándo encaja un mapa
Un mapa encaja en un juego cuando el juego tiene el conjunto de teselas, los elementos y las unidades que nombra. La biblioteca de contenido comprueba cada paquete contra el juego base y cada mod y guarda los veredictos; de ahí salen el recuento «funciona en» de un mod y la lista de mods de un mapa.
Un paquete que necesita una expansión lo dice en requiredExpansions; un mapa que no encaja con el juego base a solas sigue listado, y el juego dice por qué no cargará.
Dónde se instala
En Documentos/Open Annihilation/Maps/