التثبيت

دليل التثبيت

تعليمات كاملة خطوة بخطوة لتثبيت tModLoader على جميع المنصات.

العودة إلى البدء السريع | التالي: استخدام المودات

قبل أن تبدأ

المتطلبات

  • نسخة أصلية من Terraria مثبتة
  • اتصال بالإنترنت لتحميل المودات
  • 1GB على الأقل من مساحة التخزين الفارغة
  • صلاحيات المسؤول/root (للتثبيت)

التثبيت عبر Steam (موصى به)

هذه هي الطريقة الأسهل والموصى بها. يتولى Steam جميع التحديثات تلقائياً ويتضمن تكامل Workshop. بعد التثبيت، اطلع على دليل استخدام المودات.

1

افتح Steam

شغّل عميل Steam وتأكد من تسجيل الدخول إلى حسابك.

Steam
2

ابحث عن tModLoader

في متجر Steam، ابحث عن "tModLoader" في شريط البحث في الأعلى.

أو انقر هنا:

افتح tModLoader على Steam
3

التثبيت (مجاني!)

انقر على زر "Play Game". tModLoader مجاني تماماً - لا يتطلب شراء.

سيقوم Steam بتحميل حوالي 200-500MB حسب منصتك.

4

شغّل tModLoader

بعد التثبيت، ابحث عن tModLoader في مكتبة Steam وانقر "Play".

التشغيل الأول قد يستغرق بضع دقائق لإعداد الملفات والمجلدات.

مزايا التثبيت عبر Steam

  • تحديثات تلقائية
  • تكامل مع Steam Workshop
  • دعم الحفظ السحابي
  • لعب جماعي سهل مع الأصدقاء

التثبيت اليدوي

للمستخدمين المتقدمين أو المنصات التي لا تتوفر فيها Steam. يتطلب تحديثات يدوية.

1

التحميل من GitHub

قم بزيارة صفحة الإصدارات على GitHub وحمّل أحدث إصدار لمنصتك.

الذهاب إلى إصدارات GitHub
2

استخراج الملفات

استخرج الملفات المحملة إلى مجلد تثبيت Terraria.

Common Terraria Locations:

Windows (Steam):

C:\Program Files (x86)\Steam\steamapps\common\Terraria

Windows (GOG):

C:\GOG Games\Terraria

macOS:

~/Library/Application Support/Steam/steamapps/common/Terraria

Linux:

~/.steam/steam/steamapps/common/Terraria
3

تشغيل tModLoader

شغّل الملف التنفيذي لـ tModLoader:

  • Windows: شغّل tModLoader.exe
  • macOS: شغّل tModLoader (قد تحتاج للسماح به في تفضيلات النظام)
  • Linux: شغّل ./tModLoader (قد تحتاج لجعله قابلاً للتنفيذ أولاً)

ملاحظات خاصة بالمنصات

ملاحظات التثبيت على Windows

مطلوب .NET Framework: ثبّت .NET Framework 4.7.2 أو أحدث من Microsoft.

صلاحيات المسؤول: قد تحتاج للتشغيل كمسؤول في التشغيل الأول.

مضاد الفيروسات: بعض برامج مضاد الفيروسات قد تكتشف tModLoader. أضفه إلى الاستثناءات إذا لزم الأمر.

جدار الحماية: اسمح لـ tModLoader عبر جدار حماية Windows للعب الجماعي.

ملاحظات التثبيت على macOS

Mono Framework: ثبّت أحدث إصدار من Mono Framework من mono-project.com.

Gatekeeper: انقر بزر الماوس الأيمن ← فتح لتجاوز Gatekeeper في التشغيل الأول.

الأذونات: قد تحتاج لمنح أذونات في تفضيلات النظام ← الأمان.

ملاحظات التثبيت على Linux

Mono Framework: ثبّته عبر مدير الحزم (apt, yum, إلخ).

جعله قابلاً للتنفيذ: شغّل chmod +x tModLoader قبل التشغيل الأول.

التبعيات: قد تحتاج مكتبات إضافية حسب التوزيعة.

مشاكل الصوت: ثبّت PulseAudio إذا واجهت مشاكل صوتية.

التحقق من التثبيت

كيفية التأكد من أن tModLoader مثبت بشكل صحيح:

✓ تحقق 1: القائمة الرئيسية

يجب أن ترى خيارات القائمة الجديدة هذه:

  • • Mod Browser - تصفح وتحميل المودات
  • • Mods - تفعيل/تعطيل المودات المثبتة
  • • Workshop - تطوير ونشر المودات

✓ تحقق 2: رقم الإصدار

الزاوية السفلية اليسرى يجب أن تعرض:

tModLoader v2025.XX.X.X

✓ تحقق 3: هيكل المجلدات

انتقل إلى Documents/My Games/Terraria/ - يجب أن ترى مجلد "tModLoader".

استكشاف أخطاء التثبيت

مشكلة: ".NET Framework مفقود"

الأعراض: رسالة خطأ عند التشغيل حول .NET المفقود

الحل:

  1. 1. قم بزيارة صفحة تحميل .NET من Microsoft
  2. 2. حمّل .NET Framework 4.7.2 أو أحدث
  3. 3. ثبّته وأعد تشغيل الكمبيوتر
  4. 4. شغّل tModLoader مرة أخرى
تحميل .NET Framework

مشكلة: "مضاد الفيروسات يحظر tModLoader"

الأعراض: فشل التثبيت أو عدم تشغيل tModLoader

الحل:

  • • أضف مجلد tModLoader إلى استثناءات مضاد الفيروسات
  • • Windows Defender: الإعدادات ← الحماية من الفيروسات ← الاستثناءات
  • • أضف كامل مجلد Terraria/tModLoader
  • • عطّل مضاد الفيروسات مؤقتاً أثناء التثبيت

مشكلة: "التشغيل الأول بطيء"

الأعراض: tModLoader يستغرق أكثر من 5 دقائق للتشغيل لأول مرة

هذا طبيعي!

التشغيل الأول يقوم بهذه المهام:

  • • إنشاء هيكل المجلدات
  • • إنشاء ملفات الإعداد
  • • فهرسة المحتوى الأصلي
  • • إعداد قاعدة بيانات متصفح المودات
عمليات التشغيل التالية ستكون أسرع بكثير (10-30 ثانية).

GOG والإصدارات الأخرى

التثبيت مع إصدار GOG من Terraria

يعمل tModLoader مع GOG Galaxy والتثبيتات المستقلة من GOG:

الخيار 1: التثبيت اليدوي

  1. 1. حمّل tModLoader من GitHub
  2. 2. حدد مجلد Terraria في GOG (عادةً C:\GOG Games\Terraria)
  3. 3. استخرج ملفات tModLoader في ذلك المجلد
  4. 4. شغّل tModLoader.exe

الخيار 2: التحميل المجاني من Steam

حتى لو كنت تملك Terraria على GOG، يمكنك تحميل tModLoader مجاناً على Steam. إنه تطبيق منفصل ويعمل بشكل مستقل.

ملاحظة: تكامل Workshop متاح فقط عبر إصدار Steam. مستخدمو GOG يمكنهم استخدام متصفح المودات داخل اللعبة.

ماذا بعد؟

اكتمل التثبيت! 🎉

الآن بعد تثبيت tModLoader، أنت جاهز لبدء إضافة المودات!

استخدام المودات
تعلم كيفية تثبيت المودات
متصفح المودات
اكتشف المودات الشائعة

ماذا تقرأ بعد ذلك

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

استخدام المودات

تعلم كيفية تثبيت وإدارة المودات

متصفح المودات

اكتشف آلاف المودات

استكشاف الأخطاء

مشاكل في التثبيت؟ نحن هنا للمساعدة