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.
1. Wymagania
- Włączony OneSync (
set onesync onw 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 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
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.adminz ESX działa jako grupa ACE, gdy dodasz dla niej linię.
QBCore
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
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)
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:
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ść:
- Watch przez kilka dni normalnej gry.
- Przeczytaj, co zrobiłyby reguły: zakładka Right now,
sentinel:diag rules(kolumna shadow liczy, ile razy reguła by punktowała) isentinel:diag decisions 100. - Przypnij na Shadow każdą regułę, która oznaczyła kogoś, komu ufasz, i daj nam znać.
- Przełącz na Recommended. Staff widzi teraz case'y i dowody; nikt nie jest karany automatycznie.
- 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:
- Przez twój staff. Gracz wysyła kod twojemu staffowi (ticket na Discordzie, mail). Członek staffu zapisuje go komendą
sentinel:appeal <code> <text>. - 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 ustawset 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.
sentinel:auditwypisuje 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.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' }
- Zrestartuj ten resource.
sentinel:guard <resource>mówi teraz "guarded since ...". Samosentinel:guardwypisuje każdy chroniony resource. - 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:
- Zrób kopię zapasową folderu
zerodev_sentinel: folderówconfig/idata/(archiwa, klipy, raporty, wyuczone wartości bazowe), a z oxmysql także tabelzds_. - Zatrzymaj serwer, zastąp folder
zerodev_sentinelnowym (zachowaj nazwę folderu) i przywróć swój folderdata/. Przenieś zmienione ustawienia do nowych plików konfiguracyjnych zamiast nadpisywać je starymi plikami. - Uruchom serwer i przeczytaj ramkę startową (
sentinel:health).
Przed aktualizacją przeczytaj informacje o nowej wersji w changelogu.
18. Odinstalowanie
- Usuń linię guard z każdego chronionego resource'a (
sentinel:guardje wypisuje) i zrestartuj te resource'y. Zrób to najpierw: plik guard znika razem z folderem. - Usuń
ensure zerodev_sentineloraz liniesentinel.admin/sentinel.staffz server.cfg, a potem zatrzymaj resource. Jeślisentinel:lockdownzmienił entity lockdown, zatrzymanie Sentinela przywraca pierwotny tryb. - Usuń folder
zerodev_sentinel. To usuwadata/ze wszystkimi archiwami, klipami i raportami, więc skopiuj wszystko, co chcesz zachować. - 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.