Agency-Admin: profesjonalne narzędzia moderacyjne dla prawdziwych społeczności FiveM

Przepaść między narzędziami hobbystycznymi a profesjonalnymi

Większość menu administratora FiveM to poziom amatorski: przyciski do rozdawania broni, teleportacji, noclip i tym podobne rzeczy. Agency-Admin stworzono dla społeczności, które traktują moderację tak poważnie, jak zespół moderacyjny w prawdziwym studiu gier.

Logowanie akcji z kontekstem

Każda akcja administratora trafia do zabezpieczonego przed manipulacją logu z ID administratora, celem, akcją, znacznikiem czasu i powodem. Koniec z zagadkami typu "kto dał temu graczowi Rhino?". Logi można przeszukiwać przez UI administratora z filtrami według administratora, zakresu czasu i typu akcji. To podstawowa infrastruktura odpowiedzialności, której zespół administracji naprawdę potrzebuje.

Poziomy uprawnień

Trzy wbudowane poziomy: moderator (kick, timeout, podstawowe sprawdzanie przedmiotów), admin (ban, dodawanie przedmiotów, teleport), starszy admin (zmiany w configu, zarządzanie uprawnieniami, administracja bazą danych). Działania każdego poziomu są ściśle ograniczone, moderator nie może sam podnieść swoich uprawnień poprzez lukę. Przetestowaliśmy ten model z wieloma dużymi społecznościami w ciągu ostatnich dwóch lat.

Zarządzanie banami

Bany obsługują czas trwania, powód, URL dowodu (link do zrzutu ekranu lub wideo), status odwołania i notatki z weryfikacji. Gdy zbanowany gracz próbuje dołączyć ponownie, wyświetlany komunikat zawiera powód oraz, jeśli skonfigurowano, link do odwołania. Przejrzysta moderacja to skuteczna moderacja.

Wykrywanie zagrożeń w czasie rzeczywistym

Agency-Admin jest dostarczany z konfigurowalną warstwą detekcji, która oznacza podejrzane wzorce: nagłe skoki gotówki, niemożliwe teleportacje, szybkie duplikowanie przedmiotów, nietypowe spawnowanie broni. Oznaczenia pojawiają się w panelu administratora z pełnym kontekstem. Nie jesteśmy anticheatem, jesteśmy narzędziem detekcji, które skraca czas reakcji administracji z godzin do minut.

Instalacja & konfiguracja

Agency-Admin wymaga oxmysql do zapisywania logów. Zaimportuj admin.sql do swojej bazy danych, dodaj zasób do swojego serwera i dodaj ensure agency-admin do server.cfg. Początkowe przypisanie uprawnień administratora odbywa się poprzez config.lua, wskaż swoje najbardziej zaufane identyfikatory jako senior adminów. Wszystkie pozostałe uprawnienia są odtąd zarządzane przez UI w grze.

Zasób automatycznie wykrywa Twój framework przy starcie. Hooki uprawnień dla QBCore i ESX są dołączone w pakiecie; konfiguracje standalone implementują Config.IsAdmin(src, level) funkcję ręcznie.

Opcje konfiguracji

Ten config.lua obejmuje ustawienia uprawnień i wykrywania:

• Poziomy uprawnień, nazwy i możliwości każdego poziomu można w pełni zdefiniować na nowo. Domyślny model trzypoziomowy to punkt wyjścia, a nie wymóg.
• Progi wykrywania, skonfiguruj próg nagłego wzrostu gotówki, limit dystansu teleportacji oraz tempo przyrostu przedmiotów, które wywołują flagi.
• Webhook Discord, wszystkie akcje administratorów i flagi wykrywania mogą być przekazywane na kanał Discord równolegle z logiem w grze.
• URL apelacji od bana, adres URL wyświetlany zbanowanym graczom w wiadomości o banie.
• Okres przechowywania logów, ile dni logi działań administratora są przechowywane przed automatycznym wyczyszczeniem. Domyślnie: 90 dni.
• Tryb stealth dla starszych administratorów, starsi administratorzy mogą przeglądać serwer anonimowo, nie pojawiając się na listach graczy.

Kompatybilność z frameworkami

Agency-Admin działa na konfiguracjach QBCore, ESX i standalone. Warstwa uprawnień to jedyny element powiązany z frameworkiem, cała reszta (interfejs, logowanie, system banów, silnik detekcji) jest niezależna od frameworka. W przypadku niestandardowych frameworków warstwa kompatybilności to zaledwie cztery funkcje w config.lua.

Dlaczego ma to znaczenie dla roleplay

Kondycja serwera jest bezpośrednio powiązana z jakością moderacji. Społeczności z widoczną, spójną i odpowiedzialną moderacją zatrzymują graczy na dłużej niż te polegające na nieformalnych decyzjach. Dziennik audytu w Agency-Admin jest kluczowym mechanizmem rozliczalności: gdy decyzja moderacyjna zostanie zakwestionowana, log zapewnia dokładny kontekst tego, co się stało, kiedy i kto to autoryzował.

Warstwa detekcji zmienia podejście zespołu administracyjnego z reaktywnego na proaktywne. Zamiast czekać na zgłoszenia graczy o podejrzanym cheaterze, dashboard ujawnia podejrzane wzorce, zanim wyrządzą one szkody na całym serwerze. Kopiowanie pieniędzy wykryte w pierwszej godzinie powoduje znacznie mniej szkód niż błąd działający niezauważony przez dwa dni.

System poziomów uprawnień chroni przed zagrożeniami wewnętrznymi. Nowo zrekrutowany moderator posiadający taki sam dostęp jak starszy admin stanowi problem bezpieczeństwa i odpowiedzialności. Ściśle zdefiniowane uprawnienia sprawiają, że nawet jeśli członek ekipy zacznie działać na szkodę serwera, zasięg szkód jest ograniczony przez jego poziom.

Często zadawane pytania

Czy mogę dodać własne komendy administratorskie zintegrowane z systemem uprawnień?

Tak. Użyj exports['agency-admin']:RegisterCommand(name, tier, handler) aby rejestrować niestandardowe komendy, które dziedziczą sprawdzanie uprawnień i automatyczne logowanie Agency-Admin. Twoja komenda pojawia się na liście komend w UI administratora i jest logowana identycznie jak wbudowane akcje.

Jak system banów obsługuje VPN i konta alt?

Agency-Admin zapisuje w logach pełny zestaw identyfikatorów (license, steam, discord, IP) w momencie bana. Przy próbach ponownego połączenia sprawdza wszystkie identyfikatory, a nie tylko ten użyty do logowania. W przypadku serwerów z ciągłymi problemami z omijaniem banów panel zawiera system oznaczania podejrzanych wzorców identyfikatorów.

Czy moderatorzy widzą flagi wykrywania przed podjęciem działań?

Flagi pojawiają się wszystkim administratorom z poziomem równym lub wyższym niż minimalny skonfigurowany dla danego typu flagi. Flagi nagłego wzrostu gotówki są widoczne dla wszystkich administratorów; flagi niemożliwej teleportacji domyślnie trafiają tylko do administratorów technicznych. Każde wyświetlenie flagi jest również logowane, administratorzy widzą, które flagi sprawdzili ich koledzy i jakie działania (jeśli w ogóle) zostały podjęte.

Czy Agency-Admin koliduje z innymi menu administratora, takimi jak vMenu lub qb-adminmenu?

Brak konfliktów. Agency-Admin może współistnieć z innymi menu, ponieważ działają na różnych skrótach klawiszowych i nie dzielą stanu. Niektóre serwery uruchamiają Agency-Admin równolegle ze starszym menu administratora w okresie przejściowym, używając Agency-Admin do logowania i wykrywania, zachowując jednocześnie znane komendy dla doświadczonych członków ekipy.

Wymagania

• Serwer FiveM (QBCore, ESX lub standalone)
• oxmysql
• konto cfx.re z ważną licencją Agency-Admin
• Opcjonalnie: Agency-Reports (do zintegrowanej obsługi zgłoszeń graczy)

Budowanie kultury administracji wokół narzędzi

Najlepsze narzędzia administracyjne na świecie nie pomogą, jeśli kultura twojego zespołu nie wspiera odpowiedzialności. Audit log w Agency-Admin jest najbardziej wartościowy w społecznościach, gdzie staff wie, że jego działania są rejestrowane, i akceptuje to jako standardową procedurę, a nie inwigilację.

Ustal wcześnie zasadę, że wszystkie działania administratora przechodzą przez rejestrowany w logach interfejs. Oprzyj się pokusie pomijania logowania "tylko ten jeden raz" na potrzeby szybkich poprawek, wartość logu tkwi w jego kompletności. Log z lukami jest prawie tak samo bezużyteczny jak brak logu, gdy musisz odtworzyć przebieg zdarzeń.

Używaj flag detekcji podczas cotygodniowych przeglądów zespołu, a nie tylko wtedy, gdy coś pójdzie nie tak. Przeglądanie flag z całego tygodnia, nawet gdy nie wydarzyło się nic szczególnego, pozwala oswoić się z normalnym stanem, co sprawia, że anomalie stają się oczywiste, gdy się pojawią.

System poziomów uprawnień działa najlepiej, gdy awanse na kolejne poziomy stanowią znaczące kamienie milowe. Moderator, który uzyskuje dostęp administratora po trzech miesiącach nienagannej, udokumentowanej pracy, ma kontekst i zaangażowanie, jakich nie zapewni natychmiastowe przyznanie pełnego dostępu.