این راهنما نحوه پیکربندی فایلهای GameUserSettings.ini و Game.ini برای سرور ARK: Survival Ascended میزبانیشده با Legion Hosting را پوشش میدهد.
قبل از ویرایش فایلهای پیکربندی سرور خود را متوقف کنید. همیشه قبل از ویرایش هر فایل
.ini سرور خود را از تب Console GPanel متوقف کنید. 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 کار نخواهد کرد.
مرحله ۱ — دسترسی به مدیر فایل در GPanel
- وارد GPanel شوید.
- سرور ARK: Survival Ascended خود را از لیست سرورها انتخاب کنید.
- اگر سرور در حال اجرا است، روی تب Console کلیک کنید و Stop را بزنید و صبر کنید تا وضعیت به Offline تغییر کند.
- روی تب Files کلیک کنید تا مدیر فایل باز شود.
- به
ShooterGame/Saved/Config/WindowsServer/بروید. پس از حداقل یک بار راهاندازی سرور،GameUserSettings.iniرا اینجا خواهید یافت. اگرGame.iniموجود نیست، آن را به صورت دستی در مرحله ۳ ایجاد خواهید کرد.
مرحله ۲ — پیکربندی GameUserSettings.ini
روی GameUserSettings.ini در مدیر فایل کلیک کنید تا در ویرایشگر درونخطی باز شود. فایل به بخشهایی تقسیم شده — مهمترین بخشها برای پیکربندی سرور [SessionSettings] و [ServerSettings] هستند.
تنظیمات کلیدی در [SessionSettings]
| تنظیم | مقدار نمونه | توضیحات |
|---|---|---|
SessionName |
My Legion Server |
نامی که در مرورگر سرور درون بازی نمایش داده میشود. آن را منحصر به فرد نگه دارید تا بازیکنان بتوانند به راحتی آن را پیدا کنند. |
QueryPort |
7778 |
پورت پرسش که توسط مرورگر سرور استفاده میشود. باید با پورت اختصاصیافته در GPanel مطابقت داشته باشد. پیشفرض پورت بازی + ۱ است. |
تنظیمات کلیدی در [ServerSettings]
| تنظیم | مقدار نمونه | توضیحات |
|---|---|---|
ServerPassword |
mypassword |
رمز عبور مورد نیاز برای ورود بازیکنان. برای سرور عمومی خالی بگذارید. |
ServerAdminPassword |
adminpass123 |
رمز عبور ادمین برای احراز هویت دستورات ادمین درون بازی. آن را خصوصی نگه دارید. |
MaxPlayers |
20 |
حداکثر تعداد بازیکنان همزمان. باید با محدودیت اسلات بازیکن پلن شما مطابقت داشته باشد. |
XPMultiplier |
2.0 |
ضریب XP کسب شده. 1.0 پیشفرض است، 2.0 کسب XP را دو برابر میکند. |
TamingSpeedMultiplier |
3.0 |
ضریب سرعت رام کردن. مقادیر بالاتر رام کردن را سریعتر میکنند. |
HarvestAmountMultiplier |
2.0 |
ضریب منابع جمعآوری شده در هر عمل برداشت. |
DifficultyOffset |
1.0 |
توزیع سطح موجودات را کنترل میکند. برای حداکثر سطوح وحشی در تنظیمات رسمی روی 1.0 تنظیم کنید. |
OverrideOfficialDifficulty |
5.0 |
حداکثر سطح دایناسور وحشی را هنگامی که DifficultyOffset=1.0 است تنظیم میکند. مقدار 5.0 سطوح تا ۱۵۰ را مجاز میکند. |
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مرحله ۳ — ایجاد و پیکربندی Game.ini
ایجاد Game.ini
Game.ini باید در صورت عدم وجود توسط کاربر به صورت دستی ایجاد شود. در مدیر فایل GPanel به ShooterGame/Saved/Config/WindowsServer/ بروید. اگر 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) برای لیست کردن سرور شما استفاده میشود. اگر پورت پرسش اشتباه یا غیرقابل دسترس باشد، سرور شما حتی اگر به درستی اجرا شود در مرورگر نمایش داده نخواهد شد.
| پورت | پیشفرض | پیکربندی در | هدف |
|---|---|---|---|
| Game Port | 7777 |
تب Startup / Network در GPanel | بازیکنان از طریق این پورت برای پیوستن به سرور متصل میشوند |
| Query Port | 7778 |
GameUserSettings.ini — QueryPort در بخش [SessionSettings] |
نظرسنجی مرورگر سرور — باید با پورت اختصاصیافته در GPanel مطابقت داشته باشد |
پورت پرسش باید با GPanel مطابقت داشته باشد. مقدار
QueryPort در GameUserSettings.ini باید دقیقاً با پورت پرسش نشان داده شده در تب Network GPanel شما مطابقت داشته باشد. Legion Hosting هر دو پورت را هنگام ایجاد سرور شما از پیش اختصاص میدهد — قبل از ویرایش فایل .ini تب Network را برای مقادیر خاص خود بررسی کنید. فرض نکنید پیشفرضهای 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 مطابقت دارد. - مرورگر سرور ممکن است ۵ تا ۱۰ دقیقه طول بکشد تا سرور تازه راهاندازی یا پیکربندیشده را فهرست کند. اتصال مستقیم با
open IP:GAMEPORTدر کنسول درون بازی ASA را امتحان کنید تا تأیید کنید سرور در دسترس است در حالی که مرورگر بهروزرسانی میشود. - اگر کراسپلی فعال است، بازیکنان باید فیلترهای قفل پلتفرم را در مرورگر سرور غیرفعال کنند. برای جزئیات راهنمای اتصال را ببینید.
