Agency-Reports: أداة التبليغ الإدارية في FiveM التي تُستخدم فعليًا

حالة تقارير FiveM في 2026

لا تزال معظم الخوادم تستخدم تذاكر Discord أو أمر دردشة داخل اللعبة لتقارير اللاعبين. كلاهما معطل. لا يحتوي Discord على سياق اللاعب؛ وأمر الدردشة يفقد كل شيء بمجرد انقطاع اتصال اللاعب المبلغ. ينتهي الأمر بالمسؤولين بلعب دور المحقق عندما يجب أن يكونوا حكمًا. Agency-Reports هو الأداة التي تمنينا وجودها عندما كنا ندير خادمنا الخاص.

التقاط السياق تلقائيًا

عندما يقدم اللاعب تقريراً، نلتقط تلقائياً إحداثياته، معرفات اللاعبين القريبين، السلاح المجهز، المركبة، وآخر 60 ثانية من الدردشة. يرى المسؤولون المشهد، وليس فقط الاتهام. هذا وحده يقلل وقت التحقيق إلى النصف.

توجيه ذكي

يتم توجيه التقارير إلى الموظفين بناءً على النوع، الأولوية، والموظفين المتصلين حالياً. الغش يذهب إلى المسؤولين التقنيين، نزاعات RP إلى مسؤولي RP، التحرش إلى من هو في الخدمة. تقارير غير متصلة تُرتب وتُنبه على Discord. لا مزيد من "هل يتعامل أحد مع هذا؟" في دردشة الموظفين.

تتبع الحلول

كل تقرير له حالة: مفتوح، مُطالب به، قيد التحقيق، محلول، مغلق. يكتب المسؤولون ملاحظات الحل التي تبقى مع التقرير إلى الأبد. بعد ستة أشهر عندما يقدم نفس اللاعب تقريراً آخر، يكون تاريخه على بعد نقرة واحدة. هذه هي طريقة عمل فرق الإشراف المهنية في ألعاب MMO، وهي متأخرة في FiveM.

حلقة تغذية راجعة للاعب

عندما يُحل تقرير، يحصل المبلغ على رسالة قصيرة تشرح ما حدث. حتى إذا كانت الإجابة "تم المراجعة، لا حاجة لاتخاذ إجراء"، يشعر اللاعبون بأنهم مسموعون بدلاً من تجاهلهم. المجتمعات التي تشعر بأنها مسموعة تبقى وفية؛ هذه هي آلية الاحتفاظ الفعلية وراء أدوات الإشراف الجيدة.

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

Agency-Reports requires oxmysql for report history persistence. Import reports.sql، اسقط مجلد المورد، وأضف ensure agency-reports إلى server.cfg. اربط webhook الخاص بـ Discord في config.lua لإعادة توجيه التنبيهات في وضع عدم الاتصال. عند التشغيل الأول، يتم تهيئة قواعد التوجيه من التكوين الخاص بك، ولا يلزم إعداد قاعدة بيانات إضافي.

واجهة تقرير داخل اللعبة يفتحها اللاعبون بمفتاح قابل للتكوين (الافتراضي: F9 أو أمر دردشة). لوحة الإدارة هي لوحة منفصلة متاحة فقط للاعبين الذين لديهم أذونات الإدارة.

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

ال config.lua يتحكم في التوجيه، الاحتفاظ، وسلوك واجهة المستخدم:

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

توافق الإطار

Agency-Reports works on QBCore, ESX, and standalone. The only framework-touching component is the permission check for admin dashboard access. For standalone setups, implement Config.IsAdmin(src, level) في config.lua. كل تخزين التقارير، التوجيه، وواجهة المستخدم مستقلة عن الإطار.

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

كل تقرير لاعب غير محلول هو عجز في الثقة. عندما يقدم اللاعب تقريراً ولا يسمع ردًا، إما أن يتولى الأمور بنفسه (مما يصعد الوضع) أو يبتعد تماماً عن الخادم. يغلق Agency-Reports حلقة التغذية الراجعة هذه من خلال نظام رسالة الحل، حيث يعرف اللاعبون أن تقريرهم تم استلامه ومعالجته حتى لو لم تكن النتيجة كما توقعوا.

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

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

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

هل يمكن للاعبين إرفاق لقطات شاشة أو أدلة فيديو بالتقرير؟

يمكن للاعبين إرفاق رابط URL للأدلة الخارجية (Imgur، YouTube، Medal.tv). لا يدعم رفع الملفات مباشرة إلى الخادم لأسباب أمنية وتخزينية. تتضمن التقارير المرتبطة بـ Discord رابط الدليل في إشعار Discord للمراجعة السهلة.

ماذا يحدث للتقارير عندما ينقطع اتصال اللاعب الذي أبلغ؟

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

هل يمكننا دمج Agency-Reports مع بوت التذاكر الحالي لدينا؟

نعم، عبر إعادة توجيه webhook الخاص بـ Discord. إذا كان بوت التذاكر الخاص بك يقرأ من قناة Discord، وجه webhook إلى تلك القناة وتظهر التقارير كرسائل Discord يمكن للبوت معالجتها. للتكامل الأوثق، يطلق المورد حدثاً جانب الخادم agency-reports:onNewReport التي يمكن لأي سكريبت على جانب الخادم الاستماع إليها.

هل هناك ميزة إغلاق جماعي لأحداث الإبلاغ الجماعي؟

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

المتطلبات

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

تدريب الموظفين مع Agency-Reports

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

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

للمجتمعات التي تنتقل من إدارة التذاكر عبر Discord إلى Agency-Reports، شغّل كلا النظامين بالتوازي لمدة أسبوعين إلى أربعة أسابيع. دع الطاقم يستخدم النظام الذي يفضلونه مع تتبع وقت الحل ورضا المبلغ. عادةً ما تظهر البيانات أن Agency-Reports تحل التذاكر بشكل أسرع؛ استخدم هذا الدليل لدفع التبني الطوعي بدلاً من فرض التبديل.