Mod di Tyrian: navi, armi, nemici e livelli

Le armi, le navi, i nemici e gli sprite creati da una mod prendono il nome scelto dal loro autore, e anche i contenuti originali che copia o modifica sono citati per nome, ad esempio "base": "Vulcan Cannon". Il motore assegna da solo ogni slot interno: non scegli mai un numero ID, e due mod non se lo contendono mai.

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 vero mod.json

È l’esempio di riferimento Alien Pack, senza commenti. Non è nel pacchetto del gioco: si trova in rewrite/mods/_retired/alien_pack/ del repository. Aggiunge una nave e quattro armi copiate da quelle originali, tinge di verde ogni PNG della mod e imposta l’equipaggiamento iniziale di una nuova partita:

{
  "$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"
  }
}

Accanto, la cartella sprites/ della mod contiene l’immagine della nave (sprites/ships/xeno_vanguard.png), le icone del negozio e i proiettili; "tint" li ricolora tutti al caricamento della mod. "$schema" è facoltativo: indica al tuo editor lo schema JSON pubblicato, per completamento automatico ed errori in tempo reale. Ogni chiave sconosciuta viene segnalata come errore, quindi un refuso non passa mai inosservato.

Il repository include un editor di livelli integrato nell’editor Godot. Il suo pannello Tyrian permette di scegliere una riga di partenza sulla mappa del livello, aggiungere un nemico qui, esportare nella mod, creare il pacchetto .zip da condividere e giocare da qui: il livello parte avanzato velocemente fino alla riga scelta, così puoi provare un incontro in pochi secondi.

L’editor funziona a partire dal codice sorgente: prima compili il gioco (vedi docs/build.md), poi apri il progetto Godot. Non ti serve per creare una mod: gli eventi dei livelli si possono anche scrivere a mano in levels/epN_NN.json. Questo esempio, tratto dalla guida alle mod, aggiunge due nemici al primo livello dell’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 inserisce eventi nella lista originale, events la sostituisce, e random_enemies sostituisce i nemici casuali del livello. time è la posizione di scorrimento mostrata dall’editor. Tutti i tipi di evento sono elencati nella pagina Level events (in inglese).