ब्लॉग पर वापस
Scripts7 मिनट पढ़ें

Agency-Reports: वह FiveM एडमिन रिपोर्टिंग टूल जो वास्तव में उपयोग होता है

Agency-Reports उन तीन चीज़ों को ठीक करता है जो हर अन्य FiveM रिपोर्टिंग टूल गलत करता है: रूटिंग, संदर्भ, और समाधान ट्रैकिंग।

Agency Scripts

Agency Scripts के संस्थापक और प्रमुख डेवलपर

2026 में FiveM रिपोर्ट्स की स्थिति

अधिकांश सर्वर अभी भी खिलाड़ी रिपोर्ट के लिए Discord टिकट या इन-गेम चैट कमांड का उपयोग करते हैं। दोनों खराब हैं। Discord में कोई खिलाड़ी संदर्भ नहीं होता; एक चैट कमांड रिपोर्टिंग खिलाड़ी के डिस्कनेक्ट होते ही सब कुछ खो देता है। एडमिन को रेफरी की बजाय जासूस की भूमिका निभानी पड़ती है। Agency-Reports वह उपकरण है जिसकी हमें अपनी सर्वर स्टाफिंग के दौरान आवश्यकता थी।

स्वचालित रूप से कैप्चर किया गया संदर्भ

जब कोई खिलाड़ी रिपोर्ट दर्ज करता है, तो हम स्वचालित रूप से उनके निर्देशांक, निकटवर्ती खिलाड़ी आईडी, सुसज्जित हथियार, वाहन, और पिछले 60 सेकंड की चैट कैप्चर करते हैं। एडमिन्स को केवल आरोप नहीं बल्कि दृश्य भी दिखता है। यह अकेले जांच समय को आधा कर देता है।

स्मार्ट रूटिंग

रिपोर्ट्स प्रकार, प्राथमिकता, और वर्तमान ऑनलाइन स्टाफ के आधार पर स्टाफ को भेजे जाते हैं। चीटिंग टेक एडमिन को, RP विवाद RP एडमिन को, उत्पीड़न ड्यूटी पर मौजूद व्यक्ति को जाता है। ऑफलाइन रिपोर्ट्स कतार में लगती हैं और Discord पर अलर्ट करती हैं। स्टाफ चैट में "क्या कोई इसे संभाल रहा है?" की जरूरत नहीं।

समाधान ट्रैकिंग

हर रिपोर्ट की एक स्थिति होती है: खुला, दावा किया गया, जांच में, हल किया गया, बंद। एडमिन समाधान नोट लिखते हैं जो रिपोर्ट के साथ हमेशा रहते हैं। छह महीने बाद जब वही खिलाड़ी दूसरी रिपोर्ट करता है, तो उनका इतिहास एक क्लिक दूर होता है। यही तरीका है जिससे पेशेवर मॉडरेशन टीमें MMOs में काम करती हैं, FiveM में यह देरी से आया है।

खिलाड़ी प्रतिक्रिया लूप

जब कोई रिपोर्ट हल हो जाती है, तो रिपोर्टर को एक संक्षिप्त संदेश मिलता है जिसमें बताया जाता है कि क्या हुआ। भले ही जवाब "समीक्षा की गई, कोई कार्रवाई आवश्यक नहीं" हो, खिलाड़ी महसूस करते हैं कि उनकी सुनी गई है न कि अनदेखी की गई। समुदाय जो सुने जाने का अनुभव करते हैं वे वफादार रहते हैं; यही अच्छा मॉडरेशन टूलिंग के पीछे वास्तविक रिटेंशन मैकेनिक है।

इंस्टॉलेशन & सेटअप

Agency-Reports requires oxmysql for report history persistence. Import reports.sql , संसाधन फ़ोल्डर को ड्रॉप करें, और जोड़ें ensure agency-reports को server.cfg. अपने Discord webhook को कनेक्ट करें config.lua ऑफ़लाइन अलर्ट अग्रेषण के लिए। पहली बार शुरू करने पर, रूटिंग नियम आपके कॉन्फ़िग से प्रारंभ होते हैं, कोई अतिरिक्त डेटाबेस सेटअप आवश्यक नहीं।

इन-गेम रिपोर्ट UI खिलाड़ियों द्वारा एक कॉन्फ़िगर करने योग्य कीबाइंड (डिफ़ॉल्ट: F9 या एक चैट कमांड) से खोला जाता है। एडमिन डैशबोर्ड एक अलग पैनल है जो केवल एडमिन अनुमति फ्लैग वाले खिलाड़ियों के लिए सुलभ है।

कॉन्फ़िगरेशन विकल्प

यह config.lua रूटिंग, प्रतिधारण, और UI व्यवहार को नियंत्रित करता है:

  • रिपोर्ट श्रेणियाँ , जितनी चाहें श्रेणियाँ परिभाषित करें (धोखाधड़ी, उत्पीड़न, 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 में। सभी रिपोर्ट संग्रहण, रूटिंग, और UI फ्रेमवर्क-एग्नोस्टिक हैं।

क्यों यह रोलप्ले के लिए महत्वपूर्ण है

हर अनसुलझी खिलाड़ी रिपोर्ट एक विश्वास घाटा है। जब कोई खिलाड़ी रिपोर्ट करता है और कभी जवाब नहीं सुनता, तो वे या तो खुद ही मामला संभाल लेते हैं (स्थिति को बढ़ाते हुए) या पूरी तरह से सर्वर से अलग हो जाते हैं। Agency-Reports उस फीडबैक लूप को समाधान संदेश प्रणाली के माध्यम से बंद करता है, खिलाड़ी जानते हैं कि उनकी रिपोर्ट प्राप्त और संसाधित हो गई है भले ही परिणाम उनकी उम्मीद के अनुरूप न हो।

संदर्भ कैप्चर सिस्टम व्यावहारिक मॉडरेशन गुणक है। जो व्यवस्थापक घटना के पांच मिनट बाद जांच के लिए शामिल होते हैं उनके पास पूर्ण स्थिति संदर्भ होता है: हर कोई कहाँ खड़ा था, क्या कहा गया, आरोपी के पास क्या था। वे घटनाओं को पुनर्निर्मित करने के बजाय निर्णय लेने में समय बिताते हैं। जांच समय में यह संपीड़न सीधे प्रति घंटे एक व्यवस्थापक टीम द्वारा संभाले जा सकने वाले रिपोर्टों की संख्या बढ़ाता है।

छह महीने का इतिहास एक्सेस अक्सर नजरअंदाज किया गया फीचर है जो समुदायों की दीर्घकालिक सुरक्षा करता है। रिपोर्ट इतिहास के महीनों में पैटर्न पहचान उन खिलाड़ियों को पकड़ती है जो नियमों का धीरे-धीरे दुरुपयोग करते हैं, मध्यम नियम-उल्लंघनकर्ता जो प्रति माह तीन रिपोर्ट दर्ज करता है और उसके खिलाफ तीन हैं, हमेशा कार्रवाई सीमा के करीब रहता है। इतिहास उस पैटर्न को दृश्य बनाता है।

अक्सर पूछे जाने वाले प्रश्न

क्या प्लेयर्स रिपोर्ट में स्क्रीनशॉट या वीडियो सबूत संलग्न कर सकते हैं?

प्लेयर बाहरी सबूत (Imgur, YouTube, Medal.tv) के लिए एक URL संलग्न कर सकते हैं। सुरक्षा और संग्रहण कारणों से सीधे सर्वर पर फ़ाइल अपलोड समर्थित नहीं है। Discord-लिंक्ड रिपोर्टों में Discord सूचना में सबूत URL शामिल होता है ताकि समीक्षा आसान हो।

जब रिपोर्टिंग खिलाड़ी डिस्कनेक्ट हो जाता है तो रिपोर्ट्स का क्या होता है?

रिपोर्ट्स डेटाबेस में खिलाड़ी के कनेक्शन स्टेटस की परवाह किए बिना स्थायी रहते हैं। रिपोर्ट के समय सभी संदर्भ (निर्देशांक, चैट, आदि) संग्रहीत किए जाते हैं। एडमिन रिपोर्टर के जाने के बाद भी रिपोर्ट की जांच और समाधान कर सकते हैं, और समाधान संदेश अगले बार खिलाड़ी के जुड़ने पर भेजा जाता है।

क्या हम Agency-Reports को हमारे मौजूदा टिकट बॉट के साथ एकीकृत कर सकते हैं?

हाँ, Discord वेबहुक फॉरवर्डिंग के माध्यम से। यदि आपका टिकट बॉट Discord चैनल से पढ़ता है, तो वेबहुक को उस चैनल पर पॉइंट करें और रिपोर्ट्स Discord संदेशों के रूप में दिखाई देंगी जिन्हें आपका बॉट प्रोसेस कर सकता है। अधिक सघन एकीकरण के लिए, रिसोर्स एक सर्वर-साइड इवेंट फायर करता है। agency-reports:onNewReport जिसे कोई भी सर्वर-साइड स्क्रिप्ट सुन सकती है।

क्या मास रिपोर्ट इवेंट्स के लिए बल्क-क्लोज़ फीचर है?

हाँ। एडमिन डैशबोर्ड में रिपोर्ट सूची पर मल्टी-सेलेक्ट शामिल है। वरिष्ठ एडमिन कई रिपोर्ट्स का चयन कर सकते हैं, एकल समाधान नोट लागू कर सकते हैं, और उन्हें बैच के रूप में बंद कर सकते हैं। यह सर्वर इवेंट्स के बाद उपयोगी होता है जो एक ही घटना के बारे में डुप्लिकेट रिपोर्ट्स उत्पन्न करते हैं।

आवश्यकताएँ

  • FiveM सर्वर (QBCore, ESX, या standalone)
  • oxmysql
  • cfx.re खाता जिसमें वैध Agency-Reports लाइसेंस हो
  • Discord वेबहुक URL (ऑफ़लाइन अलर्टिंग के लिए)

Agency-Reports के साथ स्टाफ ऑनबोर्डिंग

नई मॉडरेटर विशेष रूप से Agency-Reports के संरचित वर्कफ़्लो से लाभान्वित होते हैं। सिस्टम उन्हें बिना व्यापक प्रशिक्षण के जांच प्रक्रिया के माध्यम से मार्गदर्शन करता है। एक नया मॉड जो अपनी पहली रिपोर्ट दर्ज करता है उसे स्वचालित रूप से पूरा संदर्भ मिलता है, उन्हें "क्या हुआ?" पूछने की जरूरत नहीं होती क्योंकि पूर्व-कैप्चर किया गया डेटा अधिकांश सवालों का जवाब देता है।

रिज़ॉल्यूशन नोट आवश्यकता (वैकल्पिक, लेकिन कॉन्फ़िग के माध्यम से प्रोत्साहित) एक प्रशिक्षण उपकरण है। "समीक्षित फुटेज, खिलाड़ी स्पष्ट रूप से नियम 3.2 का उल्लंघन कर रहा था, 24 घंटे का प्रतिबंध जारी किया" लिखना एक रिज़ॉल्यूशन नोट के रूप में मॉडरेटर को अपनी तर्कशक्ति व्यक्त करने के लिए मजबूर करता है। यह अभिव्यक्ति समय के साथ निर्णय गुणवत्ता में सुधार करती है और वृद्धि या अपील के लिए एक पेपर ट्रेल बनाती है।

Discord-टिकट-आधारित मॉडरेशन से Agency-Reports में संक्रमण कर रही समुदायों के लिए, दोनों सिस्टम को दो से चार सप्ताह तक समानांतर चलाएं। स्टाफ को जो भी पसंद हो उसका उपयोग करने दें जबकि समाधान समय और रिपोर्टर संतुष्टि को ट्रैक करें। डेटा आमतौर पर दिखाता है कि Agency-Reports टिकटों को तेज़ी से हल करता है; इस साक्ष्य का उपयोग स्वैच्छिक अपनाने को बढ़ावा देने के लिए करें बजाय स्विच को अनिवार्य करने के।

शुरू करने के लिए तैयार?

हमारी शॉप से स्क्रिप्ट लें, या सपोर्ट, अपडेट और आगे आने वाली चीज़ों की झलक के लिए Discord से जुड़ें।