راهنمای راهاندازی سرور Starbound
این راهنما راهاندازی و پیکربندی سرور اختصاصی Starbound شما در Legion Hosting را پوشش میدهد، شامل پیشنیازهای احراز هویت Steam، اولین راهاندازی، پیکربندی سرور، تنظیمات جهان، اتصال بازیکنان و مدیریت ذخیرهها. برای نصب ماد، نصب ماد Starbound را ببینید. برای دستورات ادمین و امتیازات، دستورات ادمین Starbound را ببینید.
پنل سرور: تمام مدیریت سرور از طریق GPanel در gpanel.legionhosting.net انجام میشود. از File Manager یا SFTP برای ویرایش فایلهای پیکربندی استفاده کنید.
پیشنیازها
قبل از راهاندازی سرور Starbound خود، باید موارد زیر را داشته باشید:
حساب Steam احراز هویت شده الزامی است. فایلهای سرور اختصاصی Starbound (Steam App ID: 211820) نمیتوانند از طریق SteamCMD ناشناس دانلود شوند. شما باید نام کاربری و رمز عبور حساب Steam معتبر را در تب Startup GPanel وارد کنید. حساب Steam مورد استفاده باید مالک یک نسخه از Starbound باشد.
- یک حساب Steam که مالک Starbound باشد. فایل باینری سرور برای دانلود ناشناس در دسترس نیست -- حسابی که ارائه میدهید باید Starbound را در کتابخانهاش داشته باشد.
- ملاحظات Steam Guard. اگر حساب Steam شما Steam Guard (احراز هویت دو عاملی) فعال دارد، باید کد احراز هویت را از طریق متغیر راهاندازی
STEAM_AUTHدر اولین نصب ارائه دهید. پس از احراز هویت اولیه، SteamCMD نشست را ذخیره میکند و راهاندازیهای بعدی نباید نیاز به کد داشته باشند مگر اینکه حافظه نهان منقضی شود. - حساب Steam اختصاصی توصیه میشود. برای امنیت، استفاده از یک حساب Steam جداگانه که فقط برای میزبانی سرور مالک Starbound است را در نظر بگیرید. این کار از اشتراکگذاری اعتبارنامههای حساب اصلی جلوگیری میکند و از تداخل در صورتی که بخواهید همزمان بازی کنید جلوگیری میکند.
اولین راهاندازی
پس از خرید سرور Starbound خود از Legion Hosting، مراحل زیر را برای اولین اجرا دنبال کنید:
- وارد GPanel شوید و سرور Starbound خود را انتخاب کنید.
- به تب Startup بروید.
- اعتبارنامههای Steam مورد نیاز را پر کنید:
- STEAM_USER -- نام کاربری حساب Steam شما (الزامی).
- STEAM_PASS -- رمز عبور حساب Steam شما (الزامی).
- STEAM_AUTH -- کد دو عاملی Steam Guard شما، در صورت درخواست (اختیاری، فقط در اولین نصب یا زمانی که نشست ذخیره شده منقضی شود نیاز است).
- به تب Console بروید و Start را کلیک کنید.
- سرور فایلهای سرور اختصاصی Starbound را از طریق SteamCMD دانلود خواهد کرد. این ممکن است در اولین اجرا چند دقیقه طول بکشد.
- پس از اتمام دانلود، سرور یک جهان پیشفرض ایجاد کرده و شروع به گوش دادن برای اتصالات میکند.
درخواست Steam Guard: اگر سرور با خطای احراز هویت شروع نشد، به تب Startup برگردید، کد فعلی Steam Guard خود را در فیلد
STEAM_AUTH وارد کنید و سرور را ریستارت کنید. ایمیل یا اپلیکیشن احراز هویت خود را برای کد بررسی کنید. معمولاً فقط یک بار نیاز به انجام این کار دارید -- SteamCMD نشست را برای راهاندازیهای آینده ذخیره میکند.
متغیرهای راهاندازی GPanel
| متغیر | الزامی | توضیحات |
|---|---|---|
STEAM_USER |
بله | نام کاربری حساب Steam. باید مالک Starbound باشد. نمیتواند anonymous باشد. |
STEAM_PASS |
بله | رمز عبور حساب Steam برای نام کاربری بالا. |
STEAM_AUTH |
خیر | کد احراز هویت دو عاملی Steam Guard. فقط در هنگام راهاندازی اولیه یا زمانی که نشست ذخیره شده منقضی شود نیاز است. |
WORKSHOP |
خیر | برای فعالسازی پشتیبانی ماد Steam Workshop روی 1 تنظیم کنید، یا برای غیرفعالسازی روی 0. پیشفرض 0 است. برای جزئیات نصب ماد Starbound را ببینید. |
starbound_server.config
فایل پیکربندی اصلی سرور در مسیر زیر قرار دارد:
storage/starbound_server.configاین فایل از فرمت JSON استفاده میکند. آن را از طریق File Manager در GPanel یا از طریق SFTP ویرایش کنید. سرور باید قبل از ویرایش متوقف شود، زیرا تغییرات در هنگام راهاندازی بارگذاری میشوند.
JSON معتبر الزامی است. تجزیهکننده پیکربندی Starbound در مورد فرمت JSON سختگیر است. مطمئن شوید که ویرگول اضافی وجود ندارد، تمام رشتهها در گیومه دوتایی هستند و براکتها/آکولادها به درستی جفت شدهاند. یک خطای نحوی واحد مانع از راهاندازی سرور میشود.
تنظیمات کلیدی سرور
| تنظیم | پیشفرض | توضیحات |
|---|---|---|
serverName |
"A Starbound Server" |
نامی که در مرورگر سرور و هنگام اتصال بازیکنان نمایش داده میشود. |
maxPlayers |
8 |
حداکثر تعداد بازیکنانی که میتوانند همزمان متصل باشند. |
gameServerPort |
21025 |
پورتی که سرور بازی روی آن گوش میدهد. در Legion Hosting، این به طور خودکار تنظیم میشود -- مگر اینکه پشتیبانی دستور دهد، آن را تغییر ندهید. |
gameServerBind |
"::" |
رابط شبکهای که به آن متصل میشود. پیشفرض "::" به تمام رابطها (IPv4 و IPv6) متصل میشود. این را تغییر ندهید. |
serverPassword |
"" |
رمز عبور لازم برای ورود به سرور. برای عدم نیاز به رمز عبور (دسترسی عمومی) خالی بگذارید. |
allowAnonymousConnections |
true |
وقتی true باشد، بازیکنان میتوانند بدون حساب Starbound متصل شوند. برای الزام احراز هویت حساب برای تمام بازیکنان روی false تنظیم کنید. |
allowAssetsMismatch |
true |
وقتی true باشد، بازیکنان با مجموعه مادهای متفاوت همچنان میتوانند متصل شوند. برای اجبار تطابق داراییها بین سرور و کلاینت روی false تنظیم کنید (برای سرورهای ماد شده توصیه میشود). |
maxTeamSize |
4 |
حداکثر تعداد بازیکنان در هر گروه/تیم. |
clientIPJoinable |
false |
آیا سرور از طریق IP مستقیم قابل اتصال است. برای سرورهای اختصاصی باید true باشد. |
clientP2PJoinable |
false |
آیا اتصالات نظیر به نظیر مجاز هستند. معمولاً برای سرورهای اختصاصی false است. |
نمونه starbound_server.config
{
"serverName" : "My Legion Starbound Server",
"maxPlayers" : 8,
"gameServerBind" : "::",
"serverPassword" : "",
"allowAnonymousConnections" : true,
"allowAssetsMismatch" : true,
"maxTeamSize" : 4,
"clientIPJoinable" : true,
"clientP2PJoinable" : false,
"allowAdminCommands" : true,
"allowAdminCommandsFromAnyone" : false,
"serverUsers" : {
"YourUsername" : {
"admin" : true,
"password" : "your-admin-password"
}
}
}تنظیمات جهان و کیهان
Starbound از یک کیهان تولید شده به صورت رویهای استفاده میکند. هر بار که یک بازیکن از یک سیستم ستارهای یا سیاره جدید بازدید میکند، بازی آن را بر اساس بذر کیهان و سیستم مختصات تولید میکند. دادههای کیهان سرور در مسیر زیر ذخیره میشوند:
storage/universe/این دایرکتوری شامل تمام دادههای جهان تولید شده، از جمله سیارات، ایستگاههای فضایی و سازههای ساخته شده توسط بازیکنان در جهان است.
پیکربندی کیهان
پارامترهای تولید کیهان را میتوان در فایل starbound_server.config یا از طریق فایلهای دارایی مرتبط با کیهان تنظیم کرد. مفاهیم کلیدی:
| مفهوم | توضیحات |
|---|---|
| بذر کیهان | کیهان به صورت رویهای بر اساس مختصات تولید میشود. تمام سرورها با همان نسخه بازی سیارات یکسانی را در همان مختصات تولید میکنند، اما اشیاء قرار داده شده توسط بازیکنان و تغییرات منحصر به هر سرور هستند. |
| سیاره شروع | بازیکنان جدید در یک سیاره شروع انتخاب شده به صورت رویهای ظاهر میشوند. جهان شروع یک سیاره از نوع باغ است که برای پیشرفت مراحل اولیه بازی مناسب است. |
| فایلهای جهان | هر سیاره بازدید شده یک فایل .world در storage/universe/ تولید میکند. این فایلها شامل تغییرات زمین، اشیاء قرار داده شده و تغییرات کاشی ایجاد شده توسط بازیکنان هستند. |
| دادههای آسمانی | فایلهای universe.chunks و universe.dat در دایرکتوری کیهان وضعیت کلی نقشه کیهان را ذخیره میکنند. |
کیهان مشترک: تمام بازیکنان روی سرور کیهان یکسانی را به اشتراک میگذارند. تغییراتی که یک بازیکن در یک سیاره ایجاد میکند (ساختمانسازی، استخراج، قرار دادن اشیاء) برای تمام بازیکنان دیگری که از آن سیاره بازدید میکنند قابل مشاهده خواهد بود.
بازنشانی کیهان: برای شروع یک کیهان کاملاً جدید، سرور را متوقف کرده و کل دایرکتوری
storage/universe/ را حذف یا تغییر نام دهید. توجه داشته باشید که این کار تمام جهانهای تولید شده، از جمله سازههای ساخته شده توسط بازیکنان را حذف میکند. همیشه قبل از انجام این کار نسخه پشتیبان تهیه کنید.
نحوه اتصال
بازیکنان از طریق منوی چندنفره درون بازی به سرور Starbound شما متصل میشوند.
اتصال مستقیم از طریق IP
- Starbound را اجرا کنید.
- از منوی اصلی، روی Multiplayer کلیک کنید.
- شخصیت خود را انتخاب کنید.
- در فیلد Server Address، آدرس IP و پورت سرور خود را با فرمت زیر وارد کنید:
IP:Port - اگر سرور رمز عبور دارد، Account Name و Password مطابق با یک ورودی
serverUsersدر پیکربندی سرور وارد کنید. اگرallowAnonymousConnectionsرویtrueباشد و رمز عبور سرور تنظیم نشده باشد، این فیلدها میتوانند خالی بمانند. - روی Join Server کلیک کنید.
پیدا کردن IP و پورت شما: برای محل یافتن این اطلاعات در GPanel، چگونه IP و پورت سرور خود را پیدا کنید را ببینید.
دوستان Steam (غیر قابل اعمال)
قابلیت "Join Game" در Steam برای بازیهای میزبانی شده نظیر به نظیر است، نه سرورهای اختصاصی. بازیکنان باید از روش اتصال مستقیم IP توضیح داده شده در بالا برای پیوستن به سرور Legion Hosting شما استفاده کنند.
عیبیابی اتصال: اگر بازیکنان نمیتوانند متصل شوند، موارد زیر را بررسی کنید:
- سرور در حال اجرا و کاملاً راهاندازی شده است (کنسول GPanel را برای "Info: Server listened on" بررسی کنید).
- IP و پورت صحیح استفاده میشوند.
- اگر از رمز عبور سرور استفاده میشود، بازیکن اعتبارنامههای صحیح
serverUsersرا وارد میکند. - اگر
allowAssetsMismatchرویfalseباشد، مادهای نصب شده بازیکن باید دقیقاً با مادهای سرور مطابقت داشته باشند. - هم سرور و هم کلاینت همان نسخه از Starbound را اجرا میکنند.
مدیریت ذخیرهها
Starbound تمام دادههای سرور را در دایرکتوری storage/ ذخیره میکند. درک ساختار فایلها به پشتیبانگیری، انتقال و عیبیابی کمک میکند.
دایرکتوریها و فایلهای کلیدی ذخیرهسازی
| مسیر | توضیحات |
|---|---|
storage/universe/ |
شامل تمام دادههای جهان تولید شده -- سیارات، ایستگاههای فضایی و تغییرات بازیکنان در جهانها. هر سیاره بازدید شده یک فایل .world دارد. |
storage/player/ |
شامل فایلهای ذخیره بازیکنان. هر بازیکن یک فایل .player دارد که موجودی، پیشرفت، وضعیت مأموریت و دادههای کشتی را ذخیره میکند. |
storage/starbound_server.config |
فایل پیکربندی اصلی سرور. |
storage/starbound_server.log |
فایل لاگ سرور. برای تشخیص کرشها، خطاها و مشکلات اتصال مفید است. |
ایجاد نسخه پشتیبان
پشتیبانگیری منظم از کیهان، دادههای بازیکنان و پیکربندی سرور شما در برابر از دست رفتن یا خرابی تصادفی محافظت میکند.
- سرور خود را در GPanel متوقف کنید تا مطمئن شوید تمام دادهها روی دیسک نوشته شدهاند.
- از طریق SFTP به سرور متصل شوید یا از File Manager استفاده کنید.
- کل دایرکتوری
storage/را به کامپیوتر محلی خود دانلود کنید. - نسخه پشتیبان را در مکانی امن با برچسب تاریخ ذخیره کنید (مثلاً
storage-backup-2026-02-26).
چه چیزی پشتیبان بگیرید: حداقل از دایرکتوریهای
storage/universe/ و storage/player/ پشتیبان بگیرید. اینها شامل تمام دادههای پیشرفت جهان و بازیکنان هستند. همچنین باید از starbound_server.config برای حفظ تنظیمات سرور پشتیبان بگیرید.
بازیابی از نسخه پشتیبان
- سرور خود را متوقف کنید.
- فایلهای پشتیبان خود را به مکانهای مربوطه در دایرکتوری
storage/آپلود کنید و فایلهای موجود را جایگزین کنید. - سرور را راهاندازی کنید.
انتقال جهان از سرور دیگر
برای انتقال کیهان Starbound خود از سرور دیگر یا بازی محلی:
- هر دو سرور مبدأ و مقصد را متوقف کنید.
- دایرکتوری
storage/universe/را از سرور مبدأ به سرور مقصد کپی کنید. - در صورت تمایل،
storage/player/را نیز کپی کنید اگر میخواهید دادههای بازیکنان را نیز منتقل کنید. - فایل
starbound_server.configخود را کپی کنید تا تنظیمات سرور حفظ شوند. - سرور مقصد را راهاندازی کنید و بررسی کنید که جهان به درستی بارگذاری میشود.
وابستگی ماد: اگر کیهان با مادها تولید شده باشد، همان مادها باید روی سرور مقصد نصب شوند. مادهای موجود نبودن باعث خطا یا محتوای گمشده هنگام بارگذاری جهانهای تحت تأثیر میشوند.
مقالات مرتبط
- نصب ماد Starbound
- دستورات ادمین Starbound
- چگونه IP و پورت سرور خود را پیدا کنید
- چگونه فایلها را از طریق SFTP آپلود کنید
- راهنمای شروع کار با سرور
به کمک نیاز دارید؟
اگر مشکلی دارید که در این راهنما پوشش داده نشده، تیم پشتیبانی ما آماده کمک است. یک تیکت در legionhosting.net/submitticket.php با جزئیات سرور و توضیح مشکل ارسال کنید.
