🎮 تثبيت سيرفر tModLoader — خادم مودات لعبة Terraria وCalamity على Docker

نشر خادم tModLoader المخصص على Ubuntu باستخدام Docker — تشغيل أضخم مودات لعبة Terraria مثل Calamity وThorium وتنزيل مودات Steam Workshop تلقائياً على المنفذ 7778.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت مؤتمت — أمر واحد ينشر خادم tModLoader على المنفذ 7778 مع التنزيل التلقائي للمودات وتوليد العوالم والمجلدات جاهزة.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/gaming/tmodloader/tmodloader-ubuntu.sh
chmod +x tmodloader-ubuntu.sh
./tmodloader-ubuntu.sh

خطوات التنفيذ

1 تحميل سكريبت التثبيت من مستودع GitHub إلى سيرفر Ubuntu باستخدام wget أو curl.

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/gaming/tmodloader/tmodloader-ubuntu.sh

2 منح صلاحيات التنفيذ للسكريبت باستخدام الأمر `chmod +x tmodloader-ubuntu.sh`.

chmod +x tmodloader-ubuntu.sh

3 تشغيل المثبت لتهيئة Docker ومجلدات المودات (`./mods`) وإطلاق حاوية tModLoader على المنفذ 7778.

./tmodloader-ubuntu.sh

4 تشغيل برنامج tModLoader على حاسوبك والانضمام بالسيرفر عبر المنفذ 7778 لمزامنة المودات واللعب فوراً.

your-server-ip:7778

المنافذ المستخدمة

المنفذالغرض
7778tModLoader server (mapped from Terrarias default port 7777)

نظرة عامة

يعد tModLoader (TML) المحرك الرسمي مفتوح المصدر لتشغيل مودات لعبة البناء والمغامرات الشهيرة Terraria. يعمل الخادم المخصص عبر منفذ TCP 7778 (المحول من 7777 الداخلي لتجنب التعارض مع سيرفرات Terraria الأصلية)، ليتيح لمجتمعات اللاعبين خوض مغامرات جماعية في عوالم معدلة بأضخم المودات العالمية مثل Calamity Mod وThorium وMagic Storage وFargo's Mod. ويقوم السيرفر بتنزيل المودات تلقائياً من Steam Workshop، ومزامنتها مع أجهزة اللاعبين المنضمين، وحفظ العوالم المعدلة 24/7.

لماذا تستخدمه

تتسبب استضافة المودات الضخمة (مثل Calamity Mod) عبر جهاز اللاعب المضيف في هبوط حاد بمعدل الإطارات (FPS)، وتسريب للذاكرة، وتقطع مقذوفات الزعماء أثناء المعارك الشرسة، فضلاً عن انقطاع السيرفر فور إغلاق المضيف للعبة. يمنحك سيرفر tModLoader المخصص على Ubuntu قوة معالجة عالية تمنع التقطيع، ويتيح لأصدقائك مواصلة البناء وتطوير الشخصيات في أي وقت على مدار الساعة.

متى تحتاجه

  • تريد أنت وأصدقاؤك خوض تجربة Terraria بمودات عملاقة شاملة (مثل Calamity وThorium وStars Above)
  • تحتاج إلى عالم معدل دائم يعمل 24/7 يتيح للاعبين البناء والتعدين دون انتظار تشغيل المضيف لحاسوبه
  • تريد تنزيل وتحديث المودات تلقائياً من متجر Steam Workshop مباشرة بالسيرفر
  • تعاني من بطء وتقطع في اللعب التعاوني عند قتال الزعماء في المودات الثقيلة عبر اتصال P2P المباشر
  • تريد تفعيل مودات إدارة الصناديق المشتركة وصناعة الأدوات (مثل Magic Storage وRecipe Browser) بالسيرفر

من يحتاجه

  • عشاق ومحترفو لعبة Terraria لخوض تحديات مود Calamity وصعوبات Infernum الشاقة
  • قادة مجتمعات الألعاب والكلانات لاستضافة خوادم Terraria معدلة عامة أو خاصة للأعضاء
  • مطورو ومبرمجو المودات لاختبار التوافقية البرمجية للمودات المكتوبة بلغة C# مع اللعب الجماعي
  • أصحاب السيرفرات المنزلية لتوسيع خوادم الألعاب بجانب Minecraft وPalworld على أنظمة لينكس
  • صناع المحتوى لتسجيل مغامرات اللعب التعاوني مع ميزة النسخ الاحتياطي التلقائي للعوالم المعدلة

حالات الاستخدام الشائعة

  • استضافة حملة لعب تعاونية لـ 6 لاعبين بمود Calamity وMagic Storage مع حلبات قتال دائمة للزعماء
  • مزامنة أكثر من 15 موداً من Steam Workshop تلقائياً مع أجهزة اللاعبين فور اتصالهم بالسيرفر
  • أتمتة سكريبت نسخ احتياطي يومي لملفات العوالم المعدلة `.twld` و`.wld` لحمايتها من التلف
  • تشغيل تحديات Fargo's Soul Mod مع Calamity على معالجات سيرفر Ubuntu عالية التردد
  • إدارة أوامر السيرفر الحية (حفظ، تعديل الوقت، طرد اللاعبين) من خلال طرفية Docker

الميزات الرئيسية

  • تكامل مع Steam Workshop: تنزيل وتحديث المودات المذكورة في ملف `enabled.json` تلقائياً
  • دعم المودات الشاملة: تشغيل مودات Calamity وThorium وMagic Storage معاً بتوافق كامل
  • عزل المنافذ على المنفذ 7778: إمكانية تشغيل سيرفر Terraria الأصلي وسيرفر المودات معاً على نفس الجهاز
  • مزامنة آلية للمودات: إشعار عميل اللعبة بنسخ المودات المطلوبة وتنزيلها تلقائياً عند الاتصال
  • محرك 64-بت بـ .NET محسّن: معالجة متطورة للذاكرة تتيح تشغيل حزم مودات تتطلب أكثر من 4 جيجابايت RAM
  • كونسول إداري مباشر: تنفيذ أوامر السيرفر (`save`, `settle`, `say`, `kick`, `ban`) عبر الطرفية
  • توافق كامل مع مختلف الأنظمة: دعم انضمام اللاعبين من أجهزة Windows وmacOS ولينكس
  • معمارية Docker Compose تجمع tModLoader مع ربط مجلدات `./mods` و`./worlds` و`./config`

كيفية الاستخدام بعد التثبيت

  • أضف معرّفات مودات Steam Workshop التي تريدها داخل ملف `./mods/enabled.json` (مثل CalamityMod)
  • أعد تشغيل الحاوية لتنزيل وبناء المودات تلقائياً: `docker compose restart`
  • شغل برنامج tModLoader على حاسوبك من Steam، واضغط Multiplayer ← Join via IP
  • اكتب IP سيرفرك والمنفذ 7778، وأدخل كلمة المرور ووافق على تنزيل المودات
  • لتنفيذ أوامر المشرف، اتصل بكونسول الحاوية: `docker attach tmodloader` (واخرج بأمان بـ `Ctrl+P` ثم `Ctrl+Q`)
  • أعد سكريبت نسخ احتياطي دوري لمجلدي العوالم والمودات `./worlds` و`./mods`

أفضل ممارسات الأمان

  • تنبيه أمني حاسم: عيّن كلمة مرور قوية للسيرفر في `serverconfig.txt` لمنع دخول اللاعبين غير المصرح لهم
  • لا توقف السيرفر بالقوة عبر `docker kill`؛ نفذ دائماً أمر `save` ثم `exit` لتجنب تلف ملفات المودات `.twld`
  • تأكد من استخدام كافة اللاعبين لنفس إصدار tModLoader الرئيسي (مثل v1.4.4-stable)
  • احمِ مجلدات العوالم والمودات بصلاحيات نظام مناسبة بالسيرفر
  • اضبط جدار الحماية الخارجي وقواعد الحماية ضد هجمات حجب الخدمة (DDoS)
  • حدّث صورة الحاوية دورياً لتطابق أحدث إصدارات tModLoader على Steam

المنافذ وإعدادات جدار الحماية

يستخدم سيرفر tModLoader منفذ TCP 7778 (المحول من منفذ 7777 الداخلي). اسمح بمنفذ TCP 7778 في جدار الحماية الخارجي للسيرفر (`ufw allow 7778/tcp`). وتأكد من توجيه المنفذ في إعدادات الراوتر أو مجموعات الأمان السحابية.

النسخ الاحتياطي والصيانة

  • انسخ مجلد `./worlds` احتياطياً، والذي يحتوي على ملفات العالم `.wld` وملفات كائنات المودات `.twld`
  • انسخ ملف `./mods/enabled.json` الذي يحتوي على قائمة معرّفات المودات المفعلة
  • انسخ ملف `./config/serverconfig.txt` الذي يحتوي على إعدادات السيرفر والصعوبة
  • أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
  • اختبر الاستعادة بربط مجلد العوالم بحاوية تجريبية للتأكد من تحميل كافة كتل المودات بنجاح

الأخطاء الشائعة

  • إيقاف الحاوية عبر `docker kill` دون حفظ العالم مما يسبب تلفاً جسيماً في ملفات بيانات المودات `.twld`
  • محاولة الاتصال بلعبة Terraria العادية بدلاً من تشغيل تطبيق tModLoader المخصص على Steam
  • محاولة تشغيل أكثر من 20 موداً ثقيلاً على سيرفر بذاكرة RAM قليلة (حيث يتطلب السيرفر من 4 إلى 8 جيجابايت RAM)
  • عدم ربط مجلدي التخزين الدائم، مما يسبب فقدان المودات وتقدم العوالم عند تحديث الحاوية
  • نسيان فتح منفذ TCP 7778 في جدار الحماية مما يمنع اللاعبين من الاتصال بالسيرفر

استكشاف الأخطاء وإصلاحها

  • ظهور خطأ عدم تطابق إصدار المود (Mod Version Mismatch) — حدّث المودات بالسيرفر (`docker compose restart`) وبالعميل
  • انهيار السيرفر بسبب نفاد الذاكرة — خصص على الأقل 4 إلى 8 جيجابايت RAM للحاوية
  • فشل اتصال اللاعبين — تأكد من فتح منفذ TCP 7778 في جدار الحماية (`ufw status`) وتوجيهه بالراوتر
  • تلف العالم بعد انهيار مفاجئ — استرجع النسخ الاحتياطية `.twld.bak` و`.wld.bak` من مجلد `./worlds`
  • انقطاع السيرفر عند الخروج من الطرفية — استخدم `Ctrl+P` ثم `Ctrl+Q` للخروج من Docker Attach دون إيقاف العملية

البدائل

سيرفر Terraria الرسمي بدون مودات. إطار TShock لإضافات اللعبة الأصلية. سيرفر Minecraft مع مودات Forge أو Fabric. سيرفر Starbound المعدل. سيرفر Valheim مع مودات BepInEx.

متى لا تستخدمه

تجنب استخدام tModLoader إذا كنت تريد فقط لعب النسخة الأصلية القياسية بدون مودات (حيث يعد سيرفر Terraria العادي على المنفذ 7777 أخف بكثير وأبسط). وإذا كنت تريد فقط إضافات إدارية لسيرفر عام دون إجبار اللاعبين على تنزيل مودات خارجية، فإن سيرفر TShock مخصص للعملاء الأصليين.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

الأسئلة الشائعة

ما الفرق بين لعبة Terraria وبرنامج tModLoader؟

Terraria هي اللعبة الأصلية الرسمية، بينما tModLoader هو محرك المودات الرسمي المستقل (متاح مجاناً على Steam) الذي يتيح للعبة تحميل وتشغيل مودات المجتمع الضخمة مثل Calamity وThorium وMagic Storage.

لماذا تم تعيين المنفذ الافتراضي كـ 7778 بدلاً من 7777؟

تم اختيار المنفذ 7778 لتتمكن من تشغيل سيرفر Terraria الأصلي (على منفذ 7777) وسيرفر المودات tModLoader (على منفذ 7778) معاً على نفس سيرفر Ubuntu دون أي تعارض في المنافذ.

هل يحتاج اللاعبون المنضمون لتنزيل المودات يدوياً مسبقاً؟

لا! عند اتصال اللاعب بسيرفر tModLoader الخاص بك، يكتشف عميل اللعبة قائمة وإصدارات المودات المفعلة بالسيرفر تلقائياً ويقوم بتنزيلها من Steam Workshop آلياً.

هل يمكن تشغيل مود Calamity Mod على هذا السيرفر؟

نعم! يعد مود Calamity أحد أشهر أسباب تشغيل سيرفرات tModLoader. ما عليك سوى وضع معرّف المود في ملف `enabled.json` ليقوم السيرفر بتنزيله وتشغيله تلقائياً.

كم يحتاج سيرفر tModLoader المعدل من الذاكرة العشوائية (RAM)؟

بينما تكتفي حزم المودات البسيطة بـ 2 جيجابايت، تتطلب حزم المودات الشاملة مثل Calamity Mod مع المودات المساعدة تخصيص 4 إلى 8 جيجابايت من الذاكرة العشوائية داخل Docker لضمان استقرار المعارك.