Agency-Admin التثبيت
لوحة إدارة لـ FiveM بتصميم Agency مع لوحة ويب كاملة على جهاز الكمبيوتر الخاص بك.
01التثبيت
- 1تأكد من تثبيت oxmysql وضبط mysql_connection_string
- 2ضع المورد في مجلد resources
- 3أضف ensure oxmysql وensure Agency-Admin إلى server.cfg، مع ensure screenshot-basic بينهما إذا أردت التقاط صورك الخاصة
- 4أضف صلاحية ACE: add_ace group.admin agencyadmin.use allow
- 5أضف نفسك: add_principal identifier.license:YOUR_LICENSE group.admin
- 6اختياري، لوحدة تحكم لوحة الويب وإعادة فحص الموارد وإعادة تشغيل الخادم: add_ace resource.Agency-Admin command allow
- 7لحفظ الإعدادات من لوحة الويب على إصدارات FXServer الأحدث: سطر واحد add_filesystem_permission Agency-Admin write <resource> لكل مورد في server.cfg، ثم أعد تشغيل الخادم مرة واحدة
- 8يُنشأ جدول agency_admin_data عند التشغيل الأول، ولا حاجة لاستيراد install.sql يدويًا
- 9التحديث: انسخ الملفات الجديدة فوق مجلد Agency-Admin دون حذفه، واحتفظ بملف config.lua ومجلد web/images/custom، ثم شغّل المورد من جديد
02المتطلبات
oxmysql (مطلوب)screenshot-basic (اختياري، لالتقاط صورك الخاصة)
+من المفيد معرفته
تشرح هذه الصفحة كيفية تثبيت Agency-Admin الإصدار 1.7.0 على خادم FiveM الخاص بك. قبل البدء، تأكد من وجود جميع التبعيات المطلوبة واتبع كل خطوة بالترتيب. تغطي العملية وضع المورد، تكوين الأذونات، وضمان تسلسل بدء التشغيل الصحيح في server.cfg لتثبيت سلس.
- التبعيات المطلوبة والاختيارية
- يتطلب Agency-Admin وجود oxmysql ليعمل. يجب أن يكون oxmysql مثبتًا وأن تضبط mysql_connection_string. إذا كنت تريد التقاط صور خاصة بك للمركبات، الشخصيات، الأجسام، أو الأسلحة، تأكد من تضمين screenshot-basic أيضًا.
- وضع المورد وبدء التشغيل
- ضع مجلد مورد Agency-Admin في دليل الموارد الخاص بالخادم. في server.cfg الخاص بك، أضف ensure oxmysql و ensure Agency-Admin. إذا كنت تخطط لاستخدام ميزة الصور داخل اللعبة، أضف ensure screenshot-basic بينهما. يضمن هذا الترتيب تحميل جميع التبعيات بشكل صحيح قبل بدء Agency-Admin.
- تعيين الأذونات وإضافة المسؤولين
- لمنح الوصول، أضف إذن ACE: add_ace group.admin agencyadmin.use allow. قم بتعيين نفسك إلى مجموعة المسؤولين باستخدام: add_principal identifier.license:YOUR_LICENSE group.admin. يتيح هذا الإعداد للمستخدمين المعينين الوصول إلى لوحة الإدارة باستخدام أسماء الأوامر المكونة في الإعدادات.
?الأسئلة المتكررة
ما هي الأذونات المطلوبة لاستخدام Agency-Admin؟
يجب عليك إضافة إذن ACE add_ace group.admin agencyadmin.use allow لمنح الوصول. ثم قم بتعيين المستخدمين إلى مجموعة المسؤولين باستخدام add_principal identifier.license:YOUR_LICENSE group.admin. فقط المستخدمون الذين لديهم هذه الأذونات يمكنهم استخدام أوامر لوحة الإدارة كما هو معرف في الإعدادات.
ما هي التبعيات التي يجب تثبيتها لـ Agency-Admin؟
oxmysql مطلوب لكي يعمل Agency-Admin. إذا كنت تريد التقاط صور داخل اللعبة للمركبات أو الشخصيات أو الأشياء أو الأسلحة، فإن screenshot-basic اختياري ومطلوب فقط لذلك.
ماذا أفعل إذا لم تفتح لوحة الإدارة؟
تحقق من تثبيت oxmysql وأن mysql_connection_string مضبوط. تأكد من تكوين الأذونات بشكل صحيح باستخدام add_ace و add_principal. أكد أنك أضفت ensure oxmysql و ensure Agency-Admin في ملف server.cfg، وأن اسم الأمر في الإعدادات يطابق ما تستخدمه.
هل أحتاج إلى استيراد أي ملفات SQL يدويًا؟
لا حاجة لاستيراد SQL يدوي. يتم إنشاء جدول agency_admin_data تلقائيًا عند أول تشغيل للموارد، لذلك لا تحتاج إلى تشغيل أي سكربتات install.sql أو ما شابه لإعداد قاعدة البيانات.