الدروس التعليمية
ملف 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 يحمل دروسه الخاصة، بخمس عشرة لغة، ويحتفظ بتلك الأربعة.
