Agency-Reports: Narzędzie do zgłoszeń dla adminów FiveM, z którego naprawdę się korzysta

Stan FiveM Reports w 2026 roku

Większość serwerów nadal używa ticketów na Discordzie lub komendy na czacie w grze do zgłoszeń od graczy. Oba rozwiązania są ułomne. Discord nie ma kontekstu gracza; komenda czatu traci wszystko w momencie rozłączenia się zgłaszającego. Administratorzy kończą jako detektywi, zamiast pełnić rolę sędziów. Agency-Reports to narzędzie, o którym marzyliśmy, gdy sami prowadziliśmy serwer.

Kontekst przechwytywany automatycznie

Gdy gracz wysyła zgłoszenie, automatycznie przechwytujemy jego współrzędne, ID pobliskich graczy, wyposażoną broń, pojazd oraz ostatnie 60 sekund czatu. Administratorzy widzą całą sytuację, a nie tylko samo oskarżenie. Już to samo skraca czas dochodzenia o połowę.

Inteligentny routing

Zgłoszenia trafiają do personelu na podstawie typu, priorytetu i aktualnie dostępnych członków zespołu. Cheating trafia do administratorów technicznych, spory RP do administratorów RP, nękanie do osoby na służbie. Zgłoszenia offline trafiają do kolejki i wysyłają powiadomienia na Discord. Koniec z pytaniami "czy ktoś się tym zajmuje?" na czacie personelu.

Śledzenie rozwiązań

Każde zgłoszenie ma status: otwarte, przejęte, badane, rozwiązane, zamknięte. Administratorzy piszą notatki z rozwiązania, które pozostają przy zgłoszeniu na zawsze. Sześć miesięcy później, gdy ten sam gracz składa kolejne zgłoszenie, jego historia jest dostępna za jednym kliknięciem. Tak działają profesjonalne zespoły moderacyjne w grach MMO, najwyższy czas na to w FiveM.

Pętla informacji zwrotnej graczy

Gdy zgłoszenie zostanie rozwiązane, zgłaszający otrzymuje krótką wiadomość wyjaśniającą, co się stało. Nawet jeśli odpowiedź brzmi "sprawdzono, brak konieczności działań", gracze czują się wysłuchani, a nie ignorowani. Społeczności, które czują się słuchane, pozostają lojalne: to właściwa mechanika retencji stojąca za dobrymi narzędziami moderacji.

Instalacja & konfiguracja

Agency-Reports wymaga oxmysql do zapisywania historii zgłoszeń. Zaimportuj reports.sql, przenieś folder zasobu i dodaj ensure agency-reports do server.cfg. Podłącz swój webhook Discord w config.lua do przekazywania powiadomień offline. Przy pierwszym uruchomieniu reguły routingu inicjalizują się z twojego configu, bez konieczności dalszej konfiguracji bazy danych.

UI zgłoszeń w grze jest otwierane przez graczy za pomocą konfigurowalnego skrótu klawiszowego (domyślnie: F9 lub komenda na czacie). Panel administratora to osobny panel dostępny wyłącznie dla graczy z uprawnieniami administratora.

Opcje konfiguracji

Ten config.lua kontroluje routing, retencję oraz zachowanie UI:

• Kategorie zgłoszeń, zdefiniuj dowolną liczbę kategorii (cheating, nękanie, spór RP, zgłoszenie błędu itp.) z regułami przekierowywania dla każdej kategorii.
• Routing personelu, każda kategoria trafia do określonych poziomów uprawnień. Cheating do administratorów technicznych, spory RP do moderatorów RP itp.
• Lista automatycznego przechwytywania, które pola kontekstowe są przechwytywane automatycznie (współrzędne, pobliscy gracze, czat z ostatnich 60s, pojazd, broń). Przełączane dla każdego pola.
• Webhook Discord, URL do przekazywania zgłoszeń offline. Zgłoszenia bez dostępnego administratora online dla danej trasy trafiają na Discord.
• Szablony wiadomości o rozwiązaniu, dostosuj wiadomość, którą gracze otrzymują po zamknięciu ich zgłoszenia.
• Anonimowe zgłaszanie, przełącz, czy zgłaszający mogą wysyłać zgłoszenia bez ujawniania swojej tożsamości innym graczom (administratorzy zawsze widzą zgłaszającego).

Kompatybilność z frameworkami

Agency-Reports działa na QBCore, ESX i standalone. Jedynym elementem powiązanym z frameworkiem jest sprawdzanie uprawnień dostępu do dashboardu admina. W konfiguracjach standalone zaimplementuj Config.IsAdmin(src, level) w config.lua. Całe przechowywanie zgłoszeń, routing oraz UI są niezależne od frameworka.

Dlaczego ma to znaczenie dla roleplay

Każde nierozwiązane zgłoszenie gracza to deficyt zaufania. Kiedy gracz składa zgłoszenie i nie otrzymuje odpowiedzi, albo bierze sprawy w swoje ręce (zaostrzając sytuację), albo całkowicie opuszcza serwer. Agency-Reports zamyka tę pętlę zwrotną za pomocą systemu wiadomości o rozwiązaniu, gracze wiedzą, że ich zgłoszenie zostało odebrane i przetworzone, nawet jeśli wynik nie był taki, na jaki liczyli.

System rejestrowania kontekstu to praktyczny mnożnik efektywności moderacji. Administratorzy, którzy dołączają na miejsce akcji pięć minut po zdarzeniu, aby przeprowadzić dochodzenie, mają pełny kontekst sytuacyjny: gdzie kto stał, co powiedziano, co miał przy sobie oskarżony. Poświęcają czas na podejmowanie decyzji, a nie rekonstrukcję wydarzeń. Takie skrócenie czasu dochodzenia bezpośrednio zwiększa liczbę zgłoszeń, które zespół administracji może obsłużyć w ciągu godziny.

Dostęp do sześciomiesięcznej historii to często pomijana funkcja, która chroni społeczności w dłuższej perspektywie. Rozpoznawanie wzorców w historii zgłoszeń z wielu miesięcy pozwala wyłapać graczy, którzy łamią regulamin powoli, a nie jawnie: umiarkowanego gracza naginającego zasady, który wysyła trzy zgłoszenia miesięcznie i ma trzy przeciwko sobie, stale balansując na granicy kary. Historia sprawia, że ten schemat staje się widoczny.

Często zadawane pytania

Czy gracze mogą dołączać zrzuty ekranu lub dowody wideo do zgłoszenia?

Gracze mogą załączyć adres URL do zewnętrznych dowodów (Imgur, YouTube, Medal.tv). Bezpośrednie przesyłanie plików na serwer nie jest obsługiwane ze względów bezpieczeństwa i pamięci masowej. Zgłoszenia połączone z Discordem zawierają adres URL dowodu w powiadomieniu na Discordzie, co ułatwia weryfikację.

Co dzieje się ze zgłoszeniami, gdy zgłaszający gracz się rozłączy?

Zgłoszenia pozostają w bazie danych niezależnie od statusu połączenia gracza. Cały kontekst zarejestrowany w momencie zgłoszenia (współrzędne, czat itp.) jest zapisywany. Administratorzy mogą badać i rozwiązywać zgłoszenia po wyjściu zgłaszającego, a wiadomość o rozwiązaniu zostanie doręczona przy następnym dołączeniu gracza.

Czy możemy zintegrować Agency-Reports z naszym istniejącym botem do ticketów?

Tak, za pośrednictwem przekazywania przez webhook Discord. Jeśli twój bot do ticketów czyta z kanału Discord, skieruj webhook na ten kanał, a zgłoszenia pojawią się jako wiadomości Discord, które twój bot może przetworzyć. W celu ściślejszej integracji zasób wywołuje event po stronie serwera agency-reports:onNewReport którego może nasłuchiwać dowolny skrypt po stronie serwera.

Czy istnieje funkcja masowego zamykania dla masowych zgłoszeń?

Tak. Panel administratora zawiera opcję multiselect na liście zgłoszeń. Starsi administratorzy mogą zaznaczyć wiele zgłoszeń, dodać jedną notatkę rozwiązania i zamknąć je zbiorczo. Przydatne po wydarzeniach na serwerze, które generują zduplikowane zgłoszenia dotyczące tego samego incydentu.

Wymagania

• Serwer FiveM (QBCore, ESX lub standalone)
• oxmysql
• konto cfx.re z ważną licencją Agency-Reports
• URL webhooka Discord (do powiadomień offline)

Wdrażanie personelu z Agency-Reports

Nowi moderatorzy szczególnie zyskują na uporządkowanym procesie w Agency-Reports. System prowadzi ich przez proces dochodzenia bez potrzeby długiego szkolenia. Nowy moderator, który przejmuje swój pierwszy raport, automatycznie otrzymuje pełny kontekst: nie musi pytać "co się stało?", ponieważ wstępnie zebrane dane odpowiadają na większość pytań, zanim wpisze choćby jedno słowo.

Wymóg notatki z rozwiązania (opcjonalny, ale zalecany w configu) to narzędzie szkoleniowe. Wpisanie "przejrzano nagranie, gracz wyraźnie złamał punkt 3.2 regulaminu, nałożono bana na 24h" jako notatki zmusza moderatora do uzasadnienia swojej decyzji. Takie uzasadnienie z czasem poprawia jakość decyzji i tworzy ślad dla eskalacji lub odwołań.

W przypadku społeczności przechodzących z moderacji opartej na ticketach Discord na Agency-Reports, prowadź oba systemy równolegle przez dwa do czterech tygodni. Pozwól zespołowi korzystać z tego, co woli, śledząc jednocześnie czas rozwiązywania i zadowolenie zgłaszających. Dane zazwyczaj pokazują, że Agency-Reports rozwiązuje zgłoszenia szybciej, wykorzystaj te dowody do dobrowolnego wdrożenia, zamiast narzucać zmianę.