تثبيت إضافات Valheim باستخدام BepInEx - خطوة بخطوة

باستخدام BepInEx يمكنك توسيع خوادم Valheim بإضافات، إذا كانت ملفات الخادم وإضافات العميل والإصدارات متطابقة بشكل صحيح. الأمر الحاسم ليس مجرد نسخ ملف DLL، بل اتباع سير عمل مضبوط: تثبيت الإطار، تشغيل الخادم مرة واحدة، إضافة الإضافات بشكل محدد، مطابقة العملاء، ثم تضييق نطاق الأخطاء عبر السجلات أو تعطيل الإضافات تدريجيًا.

ماذا يفعل BepInEx في Valheim

BepInEx هو إطار إضافات لألعاب Unity. بالنسبة إلى Valheim يُستخدم غالبًا BepInExPack Valheim المتوفر على Thunderstore: التوثيق على thunderstore.io. صفحة المشروع هذه هي المصدر الأساسي لحزمة Valheim-BepInEx المذكورة تحديدًا.

يوفر BepInEx المجلدات التي يتم فيها تحميل إضافات Valheim وتهيئتها. تتكون كثير من الإضافات من ملف DLL واحد أو أكثر يجب أن تكون داخل BepInEx/plugins/. بعد أول تشغيل للخادم، يتم عادة إنشاء ملفات إعدادات إضافية في BepInEx/config/. لا تعدّل هذه الملفات إلا بعد تشغيل الخادم مرة واحدة على الأقل مع تثبيت الإطار.

إذا كنت تريد، إلى جانب الإضافات، التخطيط لأساسيات الخادم والإعدادات وتقدم الزعماء بشكل منظم، فالدليل الداخلي استئجار خادم Valheim: الإضافات، الإعدادات وترتيب الزعماء 2026 مناسب كمرجع إضافي. ولإعدادات Unity أو أطر الإضافات الأخرى، يفيد أيضًا الاطلاع على المقارنة مع تثبيت إضافات V Rising باستخدام إضافات خادم BepInEx.

المتطلبات

قبل أن تبدأ، تحتاج إلى وصول إلى مجلد خادم Valheim، وإمكانية إعادة تشغيل الخادم، وقائمة إضافات واضحة. في استضافة ألعاب متعددة مدفوعة مثل game-serverhosting، من المهم بشكل خاص أن تُدخل التغييرات بطريقة قابلة للتتبع: أولًا نسخة احتياطية، ثم الإطار، ثم الإضافات واحدة تلو الأخرى، وبعدها التحقق. هكذا تبقى السيطرة التقنية، وقابلية الدعم، وسير التشغيل الشفاف محفوظة.

حدّد أيضًا أي الإضافات تعمل من جهة الخادم فقط، وأيها يجب على كل لاعب تثبيتها محليًا. كثير من إضافات Valheim تحتاج إلى مكونات مناسبة على الخادم والعميل؛ والعامل الحاسم هو التصنيف الموجود في صفحة كل إضافة. لذلك افحص وصف Thunderstore الخاص بكل إضافة قبل إدخالها في حزمة إضافات مشتركة.

تثبيت BepInEx على الخادم

1. نزّل BepInEx من Thunderstore.
2. فك ضغط المحتوى داخل مجلد خادم Valheim.
3. أعد تشغيل الخادم. ينشئ BepInEx مجلدات الإعدادات تلقائيًا.

بعد ذلك يجب أن تبدو بنية الهدف هكذا:

/valheim/
├── BepInEx/
│   ├── config/          # إعدادات الإضافات
│   ├── plugins/         # ضع الإضافات هنا
│   └── patchers/
├── valheim_server.x86_64
└── start_server.sh

المستوى مهم: يجب أن يكون مجلد BepInEx/ مباشرة داخل مجلد خادم Valheim، وليس داخل مجلد فرعي إضافي من أرشيف ZIP. إذا لم تظهر بنية config أو plugins بعد إعادة التشغيل، فغالبًا يكون الخطأ هناك بالضبط.

تثبيت الإضافات

1. نزّل الإضافات من Thunderstore.
2. فك ضغط ملف DLL داخل المجلد BepInEx/plugins/.
3. أعد تشغيل الخادم.

لا تثبّت الإضافات الجديدة عشوائيًا في حزم كبيرة. الأفضل اتباع نهج مضبوط: أضف إضافة واحدة، شغّل الخادم، افحص السجل، اختبر الاتصال، ثم ثبّت الإضافة التالية فقط. عند وجود عدة لاعبين، ينبغي توثيق قائمة الإضافات مع أرقام الإصدارات حتى يستخدم الجميع نفس الأساس.

إذا كانت الإضافة تجلب معها ملفات إضافية أو مجلدات خاصة بها، فاتبع تعليمات الإضافة نفسها. ليست كل إضافة مجرد ملف DLL واحد. لا تنقل ملفات الإعدادات عشوائيًا بين plugins وconfig؛ فـ BepInEx والإضافة نفسها يتوقعان مسارات محددة.

مطابقة إضافات العميل

معظم إضافات Valheim يجب أن تكون مثبتة على الخادم وعلى العميل معًا. استخدم Thunderstore Mod Manager لتثبيت العميل بسهولة.

بدلًا من ذلك يمكنك استخدام r2modman:

1. ثبّت r2modman.
2. اختر "Valheim" كلعبة.
3. تصفح الإضافات وثبّتها بنقرة واحدة.
4. صدّر حزمة إضافاتك كرمز → شاركها مع الأصدقاء.

الميزة العملية لمدير الإضافات تكمن في المطابقة: يستطيع كل اللاعبين استخدام نفس الملف الشخصي بدل البحث يدويًا عن ملفات DLL. رغم ذلك، ينبغي أن تبقى حذرًا بعد التحديثات. قد تصبح إضافة عميل محدثة غير متوافقة مع إضافة خادم أقدم. لذلك سجّل متى غيّرت حزمة الإضافات وأي الإصدارات نشطة.

إضافات موصى بها

يعرض الجدول التالي أمثلة شائعة؛ افحص كل إضافة قبل التثبيت من حيث الحداثة والاعتماديات. هذا ليس وعدًا بالأداء ولا يغني عن فحص صفحة الإضافة المعنية للتوافق والحداثة والاعتماديات المطلوبة.

التحقق من النتيجة

بعد التثبيت، يجب أن يبدأ الخادم دون انهيار. افحص أولًا ما إذا كان BepInEx يتم تحميله في السجل، وما إذا كانت هناك رسائل خطأ حول اعتماديات مفقودة أو إصدارات خاطئة أو ملفات DLL غير موجودة. بعد ذلك اختبر بعميل يستخدم نفس اختيار الإضافات.

داخل اللعبة، ينبغي أن تختبر بشكل محدد وظيفة من كل إضافة مثبتة: هل تغيير الواجهة ظاهر، هل خيار إعداد جديد فعّال، هل يوجد عنصر جديد، أو هل السلوك المتوقع نشط. إذا كان كل شيء يعمل، احفظ قائمة الإضافات العاملة وأهم ملفات الإعدادات. هكذا يمكنك تتبع التغييرات اللاحقة أو الرجوع عند حدوث مشاكل.

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

الإضافة لا تعمل

افحص أولًا إصدار BepInEx وإصدار الإضافة وتوافق الإضافة. تحقق أيضًا مما إذا كان ملف DLL موجودًا فعلًا في BepInEx/plugins/ وليس بالخطأ داخل مجلد فرعي ناتج عن فك ضغط مزدوج. اقرأ صفحة الإضافة على Thunderstore، لأن كثيرًا من الإضافات تحتاج إلى اعتماديات إضافية.

الخادم انهار

أزل الإضافات واحدة تلو الأخرى للعثور على السبب. ابدأ بآخر إضافة تم تثبيتها أو تحديثها. أعد تشغيل الخادم بعد كل تغيير وافحص السجل. إذا كان الخادم يبدأ دون إضافات، لكنه ينهار مع إضافة معينة، فغالبًا تكون الاعتمادية أو الإصدار أو الإعدادات هي السبب.

مشاكل عدم التزامن أو الاتصال

تأكد من أن جميع اللاعبين لديهم نفس الإضافات بإصدارات مناسبة. خصوصًا مع الإضافات المطلوبة على العميل، لا يكفي تغيير الخادم فقط. يقلل ملف r2modman أو Thunderstore المصدّر من الاختلافات ويجعل حالات الدعم أسهل في التتبع.

لا يتم إنشاء الإعدادات

شغّل الخادم مرة واحدة مع تثبيت BepInEx والإضافة المعنية. كثير من الإضافات تكتب إعداداتها فقط عند أول تحميل ناجح. إذا لم يظهر أي ملف بعد ذلك، فقد لا تكون الإضافة قد تم تحميلها، أو أنها في المجلد الخطأ، أو غير متوافقة مع البيئة الحالية.

الفحص، الحدود وطريق الرجوع الآمن

ينطبق دليل „Valheim Mods mit BepInEx installieren – Schritt für Schritt“ على نوع الخادم الموصوف في المقالة وعلى حالة الإصدارات الظاهرة وقت الفحص. قد تختلف أسماء القوائم، والإصدارات المتاحة، وتوافق الإضافات أو المكونات الإضافية، والموارد المطلوبة بعد التحديثات. لذلك لا تنقل أي قيم دون فحص إلى إصدار لعبة أو Loader أو خادم آخر.

أنشئ نسخة احتياطية من الملفات المتأثرة قبل إجراء تغييرات على العالم أو ملف الحفظ أو الإعدادات أو التوسعات. بعد ذلك غيّر خطوة واحدة مترابطة فقط وافحصها بنفس إصدار العميل والخادم الذي تريد اللعب به لاحقًا.

الاختبار الفردي الناجح ليس ضمانًا للأداء أو التوفر. يمكن أن تغيّر حجم العالم، والإضافات، والمكونات الإضافية، وعدد اللاعبين، ومسار الشبكة، والحمل المتزامن النتيجة. وثّق الإصدار والتغيير ونتيجة الاختبار حتى تتمكن من تتبع الانحرافات لاحقًا.

FAQ

هل يجب تثبيت BepInEx على الخادم والعميل؟

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

هل يمكنني تثبيت إضافات Valheim عبر Thunderstore فقط؟

لا، يمكنك أيضًا وضع ملفات DLL يدويًا في BepInEx/plugins/. لكن Thunderstore Mod Manager وr2modman يسهّلان مطابقة الإصدارات وتوزيعها على اللاعبين الآخرين.

لماذا لم يعد الخادم يبدأ بعد إضافة معينة؟

الأسباب الشائعة هي إصدارات BepInEx خاطئة، أو اعتماديات مفقودة، أو إصدارات إضافات غير متوافقة، أو ملفات في المجلد الخطأ. أزل الإضافات تدريجيًا وافحص السجل بعد كل إعادة تشغيل.

أين توجد إعدادات الإضافات؟

تنشئ كثير من إضافات BepInEx إعداداتها في BepInEx/config/. غالبًا لا تظهر الملفات إلا بعد أول تشغيل ناجح للخادم مع تثبيت الإضافة.

هل ينبغي أن أثبّت كل الإضافات في الوقت نفسه؟

الأفضل ألا تفعل ذلك. ثبّت الإضافات واحدة تلو الأخرى أو في مجموعات صغيرة، حتى تتمكن من ربط الأخطاء بوضوح. هذا يوفر الوقت إذا انهار الخادم أو لم يتمكن العملاء من الاتصال.