این راهنما نحوه راه‌اندازی سرور اختصاصی 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. نحوه اتصال

گزینه A -- مرورگر سرور درون‌بازی

1. Portal Knights را از طریق Steam اجرا کنید.
2. از منوی اصلی، Multiplayer را انتخاب کنید.
3. Online Game و سپس Browse Servers را انتخاب کنید.
4. سرور خود را بر اساس نام جستجو کنید یا لیست را مرور کنید.
5. سرور خود را انتخاب کنید و روی Join کلیک کنید. در صورت درخواست، رمز عبور را وارد کنید.

گزینه B -- اتصال مستقیم از طریق 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 کاملاً شروع شده است. ممکن است مرورگر سرور ۲ تا ۳ دقیقه طول بکشد تا یک سرور جدید را فهرست کند. در این بین اتصال مستقیم از طریق IP را امتحان کنید.
• نمی‌توان متصل شد: IP و پورت سرور خود را در تب Network در GPanel بررسی کنید. مطمئن شوید سرور در حال اجرا است و در حالت کرش نیست.
• کرش در هنگام شروع: فایل پیکربندی را حذف کنید و مجدداً راه‌اندازی کنید تا مقادیر پیش‌فرض بازتولید شوند. اگر مشکل ادامه دارد، کنسول GPanel را برای پیام‌های خطا بررسی کنید.
• جهان بارگذاری نمی‌شود: مطمئن شوید تنظیم basicServerData.saveFolderPath در server_config.json به دایرکتوری صحیح اشاره می‌کند.

مقالات مرتبط

• دستورات ادمین Portal Knights
• نحوه یافتن IP و پورت سرور
• نحوه آپلود فایل‌ها از طریق SFTP
• راهنمای شروع کار با سرور

نیاز به کمک دارید؟

اگر با مشکلاتی مواجه شدید که در اینجا پوشش داده نشده، یک تیکت پشتیبانی ارسال کنید و IP سرور، توضیح مشکل و هرگونه پیام خطا از کنسول GPanel را ضمیمه کنید.