Comprobar, empaquetar y publicar
oa-tool mutator check y pack, una prueba en seco, qué muestra la página del catálogo, el icono y cómo ofrecer el paquete a Core Prime.
Este capítulo resume docs/mutators/authoring.md y docs/mutators/oamut-standard.md.
Comprueba el .oamut
Un mutador se empaqueta y se comprueba con oa-tool mutator pack y oa-tool mutator check. oa-tool pack y oa-tool check son los comandos para un .oamap o un .oamod. check lee un .oamut, no una carpeta. Compila el Lua y analiza cada .sm, y no los ejecuta. La última línea es result: ok o result: refused.
$ oa-tool mutator pack commander-radar
$ oa-tool mutator check commander-radar-1.oamut
Un rechazo nombra el archivo y la línea. Arréglalo antes de ofrecer el paquete. El nombre empaquetado de Commander Radar es commander-radar-1.oamut, y esa comprobación termina en result: ok.
Empaqueta desde fuera de la carpeta
Ejecuta pack con el nombre de la carpeta, desde fuera. Si no dices más, escribe <id>-<version>.oamut en la carpeta actual. --out debe nombrar un .oamut: cualquier otra terminación se rechaza. --force sustituye un archivo que ya está. No empaquetes . desde dentro de la carpeta, y no dejes el .oamut dentro: un paquete no puede contener ese archivo. --game-dir es un error de uso en este comando.
La prueba en seco
oa-tool mutator diff pasa una carpeta de paquete por el proceso de mutación del juego, sobre una carpeta de juego, y lista lo que cambió. Las opciones van tras el último dos puntos, como strength=lite en uber-comm. Un hook maps solo corre con --map NAME. En 3.1c sin mod, las líneas del informe tras su cabecera # son estas:
$ oa-tool mutator diff --game-dir DIR --mutator ./uber-comm:strength=lite
field units/armcom.fbi [unitinfo] acceleration: 0.15 -> 0.3375 by uber-comm
field units/armcom.fbi [unitinfo] brakerate: 0.3 -> 0.675 by uber-comm
field units/armcom.fbi [unitinfo] builddistance: 60 -> 120 by uber-comm
field units/armcom.fbi [unitinfo] maxdamage: 3000 -> 4500 by uber-comm
field units/armcom.fbi [unitinfo] maxvelocity: 1.2 -> 1.8 by uber-comm
field units/armcom.fbi [unitinfo] turnrate: 1044 -> 1566 by uber-comm
field units/armcom.fbi [unitinfo] workertime: 300 -> 900 by uber-comm
field units/corcom.fbi [unitinfo] acceleration: 0.16 -> 0.36 by uber-comm
field units/corcom.fbi [unitinfo] brakerate: 0.32 -> 0.72 by uber-comm
field units/corcom.fbi [unitinfo] builddistance: 60 -> 120 by uber-comm
field units/corcom.fbi [unitinfo] maxdamage: 3000 -> 4500 by uber-comm
field units/corcom.fbi [unitinfo] maxvelocity: 1.07 -> 1.605 by uber-comm
field units/corcom.fbi [unitinfo] turnrate: 1030 -> 1545 by uber-comm
field units/corcom.fbi [unitinfo] workertime: 300 -> 900 by uber-comm
La prueba en seco de la Biblioteca es el mismo proceso sobre un almacén propio, sin partida. No pone mapa, así que un hook maps no corre allí. La Biblioteca recuerda la respuesta, y su línea Comprobado es una de estas. check no aplica el mutador. La prueba en seco y el diff sí.
| Veredicto | Qué muestra la Biblioteca |
|---|---|
compatible | Funciona con ese mod, y la línea lleva un resumen de lo que cambió. |
no-effect | Funciona, y no cambia nada de lo que cuenta la comprobación. |
incompatible | No funciona con ese mod. El motivo va detrás. |
failed | Se detuvo. El motivo va detrás. |
| aún en marcha | La comprobación con ese mod sigue en marcha. |
| aún sin ejecutar | Aún no comprobado con ese mod. |
Qué muestra la página del catálogo
La página muestra el icono, o, cuando el manifiesto no nombra ninguno, el icono de la primera etiqueta si esa etiqueta es una de las ocho. Luego el nombre, el autor, la versión y el número de versión del catálogo, el resumen (la primera línea de description), las etiquetas y una pastilla de motor desde requires.engine. Necesita lista requires.mutators. Opciones lista cada opción. Qué cambia lista las capas. Funciona con lista works-with. Sigue una tabla de versiones y después Consíguelo en el juego. Este sitio nunca enlaza el archivo del paquete. Las descargas ocurren en el juego.
El icono
Un PNG cuadrado, al menos 1 píxel de lado, como mucho 256 píxeles y 256 KiB. Dibújalo a 128 píxeles. icon en el manifiesto nombra la ruta, y ese nombre termina en .png. Sin icono, la insignia usa el icono de la primera etiqueta cuando ese id es uno de los ocho. Una etiqueta posterior no se prueba.
Ofrécelo a Core Prime
La biblioteca de contenido de Core Prime se publica desde la máquina de un mantenedor: el catálogo se firma con una clave que nunca sale de ella. Para que un mutador aparezca:
- Abre una incidencia en el repositorio de Open Annihilation con el .oamut (o un enlace), su autor y su licencia.
- Un mantenedor ejecuta las comprobaciones contra la carpeta de juego y lo añade a los registros de paquetes de la biblioteca.
- La siguiente publicación sube el archivo bajo su hash, firma el nuevo catálogo y sube su secuencia.
- Minutos después está en la Biblioteca de cada jugador y en este sitio.
Un paquete de mapas o un mod se ofrece igual. Mira Publicar en Core Prime.