Tyrian: mods de naves, armas, inimigos e níveis

As armas, naves, inimigos e sprites que um mod cria recebem nome dado pelo autor, e o conteúdo original que ele copia ou altera também é citado pelo nome, como em "base": "Vulcan Cannon". O motor atribui sozinho cada posição interna: você nunca escolhe um número de ID, e dois mods nunca disputam o mesmo.

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

Um mod.json de verdade

Este é o exemplo de referência Alien Pack, sem os comentários. Ele não vem no pacote do jogo: fica em rewrite/mods/_retired/alien_pack/ no repositório. Ele adiciona uma nave e quatro armas copiadas de originais, tinge de verde todos os PNG do mod e define o equipamento inicial de um novo jogo:

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

Ao lado dele, a pasta sprites/ do mod contém a imagem da nave (sprites/ships/xeno_vanguard.png), os ícones da loja e os tiros; "tint" recolore todos eles quando o mod é carregado. "$schema" é opcional: ele aponta seu editor para o esquema JSON publicado, para autocompletar e mostrar erros ao vivo. Toda chave desconhecida é relatada como erro, então um erro de digitação nunca passa despercebido.

O repositório inclui um editor de níveis integrado ao editor do Godot. O painel Tyrian dele permite escolher uma linha inicial no mapa do nível, Adicionar um inimigo aqui, Exportar para o mod, Gerar o pacote .zip para compartilhar e Jogar daqui, que inicia o nível avançado até a linha escolhida, para você testar um encontro em segundos.

O editor funciona a partir do código-fonte: primeiro você compila o jogo (veja docs/build.md), depois abre o projeto do Godot. Você não precisa dele para criar um mod: os eventos de nível também podem ser escritos à mão em levels/epN_NN.json. Este exemplo, do guia de mods, adiciona dois inimigos ao primeiro nível do episódio 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 insere eventos na lista original, events a substitui, e random_enemies substitui os inimigos aleatórios do nível. time é a posição de rolagem mostrada pelo editor. Todos os tipos de evento estão listados na página Eventos de nível (em inglês).