این راهنما نحوه راهاندازی و پیکربندی سرور headless Resonite میزبانیشده با Legion Hosting را پوشش میدهد. Resonite یک پلتفرم VR اجتماعی است که کاربران میتوانند در دنیاهای ساختهشده توسط کاربران بسازند، خلق کنند و معاشرت کنند. برای مدیریت نشست و دستورات ادمین، راهنمای مدیریت سرور Resonite را ببینید.
1. دسترسی به سرور شما
- وارد GPanel شوید.
- سرور Resonite خود را از لیست سرورها انتخاب کنید.
- سرور شما از طریق تب Console در GPanel و پیکربندی headless Resonite مدیریت میشود.
توجه: پورتها بهصورت تصادفی تخصیص داده میشوند مگر اینکه IP اختصاصی داشته باشید. سرورهای headless Resonite عمدتاً از فایل پیکربندی JSON و مرورگر نشست برای اتصالات استفاده میکنند، اما پورت تخصیصیافته همچنان برای ارتباطات شبکهای استفاده میشود.
2. متغیرهای استارتاپ
این تنظیمات را از تب Startup در GPanel پیکربندی کنید:
| متغیر | نام محیطی | پیشفرض | توضیحات |
|---|---|---|---|
| فعالسازی بارگذار ماد | ENABLE_MODLOADER |
false | فعالسازی ResoniteModLoader برای مادهای سفارشی (true/false). |
| بهروزرسانی خودکار | AUTO_UPDATE |
1 | بهروزرسانی خودکار سرور هنگام شروع (1=بله، 0=خیر). |
مهم: Resonite headless نیاز به اشتراک Patreon با دسترسی headless دارد. یک رمز عبور بتا (که با ارسال پیام
/headlessCode به ربات Resonite در بازی دریافت میشود) برای نصب لازم است. این توسط ارائهدهنده میزبانی پیکربندی میشود.
3. فایل پیکربندی
فایل پیکربندی اصلی Headless/Config/Config.json است. آن را از طریق SFTP ویرایش کنید. تنظیمات کلیدی:
{
"tickRate": 60.0,
"maxConcurrentAssetTransfers": 4,
"loginCredential": "your_username",
"loginPassword": "your_password",
"startWorlds": [
{
"isEnabled": true,
"sessionName": "My World",
"maxUsers": 32,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld",
"autoRecover": true,
"autoSleep": true,
"saveOnExit": false
}
]
}4. مرجع تنظیمات Config.json
| تنظیم | پیشفرض | توضیحات |
|---|---|---|
tickRate | 60.0 | نرخ تیک شبیهسازی سرور. |
maxConcurrentAssetTransfers | 4 | حداکثر دانلود همزمان داراییها. |
loginCredential | (خالی) | نام کاربری حساب Resonite برای headless. |
loginPassword | (خالی) | رمز عبور حساب Resonite. |
5. پیکربندی دنیا
هر مدخل در آرایه startWorlds یک نشست دنیا را تعریف میکند. تنظیمات کلیدی دنیا:
| تنظیم | پیشفرض | توضیحات |
|---|---|---|
isEnabled | true | آیا این دنیا باید شروع شود. |
sessionName | null | نام نمایشی نشست. |
maxUsers | 32 | حداکثر کاربران در دنیا. |
accessLevel | Anyone | چه کسی میتواند بپیوندد: Anyone، RegisteredUsers، Contacts، ContactsPlus، Private. |
loadWorldPresetName | SpaceWorld | دنیای پیشساخته برای بارگذاری (مثلاً SpaceWorld، Grid، BasicEmpty). |
loadWorldURL | null | URL یک دنیای سفارشی برای بارگذاری به جای پیشساخته. |
autoRecover | true | بازیابی خودکار دنیا پس از کرش. |
autoSleep | true | خواباندن دنیا وقتی هیچ کاربری حضور ندارد. |
saveOnExit | false | ذخیره وضعیت دنیا هنگام خاموش شدن سرور. |
autosaveInterval | -1.0 | فاصله ذخیره خودکار بر حسب ثانیه (-1 = غیرفعال). |
hideFromPublicListing | null | پنهان کردن این نشست از لیست عمومی. |
awayKickMinutes | -1.0 | دقایق قبل از اخراج کاربران غیرفعال (-1 = غیرفعال). |
idleRestartInterval | -1.0 | ریاستارت دنیا پس از این تعداد ثانیه خالی بودن (-1 = غیرفعال). |
forcedRestartInterval | -1.0 | ریاستارت اجباری پس از این تعداد ثانیه صرفنظر از کاربران (-1 = غیرفعال). |
6. اتصال به سرور شما
- Resonite را روی رایانه یا هدست VR خود اجرا کنید.
- Session Browser را باز کنید (Dash Menu > Worlds).
- سرور خود را بر اساس نام نشست جستجو کنید.
- روی Join کلیک کنید تا وارد دنیا شوید.
برای نشستهای خصوصی، حساب headless باید کاربران را دعوت کند یا از autoInviteUsernames در پیکربندی استفاده کند.
7. چکلیست راهاندازی اولیه
Headless/Config/Config.jsonرا ویرایش کنید وloginCredentialوloginPasswordرا برای حساب Resonite خود تنظیم کنید.- یک
sessionNameبرای دنیای خود تنظیم کنید. - یک
loadWorldPresetNameانتخاب کنید یا یکloadWorldURLبرای دنیای سفارشی ارائه دهید. accessLevelرا برای کنترل اینکه چه کسی میتواند بپیوندد تنظیم کنید.- سرور را شروع کرده و تأیید کنید که
World running...در کنسول نمایش داده میشود.
مقالات مرتبط
- راهنمای مدیریت سرور Resonite
- چگونه IP و پورت سرور خود را پیدا کنید
- چگونه فایلها را از طریق SFTP آپلود کنید
نیاز به کمک دارید؟
اگر با سرور Resonite خود مشکلی دارید، یک تیکت پشتیبانی ارسال کنید و جزئیات سرور، توضیح مشکل و پیامهای خطا از کنسول GPanel را ضمیمه کنید.
