این راهنما دستورات کنسول headless، مدیریت جهان، نقشهای کاربری، NeosModLoader و عیبیابی سرور اختصاصی NeosVR شما را پوشش میدهد. NeosVR یک متاورس واقعیت مجازی اجتماعی با ابزارهای خلق قدرتمند است. برای راهاندازی اولیه، پیکربندی Config.json و دستورالعملهای اتصال، به راهنمای راهاندازی سرور NeosVR مراجعه کنید.
1. دسترسی به کنسول
سرور headless NeosVR خود را از طریق تب Console در GPanel مدیریت کنید. تمام دستورات مستقیماً در کنسول تایپ میشوند.
2. دستورات کنسول Headless
مدیریت جهان
| دستور | توضیحات |
|---|---|
worlds | لیست تمام جهانهای در حال اجرا به همراه شاخصهایشان. |
focus <world_index> | تغییر فوکوس به یک جهان خاص بر اساس شاخص. |
startWorldURL <record_url> | شروع یک جهان جدید از یک URL رکورد Neos. |
startWorldTemplate <template> | شروع یک جهان از یک قالب داخلی (مثلاً SpaceWorld). |
save | ذخیره جهان فعلی فوکوسشده. |
close | بستن جهان فعلی فوکوسشده. |
restart | راهاندازی مجدد جهان فعلی فوکوسشده. |
مدیریت نشست
| دستور | توضیحات |
|---|---|
sessionURL | نمایش URL نشست برای جهان فوکوسشده. |
sessionID | نمایش شناسه نشست برای جهان فوکوسشده. |
name <new_name> | تغییر نام نشست جهان فوکوسشده. |
accessLevel <level> | تغییر سطح دسترسی: Anyone، RegisteredUsers، ContactsPlus، Contacts، Private. |
maxUsers <count> | تنظیم حداکثر تعداد کاربران برای نشست. |
hideFromListing <true/false> | تغییر نمایش در مرورگر نشست عمومی. |
description <text> | تنظیم توضیحات نشست. |
مدیریت کاربران
| دستور | توضیحات |
|---|---|
users | لیست تمام کاربران در جهان فوکوسشده. |
kick <username> | اخراج یک کاربر از جهان. |
ban <username> | مسدود کردن یک کاربر از جهان. |
silence <username> | بیصدا کردن یک کاربر (قطع صدای او). |
unsilence <username> | رفع بیصدایی یک کاربر که قبلاً بیصدا شده بود. |
respawn <username> | بازتولد یک کاربر در نقطه شروع جهان. |
role <username> <role> | اختصاص یک نقش به کاربر (بخش ۳ را ببینید). |
کنترل سرور
| دستور | توضیحات |
|---|---|
status | نمایش وضعیت سرور و مصرف منابع. |
shutdown | خاموش کردن منظم سرور headless. |
gc | اجرای اجباری جمعآوری زباله برای آزادسازی حافظه. |
tickRate <rate> | تغییر نرخ تیک سرور در زمان اجرا. |
3. نقشهای کاربری
NeosVR از یک سلسلهمراتب نقش برای مجوزهای جهان استفاده میکند:
| نقش | توضیحات |
|---|---|
Admin | کنترل کامل جهان. میتواند هر چیزی را تغییر دهد، کاربران را مدیریت کند و تنظیمات جهان را عوض کند. |
Builder | میتواند اشیاء را در جهان ایجاد و ویرایش کند. |
Moderator | میتواند کاربران را اخراج/مسدود کند و تنظیمات نشست را مدیریت کند. |
Guest | دسترسی پایه. میتواند با اشیاء موجود تعامل داشته باشد اما نمیتواند بسازد. |
Spectator | دسترسی فقط مشاهده. نمیتواند با جهان تعامل داشته باشد. |
اختصاص نقشها از طریق کنسول: role <username> Admin
همچنین میتوانید نقشهای پیشفرض را در Config.json با استفاده از تنظیم defaultUserRoles تعیین کنید.
4. NeosModLoader
NeosModLoader امکان بارگذاری مادهای ساختهشده توسط جامعه را در سرور headless فراهم میکند.
- ENABLE_MODLOADER را در متغیرهای Startup GPanel روی
trueتنظیم کنید. - مادها را از گیتهاب NeosModLoader دانلود کنید.
- فایلهای
.dllماد را از طریق SFTP به پوشهnml_mods/آپلود کنید. - سرور را برای بارگذاری مادها راهاندازی مجدد کنید.
5. عیبیابی
سرور شروع نمیشود
- بررسی کنید که STEAM_USER و STEAM_PASS شما صحیح باشند.
- مطمئن شوید که SRCDS_BETAPASS (رمز بتای کلاینت headless) از Discord Patreon Neos بهروز باشد.
- اگر از Steam Guard 2FA استفاده میکنید، کد را در STEAM_AUTH وارد کنید و سریعاً سرور را راهاندازی مجدد کنید.
جهان بارگذاری نمیشود
- بررسی کنید که
Config.jsonیک JSON معتبر باشد (بدون ویرگول اضافی، با براکتهای صحیح). - اطمینان حاصل کنید که
loginCredentialوloginPasswordدرConfig/Config.jsonبه درستی تنظیم شدهاند. - مطمئن شوید که URL جهان یا نام پیشتنظیم معتبر است.
کاربران نمیتوانند بپیوندند
- بررسی کنید که
accessLevelرویPrivateتنظیم نشده باشد مگر اینکه عمداً باشد. - اطمینان حاصل کنید که
maxUsersبه حد خود نرسیده باشد. - مطمئن شوید که headless وارد شده است (خروجی کنسول را برای تأیید ورود بررسی کنید).
مقالات مرتبط
- راهنمای راهاندازی سرور NeosVR
- چگونه IP و پورت سرور خود را پیدا کنیم
- چگونه فایلها را از طریق SFTP آپلود کنیم
نیاز به کمک دارید؟
اگر با مشکلاتی در سرور NeosVR خود مواجه شدید که در اینجا پوشش داده نشدهاند، یک تیکت پشتیبانی ارسال کنید و IP سرور، توضیحات مشکل و هرگونه پیام خطای مرتبط از کنسول GPanel را شامل کنید.
