كيفية إنشاء أول مود Terraria في 2025

ما ستتعلمه

• إعداد بيئة التطوير الخاصة بك
• إنشاء سيف مخصص بخصائص فريدة
• فهم واجهة C# API الخاصة بـ tModLoader
• اختبار وتصحيح المود الخاص بك
• النشر على Steam Workshop

المتطلبات المسبقة

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

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

البرمجيات المطلوبة

• tModLoader مثبت ويعمل
• Visual Studio 2022 (موصى به) أو VS Code
• .NET 6.0 SDK أو أحدث

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

إنشاء قالب المود الخاص بك

شغّل tModLoader واذهب إلى "Workshop" → "Develop Mods"
انقر على "Create Mod"
أدخل اسم المود (مثل "MyFirstMod" - بدون مسافات!)
املأ اسم المؤلف والوصف
انقر على "Create"

هذا ينشئ قالب مود في مجلد ModSources الخاص بك مع جميع الملفات اللازمة.

الخطوة 2: إنشاء سيف مخصص

لنُنشئ سيفاً مخصصاً بسيطاً لكن فعالاً. هذا سيعلمك أساسيات إنشاء العناصر.

إنشاء فئة العنصر

أنشئ ملفاً جديداً: Items/BeginnerSword.cs

using Terraria;
using Terraria.ID;
using Terraria.ModLoader;

namespace MyFirstMod.Items
{
    public class BeginnerSword : ModItem
    {
        public override void SetDefaults()
        {
            // Basic item properties
            Item.damage = 45;                    // Damage value
            Item.DamageType = DamageClass.Melee; // Damage type
            Item.width = 40;                     // Hitbox width
            Item.height = 40;                    // Hitbox height
            Item.useTime = 20;                   // Use speed
            Item.useAnimation = 20;              // Animation speed
            Item.useStyle = ItemUseStyleID.Swing;// How it's used
            Item.knockBack = 6;                  // Knockback strength
            Item.value = Item.buyPrice(gold: 2); // Sell value
            Item.rare = ItemRarityID.Green;      // Rarity color
            Item.UseSound = SoundID.Item1;       // Use sound
            Item.autoReuse = true;               // Can auto-swing
        }

        public override void AddRecipes()
        {
            Recipe recipe = CreateRecipe();
            recipe.AddIngredient(ItemID.IronBar, 15);
            recipe.AddIngredient(ItemID.Wood, 10);
            recipe.AddTile(TileID.Anvils);
            recipe.Register();
        }
    }
}

فهم الكود

SetDefaults(): يحدد جميع خصائص العنصر مثل الضرر والحجم والسلوك
AddRecipes(): ينشئ وصفات الصناعة لعنصرك
DamageClass.Melee: يجعله يتناسب مع مكافآت ضرر القتال القريب
ItemRarityID.Green: يحدد لون الندرة (يؤثر على لون اسم العنصر)

الخطوة 3: البناء والاختبار

استخدام Build + Reload

أفضل ميزة في tModLoader للمطورين هي نظام "Build + Reload" الذي يتيح لك اختبار التغييرات فوراً:

في tModLoader، اذهب إلى "Workshop" → "Develop Mods"
ابحث عن المود الخاص بك وانقر "Build + Reload"
انتظر التجميع (يجب أن يستغرق 5-10 ثوانٍ)
يُعاد تحميل المود تلقائياً مع التغييرات
اختبر سيفك الجديد في اللعبة!

اختبار سيفك

لاختبار سيفك الجديد:

1. افتح المخزون وتحقق من إمكانية صنعه (ستحتاج قضبان حديد وخشب)
2. اصنع السيف واختبر ضرره على الأعداء
3. تحقق من أن المؤثر الصوتي والرسوم المتحركة تعمل بشكل صحيح
4. تحقق من وظيفة التأرجح التلقائي

إضافة ميزات متقدمة

تأثيرات مخصصة عند الضرب

لنضف تأثيراً خاصاً عندما يضرب سيفك عدواً:

public override void OnHitNPC(Player player, NPC target, NPC.HitInfo hit, int damageDone)
{
    // 20% chance to inflict fire debuff
    if (Main.rand.NextBool(5))
    {
        target.AddBuff(BuffID.OnFire, 180); // 3 seconds of fire
    }

    // Spawn some visual effects
    for (int i = 0; i < 10; i++)
    {
        Dust.NewDust(target.position, target.width, target.height, DustID.Fire);
    }
}

هذا يضيف احتمال 20% لإشعال الأعداء وينشئ تأثيرات جسيمات نار عند الضرب.

تلميح مخصص

أضف نصاً مخصصاً لتلميح عنصرك:

public override void ModifyTooltips(List<TooltipLine> tooltips)
{
    TooltipLine line = new TooltipLine(Mod, "CustomTooltip", "A sword forged by a beginner modder!");
    line.OverrideColor = Color.Orange;
    tooltips.Add(line);
}

نشر المود الخاص بك

النشر على Steam Workshop

تأكد من أن المود يُبنى بدون أخطاء
أضف ملف icon.png (64×64 بكسل) إلى مجلد المود
اكتب description.txt جيد يشرح ما يفعله المود
في "Develop Mods"، انقر "Publish" بجانب المود
املأ نموذج Steam Workshop بالوسوم والوصف
ارفع لقطات شاشة تعرض المود أثناء العمل
انقر "Publish" لنشره!

نصائح للنشر الناجح

• اكتب أوصافاً واضحة ومفصلة
• أضف لقطات شاشة عالية الجودة
• استخدم وسوماً ذات صلة لسهولة الاكتشاف
• اختبر جيداً قبل النشر
• استجب لملاحظات وتعليقات المستخدمين

تهانينا! أنت الآن مطور مودات!

لقد أنشأت أول مود Terraria! هذه مجرد البداية - واجهة API الخاصة بـ tModLoader يمكنها فعل أشياء مذهلة. استكشف شخصيات NPC والمقذوفات والبلاط وتوليد العالم بعد ذلك.

التطوير المتقدم مرجع API