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

The Gap Between Hobbyist and Professional Tooling

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

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

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

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

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

إدارة الحظر

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

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

Agency-Admin ships with a configurable detection layer that flags suspicious patterns: sudden money spikes, impossible teleports, rapid item duplication, unusual weapon spawns. Flags surface in the admin dashboard with full context. We're not an anticheat, we're a detection tool that makes admin response time drop from hours to minutes.

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

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 works on QBCore, ESX, and standalone setups. The permission layer is the only framework-touching piece, everything else (UI, logging, ban system, detection engine) is framework-agnostic. For custom frameworks, the compatibility shim is four functions in config.lua.

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

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

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

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

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

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

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

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

Agency-Admin logs the full identifier set (license, steam, discord, IP) at ban time. On reconnect attempts it checks all identifiers, not just the one used for login. For servers with persistent ban evasion issues, the dashboard includes a flagging system for suspicious identifier patterns.

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

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

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

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

المتطلبات

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

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

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

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

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

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