دليل إعداد خادم Vintage Story

يغطي هذا الدليل كيفية إعداد وتكوين خادم Vintage Story المخصص المستضاف مع Legion Hosting، بما في ذلك التشغيل الأول، متغيرات GPanel، إدارة الإصدارات، تكوين الخادم، إعدادات العالم، توصيل اللاعبين، وإدارة الحفظ. لتثبيت المودات، راجع تثبيت مودات Vintage Story. لإعداد المشرف والأوامر، راجع أوامر المشرف في Vintage Story.

قبل البدء: تأكد من إنشاء خادمك في GPanel. إذا كنت بحاجة إلى مساعدة في العثور على عنوان IP ومنفذ الخادم، راجع كيفية العثور على عنوان IP ومنفذ الخادم.

التشغيل الأول

عند تشغيل خادم Vintage Story لأول مرة من GPanel، سيقوم الخادم تلقائيًا بتنزيل ملفات اللعبة من واجهة برمجة تطبيقات Vintage Story الرسمية وإنشاء عالم افتراضي. قد يستغرق هذا التشغيل الأولي عدة دقائق أثناء تنزيل الملفات واستخراجها.

سجّل الدخول إلى GPanel واختر خادم Vintage Story الخاص بك.
قبل التشغيل، راجع تبويب Startup لتأكيد فرع الإصدار المفضل لديك (stable أو unstable أو pre-release).
انقر على Start في تبويب Console. راقب مخرجات وحدة التحكم لمتابعة رسائل التقدم أثناء تنزيل الخادم وتثبيت ملفات اللعبة.
بمجرد ظهور رسالة تشير إلى أن الخادم يستمع للاتصالات، يكون الخادم جاهزًا. سيتم إنشاء ملف serverconfig.json افتراضي تلقائيًا.

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

متغيرات التشغيل في GPanel

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

المتغير	القيمة الافتراضية	الوصف
`SERVER_PORT`	(مُعيَّن)	منفذ اللعبة الذي يستخدمه اللاعبون للاتصال. يتم تعيينه تلقائيًا بواسطة GPanel -- تحقق من تبويب Network للمنفذ المعين لك.
`MAX_CLIENTS`	`16`	الحد الأقصى لعدد اللاعبين المتزامنين. يمكن تعيينه حتى 256. يجب أن يتوافق مع موارد خطة الاستضافة الخاصة بك.
`FILES_BRANCH`	`stable`	فرع الإصدار المستخدم. الخيارات: `stable` أو `unstable` أو `pre`. راجع قسم إدارة الإصدارات أدناه للتفاصيل.
`RELEASE_VERSION`	`latest`	الإصدار المحدد المراد تثبيته. اضبطه على `latest` لاستخدام أحدث إصدار دائمًا على الفرع المختار، أو أدخل رقم إصدار محدد (مثل `1.19.8`) لتثبيت ذلك الإصدار.
`OPTIONS`	(فارغ)	وسائط سطر الأوامر الإضافية التي تُمرر إلى عملية الخادم عند التشغيل. اتركه فارغًا ما لم تحتاج إلى علامات تشغيل محددة.
`SQLITE_TMPDIR`	(تلقائي)	الدليل المؤقت الذي يستخدمه SQLite لعمليات قاعدة البيانات. عادةً لا يحتاج إلى تغيير.

بعد تحديث متغيرات التشغيل، أعد تشغيل الخادم من GPanel لتطبيق التغييرات.

إدارة الإصدارات

يقدم Vintage Story ثلاثة فروع إصدار. يتم تعيين اختيارك للفرع عبر متغير التشغيل FILES_BRANCH في GPanel.

الفرع	القيمة	الوصف
Stable	`stable`	الفرع الموصى به لمعظم الخوادم. تم اختبار هذه الإصدارات بدقة وهي الأكثر موثوقية للعوالم طويلة المدى.
Unstable	`unstable`	إصدارات تجريبية تحتوي على ميزات وتغييرات جديدة لا تزال قيد الاختبار. قد تحتوي على أخطاء. استخدم هذا إذا كنت تريد الوصول المبكر للمحتوى الجديد وتقبل بعض عدم الاستقرار.
Pre-release	`pre`	بنيات التطوير المبكرة. هذه الأقل اختبارًا وقد تحتوي على مشاكل كبيرة. يوصى بها فقط لأغراض الاختبار -- وليس لخوادم الإنتاج.

تثبيت إصدار محدد

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

انتقل إلى تبويب Startup في GPanel.
غيّر RELEASE_VERSION من latest إلى رقم الإصدار الدقيق الذي تريده (مثل 1.19.8).
أعد تشغيل الخادم. سيستخدم الإصدار المثبت فقط بغض النظر عن الإصدارات الأحدث.

توافق المودات: إذا كنت تستخدم مودات، يوصى بتثبيت إصدار محدد. يمكن لتحديثات اللعبة أن تعطل توافق المودات، والتحديث أثناء اللعب يمكن أن يسبب مشاكل. تحقق من أن المودات الخاصة بك تدعم الإصدار المستهدف قبل التحديث. راجع تثبيت مودات Vintage Story للتفاصيل.

قد يتطلب تبديل الفروع إعادة تعيين العالم. يمكن أن يؤدي الانتقال بين فرعي stable و unstable إلى تغييرات في تنسيق العالم. قم دائمًا بعمل نسخة احتياطية من عالمك قبل تغيير الفروع. إذا كان الإصدار الجديد غير متوافق مع عالمك الحالي، فقد تحتاج إلى بدء عالم جديد.

serverconfig.json

ملف تكوين الخادم الرئيسي هو serverconfig.json، الموجود في الدليل الجذر للخادم. يتم إنشاء هذا الملف تلقائيًا عند التشغيل الأول. أوقف الخادم قبل تعديله، ثم أعد التشغيل لتطبيق التغييرات.

أوقف الخادم من تبويب Console في GPanel.
افتح تبويب Files وانقر على serverconfig.json لتعديله.
عدّل الإعدادات التي تحتاجها (راجع الجدول أدناه).
احفظ الملف وشغّل الخادم.

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

الإعداد	قيمة مثال	الوصف
`ServerName`	`"My Legion VS Server"`	الاسم المعروض في متصفح الخوادم داخل اللعبة. اجعله وصفيًا حتى يتمكن اللاعبون من العثور على خادمك.
`WelcomeMessage`	`"Welcome to the server!"`	الرسالة المعروضة للاعبين عند انضمامهم. تدعم التنسيق الأساسي.
`MaxClients`	`16`	الحد الأقصى لعدد اللاعبين المتزامنين. يجب أن يتطابق مع متغير التشغيل `MAX_CLIENTS`.
`Password`	`"mysecretpass"`	كلمة المرور المطلوبة للانضمام إلى الخادم. اتركها كسلسلة فارغة (`""`) لخادم عام.
`AllowPvP`	`true`	اضبطها على `true` لتمكين قتال لاعب ضد لاعب، أو `false` لخادم PvE فقط.
`SpawnRadius`	`50`	نصف القطر (بالكتل) حول نقطة ظهور العالم حيث يمكن للاعبين الجدد الظهور. القيمة الأكبر توزع اللاعبين أكثر عند الانضمام.
`MapSizeX`	`1024000`	عرض العالم بالكتل. القيمة الافتراضية تنشئ عالمًا كبيرًا جدًا. تقليل هذه القيمة يحد من مدى سفر اللاعبين شرقًا وغربًا.
`MapSizeZ`	`1024000`	عمق العالم بالكتل. القيمة الافتراضية تنشئ عالمًا كبيرًا جدًا. تقليل هذه القيمة يحد من مدى سفر اللاعبين شمالًا وجنوبًا.
`WorldSeed`	`"myseed123"`	البذرة المستخدمة لتوليد العالم. نفس البذرة تنتج نفس العالم. اتركها كسلسلة فارغة لبذرة عشوائية.

مثال بسيط للإعدادات الرئيسية في serverconfig.json:

{
  "ServerName": "My Legion VS Server",
  "WelcomeMessage": "Welcome! Enjoy your stay.",
  "MaxClients": 16,
  "Password": "",
  "AllowPvP": true,
  "SpawnRadius": 50,
  "MapSizeX": 1024000,
  "MapSizeZ": 1024000,
  "WorldSeed": ""
}

يجب أن يكون الملف بتنسيق JSON صالح. تأكد من أن جميع السلاسل النصية محاطة بعلامات اقتباس مزدوجة، والقيم المنطقية بأحرف صغيرة (true/false)، وعدم وجود فواصل زائدة بعد العنصر الأخير في كائن أو مصفوفة. إذا فشل الخادم في التشغيل بعد التعديل، تحقق من أخطاء صياغة JSON.

تكوين العالم

يقوم Vintage Story بتوليد عالمه بناءً على الإعدادات في serverconfig.json. يحدث توليد العالم فقط عند التشغيل الأول بعالم معين -- تغيير إعدادات التوليد بعد إنشاء العالم لن يغير التضاريس الموجودة بأثر رجعي.

إعدادات توليد العالم

WorldSeed: تحدد تخطيط التضاريس وتوزيع المناطق الحيوية والموارد. عيّن بذرة محددة لمشاركة نفس تخطيط العالم مع الآخرين، أو اتركها فارغة لعالم يتم توليده عشوائيًا.
MapSizeX / MapSizeZ: تتحكم في المساحة القابلة للعب القصوى. القيم الأصغر تنشئ عالمًا أكثر تحديدًا ويمكن أن تقلل استخدام الموارد. اللاعبون الذين يصلون إلى حافة الخريطة لن يتمكنوا من السفر أبعد في ذلك الاتجاه.
WorldConfig: يتيح لك كائن WorldConfig ضمن serverconfig.json ضبط معلمات توليد العالم بدقة مثل مقياس التضاريس وأنماط المناخ والميزات الجيولوجية. هذه إعدادات متقدمة -- القيم الافتراضية تعمل بشكل جيد لمعظم الخوادم.

إعدادات توليد العالم مقفلة بعد الإنشاء. إعدادات مثل WorldSeed و MapSizeX و MapSizeZ تسري فقط عند توليد العالم لأول مرة. لتطبيق إعدادات توليد جديدة، يجب إنشاء عالم جديد (راجع إدارة الحفظ أدناه).

اختيار بذرة

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

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

يتصل اللاعبون بخادم Vintage Story الخاص بك من خلال قائمة اللعب الجماعي داخل اللعبة.

الاتصال المباشر

شغّل Vintage Story وانقر على Multiplayer من القائمة الرئيسية.
انقر على Direct Connect.
أدخل عنوان IP الخادم ومنفذ اللعبة بالتنسيق:
```
your.server.ip:port
```
تحقق من تبويب Network في GPanel لمعرفة عنوان IP والمنفذ المعينين لك.
انقر على Connect. إذا كان الخادم محميًا بكلمة مرور، أدخلها عند الطلب.

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

شغّل Vintage Story وانقر على Multiplayer من القائمة الرئيسية.
سيقوم متصفح الخوادم بتحميل قائمة بالخوادم العامة. استخدم شريط البحث للعثور على خادمك بالاسم (قيمة ServerName من serverconfig.json).
انقر على خادمك في القائمة وانقر على Join.

الخادم لا يظهر في المتصفح؟ قد يستغرق متصفح الخوادم عدة دقائق لفهرسة خادم تم تشغيله حديثًا. استخدم الاتصال المباشر للوصول الفوري. تأكد أيضًا من أنك لم تعيّن كلمة مرور -- قد لا تظهر الخوادم المحمية بكلمة مرور في المتصفح العام حسب إعدادات الخادم.

إدارة الحفظ

يتم تخزين بيانات عالم Vintage Story على خادمك وحفظها تلقائيًا أثناء اللعب.

موقع بيانات العالم

يتم تخزين ملفات حفظ العالم في دليل data/ على خادمك. يعتمد المسار الدقيق على اسم عالمك. يمكنك الوصول إلى هذه الملفات من خلال تبويب Files في GPanel أو عبر SFTP.

عمل نسخة احتياطية من عالمك

أوقف الخادم لضمان نسخة احتياطية نظيفة (لا توجد ملفات يتم كتابتها أثناء الحفظ).
اتصل بخادمك عبر SFTP. راجع كيفية رفع الملفات عبر SFTP لتعليمات الاتصال.
قم بتنزيل دليل data/ بالكامل إلى جهازك المحلي.
خزّن النسخة الاحتياطية في مكان آمن. فكّر في الاحتفاظ بنسخ احتياطية متعددة بتواريخ مختلفة في حال احتجت للعودة إلى نقطة محددة.

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

إعادة تعيين العالم

لبدء عالم جديد تمامًا:

أوقف الخادم من تبويب Console في GPanel.
قم بعمل نسخة احتياطية من بيانات العالم الحالي إذا كنت تريد الاحتفاظ بها (راجع أعلاه).
انتقل إلى دليل data/ في مدير ملفات GPanel واحذف ملفات حفظ العالم.
اختياريًا، قم بتحديث WorldSeed في serverconfig.json لتوليد تخطيط عالم مختلف.
شغّل الخادم. سيتم توليد عالم جديد من الصفر باستخدام إعدادات التكوين الحالية.

حذف ملفات العالم دائم. بمجرد الحذف، لا يمكن استرداد العالم ما لم يكن لديك نسخة احتياطية. قم دائمًا بتنزيل نسخة احتياطية قبل إجراء إعادة تعيين العالم.

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

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

دليل إعداد خادم Vintage Story - مكتبة الشروحات

الدعم

التصنيفات

دليل إعداد خادم Vintage Story