Anatomie d'un pack de cartes

Le zip .oamap, son manifeste oamap.yaml, l'index des cartes écrit par l'empaqueteur, et comment la taille et les éléments d'une carte décident si elle convient à un jeu.

Le paquet

Un .oamap est un zip du dossier du pack, avec oamap.yaml à la racine ou dans l'unique dossier que la racine contient (la commande Compresser du Finder produit un tel fichier). Les règles d'archive sont celles du paquet de mod : entrées stockées ou compressées ; pas de liens, de noms de périphériques, de chemins absolus ni de .. ; pas deux noms qui ne diffèrent que par la casse ; au plus 4 Gio décompressés.

my-maps.oamaple fichier qu'un joueur télécharge ou ouvre├─ oamap.yamlrequis le manifeste : identifiant, nom, numéro, auteur, empaquetage et l'index des cartes├─ Ridge.tnt · Ridge.otaune carte : son terrain (.tnt) et ses réglages (.ota)├─ Long Lakes.tnt · Long Lakes.otaune autre ; un pack contient de 1 à 256 cartes└─ READMEtout le reste est embarqué et ignoré

Le manifeste

YAML strict : un document, une table de premier niveau, ni ancres ni scalaires de bloc. L'identifiant est en kebab-case minuscule, de 1 à 32 octets, et nomme le dossier d'installation du pack. Une clé absente du standard est refusée.

oamap: 1
id: my-maps                  # kebab-case, 1 à 32 octets ; le nom du dossier d'installation
name: My Maps
version: "1.0"             # texte libre, jamais ordonné
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"}   # mettez la plage de moteur entre guillemets : un > nu ouvre un scalaire de bloc, refusé
# maps: est écrit pour vous par oa-tool pack (l'index ci-dessous)

L'index

oa-tool pack écrit une entrée maps pour chaque carte du dossier qui a un schéma Network, dans l'ordre des octets de son chemin. Un dossier peut lister les entrées lui-même pour fixer le nom, la description ou le nombre de joueurs d'une carte ; le reste est toujours calculé.

Clé	Règle
`stem`	Le radical du fichier de la carte ; un radical absent du dossier est une erreur.
`name`, `description`	Fixés par la liste du dossier ou pris dans la carte ; mêmes règles qu'une entrée empaquetée.
`players`	Le nombre de joueurs pour lequel la carte est faite, de 2 à 10.
`size`, `preview`, `files`	Toujours calculés par l'empaqueteur, même si le dossier les fixe.

Quand une carte convient

Une carte convient à un jeu quand celui-ci a le jeu de tuiles, les éléments et les unités qu'elle nomme. La bibliothèque de contenu vérifie chaque pack contre le jeu de base et chaque mod et enregistre les verdicts ; c'est de là que viennent le compteur « fonctionne sur » d'un mod et la liste des mods d'une carte.

Un pack qui exige une extension le dit dans requiredExpansions ; une carte qui ne convient pas au jeu de base seul reste listée, et le jeu explique pourquoi elle ne se chargera pas.

Où il s'installe

Dans Documents/Open Annihilation/Maps/, sous l'identifiant du manifeste, jamais sous le nom du fichier. Une révision plus récente du même numéro remplace le dossier ; un autre numéro peut s'installer à côté. Tout est vérifié avant d'écrire quoi que ce soit.

Suivant: Anatomie d'un mod Le standard sur GitHub