WIKI

التعديلات

الدروس التعليمية

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