این راهنما دستورات کنسول headless، مدیریت نشست، راهاندازی بارگذار ماد و عیبیابی سرور Resonite شما را پوشش میدهد. برای راهاندازی اولیه، راهنمای راهاندازی سرور Headless Resonite را ببینید.
1. دستورات کنسول Headless
سرور headless Resonite دستورات را از طریق کنسول GPanel قبول میکند. سرور به دستور shutdown برای خاموش شدن مرتب پاسخ میدهد.
| دستور | توضیحات |
|---|---|
worlds |
لیست تمام نشستهای دنیای فعال. |
focus <world_index> |
تمرکز بر یک دنیای خاص برای اجرای دستورات. |
status |
نمایش وضعیت دنیای متمرکز. |
users |
لیست کاربران در دنیای متمرکز. |
kick <username> |
اخراج یک کاربر از دنیای متمرکز. |
ban <username> |
مسدود کردن یک کاربر از دنیای متمرکز. |
silence <username> |
بیصدا کردن یک کاربر در دنیای متمرکز. |
unsilence <username> |
لغو بیصدا کردن یک کاربر. |
respawn <username> |
بازتولد یک کاربر در نقطه مبدأ دنیا. |
role <username> <role> |
تنظیم نقش یک کاربر (Admin، Builder، Moderator، Guest، Spectator). |
name <session_name> |
تغییر نام نشست متمرکز. |
accessLevel <level> |
تغییر اینکه چه کسی میتواند بپیوندد (Anyone، RegisteredUsers، Contacts، ContactsPlus، Private). |
maxUsers <count> |
تغییر حداکثر تعداد کاربران برای دنیای متمرکز. |
save |
ذخیره دنیای متمرکز. |
close |
بستن دنیای متمرکز. |
restart |
ریاستارت دنیای متمرکز. |
invite <username> |
دعوت یک کاربر به دنیای متمرکز. |
message <text> |
ارسال پیام به دنیای متمرکز. |
shutdown |
خاموش کردن مرتب کل سرور headless. |
2. سطوح دسترسی
با تنظیم accessLevel کنترل کنید چه کسی میتواند به نشستهای دنیای شما بپیوندد:
| سطح | توضیحات |
|---|---|
| Anyone | باز برای تمام کاربران Resonite. |
| RegisteredUsers | فقط حسابهای ثبتشده Resonite. |
| Contacts | فقط کاربران در لیست مخاطبین حساب headless. |
| ContactsPlus | مخاطبین و مخاطبین مخاطبین. |
| Private | فقط با دعوت. |
3. نقشهای کاربر
نقشها را تخصیص دهید تا کنترل کنید کاربران در دنیای شما چه کارهایی میتوانند انجام دهند:
| نقش | توضیحات |
|---|---|
| Admin | کنترل کامل بر دنیا. |
| Builder | امکان ساخت و تغییر اشیاء. |
| Moderator | امکان اخراج/مسدود کردن کاربران و مدیریت چت. |
| Guest | دسترسی کاربر استاندارد. |
| Spectator | امکان مشاهده بدون تعامل. |
نقشهای پیشفرض را در Config.json با استفاده از defaultUserRoles تنظیم کنید یا آنها را برای هر کاربر با دستور کنسول role تخصیص دهید.
4. چندین دنیا
سرور headless میتواند چندین دنیا را بهصورت همزمان میزبانی کند. مدخلهای اضافی را به آرایه startWorlds در Headless/Config/Config.json اضافه کنید:
"startWorlds": [
{
"isEnabled": true,
"sessionName": "World 1",
"maxUsers": 16,
"accessLevel": "Anyone",
"loadWorldPresetName": "SpaceWorld"
},
{
"isEnabled": true,
"sessionName": "World 2",
"maxUsers": 8,
"accessLevel": "Contacts",
"loadWorldPresetName": "Grid"
}
]از focus 0 و focus 1 در کنسول برای جابهجایی بین دنیاها استفاده کنید.
5. بارگذار ماد
Resonite از مادها از طریق ResoniteModLoader پشتیبانی میکند. برای فعالسازی:
ENABLE_MODLOADERرا در تب Startup رویtrueتنظیم کنید.- سرور را دوباره نصب یا ریاستارت کنید -- فایلهای DLL بارگذار ماد بهصورت خودکار دانلود میشوند.
- فایلهای DLL ماد را از طریق SFTP در دایرکتوری
rml_mods/قرار دهید. - سرور را ریاستارت کنید تا مادها بارگذاری شوند.
فایلهای بارگذار ماد:
Libraries/ResoniteModLoader.dll-- بارگذار ماد اصلی.rml_libs/0Harmony.dll-- وابستگی ضروری.rml_mods/-- فایلهای DLL ماد خود را اینجا قرار دهید.
6. عیبیابی
- سرور شروع نمیشود: اطلاعات ورود در
Config.jsonرا تأیید کنید. headless باید با یک حساب معتبر Resonite احراز هویت شود. - دنیا در مرورگر نمایش داده نمیشود: بررسی کنید
hideFromPublicListingرویtrueتنظیم نشده باشد. مطمئن شویدaccessLevelبه کاربران جستجوکننده اجازه دسترسی میدهد. - "World running..." ظاهر نمیشود: کنسول را برای خطاها بررسی کنید. نام پیشساخته دنیا ممکن است نادرست باشد.
- مادها بارگذاری نمیشوند: تأیید کنید
ENABLE_MODLOADERرویtrueاست و فایلهای DLL ماد درrml_mods/هستند. کنسول را برای خطاهای بارگذار ماد بررسی کنید. - مصرف بالای منابع:
tickRateرا درConfig.jsonکاهش دهید یاmaxConcurrentAssetTransfersرا پایین بیاورید. محتوای پیچیده ساختهشده توسط کاربران میتواند منابع زیادی مصرف کند.
مقالات مرتبط
- راهنمای راهاندازی سرور Headless Resonite
- چگونه IP و پورت سرور خود را پیدا کنید
- چگونه فایلها را از طریق SFTP آپلود کنید
نیاز به کمک دارید؟
اگر به کمک بیشتری نیاز دارید، یک تیکت پشتیبانی ارسال کنید و جزئیات سرور و پیامهای خطا از کنسول GPanel را ضمیمه کنید.
