يغطي هذا الدليل كيفية إعداد خادم Portal Knights المخصص على Legion Hosting، وتكوين متغيرات بدء التشغيل، وضبط إعدادات الخادم، والاتصال مع الأصدقاء، وإدارة حفظ العوالم. لأوامر الإدارة وإدارة اللاعبين، راجع أوامر إدارة Portal Knights.

1. البدء لأول مرة

1. سجّل الدخول إلى GPanel واختر خادم Portal Knights الخاص بك.
2. انتقل إلى علامة التبويب Startup وراجع المتغيرات المتاحة (انظر الجدول أدناه).
3. عيّن SERVER_NAME حتى تتمكن من تحديد خادمك في المتصفح.
4. غيّر ADMIN_PASS من القيمة الافتراضية. اختياريًا عيّن USER_PASS أو GUEST_PASS لتقييد الوصول إلى مجموعتك.
5. عُد إلى علامة التبويب Console وانقر على Start.
6. انتظر حتى تشير وحدة التحكم إلى أن الخادم قد انتهى من التحميل. سيُنشئ البدء الأول ملفات التكوين الافتراضية وعالمًا جديدًا.

2. متغيرات بدء التشغيل في GPanel

المتغيرات التالية متاحة في علامة التبويب Startup في GPanel. يتم تطبيق هذه القيم في كل مرة يبدأ فيها الخادم.

3. تكوين الخادم

بالإضافة إلى متغيرات بدء التشغيل، يتيح Portal Knights الضبط الدقيق من خلال ملف تكوين الخادم. أوقف خادمك قبل إجراء التغييرات.

موقع ملف التكوين

dedicated_server/server_config.json

افتح هذا الملف باستخدام علامة التبويب Files في GPanel أو اتصل عبر SFTP. إذا لم يكن الملف موجودًا، ابدأ الخادم وأوقفه مرة واحدة لإنشائه بالقيم الافتراضية.

الإعدادات الرئيسية

يستخدم ملف التكوين تنسيق JSON. تشمل الخصائص الرئيسية:

مثال على التكوين

{
  "basicServerData": {
    "name": "My Portal Knights Server",
    "ipv4": "0.0.0.0",
    "port": 27015,
    "saveFolderPath": "./savedata"
  },
  "admins": {
    "credentials": {
      "password": "my_admin_password"
    }
  },
  "users": {
    "credentials": {
      "password": ""
    }
  },
  "guests": {
    "credentials": {
      "password": ""
    }
  },
  "gameplayMode": "Adventure",
  "universeSize": "Normal",
  "hideConsoleWindow": true
}

4. إعدادات العالم

تتكون عوالم Portal Knights من جزر مُولَّدة إجرائيًا متصلة ببوابات. اعتبارات رئيسية متعلقة بالعالم:

• مجلد الحفظ: تُخزَّن بيانات العالم في مجلد savedata (يُكوَّن عبر basicServerData.saveFolderPath في ملف التكوين).
• وضع اللعب: يُعيَّن عبر متغير بدء التشغيل GAMEMODE. Adventure هو تجربة RPG القياسية؛ Creative يتيح البناء والاستكشاف الحر.
• حجم الكون: يُعيَّن عبر متغير بدء التشغيل UNIVERSE_SIZE. يتحكم في عدد الجزر: Small أو Normal أو Large.
• تقدم الجزر: يتقدم اللاعبون عبر الجزر من خلال جمع شظايا البوابات وتنشيط البوابات. يتتبع الخادم جميع الجزر المكتشفة وحالاتها.

5. كيفية الاتصال

الخيار أ -- متصفح الخوادم داخل اللعبة

1. شغّل Portal Knights عبر Steam.
2. من القائمة الرئيسية، اختر Multiplayer.
3. اختر Online Game ثم Browse Servers.
4. ابحث عن خادمك بالاسم أو تصفح القائمة.
5. اختر خادمك وانقر على Join. أدخل كلمة المرور إذا طُلب منك.

الخيار ب -- الاتصال المباشر عبر IP

1. شغّل Portal Knights عبر Steam.
2. من القائمة الرئيسية، اختر Multiplayer.
3. اختر Online Game ثم Direct Connect.
4. أدخل عنوان IP الخادم والمنفذ من علامة التبويب Network في GPanel:

   <your-server-ip>:<port>

5. أدخل كلمة مرور الخادم إذا تم تعيين واحدة.

6. إدارة الحفظ

موقع ملفات الحفظ

تُخزَّن حفظات العالم على الخادم في:

dedicated_server/savedata/

يُكوَّن هذا المسار عبر إعداد basicServerData.saveFolderPath في server_config.json.

النسخ الاحتياطي اليدوي عبر SFTP

1. أوقف الخادم من GPanel لضمان كتابة جميع البيانات على القرص.
2. اتصل بخادمك عبر SFTP. راجع كيفية رفع الملفات عبر SFTP للتعليمات.
3. انتقل إلى مجلد dedicated_server/savedata/.
4. حمّل مجلد العالم بالكامل الذي تريد نسخه احتياطيًا.

استعادة حفظ

1. أوقف الخادم من GPanel.
2. اتصل عبر SFTP وانتقل إلى dedicated_server/savedata/.
3. ارفع مجلد العالم المحفوظ احتياطيًا، مع استبدال الموجود إذا لزم الأمر.
4. تأكد من أن اسم المجلد يطابق إعداد world_name في التكوين الخاص بك.
5. ابدأ الخادم من GPanel.

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

• الخادم لا يظهر في المتصفح: تأكد من أن الخادم قد بدأ بالكامل في GPanel. قد يستغرق متصفح الخوادم من 2 إلى 3 دقائق لفهرسة خادم جديد. جرّب الاتصال المباشر عبر IP في هذه الأثناء.
• لا يمكن الاتصال: تحقق من عنوان IP الخادم والمنفذ في علامة التبويب Network في GPanel. تأكد من أن الخادم يعمل وليس في حالة تعطل.
• تعطل عند بدء التشغيل: احذف ملف التكوين وأعد التشغيل لإعادة إنشاء القيم الافتراضية. إذا استمرت المشكلة، تحقق من وحدة تحكم GPanel لرسائل الخطأ.
• العالم لا يُحمَّل: تأكد من أن إعداد basicServerData.saveFolderPath في server_config.json يشير إلى المجلد الصحيح.

مقالات ذات صلة

• أوامر إدارة Portal Knights
• كيفية إيجاد عنوان IP الخادم والمنفذ
• كيفية رفع الملفات عبر SFTP
• دليل بدء تشغيل الخادم

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

إذا واجهت مشاكل غير مذكورة هنا، افتح تذكرة دعم وأرفق عنوان IP الخادم ووصفًا للمشكلة وأي رسائل خطأ من وحدة تحكم GPanel.