يغطي هذا الدليل أوامر وحدة التحكم headless، وإدارة الجلسات، وإعداد محمل التعديلات، واستكشاف الأخطاء وإصلاحها لخادم Resonite الخاص بك. للإعداد الأولي، راجع دليل إعداد خادم Resonite Headless.
1. أوامر وحدة التحكم Headless
يقبل خادم Resonite headless الأوامر عبر وحدة تحكم 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علىtrueفي تبويب Startup. - أعد التثبيت أو أعد تشغيل الخادم -- سيتم تنزيل ملفات محمل التعديلات تلقائياً.
- ضع ملفات DLL الخاصة بالتعديلات في مجلد
rml_mods/عبر SFTP. - أعد تشغيل الخادم لتحميل التعديلات.
ملفات محمل التعديلات:
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. قد يكون المحتوى الذي أنشأه المستخدمون معقداً ويستهلك موارد كثيرة.
مقالات ذات صلة
- دليل إعداد خادم Resonite Headless
- كيفية العثور على عنوان IP والمنفذ الخاص بخادمك
- كيفية رفع الملفات عبر SFTP
هل تحتاج مساعدة؟
إذا كنت بحاجة إلى مزيد من المساعدة، افتح تذكرة دعم مع تفاصيل خادمك وأي رسائل خطأ من وحدة تحكم GPanel.
