العودة إلى المدونة
Scripts5 دقيقة قراءة

Agency-Admin: أدوات احترافية لإدارة مجتمعات FiveM الحقيقية

صُمم Agency-Admin لفرق الخوادم التي تأخذ الإشراف بجدية. إليك شكل أدوات الإدارة الاحترافية في 2026.

Agency Scripts

المؤسس والمطور الرئيسي في Agency Scripts

الفجوة بين أدوات الهواة والمحترفين

معظم قوائم إدارة FiveM هي من مستوى الهواة: أزرار لإعطاء الأسلحة، التنقل، noclip، من هذا القبيل. تم بناء Agency-Admin للمجتمعات التي تأخذ الإشراف على محمل الجد كما يفعل فريق الإشراف في استوديو ألعاب حقيقي.

تسجيل الإجراءات مع السياق

كل إجراء إداري يُسجل في سجل مقاوم للتلاعب يحتوي على معرف المسؤول، الهدف، الإجراء، الطابع الزمني، والسبب. لم يعد هناك غموض حول "من أعطى ذلك اللاعب Rhino؟". يمكن الاستعلام عن السجلات من خلال واجهة الإدارة مع فلاتر للمسؤول، نطاق الوقت، ونوع الإجراء. هذه هي البنية الأساسية للمساءلة التي تحتاجها فرق العمل فعلاً.

مستويات الإذن

ثلاث مستويات مدمجة: مشرف (طرد، توقيت مؤقت، فحوصات أساسية للعناصر)، مسؤول (حظر، إعطاء عناصر، انتقال فوري)، مسؤول كبير (تغييرات التكوين، إدارة الأذونات، إدارة قاعدة البيانات). إجراءات كل مستوى محددة بدقة، لا يمكن للمشرف تصعيد نفسه عن طريق إيجاد ثغرة. لقد اختبرنا هذا النموذج مع عدة مجتمعات كبيرة خلال العامين الماضيين.

إدارة الحظر

يدعم الحظر مدة الحظر، السبب، رابط الدليل (لقطة شاشة أو رابط فيديو)، حالة الاستئناف، وملاحظات المراجعة. عندما يحاول لاعب محظور الانضمام مجددًا، تظهر له رسالة تتضمن السبب وإذا تم التكوين، رابط الاستئناف. الإدارة الشفافة هي إدارة فعالة.

كشف التهديدات في الوقت الحقيقي

يأتي Agency-Admin مزودًا بطبقة كشف قابلة للتهيئة ترصد الأنماط المشبوهة: ارتفاعات مفاجئة في الأموال، وانتقالات آنية مستحيلة، وتكرار سريع للعناصر، وظهور أسلحة غير معتاد. تظهر التنبيهات في لوحة تحكم الإدارة مع السياق الكامل. لسنا نظامًا لمكافحة الغش، بل أداة كشف تقلل زمن استجابة الإدارة من ساعات إلى دقائق.

التثبيت & الإعداد

Agency-Admin requires oxmysql for log persistence. Import admin.sql في قاعدة بياناتك، أضف المورد إلى خادمك، وأضف ensure agency-admin إلى server.cfg. يتم تعيين المسؤول الأولي من خلال config.lua، سرد أعلى معرفات الثقة الخاصة بك كمسؤولين كبار. جميع منح الأذونات الأخرى تُدار من خلال واجهة المستخدم داخل اللعبة من الآن فصاعدًا.

يكتشف المورد إطار عملك تلقائيًا عند بدء التشغيل. يتم تضمين خطافات الأذونات لـ QBCore وESX؛ الإعدادات المستقلة تنفذ Config.IsAdmin(src, level) function يدويًا.

خيارات التكوين

ال config.lua يغطي إعدادات الأذونات والكشف:

  • مستويات الإذن، أسماء وقدرات كل مستوى قابلة لإعادة التعريف بالكامل. نموذج المستويات الثلاثة الافتراضي هو نقطة انطلاق، وليس مطلبًا.
  • عتبات الكشف، قم بتكوين عتبة ارتفاع المال، حد مسافة الانتقال، وسرعة عدد العناصر التي تؤدي إلى تفعيل الأعلام.
  • رابط ويب هوك Discord ، يمكن إعادة توجيه جميع إجراءات الإدارة وأعلام الكشف إلى قناة Discord بالتوازي مع سجل داخل اللعبة.
  • رابط استئناف الحظر، عنوان URL المعروض للاعبين المحظورين في رسالة الحظر الخاصة بهم.
  • الاحتفاظ بالسجلات، عدد أيام الاحتفاظ بسجلات إجراءات الإدارة قبل التنظيف التلقائي. الافتراضي 90 يومًا.
  • وضع التخفي للمشرفين الكبار، يمكن للمشرفين الكبار تصفح الخادم بشكل مجهول دون الظهور في قوائم اللاعبين.

توافق الإطار

يعمل Agency-Admin على إعدادات QBCore وESX وstandalone. طبقة الصلاحيات هي الجزء الوحيد الذي يتفاعل مع إطار العمل، أما كل شيء آخر، بما في ذلك الواجهة وتسجيل السجلات ونظام الحظر ومحرك الكشف، فهو مستقل عن إطار العمل. ولأطر العمل المخصصة، تتكون طبقة التوافق من أربع دوال في config.lua.

لماذا هذا مهم للعب التمثيلي

صحة الخادم مرتبطة مباشرة بجودة الإشراف. المجتمعات التي لديها إشراف مرئي، متسق، ومسؤول تحتفظ باللاعبين لفترة أطول من تلك التي تعتمد على قرارات غير رسمية. سجل التدقيق في Agency-Admin هو آلية المسؤولية الأساسية: عندما يتم الطعن في قرار إشرافي، يوفر السجل السياق الدقيق لما حدث، متى، ومن الذي أذن به.

تغير طبقة الكشف موقف فريق الإدارة من رد الفعل إلى الاستباق. بدلاً من انتظار تقارير اللاعبين عن غشاش مشتبه به، تعرض لوحة التحكم الأنماط المشبوهة قبل أن تسبب ضررًا على مستوى الخادم. اكتشاف تكرار المال في الساعة الأولى يسبب ضررًا أقل بكثير من استمرار التكرار لمدة يومين دون اكتشاف.

نظام مستويات الأذونات يحمي من مخاطر الداخلين. مشرف جديد لديه نفس الوصول كمسؤول كبير هو مشكلة أمنية ومسؤولية. الأذونات المحددة بدقة تعني أنه حتى إذا انحرف أحد الموظفين، فإن نطاق الضرر محدود بمستواه.

الأسئلة المتكررة

هل يمكنني إضافة أوامر إدارة مخصصة تتكامل مع نظام الأذونات؟

نعم. استخدم exports['agency-admin']:RegisterCommand(name, tier, handler) لتسجيل أوامر مخصصة ترث فحوصات الأذونات والتسجيل التلقائي من Agency-Admin. يظهر أمرك في قائمة الأوامر بواجهة الإدارة ويتم تسجيله بنفس طريقة الإجراءات المدمجة.

كيف يتعامل نظام الحظر مع VPN/الحسابات البديلة؟

يسجل Agency-Admin مجموعة المعرّفات كاملة (license وsteam وdiscord وIP) عند الحظر. وعند محاولة إعادة الاتصال، يتحقق من جميع المعرّفات، وليس المعرّف المستخدم لتسجيل الدخول فحسب. وتتضمن لوحة التحكم نظامًا لوضع علامات على أنماط المعرّفات المشبوهة للخوادم التي تواجه مشكلات مستمرة مع التهرب من الحظر.

هل يمكن للمشرفين رؤية علامات الكشف قبل اتخاذ إجراء؟

تظهر الأعلام لجميع المسؤولين الذين لديهم رتبة مساوية أو أعلى من الحد الأدنى المكون لهذا النوع من الأعلام. الأعلام الخاصة بزيادة المال مرئية لجميع المسؤولين؛ الأعلام التي تمنع التنقل عن بعد توجه فقط إلى المسؤولين التقنيين بشكل افتراضي. كما يتم تسجيل جميع عمليات عرض الأعلام، ويمكن للمسؤولين رؤية الأعلام التي راجعها زملاؤهم والإجراء المتخذ (إن وجد).

هل يتعارض Agency-Admin مع قوائم الإدارة الأخرى مثل vMenu أو qb-adminmenu؟

لا تعارض. يمكن لـ Agency-Admin التعايش مع قوائم أخرى، فهي تعمل على مفاتيح مختلفة ولا تشارك الحالة. بعض الخوادم تشغل Agency-Admin جنبًا إلى جنب مع قائمة إدارة قديمة أثناء الانتقال، باستخدام Agency-Admin للتسجيل والكشف مع الاحتفاظ بالأوامر المألوفة لأعضاء الطاقم المخضرمين.

المتطلبات

  • خادم FiveM (QBCore، ESX، أو مستقل)
  • oxmysql
  • حساب cfx.re مع ترخيص Agency-Admin صالح
  • اختياري: Agency-Reports (للتعامل المتكامل مع تقارير اللاعبين)

بناء ثقافة الموظفين حول الأدوات

أفضل أدوات الإدارة في العالم لا تفيد إذا لم تدعم ثقافة موظفيك المساءلة. سجل التدقيق في Agency-Admin هو الأكثر قيمة في المجتمعات حيث يعرف الموظفون أن أفعالهم تُسجل ويقبلون ذلك كإجراء تشغيلي قياسي بدلاً من مراقبة.

حدد في وقت مبكر أن جميع إجراءات الإدارة تمر عبر واجهة التسجيل. قاوم إغراء تجاوز التسجيل "مرة واحدة فقط" للإصلاحات السريعة، قيمة السجل تكمن في اكتماله. السجل الذي يحتوي على فجوات سيء تقريبًا مثل عدم وجود سجل على الإطلاق عندما تحتاج إلى إعادة بناء الأحداث.

استخدم علامات الكشف في مراجعات الموظفين الأسبوعية بدلاً من استخدامها فقط عند حدوث خطأ ما. مراجعة علامات الأسبوع حتى عندما لا يحدث شيء ملحوظ تبني الألفة مع ما يبدو طبيعيًا، مما يجعل الشذوذات واضحة عند ظهورها.

نظام مستويات الأذونات يعمل بشكل أفضل عندما تكون الترقيات عبر المستويات معالم ذات معنى. المشرف الذي يحصل على وصول إداري بعد ثلاثة أشهر من العمل النظيف المسجل لديه سياق واستثمار لا توفره المنح الفورية للوصول الكامل.

السكربت المناسب

جاهز لسيرفرك مع التحديثات المضمّنة.

جاهز للبدء؟

احصل على السكربتات من متجرنا، أو انضم إلى Discord للدعم والتحديثات ونظرة على ما هو قادم.