Dokumentacja ZeroDev Sentinel

ZeroDev Sentinel: instalacja i obsługa

ZeroDev Sentinel to anti-cheat po stronie serwera dla FiveM, w formie resource'a. Zapisuje to, co widzi serwer, ocenia to regułami, które same tłumaczą się prostymi zdaniami, i daje twojemu staffowi dowody, zanim ktokolwiek zostanie ukarany. Startuje na poziomie ochrony Watch: loguje i nikogo nie karze, dopóki sam nie wybierzesz inaczej. Ten poradnik dotyczy wersji 0.1.2 na serwerach ESX, QBCore, Qbox i standalone.

Dla ZeroDev Sentinel 0.1.223 min czytaniaAktualizacja

1. Wymagania

  • Włączony OneSync (set onesync on w server.cfg). Resource deklaruje OneSync jako zależność, więc FXServer nie uruchomi go bez OneSync.
  • Artifact FXServer, który uruchamia skrypty Node 22 (każdy aktualny zalecany artifact; manifest wymaga node_version '22'). Node odpowiada za hashowanie, kompresję, listowanie plików i ścieżkę webową dla odwołań.
  • Opcjonalnie: oxmysql. Z nim Sentinel trzyma swoje dane w twojej bazie i przy pierwszym starcie sam tworzy swoje tabele. Nie ma pliku SQL do importu. Bez niego wszystko leży we własnym magazynie key-value resource'a.
  • Opcjonalnie: pma-voice, do słuchania czatu głosowego gracza z konsoli albo z panelu w przeglądarce.

Framework ma znaczenie tylko w dwóch sprawach: ślad pieniędzy i itemów (pieniądze i itemy, których nie wypłacił żaden sklep, job ani skrypt, pętle nagród, rollbacki) oraz to, kto jest w twoim staffie (grupy ACE, których używa każdy framework). Wykrywanie, case'y, klipy, konsola, panel w przeglądarce, Discord i owner desk działają tak samo na każdym frameworku.

2. Instalacja w pięć minut

Nic nie wymaga SQL, do pierwszego startu nie trzeba zmieniać configu i żaden inny resource nie jest zmieniany.

Krok 1: Wrzuć folder do resources

Skopiuj folder zerodev_sentinel do swojego folderu resources. Zostaw dokładnie tę nazwę folderu: plik guard raportuje do zerodev_sentinel, a sentinel:guard ostrzega cię, gdy folder nazywa się inaczej.

Krok 2: Dodaj go do server.cfg

Uruchamiaj go po oxmysql i twoim frameworku, żeby magazyn danych i ślad pieniędzy znalazły je przy starcie. Dokładna kolejność dla twojego frameworka jest w sekcji 3.

Krok 3: Uruchom serwer

Konsola wypisuje ramkę startową i jednorazowy kod właściciela. Każdy wiersz ramki to prawdziwe sprawdzenie; ostatnia linia mówi READY albo NOT READY z liczbą problemów (sekcja 15).

Krok 4: Zajmij miejsce właściciela

Wejdź na serwer i wpisz /sentinel owner <code> na czacie. Od teraz masz miejsce właściciela (sekcja 4).

Krok 5: Otwórz owner desk

Naciśnij F7 w grze (albo wpisz sentinel:console w F8) i otwórz OWNER. Zakładka First run pokazuje, co jest zrobione, a co nie: Discord, magazyn klipów, twój staff i jego uprawnienia. Każda linia ma jeden przycisk. Potem graj przez kilka dni na Watch, przeczytaj w zakładce Right now, co znalazł Sentinel, i przełącz poziom ochrony na Recommended w tym samym desku (sekcja 6).

3. Twój framework

Sentinel sam znajduje framework i inventory przy starcie. Nie ma nic do ustawiania. sentinel:trail w konsoli serwera pokazuje, który adapter wybrał.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Pieniądze i itemy: odczytywane z własnych eventów serwerowych ESX (pieniądze na koncie dodane, zabrane lub ustawione; itemy w inventory dodane lub zabrane; itemy przekazane od gracza do gracza, z powiązaniem obu stron). Rollback używa własnych metod gracza z ESX i odczytuje wynik z powrotem.
  • ESX z ox_inventory: pieniądze są śledzone tak samo. W tym trybie metody itemów ESX nie zwracają wyników, więc Sentinel decyduje tylko na podstawie ponownego odczytu.
  • Staff: daj swoim adminom uprawnienie ACE (sekcja 5). Własne group.admin z ESX działa jako grupa ACE, gdy dodasz dla niej linię.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Pieniądze: odczytywane z eventu zmiany pieniędzy w QBCore (dodanie, zabranie i ustawienie, z powodem). Strata i równy zysk w tym samym momencie są łączone jako przelew, bo QBCore nie ma własnego eventu przelewu.
  • Itemy: z ox_inventory itemy są śledzone przez jego hooki. Z qb-inventory zmiany itemów nie są śledzone (payload jego listenera nie jest udokumentowany), ale rollback nadal może przenosić itemy przez udokumentowane exporty qb-inventory.
  • Staff: grupy uprawnień QBCore to grupy ACE (group.admin, group.god). Dodaj linie ACE z sekcji 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Pieniądze: odczytywane z eventu zmiany pieniędzy w Qbox; salda są odczytywane z powrotem własnymi exportami qbx_core. Pieniądze zmienione postaci offline (po citizen id) nie wywołują eventu, więc nie ma ich w śladzie.
  • Itemy: Qbox używa ox_inventory, a Sentinel śledzi jego itemy przez hooki ox_inventory. Itemy, które oznaczają pieniądze frameworka, zostają dla części frameworkowej.
  • Staff: grupy ACE, tak jak na QBCore.

Standalone (bez frameworka)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Działa wszystko poza śladem pieniędzy i itemów: ruch, świat, eventy, eventy-pułapki, godmode, state bagi, bronie, case'y, klipy, replay, konsola, panel, Discord, role i bany.
  • Z ox_inventory i bez frameworka itemy są śledzone przez ox_inventory.
  • Magazyn danych: magazyn key-value albo oxmysql, jeśli uruchomisz go wcześniej.

Sprawdzenie, czy działa

  • sentinel:health: ramka startowa jeszcze raz. Każdy wiersz to prawdziwe sprawdzenie; READY oznacza, że niczego nie brakuje.
  • sentinel:diag: dlaczego wybrano taki magazyn danych, adaptery i poziom, każda reguła z jej licznikami i ostatnie decyzje.
  • sentinel:trail: używany adapter pieniędzy i itemów oraz ostatnie zmiany jednego gracza.

W automatycznym trybie magazynu Sentinel używa oxmysql tylko wtedy, gdy oxmysql już działa (czeka do 15 sekund, gdy oxmysql się uruchamia); jeśli oxmysql wystartuje później, używa magazynu key-value.

4. Pierwsze uruchomienie: miejsce właściciela

Pierwszy start wypisuje w konsoli serwera jednorazowy kod, ważny przez 30 minut (sentinel:owner code wypisuje nowy). Wejdź na serwer i wpisz /sentinel owner <code>: miejsce zostaje przypisane do twojego konta, a kod przestaje działać.

Tylko miejsce właściciela może zmieniać klucze, poziom ochrony, role i uprawnienia. sentinel:owner reset w konsoli serwera zwalnia miejsce, jeśli musisz przenieść je na inne konto.

5. Staff i uprawnienia

W owner desk, STAFF: wybierz gracza online, wybierz rolę, naciśnij GRANT. W zestawie są cztery role:

Rola Może, od razu po instalacji
Wsparcie przeglądać case'y, obsługiwać zgłoszenia, mapa służby
Moderator jak Support, plus replaye, kick i kwarantanna
Admin jak Moderator, plus odkrycie, oczyszczenie, podgląd na żywo, wnioski o bana, odwołania
Senior admin jak Admin, plus ban, który działa od razu

Uprawnienia wybierasz ty. Każda rola to lista przełączników, które możesz zmieniać. Twórz własne role z kopii (na przykład "Trial mod"), zmieniaj nazwę dowolnej roli i dawaj jednej osobie dodatkowy przełącznik albo go zabieraj bez zmiany jej roli. Przełączniki oznaczone jako niebezpieczne (natychmiastowy ban, słuchanie czatu głosowego, ustawienia, zarządzanie staffem) wymagają drugiego kliknięcia. Każda zmiana trafia do rejestru staffu, więc zawsze widzisz, kto co zmienił.

ACE dalej działa na serwerach, które już go używają, i jest odczytywany przy każdym sprawdzeniu:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Uprawnienie Rola, którą daje
sentinel.admin Admin (Senior admin, dopóki miejsce właściciela nie jest zajęte) i każda komenda sentinel:* w grze
sentinel.staff Moderator; reguły ruchu traktują własny ruch członka staffu jako wyjaśniony

Kilka komend (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) jest zarejestrowanych jako restricted: w grze potrzebują też command.<name>. Typowa linia add_ace group.admin command allow to załatwia. Konsola serwera może uruchomić każdą komendę.

6. Poziom ochrony

Jeden przełącznik w owner desk (OWNER, PROTECTION), do tego sentinel:level w konsoli serwera i Config.Protection w config/config.lua. To, co ustawisz w desku, zostaje zapisane i po restarcie wygrywa z linią w configu.

  • Watch: każda reguła obserwuje i zapisuje, co by zrobiła; nikt nie dostaje alertu i nikomu nic się nie dzieje. W tym czasie Sentinel uczy się, co jest normalne na twoim serwerze: obserwator eventów (częstotliwość i kształt każdego eventu) oraz sprawdzenie przy wejściu uczą się tylko na Watch; limity encji, walki i pieniędzy dalej uczą się z czystej gry.
  • Recommended: każda reguła jest live. Staff dostaje alerty z dowodami i otwiera się case. Sentinel nigdy nie karze sam; decyduje twój staff.
  • Strict: jak Recommended, a do tego wysoki wynik wysyła gracza na kwarantannę, aż staff to sprawdzi; znalezisko na poziomie dowodu (Tier A: wywołany event-pułapka, sfałszowane żądanie) dodatkowo dodaje bana do kolejki na ban wave.

Pod przełącznikiem desk pokazuje każdą regułę z jej stanem i źródłem tego stanu. Możesz tam przypiąć pojedynczą regułę na Live albo Shadow, jeśli twój serwer tego potrzebuje (na przykład regułę, która ciągle oznacza jeden z twoich własnych skryptów); linia state w Config.Rules przypina ją w pliku configu i wygrywa z deskiem.

Rozsądna kolejność:

  1. Watch przez kilka dni normalnej gry.
  2. Przeczytaj, co zrobiłyby reguły: zakładka Right now, sentinel:diag rules (kolumna shadow liczy, ile razy reguła by punktowała) i sentinel:diag decisions 100.
  3. Przypnij na Shadow każdą regułę, która oznaczyła kogoś, komu ufasz, i daj nam znać.
  4. Przełącz na Recommended. Staff widzi teraz case'y i dowody; nikt nie jest karany automatycznie.
  5. Strict, gdy ufasz temu, co pokazuje ci Recommended.

Powrót w każdej chwili: Watch w desku albo sentinel:level watch.

7. Konsola staffu (F7)

Naciśnij F7 w grze (albo wpisz sentinel:console w F8). Każdy gracz może zmienić klawisz w ustawieniach gry (Key Bindings, FiveM). Esc ją zamyka.

  • Right now mówi prostymi słowami, co dzieje się na twoim serwerze: kto wygląda na zagrożenie i dlaczego, co zostało udowodnione, co zostało wyjaśnione (revive, teleport z samego skryptu) i co wymaga twojej uwagi. Każdy gracz, który ma znaczenie, dostaje jeden wiersz: co zrobił, czym to prawdopodobnie jest, jak pewny jest Sentinel (Unusual, Suspicious, Very likely, Proven), co Sentinel już zrobił i jeden następny krok.
  • Case files: najpierw otwarte case'y, każdy ze swoim znaleziskiem, dowodami, klipami ekranu, pieczęcią (czy łańcuch hashy case'a nadal się zgadza) i klawiszami REVEAL, QUARANTINE, CLEAR i BAN (CLEAR i BAN wymagają drugiego naciśnięcia).
  • Duty map: gracze online na modelu 3D wyspy. Teren jest mierzony przez grę pierwszego członka staffu i przechowywany w data/map/.
  • Play replay zamyka konsolę i odtwarza incydent w prywatnym świecie; naciśnij Backspace, żeby wrócić.
  • Owner (tylko miejsce właściciela): First run, Protection, Keys, Staff, Internal affairs i Server check.

Komendy wpisywane w grze podajesz w F8 bez ukośnika albo na czacie z ukośnikiem (/sentinel:diag).

8. Panel w przeglądarce

Ten sam desk w przeglądarce, na czas, gdy nie jesteś w grze:

  • na komputerze serwera: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (port to port twojego serwera, domyślnie 30120)
  • z innego miejsca: http://<server address>:<port>/zerodev_sentinel/panel/ albo twój własny adres HTTPS postawiony przed nim

Logowanie. Użyj jednorazowego kodu: wpisz /sentinel panel w grze (kod widzisz tylko ty, działa raz, przez 5 minut) albo uruchom sentinel:panel <id or account> w konsoli serwera. Sesja trwa 8 godzin; SIGN OUT i END ALL MY SESSIONS ją kończą. Twoja rola i przełączniki działają w przeglądarce dokładnie tak samo jak w grze.

Live view. Staff z przełącznikiem live view może oglądać ekran dowolnego gracza online z panelu albo z konsoli. Nic nie jest zapisywane na dysku, dopóki nie naciśniesz Save to case.

Nasłuch. Słuchanie czatu głosowego tego gracza wymaga przełącznika listen (domyślnie tylko właściciel) i pma-voice. Dźwięk jest odtwarzany przez twoją własną grę, więc bądź w grze na tym samym serwerze.

Każdy live view i każdy nasłuch jest zapisywany w rejestrze staffu i w case'ie gracza, a gracze przy pierwszym wejściu dostają informację, że staff może oglądać i słuchać (powiadomienie o nagrywaniu, Config.Notice).

9. Case'y, kwarantanna, kick, ban i odwołania

Gdy coś zostanie znalezione, Right now wskazuje gracza prostym językiem: co zrobił, jak pewny jest Sentinel i co z tym zrobił. Otwórz case, żeby zobaczyć dowody (pozycje, klipy ekranu zabezpieczone SHA-256, powtórkę 3D), i użyj klawiszy:

  • REVEAL: pokazuje identyfikatory gracza.
  • QUARANTINE: przenosi gracza z prawdziwego świata do prywatnego routing bucketa, aż staff to sprawdzi. sentinel:release <server id> przywraca go z powrotem.
  • CLEAR: to nie cheat; zamyka case i zatrzymuje jego bana czekającego w kolejce.
  • KICK: wyrzuca z serwera, z powodem, który gracz czyta.
  • BAN: przez ban wave, z kodem odwołania.

Ban wave. Bany, także BAN naciśnięty w konsoli, trafiają do kolejki ban wave i są nakładane tylko na Strict, domyślnie w losowym momencie od 2 do 24 godzin później (Config.Actions). sentinel:wave wypisuje je, sentinel:wave now <account> nakłada jeden od razu, sentinel:wave cancel <account> go anuluje.

Odwołania. Zbanowany gracz widzi kod odwołania w komunikacie o odmowie (8 liter i cyfr). Nie może wejść na serwer, żeby się odwołać, więc odwołanie dociera do ciebie spoza gry:

  1. Przez twój staff. Gracz wysyła kod twojemu staffowi (ticket na Discordzie, mail). Członek staffu zapisuje go komendą sentinel:appeal <code> <text>.
  2. Przez ścieżkę webową. Sentinel odpowiada pod własnym adresem twojego serwera: http://<server address>:<port>/zerodev_sentinel/appeal. Przyjmuje tylko POST z JSON-em { "code": "...", "text": "...", "contact": "optional" } (text od 10 do 2000 znaków), więc jest przeznaczona dla formularza na twojej stronie, a nie jako strona, na którą wysyłasz graczy. Każde przyjęte żądanie dostaje tę samą odpowiedź, 202 "received", niezależnie od tego, czy kod pasował do bana, czy nie. Zbyt wiele żądań z jednego adresu (5 w 10 minut) albo łącznie (30 na minutę) dostaje 429. Za własnym reverse proxy HTTPS ustaw set sentinel_http_proxy true, żeby limity liczyły adres odwiedzającego.

Tekst odmowy nie mówi, gdzie się odwołać. Powiedz to graczom w regulaminie albo napisz własny tekst ze swoim linkiem w Config.Bans.message (zostaw %s, w to miejsce trafia kod), na przykład 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Staff decyduje w konsoli albo komendą sentinel:decide <case or code> accept|reject [note]. Accept zdejmuje każdego aktywnego bana tego konta lub case'a i anuluje bana czekającego w kolejce ban wave; reject zostawia bana. Decyzja jest ostateczna i trafia do logu case'a. sentinel:appeals wypisuje otwarte odwołania.

10. Zgłoszenia i internal affairs

Player reports. Każdy gracz wpisuje /report <server id> <what happened>, żeby zgłosić gracza albo członka staffu. Ostatnie dwie minuty wokół obu graczy zapisują się w case'ie. Staff zamyka zgłoszenie jako: podjęto działanie, brak naruszenia, brak dowodu albo duplikat. Zgłoszenia na staff trafiają tylko do właściciela.

Internal affairs (tylko właściciel, na owner desk): co zrobił każdy członek staffu i co trzeba sprawdzić (uprawnienia nadane samemu sobie, ukrywanie się w walce, bany bez case'a, teleporty do graczy). Cotygodniowy raport uczciwości jest zapisywany w data/reports/; sentinel:staff report zapisuje go od razu. Nic w rejestrze staffu nie karze staffu.

11. Ochrona resource'a

Bez żadnej konfiguracji Sentinel obserwuje każdy event, który gracze mogą wysłać do twoich skryptów, i ocenia gracza. Nie może zatrzymać handlera innego resource'a przed uruchomieniem. Żeby zatrzymać złe wywołanie, zanim skrypt się uruchomi, dodaj guard do tego skryptu.

  1. sentinel:audit wypisuje eventy każdego uruchomionego resource'a, które mogą wywołać klienci, ocenione według tego, co robią ich handlery (na przykład handler, który daje pieniądze w kwocie wybranej przez klienta). Użyj tego, żeby zdecydować, które resource'y chronić najpierw.
  2. sentinel:guard <resource> wypisuje linię do dodania i server_scripts tego resource'a w takiej postaci, w jakiej by wyglądały. Linia guard musi być pierwszym skryptem serwerowym. Komenda tylko wypisuje; nie zmienia żadnego pliku.

lua server_scripts { '@zerodev_sentinel/guard/guard.lua', 'server/main.lua' }

  1. Zrestartuj ten resource. sentinel:guard <resource> mówi teraz "guarded since ...". Samo sentinel:guard wypisuje każdy chroniony resource.
  2. Dodawaj reguły komendą sentinel:patch. Dopóki resource nie ma reguł, jego guard przepuszcza każde wywołanie, poza wywołaniami od graczy na kwarantannie, które odrzuca każdy guard. Przykład: najwyżej 3 zakupy w 10 sekund, nazwa itemu do 32 znaków i ilość od 1 do 10; odrzucone wywołanie liczy się jako dowód ("hard": true):

text sentinel:patch myshop myshop:buy {"args":[{"type":"string","maxLen":32},{"type":"number","int":true,"min":1,"max":10}],"rate":3,"window":10000,"hard":true}

Dla callbacka frameworka wpisz callback:<name> jako event: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> wypisuje reguły resource'a; sentinel:patch <resource> <event> off usuwa jedną.

Guard nigdy nie edytuje plików i nigdy nie zmienia tego, co dostaje handler. To zwykły, czytelny kod Lua w guard/guard.lua.

12. Klucze do Discorda i magazynu klipów

Najprościej zrobić to na owner desk, KEYS: wklej każdą wartość i naciśnij SAVE. Klucze są przechowywane tylko na serwerze; desk i każda odpowiedź mówią tylko "set" i nigdy więcej nie pokazują klucza.

Linia na desku Co to jest Albo w server.cfg (używaj set, nigdy setr)
Discord bot token bot, którego stworzyłeś na discord.com/developers, zaproszony na twój serwer set sentinel_discord_token "..."
Discord server id kliknij prawym przyciskiem swój serwer, Copy Server ID (z włączonym trybem dewelopera) set sentinel_discord_guild "..."
Alert channel id tu publikowane są case'y, z przyciskami dla twojego staffu set sentinel_discord_channel "..."
Appeals channel id tu publikowane są odwołania set sentinel_discord_appeals "..."
FiveManage key klucz media z fivemanage.com; tam wysyłane są klipy set sentinel_fivemanage_key "..."
Clip webhook zamiast FiveManage: webhook Discorda, który odbiera klipy set sentinel_clip_webhook "..."
Clip storage fivemanage, discord, off albo automatycznie (pierwszy, który jest ustawiony) set sentinel_clip_storage "..."

Klucz w server.cfg wygrywa z deskiem, a desk to pokazuje. Przyciski na Discordzie podlegają tym samym rolom i przełącznikom co konsola. Bez żadnego z nich case'y i klipy zostają na twoim serwerze (data/), a konsola i panel je pokazują.

Prostsze alerty przez webhook nadal działają: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" albo sentinel:webhook set <url> w konsoli serwera. sentinel:webhook test wysyła wiadomość testową; sentinel:webhook pokazuje stan, nigdy nie wypisując URL-a; sentinel:webhook clear usuwa zapisany.

13. Co wyłapuje każda reguła

Każda reguła, gdy się uruchomi, zapisuje proste zdanie o tym, co zobaczyła i co wykluczyła. Zanim reguła zostanie policzona przeciwko komukolwiek, Sentinel sprawdza powody, które by to wyjaśniały (respawn, revive, działanie staffu, jeden z twoich własnych skryptów, który przenosi graczy albo im płaci). Wyjaśnione znalezisko jest logowane i nigdy nie dostaje punktów.

  • Tier A to dowód: coś, co robi tylko cheat (event-pułapka, którego nie wywołuje żaden prawdziwy skrypt, sfałszowane żądanie).
  • Tier B jest mocny: członek staffu powinien to sprawdzić. Sam z siebie otwiera case tylko wtedy, gdy zgadzają się dwie różne rodziny albo ta sama się powtarza.
  • Tier C jest słaby: dodaje do wyniku i nigdy nie działa sam.

Ruch

Reguła Wyłapuje Wyjaśnia to Tier
teleport Skok o ponad 150 m (albo 3x więcej, niż jest możliwe) między dwiema próbkami spawn, respawn albo revive, zmiana routing bucketa, staff, event teleportu twojego skryptu B
foot_speed Bieg ponad 12 m/s przez 1.5 s pieszo, bez spadania, bez ragdolla spawn, respawn, staff, twój skrypt B
air_float Poruszanie się w stanie zamrożenia (noclip); "spadanie" bez opadania (fly); szybki ruch po koordynatach, gdy gra mówi, że gracz stoi w miejscu (speed menu) spawn, respawn, staff, twój skrypt B
foot_rise Wspinanie się prosto w górę szybciej niż 4 m/s pieszo przez 3 s spawn, respawn, staff, twój skrypt B
vehicle_speed Pojazd jadący ponad 1.3x szybciej niż najszybszy wynik jego klasy na twoim serwerze staff, twój skrypt B

Świat

Reguła Wyłapuje Wyjaśnia to Tier
entity_blocked Spawnowanie modelu, który zablokowałeś twoje skrypty, które go spawnują B
entity_rate / entity_model_rate Spawnowanie znacznie większej liczby entity (albo jednego modelu) na minutę, niż robią to gracze i skrypty twoje skrypty spawnujące B
entity_untrusted Entity utworzone przez klienta bez żadnego skryptu, który je spawnuje twoje skrypty spawnujące B
entity_disguised Seria tego samego modelu peda z otoczenia wokół jednego gracza (menu maskujące swoje spawny jako ruch uliczny) spawn, respawn, zmiana bucketa B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Eksplozje, których trzymana broń nie może wywołać, zbyt liczne, niewidzialne albo daleko od gracza eksplozje twoich skryptów B
projectile_weapon / projectile_rate Pociski, których broń nie może wystrzelić, albo zbyt liczne B
ptfx_rate Floody efektów cząsteczkowych (częsty atak wywołujący crashe i lagi) B
fire_rate Pożary wzniecane szybciej, niż pozwala jakakolwiek broń B

Walka

Reguła Wyłapuje Tier
damage_plausibility Obrażenia powyżej możliwej wartości dla tej broni B
hit_range Trafienia spoza zasięgu broni B
shot_rate / kill_rate Strzelanie szybciej niż broń; zabójstwa na minutę znacznie powyżej tego, co na twoim serwerze B
silent_aim Trafienia tam, gdzie gracz nie celował, powtarzające się B
aim_stats / aim_stats_backed Udział headshotów i kąty snapów daleko poza tym, co mają gracze twojego serwera, na przestrzeni 30+ walk C (B z inną rodziną)
esp_los_backed Powtarzające się celowanie w graczy, których świadkowie zgłaszają jako ukrytych za ścianami C do B

Eventy i żądania

Reguła Wyłapuje Tier
bait_event Wywołanie podłożonego eventu, którego nie używa żaden prawdziwy skrypt (cheat menu skanują w poszukiwaniu takich i je wywołują) A
bait_statebag / statebag_write Zapisywanie state bagów, które powinien zapisywać tylko serwer (robienie z siebie admina, flagi godmode), albo zbyt dużych A / B
events_before_ready / _trap Eventy wysłane, zanim gracz w ogóle się zespawnował (wstrzyknięte przed wejściem na serwer) B / A
event_rate / event_shape Event wywoływany znacznie szybciej niż normalnie albo z argumentami o kształcie innym niż w normalnych wywołaniach na twoim serwerze B
event_flood 500+ wywołań w 10 s; przy własnym kicku FiveM za overflow wypisywane są eventy z czołówki B
guard_rule / guard_hard Złamanie reguły, którą ustawiłeś na chronionym evencie (ilość, częstotliwość, odległość) B / A

Ekonomia

Reguła Wyłapuje Tier
money_nowhere / item_nowhere Pieniądze albo itemy, których nie wydał żaden sklep, job ani skrypt (eventy deweloperskie, wyciekła sprzedaż w sklepach) B
economy_repeat Event nagrody albo joba wypłacony 10 razy w 30 s (farmienie przez wywoływanie go w pętli) B
money_jump / money_rate Nagły skok salda albo tempo wypłat znacznie powyżej tego, co na twoim serwerze B
economy_trap Odebranie podłożonej nagrody, której nie wypłaca żaden prawdziwy job A
weapon_not_owned Trzymanie broni, której ekwipunek nigdy nie wydał B

Gra gracza (świadek)

Reguła Wyłapuje Tier
godmode Serwer odczytuje gracza jako nieśmiertelnego przez 30 s (nie we wspólnej safe zone) B
witness_backed Sygnały z gry potwierdzone własnym obrazem serwera (godmode, niewidzialność, brak kolizji) B
witness_bait Gra odpowiada na sprawdzenie, o którym nie powinna wiedzieć A
witness_tamper Własne sprawdzenia Sentinela w grze zostały zhookowane albo zmienione B

Tożsamość i pliki

Reguła Wyłapuje Tier
ban_fingerprint Zbanowany gracz, który wrócił na nowym koncie (tokeny sprzętowe, identyfikatory, fingerprint przeglądarki) A / flag
young_account Zupełnie nowe konto (tylko dodaje wagi) C
scanner_error / too_large Resource'y, których skaner skryptów nie mógł odczytać, albo zbyt duże pliki, które warto sprawdzić info

Czego nie obiecuje żadna reguła

Sentinel ocenia to, co widzi serwer i co zgłasza gra gracza. Nie czyta innych programów na komputerze gracza i żaden anti-cheat nie może obiecać, że każdy cheat zostanie wyłapany. Każde znalezisko ma swoje dowody, więc twój staff decyduje na podstawie faktów.

14. Komendy i konfiguracja

Każda komenda jest na stronie komend, a każdy klucz configu na stronie konfiguracji; obie są generowane z samego resource'a. Te, których używasz najczęściej:

Komenda Co robi
/sentinel owner <code> zajmij miejsce właściciela w grze kodem z konsoli
/sentinel panel jednorazowy kod logowania do panelu w przeglądarce (tylko dla staffu)
/report <server id> <what happened> każdy gracz zgłasza gracza lub członka staffu
sentinel:health ponownie ramka startowa
sentinel:diag co zdecydował Sentinel i dlaczego
sentinel:level watch\|recommended\|strict zmień poziom ochrony i go zapisz
sentinel:wave bany czekające w kolejce na ban wave
sentinel:appeals otwarte odwołania
sentinel:audit ryzykowne eventy każdego uruchomionego resource'a
sentinel:guard <resource> linia, która chroni resource
sentinel:advisor ustawienia FiveM, które warto zmienić na twoim serwerze

Pliki konfiguracyjne w config/ (config.lua, protection.lua, watch.lua) i tłumaczenia w config/locales/ są dla ciebie otwarte, tak samo jak adaptery frameworków w bridge/ i plik guard w guard/. Dbaj, by były poprawnym kodem Lua, i po zmianie zrestartuj zerodev_sentinel. Do pierwszego uruchomienia nie trzeba niczego zmieniać w configu.

15. Ramka startowa i doradca zabezpieczeń

Chwilę po tym, jak magazyn danych jest gotowy, Sentinel wypisuje ramkę w konsoli serwera. Wiersz FAIL oznacza, że Sentinel nie może działać poprawnie; wiersz WARN oznacza, że działa z ograniczeniami (na przykład dowody bez skrótów). Wypisz ją ponownie w dowolnej chwili komendą sentinel:health.

Wiersz Co sprawdza Gdy nie jest OK
Build Wersja i etykieta builda z fxmanifest.lua. -
OneSync Convar onesync. Sentinel odczytuje pozycje, encje i eventy gry przez OneSync. włącz onesync w server.cfg
Uruchomione kopie Ile kopii resource'a jest uruchomionych, niezależnie od nazwy folderu. Musi być 1. zostaw jedną kopię Sentinela; zatrzymaj drugi folder
Przechowywanie danych Który magazyn danych wybrano (mysql lub kvp) i czy jest gotowy. zobacz sentinel:diag storage
Folder dowodów Testowy zapis i odczyt w data/archive wewnątrz resource'a. utwórz folder data/archive wewnątrz resource'a Sentinel i upewnij się, że serwer może do niego zapisywać
SHA-256 Czy node/util.js odpowiada; tworzy odcisk każdego dowodu. dowody zapisują się bez skrótów; poszukaj błędu Node w konsoli
Ochrona Poziom ochrony, jego tryb i skąd pochodzi. -
Reguły Ile reguł działa na żywo, a ile w trybie shadow. -

Po ramce startowej doradca wypisuje ustawienia FiveM, które warto zmienić na twoim serwerze (z Config.Advisor.atStartup = false wypisuje je tylko po sentinel:advisor). Przy każdym ustawieniu pokazuje obecną wartość, zalecaną, co blokuje, co może zepsuć i linię do skopiowania. Tylko odczytuje wartości; nigdy nie zmienia server.cfg. Przetestuj linię na swoim serwerze, zanim ją zostawisz.

16. Języki i to, co jest nagrywane

Teksty dla graczy i staffu pochodzą z config/locales/<code>.lua, 25 języków w tym buildzie. Config.Locale wybiera język; z Config.GameLanguage = true gracz, którego gra działa w języku oferowanym przez GTA, widzi Sentinela w tym języku, gdy jest już w grze.

Sentinel trzyma w pamięci dla każdego gracza mniej więcej ostatnie dwie minuty pozycji i eventów (Config.Recorder) i zapisuje je do archiwum w data/archive/, gdy otwiera się case albo staff użyje sentinel:save. Podczas przeglądu prosi grę podejrzanego o klipy z ekranu (fragmenty po 20 sekund) i zapisuje je w data/clips/. Zapisuje identyfikatory, które FiveM przekazuje serwerowi (adres IP jest zapisywany, ale domyślnie nigdy nie służy do odrzucenia połączenia), a gdy działa Discord, także Discord id. Przy pierwszym wejściu każdy gracz dostaje w swoim języku krótką informację, że serwer nagrywa rozgrywkę i że staff może oglądać i słuchać (Config.Notice = false to wyłącza; wtedy napisz o tym w regulaminie). Wspomnij o tym też w polityce prywatności.

Stare archiwa i klipy nie są w tym buildzie usuwane automatycznie: wyczyść data/archive/ i data/clips/ sam, gdy nie będą ci już potrzebne.

Z oxmysql dane Sentinela są w tabelach zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report i zds_trail. Bez oxmysql te same dane są w magazynie klucz-wartość resource'a (klucze zaczynające się od zds:). Bany są zawsze kopiowane do magazynu klucz-wartość, więc działają dalej, gdy baza danych leży.

17. Aktualizacja

Nowe wersje trafiają do tego samego assetu w Keymaster. Sentinel trzyma dowody we własnym folderze, więc zanim go podmienisz:

  1. Zrób kopię zapasową folderu zerodev_sentinel: folderów config/ i data/ (archiwa, klipy, raporty, wyuczone wartości bazowe), a z oxmysql także tabel zds_.
  2. Zatrzymaj serwer, zastąp folder zerodev_sentinel nowym (zachowaj nazwę folderu) i przywróć swój folder data/. Przenieś zmienione ustawienia do nowych plików konfiguracyjnych zamiast nadpisywać je starymi plikami.
  3. Uruchom serwer i przeczytaj ramkę startową (sentinel:health).

Przed aktualizacją przeczytaj informacje o nowej wersji w changelogu.

18. Odinstalowanie

  1. Usuń linię guard z każdego chronionego resource'a (sentinel:guard je wypisuje) i zrestartuj te resource'y. Zrób to najpierw: plik guard znika razem z folderem.
  2. Usuń ensure zerodev_sentinel oraz linie sentinel.admin / sentinel.staff z server.cfg, a potem zatrzymaj resource. Jeśli sentinel:lockdown zmienił entity lockdown, zatrzymanie Sentinela przywraca pierwotny tryb.
  3. Usuń folder zerodev_sentinel. To usuwa data/ ze wszystkimi archiwami, klipami i raportami, więc skopiuj wszystko, co chcesz zachować.
  4. Z oxmysql usuń tabele zds_ wymienione w sekcji 16, jeśli nie chcesz już banów i case'ów. Wpisy klucz-wartość zostają w magazynie serwera pod nazwą resource'a i bez niego nic nie robią.

Sentinel zapisuje tylko w swoim folderze, swoich tabelach w bazie i swoim magazynie klucz-wartość. Nie edytuje innych resource'ów ani server.cfg.

Najczęściej zadawane pytania

Czy Sentinel sam banuje lub kickuje?

Nie na Watch ani Recommended. Startuje na Watch, gdzie tylko loguje, co by zrobił. Na Recommended staff dostaje dowody i decyduje. Dopiero na Strict wysoki wynik wysyła gracza na kwarantannę, aż staff to sprawdzi, a znalezisko na poziomie dowodu dodaje bana do kolejki na ban wave.

Czy potrzebuję bazy danych?

Nie. Z oxmysql Sentinel trzyma dane w twojej bazie i przy pierwszym starcie tworzy własne tabele; nie ma pliku SQL do importu. Bez niego wszystko jest w własnym magazynie klucz-wartość resource'a.

Czy działa na QBCore i Qbox?

Tak. Wykrywanie, case'y, klipy, konsola, panel w przeglądarce, Discord i owner desk są takie same na każdym frameworku. Ślad pieniędzy i itemów ma własny adapter dla ESX, QBCore, Qbox i ox_inventory.

Jak dać dostęp moim adminom?

Na owner desk, STAFF: wybierz gracza online, wybierz rolę, naciśnij GRANT. Albo dalej używaj ACE: sentinel.admin daje Admin, a sentinel.staff daje Moderator.

Czy zbanowany gracz może się odwołać?

Tak. Komunikat o odmowie pokazuje kod odwołania. Gracz wysyła go twojemu staffowi, który zapisuje go komendą sentinel:appeal, albo twoja strona wysyła go do ścieżki odwołań Sentinela. Staff przyjmuje lub odrzuca odwołanie w konsoli albo komendą sentinel:decide.

Czy widzi programy do cheatowania na komputerze gracza?

Nie. Sentinel ocenia to, co widzi serwer, i to, co zgłasza gra gracza. Nie odczytuje innych programów na komputerze gracza.

Czy podsłuch czatu głosowego jest gotowy?

Wymaga pma-voice i przełącznika podsłuchu (domyślnie tylko dla właściciela), a dźwięk leci przez twoją własną grę.

Co widzą gracze?

Przy pierwszym wejściu krótką informację w ich języku, że serwer nagrywa rozgrywkę i że staff może oglądać i słuchać (Config.Notice). Dla uczciwego gracza nic więcej się nie zmienia.

Przetłumaczone z angielskiego. Jeśli coś tutaj różni się od strony angielskiej, rację ma strona angielska. English