راهنمای راهاندازی سرور Vintage Story
این راهنما نحوه راهاندازی و پیکربندی سرور اختصاصی Vintage Story میزبانی شده در Legion Hosting را پوشش میدهد، از جمله اولین راهاندازی، متغیرهای GPanel، مدیریت نسخه، پیکربندی سرور، تنظیمات جهان، اتصال بازیکنان و مدیریت ذخیرهسازی. برای نصب مادها، به نصب ماد Vintage Story مراجعه کنید. برای راهاندازی ادمین و دستورات، به دستورات ادمین Vintage Story مراجعه کنید.
اولین راهاندازی
وقتی سرور Vintage Story خود را برای اولین بار از GPanel راهاندازی میکنید، سرور به طور خودکار فایلهای بازی را از API رسمی Vintage Story دانلود کرده و یک جهان پیشفرض ایجاد میکند. این راهاندازی اولیه ممکن است چند دقیقه طول بکشد تا فایلها دانلود و استخراج شوند.
- وارد GPanel شوید و سرور Vintage Story خود را انتخاب کنید.
- قبل از راهاندازی، تب Startup را بررسی کنید تا شاخه نسخه مورد نظر خود (stable، unstable یا pre-release) را تأیید کنید.
- در تب Console روی Start کلیک کنید. خروجی کنسول را برای پیامهای پیشرفت مشاهده کنید تا سرور فایلهای بازی را دانلود و نصب کند.
- وقتی پیامی مبنی بر آماده بودن سرور برای دریافت اتصالات مشاهده کردید، سرور آماده است. یک فایل
serverconfig.jsonپیشفرض به طور خودکار ایجاد خواهد شد.
متغیرهای راهاندازی GPanel
تنظیمات اصلی سرور از طریق تب Startup در GPanel کنترل میشوند. قبل از راهاندازی سرور، این موارد را بررسی و تنظیم کنید.
| متغیر | پیشفرض | توضیحات |
|---|---|---|
SERVER_PORT |
(اختصاص داده شده) | port بازی که بازیکنان برای اتصال استفاده میکنند. این به طور خودکار توسط GPanel اختصاص داده میشود -- تب Network را برای port اختصاص داده شده بررسی کنید. |
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).- سرور را ریستارت کنید. سرور فقط از نسخه قفل شده استفاده خواهد کرد صرف نظر از نسخههای جدیدتر.
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": ""
}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 و port بازی سرور خود را با فرمت زیر وارد کنید:
تب Network در GPanel را برای IP و port اختصاص داده شده بررسی کنید.your.server.ip:port - روی Connect کلیک کنید. اگر سرور رمز عبور دارد، هنگام درخواست آن را وارد کنید.
مرورگر سرور
- Vintage Story را اجرا کنید و از منوی اصلی روی Multiplayer کلیک کنید.
- مرورگر سرور لیستی از سرورهای عمومی را بارگذاری میکند. از نوار جستجو برای یافتن سرور خود بر اساس نام (مقدار
ServerNameازserverconfig.json) استفاده کنید. - روی سرور خود در لیست کلیک کنید و روی Join کلیک کنید.
مدیریت ذخیرهسازی
دادههای جهان Vintage Story روی سرور شما ذخیره شده و به طور خودکار در طول بازی ذخیره میشوند.
محل دادههای جهان
فایلهای ذخیره جهان در دایرکتوری data/ روی سرور شما ذخیره شدهاند. مسیر دقیق به نام جهان شما بستگی دارد. میتوانید از طریق تب Files در GPanel یا از طریق SFTP به این فایلها دسترسی داشته باشید.
تهیه نسخه پشتیبان از جهان
- سرور را متوقف کنید تا از پشتیبانگیری تمیز اطمینان حاصل شود (بدون نوشتن فایل در میانه ذخیرهسازی).
- از طریق SFTP به سرور خود متصل شوید. برای دستورالعملهای اتصال به نحوه آپلود فایل از طریق SFTP مراجعه کنید.
- کل دایرکتوری
data/را به دستگاه محلی خود دانلود کنید. - نسخه پشتیبان را در مکان امنی ذخیره کنید. نگهداری چندین نسخه پشتیبان با تاریخ را در نظر بگیرید تا در صورت نیاز بتوانید به نقطه خاصی بازگردید.
بازنشانی جهان
برای شروع جهان کاملاً جدید:
- سرور را از تب Console در GPanel متوقف کنید.
- اگر میخواهید دادههای جهان موجود را نگه دارید، نسخه پشتیبان تهیه کنید (بالا را ببینید).
- در مدیر فایل GPanel به دایرکتوری
data/بروید و فایلهای ذخیره جهان را حذف کنید. - اختیاری:
WorldSeedرا درserverconfig.jsonبهروزرسانی کنید تا چیدمان جهان متفاوتی تولید شود. - سرور را راهاندازی کنید. یک جهان جدید از ابتدا با استفاده از تنظیمات پیکربندی فعلی شما تولید خواهد شد.
مقالات مرتبط
- نصب ماد Vintage Story
- دستورات ادمین Vintage Story
- نحوه یافتن IP و Port سرور
- نحوه آپلود فایل از طریق SFTP
- راهنمای راهاندازی سرور
نیاز به کمک دارید؟
اگر با مشکلی مواجه شدید که در این راهنما پوشش داده نشده است، یک تیکت پشتیبانی ارسال کنید و آدرس IP سرور، توضیح مشکل و هرگونه خروجی کنسول مرتبط از GPanel را ارائه دهید.
