يغطي هذا الدليل إعداد المشرف، وأوامر وحدة التحكم، ونظام حزم Lua، وإدارة اللاعبين والمركبات، وتكوين قاعدة البيانات لخادم Onset المخصص على Legion Hosting. لإعداد الخادم الأولي، راجع دليل إعداد خادم Onset.
إعداد المشرف
يتعامل Onset مع صلاحيات المشرف من خلال برمجة Lua ضمن حزم أوضاع اللعب الخاصة بك. على عكس العديد من الألعاب التي تحتوي على أنظمة إدارة مدمجة، يعتمد Onset على حزمك لتحديد من لديه صلاحيات مرتفعة وما تسمح به تلك الصلاحيات.
تتضمن معظم حزم أوضاع اللعب المجتمعية نظام إدارة. عادةً ما يتضمن إعداد المشرف:
- افتح مدير الملفات في GPanel
- انتقل إلى مجلد الحزمة الخاصة بك (مثل
packages/mygamemode/) - حدد موقع ملف تكوين المشرف (غالبًا
config.luaأوadmins.luaأو ملف تكوين JSON) - أضف Steam64 ID أو معرف اللاعب داخل اللعبة إلى قائمة المشرفين
- احفظ الملف وأعد تشغيل الخادم
-- Example: config.lua admin setup
Config = {}
Config.Admins = {
"76561198000000001", -- Your Steam64 ID
"76561198000000002" -- Another admin
}
أوامر وحدة تحكم الخادم
يوفر Onset أوامر وحدة تحكم مدمجة تعمل بغض النظر عن الحزم المثبتة. يمكن إدخال هذه الأوامر مباشرة في وحدة تحكم GPanel.
| الأمر | الوصف |
|---|---|
help |
يعرض جميع أوامر وحدة التحكم المتاحة |
stop |
يوقف الخادم بشكل سلس |
restart |
يعيد تشغيل الخادم |
players |
يعرض جميع اللاعبين المتصلين مع معرفاتهم |
kick <playerid> [reason] |
يطرد لاعبًا من الخادم |
ban <playerid> [reason] |
يحظر لاعبًا من الخادم |
unban <steamid> |
يزيل الحظر عن Steam ID المحدد |
package reload <name> |
يعيد تحميل حزمة بدون إعادة تشغيل الخادم |
package start <name> |
يبدأ تشغيل حزمة غير نشطة حاليًا |
package stop <name> |
يوقف حزمة قيد التشغيل |
package list |
يعرض جميع الحزم المحملة وحالتها |
نظام الحزم (برمجة Lua)
يتم تحديد أسلوب اللعب في Onset بالكامل من خلال حزم مكتوبة بلغة Lua. كل حزمة هي مجلد داخل مجلد packages/ يحتوي على سكربتات Lua تعمل على جانب الخادم و/أو جانب العميل.
هيكل الحزمة
packages/
mygamemode/
package.json <-- Package metadata and file declarations
server/
main.lua <-- Server-side entry point
commands.lua <-- Custom command handlers
client/
main.lua <-- Client-side entry point
ui.lua <-- User interface scripts
تثبيت الحزم
- قم بتنزيل الحزمة من منتديات مجتمع Onset أو مستودعات GitHub
- اتصل بخادمك عبر SFTP
- ارفع مجلد الحزمة إلى مجلد
packages/ - افتح
server_config.jsonفي مدير الملفات - أضف اسم مجلد الحزمة إلى مصفوفة
"packages" - أعد تشغيل الخادم من خلال GPanel
// server_config.json - Adding packages
{
"packages": [
"roleplay",
"admintools",
"vehicleshop"
]
}
"packages" بالترتيب المدرجة به. إذا كانت إحدى الحزم تعتمد على أخرى، تأكد من إدراج الحزمة المطلوبة أولاً.
إدارة اللاعبين
بالإضافة إلى أوامر الطرد والحظر المدمجة، توفر معظم حزم أوضاع اللعب ميزات إضافية لإدارة اللاعبين. تشمل الأوامر الشائعة التي توفرها الحزم:
| الأمر (يعتمد على الحزمة) | الوصف |
|---|---|
/tp <player> |
الانتقال إلى لاعب آخر |
/bring <player> |
نقل لاعب آخر إلى موقعك |
/goto <x> <y> <z> |
الانتقال إلى إحداثيات محددة في العالم |
/setadmin <player> <level> |
تعيين مستوى إدارة اللاعب (إذا كانت الحزمة تدعم المستويات) |
/announce <message> |
إرسال إعلان على مستوى الخادم |
إدارة المركبات
يتميز Onset بنظام مركبات مدمج يمكن للحزم توسيعه. يحتاج المشرفون عادةً إلى إدارة المركبات المُنشأة لمنع ازدحام الخادم.
- إنشاء المركبات — تتيح معظم حزم RP للمشرفين إنشاء مركبات عبر أوامر مثل
/car <model> - تنظيف المركبات — تتضمن بعض الحزم إزالة تلقائية للمركبات المهجورة أو أوامر مشرف مثل
/destroyvehicles - حدود المركبات — قم بتكوين الحد الأقصى للمركبات لكل لاعب لمنع التأخير الناتج عن كثرة الكيانات المُنشأة
قاعدة البيانات (MariaDB)
يدعم Onset اتصالات قواعد بيانات MariaDB/MySQL لتخزين البيانات بشكل دائم. يُستخدم هذا من قبل حزم لعب الأدوار وأوضاع اللعب الأخرى لتخزين بيانات اللاعبين والمخزونات والممتلكات والمزيد.
يتم التعامل مع تكوين قاعدة البيانات ضمن ملفات تكوين الحزمة الخاصة بك. إعداد نموذجي:
-- Database configuration in package config
Database = {
host = "127.0.0.1",
port = 3306,
username = "onset_user",
password = "your_password",
database = "onset_gamemode"
}
استكشاف الأخطاء وإصلاحها
| المشكلة | الحل |
|---|---|
| الخادم يعمل لكن لا يوجد أسلوب لعب متاح | تحتاج إلى تثبيت حزمة وضع لعب واحدة على الأقل وإدراجها في server_config.json. خادم Onset الأساسي لا يحتوي على أسلوب لعب مدمج. |
| فشل تحميل الحزمة | تحقق من وحدة تحكم GPanel بحثًا عن رسائل خطأ Lua. الأسباب الشائعة: package.json مفقود، أخطاء في صياغة ملفات Lua، أو تبعيات مفقودة. |
| أخطاء اتصال قاعدة البيانات | تحقق من بيانات اعتماد قاعدة البيانات، وتأكد من وجود قاعدة البيانات، وتحقق من أن خدمة MariaDB قيد التشغيل. اختبر الاتصال من سجلات وحدة التحكم. |
| الخادم غير مرئي في المتصفح | تأكد من تعيين "visible": true في server_config.json. تحقق أيضًا من إمكانية الوصول إلى المنفذ 7776 (TCP) لمنفذ الاستعلام. |
| تأخير أو تقطع عالي | قلل قيمة streamdistance، وخفض tickrate إذا كان استخدام المعالج مرتفعًا، وتحقق من سكربتات Lua غير الفعالة في حزمك. |
مقالات ذات صلة
- دليل إعداد خادم Onset
- كيفية العثور على عنوان IP والمنفذ لخادمك
- كيفية رفع الملفات عبر SFTP
- البدء مع خادمك الجديد
تحتاج مساعدة؟
إذا كنت تواجه مشاكل مع خادم Onset الخاص بك أو تحتاج إلى مساعدة إضافية، فريق الدعم لدينا هنا للمساعدة. أرسل تذكرة دعم وسنرد عليك في أقرب وقت ممكن.