يغطي هذا الدليل كيفية تكوين ملفات GameUserSettings.ini وGame.ini لخادم ARK: Survival Ascended المستضاف على Legion Hosting.
أوقف خادمك قبل تعديل ملفات التكوين. قم دائماً بإيقاف خادمك من علامة التبويب Console في GPanel قبل تعديل أي ملفات
.ini. يمكن لـ ARK الكتابة فوق الملفات عند الإيقاف، لذا قد تُفقد التغييرات التي تتم أثناء تشغيل الخادم.
نظرة عامة على ملفات التكوين
يستخدم ARK: Survival Ascended ملفي تكوين رئيسيين للتحكم في سلوك الخادم. كلاهما موجود داخل مجلد ShooterGame/Saved/Config/WindowsServer/ على خادمك.
| الملف | الغرض |
|---|---|
GameUserSettings.ini |
إعدادات الخادم الأساسية — اسم الجلسة، كلمات المرور، عدد اللاعبين، المعدلات، اللعب المشترك، BattleEye، والمزيد. يتم إنشاء هذا الملف عند أول بدء تشغيل للخادم. |
Game.ini |
تجاوزات اللعب المتقدمة — نقاط الإنغرام، تدرج الإحصائيات، أحجام تكديس العناصر، إعدادات ظهور NPC المخصصة. يجب أن يكون الاسم Game.ini بالضبط (حساس لحالة الأحرف). أنشئه يدوياً إذا لم يكن موجوداً. |
قد لا يكون Game.ini موجوداً بشكل افتراضي. إذا لم يكن الملف موجوداً، أنشئه يدوياً في محرر ملفات GPanel. يجب أن يكون اسم الملف
Game.ini بالضبط بحرف G وI كبيرين — game.ini أو GAME.INI لن يعملا.
الخطوة 1 — الوصول إلى مدير الملفات في GPanel
- سجل الدخول إلى GPanel.
- اختر خادم ARK: Survival Ascended من قائمة الخوادم.
- إذا كان الخادم يعمل، انقر على Stop في علامة التبويب Console وانتظر حتى تتغير الحالة إلى Offline.
- انقر على علامة التبويب Files لفتح مدير الملفات.
- انتقل إلى
ShooterGame/Saved/Config/WindowsServer/. ستجدGameUserSettings.iniهنا بمجرد تشغيل الخادم مرة واحدة على الأقل. إذا لم يكنGame.iniموجوداً، ستقوم بإنشائه يدوياً في الخطوة 3.
الخطوة 2 — تكوين GameUserSettings.ini
انقر على GameUserSettings.ini في مدير الملفات لفتحه في المحرر المدمج. الملف مقسم إلى أقسام — أهمها لتكوين الخادم هي [SessionSettings] و[ServerSettings].
الإعدادات الرئيسية في [SessionSettings]
| الإعداد | قيمة نموذجية | الوصف |
|---|---|---|
SessionName |
My Legion Server |
الاسم الذي يظهر في متصفح الخوادم داخل اللعبة. اجعله فريداً حتى يتمكن اللاعبون من العثور عليه بسهولة. |
QueryPort |
7778 |
منفذ الاستعلام المستخدم بواسطة متصفح الخوادم. يجب أن يتطابق مع المنفذ المعين في GPanel. الافتراضي هو منفذ اللعبة + 1. |
الإعدادات الرئيسية في [ServerSettings]
| الإعداد | قيمة نموذجية | الوصف |
|---|---|---|
ServerPassword |
mypassword |
كلمة المرور المطلوبة للاعبين للانضمام. اتركها فارغة لخادم عام. |
ServerAdminPassword |
adminpass123 |
كلمة مرور المسؤول المستخدمة للمصادقة على أوامر المسؤول داخل اللعبة. احتفظ بها خاصة. |
MaxPlayers |
20 |
الحد الأقصى لعدد اللاعبين المتزامنين. يجب أن يتطابق مع حد فتحات اللاعبين في خطتك. |
XPMultiplier |
2.0 |
مضاعف نقاط الخبرة المكتسبة. 1.0 هو الافتراضي، 2.0 يضاعف كسب الخبرة. |
TamingSpeedMultiplier |
3.0 |
مضاعف سرعة الترويض. القيم الأعلى تسرّع الترويض. |
HarvestAmountMultiplier |
2.0 |
مضاعف الموارد المجموعة لكل عملية حصاد. |
DifficultyOffset |
1.0 |
يتحكم في توزيع مستوى المخلوقات. اضبطه على 1.0 لأقصى مستويات برية على الإعدادات الرسمية. |
OverrideOfficialDifficulty |
5.0 |
يحدد الحد الأقصى لمستوى الديناصورات البرية عندما يكون DifficultyOffset=1.0. القيمة 5.0 تسمح بمستويات تصل إلى 150. |
AllowCrateSpawnsOnTopOfStructures |
True |
يسمح لصناديق الإمداد بالهبوط على مباني اللاعبين. يُوصى به لخوادم PvE. |
EnablePvPGamma |
True |
يسمح للاعبين بتعديل جاما في PvP. قم بتعطيله لتجربة أكثر تنافسية. |
مثال بسيط لقسم GameUserSettings.ini مُكوّن:
[SessionSettings]
SessionName=My Legion Server
QueryPort=7778
[ServerSettings]
ServerPassword=
ServerAdminPassword=adminpass123
MaxPlayers=20
XPMultiplier=2.0
TamingSpeedMultiplier=3.0
HarvestAmountMultiplier=2.0
DifficultyOffset=1.0
OverrideOfficialDifficulty=5.0الخطوة 3 — إنشاء وتكوين Game.ini
إنشاء Game.ini
يجب إنشاء Game.ini يدوياً بواسطة المستخدم إذا لم يكن موجوداً بالفعل. انتقل إلى ShooterGame/Saved/Config/WindowsServer/ في مدير ملفات GPanel. إذا لم يكن Game.ini مدرجاً، أنشئ ملفاً جديداً بالاسم الدقيق Game.ini (حرف G كبير وحرف I كبير — game.ini أو GAME.INI لن يعملا).
ابدأ الملف بالترويسة التالية — جميع إعدادات Game.ini تندرج تحت هذا القسم الواحد:
[/script/shootergame.shootergamemode]تعديل Game.ini
يستخدم Game.ini تنسيقاً قائماً على الأقسام. القسم الأكثر شيوعاً لتخصيص الخادم هو [/script/shootergame.shootergamemode]. تُضاف الإعدادات سطراً واحداً لكل إعداد داخل القسم المناسب.
تخصيصات Game.ini الشائعة:
[/script/shootergame.shootergamemode]
; Engram points per level (one entry per level, starting at level 1)
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
OverridePlayerLevelEngramPoints=8
; Increase max XP required per level (one entry per level)
LevelExperienceRampOverrides=(...)
; Custom harvest amounts per resource
ResourceItemReplacementClasses=(...)
; Disable specific engrams
EngramEntryAutoUnlocks=(EngramClassName="EngramEntry_TurretGun_Rocket_C",LevelToAutoUnlock=0)| الإعداد | الوصف |
|---|---|
OverridePlayerLevelEngramPoints=N |
يحدد نقاط الإنغرام الممنوحة عند كل مستوى. أضف سطراً واحداً لكل مستوى لاعب. استخدم هذا لمنح المزيد من الإنغرامات لكل ارتقاء في المستوى. |
MaxCustomNodes=N |
يتحكم في الحد الأقصى لنقاط الظهور المخصصة. مهم لتكوينات ظهور المودات المتقدمة. |
EngramEntryAutoUnlocks=(...) |
يفرض فتح إنغرامات محددة تلقائياً عند مستوى معين، مفيد لمنح جميع اللاعبين الوصول إلى عناصر معينة دون إنفاق النقاط. |
ConfigOverrideItemMaxQuantity=(...) |
يتجاوز الحد الأقصى لأحجام التكديس لعناصر محددة. |
نصيحة: يجب أن يكون عنوان القسم
[/script/shootergame.shootergamemode] موجوداً مرة واحدة فقط في Game.ini. إذا أضفته مرة ثانية، سيتم استخدام الحدوث الأخير فقط. أضف جميع إعداداتك تحت العنوان الواحد.
تكوين منفذ الاستعلام
منفذ الاستعلام منفصل عن منفذ اللعبة ويُستخدم حصرياً بواسطة متصفح الخوادم (Steam/Epic) لإدراج خادمك. إذا كان منفذ الاستعلام خاطئاً أو غير قابل للوصول، فلن يظهر خادمك في المتصفح حتى لو كان يعمل بشكل صحيح.
| المنفذ | الافتراضي | مُكوّن في | الغرض |
|---|---|---|---|
| منفذ اللعبة | 7777 |
GPanel Startup / علامة التبويب Network | يتصل اللاعبون من خلال هذا المنفذ للانضمام إلى الخادم |
| منفذ الاستعلام | 7778 |
GameUserSettings.ini — QueryPort تحت [SessionSettings] |
استطلاع متصفح الخوادم — يجب أن يتطابق مع المنفذ المخصص في GPanel |
يجب أن يتطابق منفذ الاستعلام مع GPanel. يجب أن تتطابق قيمة
QueryPort في GameUserSettings.ini تماماً مع منفذ الاستعلام المعروض في علامة التبويب Network في GPanel. تقوم Legion Hosting بتعيين كلا المنفذين مسبقاً عند إنشاء خادمك — تحقق من علامة التبويب Network للقيم الخاصة بك قبل تعديل ملف .ini. لا تفترض أن القيم الافتراضية 7777/7778 تنطبق على خادمك.
تطبيق التغييرات
- احفظ ملف
.iniالمعدل باستخدام زر Save في محرر ملفات GPanel. - ارجع إلى علامة التبويب Console.
- انقر على Start لبدء تشغيل الخادم. سيقوم GPanel بتحميل التكوين المحدث عند بدء التشغيل.
- راقب مخرجات وحدة التحكم بحثاً عن أي أخطاء. أخطاء التكوين مثل القيم غير الصالحة أو ترويسات الأقسام المكررة ستنتج عادةً تحذيرات في سجل بدء التشغيل.
قم دائماً بتعديل ملفات التكوين أثناء إيقاف الخادم. تعديل
GameUserSettings.ini أو Game.ini أثناء إيقاف الخادم ثم تشغيله كافٍ. لا تحاول إعادة تحميل ملفات التكوين أثناء تشغيل الخادم — ARK لا يدعم إعادة التحميل المباشر للتكوين لمعظم الإعدادات.
استكشاف الأخطاء وإصلاحها
Game.ini غير موجود أو الإعدادات لا تُقرأ
Game.iniلا يُنشأ تلقائياً. إذا لم يكن الملف موجوداً، أنشئه يدوياً في محرر ملفات GPanel داخلShooterGame/Saved/Config/WindowsServer/.- اسم الملف حساس لحالة الأحرف. يجب أن يكون
Game.iniبالضبط — وليسgame.iniأوGAME.INIأو أي صيغة أخرى. - تأكد من أن الملف يحتوي على ترويسة
[/script/shootergame.shootergamemode]كسطر أول، وأن هذه الترويسة تظهر مرة واحدة فقط.
الإعدادات في Game.ini أو GameUserSettings.ini لا تُطبّق
- تأكد من أن الخادم كان متوقفاً بالكامل قبل تعديل الملف. إذا كان الخادم يعمل، فقد يكون قد كتب فوق تغييراتك عند الإيقاف التالي.
- تحقق من أن ترويسة القسم (مثل
[ServerSettings]أو[/script/shootergame.shootergamemode]) تظهر مرة واحدة فقط في الملف. ترويسات الأقسام المكررة ستؤدي إلى تجاوز الإعدادات اللاحقة للسابقة، أو تجاهلها بالكامل حسب المحلل. - بعد حفظ الملف، أعد تشغيل الخادم بالكامل من GPanel قبل الاختبار.
- تحقق من أن الملف في المجلد الصحيح:
ShooterGame/Saved/Config/WindowsServer/. الملفات الموضوعة في المكان الخاطئ يتم تجاهلها بصمت.
الخادم لا يظهر في متصفح الخوادم بعد تكوين الإعدادات
- تأكد من أن
QueryPortفيGameUserSettings.iniيتطابق تماماً مع المنفذ المدرج في علامة التبويب Network في GPanel. - قد يستغرق متصفح الخوادم من 5 إلى 10 دقائق لفهرسة خادم بدأ حديثاً أو أُعيد تكوينه. جرب الاتصال المباشر باستخدام
open IP:GAMEPORTفي وحدة تحكم ASA داخل اللعبة للتحقق من إمكانية الوصول إلى الخادم بينما يلحق المتصفح. - إذا كان اللعب المشترك مفعلاً، يجب على اللاعبين إلغاء تحديد فلاتر قفل المنصة في متصفح الخوادم. راجع دليل الاتصال للتفاصيل.
