Обучение
tutorials.json рядом с mod.json добавляет в руководство игры ваши собственные статьи с фотографией вашего режима. Новая статья открывается небольшой карточкой поверх матча, когда впервые наступает её момент, и после этого остаётся в руководстве. Обучение — это текст и картинки: оно никогда не делает мод игровым.
{"version": 1, "tutorials": {
"my_intro": {
"title": {"en": "My mod", "pt_br": "Meu mod"},
"body": {"en": "What the player needs to know.", "pt_br": "O que o jogador precisa saber."},
"image": "Tutorials/intro.jpg",
"trigger": "run_start"
}
}}
titleиbody— тексты по языкам; для отсутствующего языка берётся английский. Пишите два-три коротких предложения: что это такое и что делает игрок.image— PNG, JPEG или WebP в вашей папке. Используйте снимок из игры, а не рисунок.clip(необязательно) — несколько секунд игры в виде видео Ogg Theora (.ogv) в вашей папке, которое крутится по кругу без звука вместо фотографии. Делайте его коротким, от 3 до 10 секунд, без текста, примерно 960 × 540.tutorialбашни вtower_data.jsonможет указать одну из ваших статей какmod_<name>.
Когда она открывается
trigger | Открывается, когда |
|---|---|
run_start | начинается забег |
wave:<N> | начинается волна N (wave:12) |
boss | начинается волна с боссом |
tower_built, tower_built:<Tower> | игрок возводит башню или башню этого типа (tower_built:Cannon, в том числе ваши собственные) |
tower_lost | падает одна из башен игрока |
card:<id> | игрок берёт эту карту (card:unlock_cockpit) |
worm | кусает червь |
material:<id>, material:<id>:<count> | запас этого материала достигает единицы или указанного количества (material:oil:10) |
day:<N>, night | наступает день N или опускается ночь — при быстром дне |
belt_tool, generator, generator_bitten, hangar, swarm, deposit | собственные моменты Torretaz — для мода на его правилах |
Если у нескольких статей один триггер, каждый такой момент открывает первую ещё не прочитанную. Без триггера статья ждёт в руководстве или вызова api.tutorial("my_intro") из вашего скрипта (скрипты).
Собственное обучение игры
"vanilla" рядом с "tutorials" говорит, какие статьи обучения игры по-прежнему действуют под вашим модом: true — все, false — ни одной, или список их ключей, например ["camera", "card_rarity", "rain", "sandstorm"]. Полная конверсия, которая ничего не указала, не сохраняет ни одной. Torretaz поставляет своё обучение на пятнадцати языках и сохраняет эти четыре статьи.
