Моды для Tyrian: корабли, оружие, враги и уровни

Оружию, кораблям, врагам и спрайтам, которые создаёт мод, имена даёт автор, а оригинальный контент, который мод копирует или меняет, тоже указывается по имени, например "base": "Vulcan Cannon". Все внутренние слоты движок назначает сам: вы никогда не выбираете числовой ID, и два мода никогда не спорят за один и тот же.

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

Настоящий mod.json

Это эталонный пример Alien Pack без комментариев. В пакет игры он не входит: он лежит в папке rewrite/mods/_retired/alien_pack/ репозитория. Он добавляет корабль и четыре вида оружия, скопированные с оригинальных, перекрашивает все PNG мода в зелёный и задаёт стартовое снаряжение новой игры:

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

Рядом с ним в папке sprites/ мода лежат изображение корабля (sprites/ships/xeno_vanguard.png), иконки для магазина и выстрелы; "tint" перекрашивает их все при загрузке мода. "$schema" необязателен: он указывает вашему редактору на опубликованную JSON-схему для автодополнения и проверки ошибок на лету. Любой неизвестный ключ считается ошибкой, так что опечатка никогда не останется незамеченной.

В репозиторий входит редактор уровней, встроенный в редактор Godot. Его панель Tyrian позволяет выбрать стартовую строку на карте уровня, а также содержит кнопки Add an enemy here (добавить врага), Export to the mod (экспорт в мод), Build the .zip package (собрать .zip, чтобы поделиться) и Play from here (играть отсюда). Последняя запускает уровень, перемотанный до выбранной строки, так что встречу с врагами можно проверить за секунды.

Редактор работает с исходным кодом: сначала соберите игру (см. docs/build.md, на английском), затем откройте проект Godot. Для создания мода он не обязателен: события уровня можно писать и вручную в levels/epN_NN.json. Этот пример из руководства по моддингу добавляет двух врагов в первый уровень эпизода 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 вставляет события в оригинальный список, events заменяет его, а random_enemies заменяет случайных врагов уровня. time задаёт позицию прокрутки, которую показывает редактор. Все типы событий перечислены на странице Level events (на английском).