تطوير المودات

دليل تطوير المودات

أنشئ مودات خاصة بك باستخدام واجهة برمجة C# القوية من tModLoader.

المتطلبات الأساسية

أدوات التطوير

  • Visual Studio 2022 (موصى به)
  • JetBrains Rider (بديل)
  • VS Code مع إضافة C#
  • .NET 6.0 SDK أو أحدث

المعرفة المطلوبة

  • أساسيات برمجة C#
  • مفاهيم البرمجة الكائنية (الفئات، الوراثة)
  • معرفة بلعبة Terraria
  • فهم أساسي لتطوير الألعاب

إنشاء أول مود لك

الخطوة 1: إعداد بيئة التطوير

قم بتثبيت Visual Studio و .NET SDK من المصادر الرسمية.

عرض دليل الإعداد المفصل ←

الخطوة 2: إنشاء مشروع المود

  1. 1. شغّل tModLoader
  2. 2. اذهب إلى "ورشة العمل" ← "تطوير المودات"
  3. 3. انقر على "إنشاء مود"
  4. 4. أدخل اسماً فريداً للمود (بدون مسافات)
  5. 5. انقر على "إنشاء"

الخطوة 3: فهم بنية المود

YourModName/
├── build.txt # البيانات الوصفية
├── description.txt # الوصف
├── icon.png # أيقونة 64x64
├── YourModName.cs # الفئة الرئيسية
├── Items/ # عناصر مخصصة
├── NPCs/ # شخصيات مخصصة
├── Projectiles/ # المقذوفات
└── Tiles/ # الكتل/البلاطات

فهم واجهة برمجة tModLoader

يوفر tModLoader خطافات واسعة في أنظمة Terraria من خلال فئات C#.

الفئات الأساسية

  • • Mod (فئة المود الأساسية)
  • • ModItem (العناصر/الأسلحة)
  • • ModNPC (الأعداء/الشخصيات)
  • • ModProjectile (المقذوفات)

محتوى العالم

  • • ModTile (الكتل/البلاطات)
  • • ModWall (الجدران)
  • • ModBiome (البيئات)
  • • ModWorld (توليد العالم)

التأثيرات والواجهة

  • • ModBuff (التعزيزات/الإضعافات)
  • • ModDust (الجسيمات)
  • • ModSound (الأصوات)
  • • UIState (واجهة مخصصة)

مصادر التعلم

ويكي GitHub الرسمي

المورد الأكثر شمولاً مع مئات الأمثلة والدروس التعليمية.

التغطية: جميع فئات API مع أمثلة
التحديثات: صيانة منتظمة
الأمثلة: +200 مقتطف كود
المجتمع: مفتوح للمساهمات
زيارة ويكي GitHub

دروس فيديو

تعلم بصرياً مع دروس المجتمع على YouTube.

  • • إنشاء مود أساسي
  • • تقنيات متقدمة
  • • جلسات برمجة مباشرة

مودات نموذجية

ادرس الكود المصدري لمودات مفتوحة المصدر الشائعة.

  • • ExampleMod (القالب الرسمي)
  • • مستودعات مودات المجتمع
  • • مشاريع مُعلّقة بشكل جيد

الخطوات التالية

مواصلة التعلم