教程
放在 mod.json 旁边的 tutorials.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。tower_data.json中防御塔的tutorial可以用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")(脚本)。
游戏自带的教程
与 "tutorials" 并列的 "vanilla" 表示在你的模组下游戏的哪些教程仍然适用:true 表示全部,false 表示全不,或者是它们的键的列表,例如 ["camera", "card_rarity", "rain", "sandstorm"]。什么都没写的全面转换不保留任何教程。Torretaz 附带了它自己的十五种语言的教程,并保留了这四个。
