Tyrian: mods de naves, armas, enemigos y niveles

Las armas, naves, enemigos y sprites que crea un mod los nombra su autor, y el contenido original que copia o modifica también se cita por su nombre, como en "base": "Vulcan Cannon". El motor asigna él mismo cada ranura interna: nunca eliges un número de ID y dos mods nunca se pelean por uno.

my_mod/
  mod.json              required: "format_version": 1 and "name"
  README.md             optional: shown in Setup → Mods (1 KiB at most)
  levels/ep1_09.json    optional: events of a level
  sprites/shots/*.png   optional: images, cited by their file name

Un mod.json real

Este es el ejemplo de referencia Alien Pack, sin comentarios. No está en el paquete del juego: se encuentra en rewrite/mods/_retired/alien_pack/ del repositorio. Añade una nave y cuatro armas copiadas de originales, tiñe de verde todos los PNG del mod y define el equipo inicial de una partida nueva:

{
  "$schema": "../../mod.schema.json",
  "format_version": 1,
  "name":        "Alien Pack",
  "author":      "OpenTyrian2000 Team",
  "version":     "3.0",
  "description": "Green alien fleet — 4 stock weapons re-skinned via engine tint.",
  "tint":        "green",
  "enabled":     false,
  "ships": [
    { "name": "Xeno Vanguard", "base": "Gencore II", "ship_sprite": "xeno_vanguard", "always_available": true }
  ],
  "weapons": [
    { "name": "Alien Vulcan Cannon", "base": "Vulcan Cannon",          "always_available": true },
    { "name": "Alien Mega Cannon",   "base": "Mega Cannon",            "always_available": true },
    { "name": "Alien Bio Spreader",  "base": "Sonic Wave",             "always_available": true },
    { "name": "Alien Guided Orbs",   "base": "Heavy Missile Launcher", "always_available": true }
  ],
  "starter": {
    "ship":         "Xeno Vanguard",
    "front_weapon": "Alien Vulcan Cannon",
    "rear_weapon":  "Alien Guided Orbs"
  }
}

Junto a él, la carpeta sprites/ del mod contiene la imagen de la nave (sprites/ships/xeno_vanguard.png), los iconos de la tienda y los disparos; "tint" les cambia el color a todos al cargar el mod. "$schema" es opcional: indica a tu editor el esquema JSON publicado para autocompletar y mostrar errores al momento. Toda clave desconocida se notifica como error, así que una errata nunca pasa inadvertida.

El repositorio incluye un editor de niveles integrado en el editor de Godot. Su panel Tyrian (en inglés) te permite elegir una fila de inicio en el mapa del nivel, añadir un enemigo aquí, exportar al mod, generar el paquete .zip para compartir y Jugar desde aquí, que inicia el nivel avanzado hasta la fila que elegiste, para que puedas probar un encuentro en segundos.

El editor funciona a partir del código fuente: primero compilas el juego (consulta docs/build.md) y luego abres el proyecto de Godot. No lo necesitas para crear un mod: los eventos de nivel también se pueden escribir a mano en levels/epN_NN.json. Este ejemplo, de la guía de mods, añade dos enemigos al primer nivel del episodio 1:

{ "episode": 1, "lvl_file_num": 9,
  "add_events": [ { "time": 300, "spawn": "my_drone", "x": 130 },
                  { "time": 300, "spawn": "tech_corridor_32", "x": "random", "link": 3 } ] }

add_events inserta eventos en la lista original, events la sustituye y random_enemies sustituye los enemigos aleatorios del nivel. time es la posición de desplazamiento que muestra el editor. Todos los tipos de evento aparecen en la página Level events (en inglés).