Документація ZeroDev Sentinel

ZeroDev Sentinel: встановлення та використання

ZeroDev Sentinel — серверний античит-ресурс для FiveM. Він записує те, що бачить сервер, оцінює це правилами, які самі пояснюють себе простими реченнями, і дає вашому персоналу докази до того, як когось покарають. Він стартує на рівні захисту Watch: пише в лог і нікого не карає, доки ви не оберете інакше. Цей посібник описує версію 0.1.2 на серверах ESX, QBCore, Qbox і standalone.

Для ZeroDev Sentinel 0.1.223 хв читанняОновлено

1. Вимоги

  • Увімкнений OneSync (set onesync on у server.cfg). Ресурс оголошує OneSync залежністю, тому FXServer не запустить його без OneSync.
  • Артефакт FXServer, який запускає скрипти Node 22 (будь-який чинний рекомендований артефакт; маніфест вимагає node_version '22'). Node відповідає за хешування, стиснення, список файлів і веб-маршрут для апеляцій.
  • Необов'язково: oxmysql. З ним Sentinel зберігає свої записи у вашій базі даних і під час першого запуску сам створює свої таблиці. SQL-файлу для імпорту немає. Без нього все зберігається у власному key-value сховищі ресурсу.
  • Необов'язково: pma-voice — для прослуховування голосового чату гравця з консолі або браузерної панелі.

Фреймворк важливий лише для двох речей: сліду грошей і предметів (гроші та предмети, які не видав жоден магазин, робота чи скрипт, цикли нагород, відкати) і того, хто ваш персонал (ACE-групи, які використовує будь-який фреймворк). Виявлення, кейси, кліпи, консоль, браузерна панель, Discord і owner desk працюють однаково на будь-якому фреймворку.

2. Встановлення за п'ять хвилин

SQL не потрібен, для першого запуску не треба правити конфіг, і жоден інший ресурс не змінюється.

Крок 1: Покладіть папку в resources

Скопіюйте папку zerodev_sentinel у свою папку resources. Залиште саме таку назву папки: guard-файл надсилає дані в zerodev_sentinel, а sentinel:guard попереджає вас, якщо папка називається інакше.

Крок 2: Додайте його в server.cfg

Запускайте його після oxmysql і вашого фреймворку, щоб сховище і слід грошей знайшли їх під час старту. Точний порядок для вашого фреймворку наведено в розділі 3.

Крок 3: Запустіть сервер

Консоль виводить стартову рамку й одноразовий код власника. Кожен рядок рамки — справжня перевірка; останній рядок показує READY або NOT READY з кількістю проблем (розділ 15).

Крок 4: Займіть місце власника

Зайдіть на сервер і введіть /sentinel owner <code> у чат. Тепер місце власника за вами (розділ 4).

Крок 5: Відкрийте owner desk

Натисніть F7 у грі (або введіть sentinel:console в F8) і відкрийте OWNER. Вкладка First run показує, що зроблено, а що ні: Discord, сховище кліпів, ваш персонал і його права. У кожного рядка одна кнопка. Потім пограйте кілька днів на Watch, прочитайте на вкладці Right now, що знайшов Sentinel, і перемкніть рівень захисту на Recommended у тому самому desk (розділ 6).

3. Ваш фреймворк

Sentinel сам знаходить фреймворк та inventory під час запуску. Налаштовувати нічого не треба. sentinel:trail у консолі сервера показує, який адаптер він обрав.

ESX Legacy

server.cfg
set onesync on
ensure oxmysql
ensure es_extended
# your other resources: inventory, jobs, shops ...
ensure zerodev_sentinel
  • Гроші та предмети: читаються з власних серверних івентів ESX (гроші на рахунку додано, знято або виставлено; предмети в inventory додано або прибрано; предмети передано від гравця до гравця, з прив'язкою обох сторін). Відкат використовує власні методи гравця ESX і зчитує результат назад.
  • ESX з ox_inventory: гроші відстежуються так само. У цьому режимі методи предметів ESX не повертають результату, тому Sentinel вирішує лише за повторним зчитуванням.
  • Персонал: видайте своїм адмінам ACE-право (розділ 5). Власна group.admin з ESX працює як ACE-група, якщо ви додасте для неї рядок.

QBCore

server.cfg
set onesync on
ensure oxmysql
ensure qb-core
ensure qb-inventory      # or ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Гроші: читаються з івенту зміни грошей QBCore (додавання, зняття і виставлення, з причиною). Втрата і такий самий приріст в одну мить пов'язуються як переказ, бо в QBCore немає власного івенту переказу.
  • Предмети: з ox_inventory предмети відстежуються через його хуки. З qb-inventory зміни предметів не відстежуються (payload його listener не задокументований), але відкат усе одно може переміщати предмети через задокументовані експорти qb-inventory.
  • Персонал: групи прав QBCore — це ACE-групи (group.admin, group.god). Додайте ACE-рядки з розділу 5.

Qbox

server.cfg
set onesync on
ensure oxmysql
ensure ox_lib
ensure qbx_core
ensure ox_inventory
# your other resources ...
ensure zerodev_sentinel
  • Гроші: читаються з івенту зміни грошей Qbox; баланси зчитуються назад власними експортами qbx_core. Гроші, змінені в офлайн-персонажа (за citizen id), не викликають івенту, тому їх немає в сліді.
  • Предмети: Qbox використовує ox_inventory, і Sentinel відстежує його предмети через хуки ox_inventory. Предмети, що позначають гроші фреймворку, залишаються за частиною фреймворку.
  • Персонал: ACE-групи, як на QBCore.

Standalone (без фреймворку)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Працює все, крім сліду грошей і предметів: рух, світ, івенти, івенти-приманки, godmode, state bags, зброя, кейси, кліпи, replay, консоль, панель, Discord, ролі та бани.
  • З ox_inventory і без фреймворку предмети відстежуються через ox_inventory.
  • Сховище: key-value сховище або oxmysql, якщо запустити його раніше.

Перевірка роботи

  • sentinel:health: стартова рамка ще раз. Кожен рядок — справжня перевірка; READY означає, що нічого не бракує.
  • sentinel:diag: чому обрано сховище, адаптери й рівень, кожне правило з його лічильниками та останні рішення.
  • sentinel:trail: адаптер грошей і предметів, що використовується, та останні зміни одного гравця.

В автоматичному режимі сховища Sentinel використовує oxmysql, лише якщо oxmysql уже запущений (він чекає до 15 секунд, поки oxmysql стартує); якщо oxmysql запускається пізніше, використовується key-value сховище.

4. Перший запуск: місце власника

Під час першого запуску в консолі сервера з'являється одноразовий код, дійсний 30 хвилин (sentinel:owner code виводить новий). Зайдіть і введіть /sentinel owner <code>: місце прив'язується до вашого акаунта, а код перестає діяти.

Лише місце власника може змінювати ключі, рівень захисту, ролі та права. sentinel:owner reset у консолі сервера звільняє місце, якщо його треба перенести на інший акаунт.

5. Персонал і права

В owner desk, STAFF: оберіть гравця онлайн, оберіть роль, натисніть GRANT. У комплекті чотири ролі:

Роль Може одразу після встановлення
Підтримка переглядати кейси, розбирати скарги, карта чергування
Moderator як Support, плюс replay, кік і карантин
Admin як Moderator, плюс розкриття, зняття підозр, перегляд наживо, запити на бан, апеляції
Senior admin як Admin, плюс бан, що діє одразу

Права обираєте ви. Кожна роль — це список перемикачів, які можна змінювати. Створюйте власні ролі з копії (наприклад, "Trial mod"), перейменовуйте будь-яку роль і давайте одній людині додатковий перемикач або забирайте його, не змінюючи її ролі. Перемикачі, позначені як небезпечні (миттєвий бан, прослуховування голосового чату, налаштування, керування персоналом), вимагають другого натискання. Кожна зміна записується в журнал персоналу, тож ви завжди бачите, хто що змінив.

ACE і далі працює для серверів, які вже його використовують, і читається під час кожної перевірки:

server.cfg
add_ace group.admin sentinel.admin allow
add_ace group.moderator sentinel.staff allow
add_principal identifier.fivem:1234567 group.admin
Право Яку роль дає
sentinel.admin Admin (Senior admin, доки місце власника не зайняте) і будь-яка команда sentinel:* у грі
sentinel.staff Moderator; правила руху вважають власний рух члена персоналу поясненим

Кілька команд (sentinel:audit, sentinel:case, sentinel:replay, sentinel:save) зареєстровано як restricted: у грі їм додатково потрібен command.<name>. Звичайний рядок add_ace group.admin command allow це покриває. Консоль сервера може виконати будь-яку команду.

6. Рівень захисту

Один перемикач в owner desk (OWNER, PROTECTION), а також sentinel:level у консолі сервера і Config.Protection у config/config.lua. Те, що ви виставили в desk, зберігається і після рестарту важливіше за рядок у конфігу.

  • Watch: кожне правило спостерігає і записує, що б воно зробило; ніхто не отримує сповіщень і ні з ким нічого не стається. Тим часом Sentinel дізнається, що нормально на вашому сервері: спостерігач івентів (частота і форма кожного івенту) і перевірка під час входу навчаються лише на Watch; ліміти для сутностей, бою і грошей і далі навчаються на чесній грі.
  • Recommended: кожне правило працює наживо. Персонал отримує сповіщення з доказами, і відкривається кейс. Sentinel ніколи не карає сам; вирішує ваш персонал.
  • Strict: як Recommended, і високий рахунок відправляє гравця в карантин, доки персонал не погляне; знахідка рівня доказу (Tier A: спрацював івент-приманка, підроблений запит) ще й ставить бан у чергу на ban wave.

Під перемикачем desk показує кожне правило з його станом і тим, звідки цей стан береться. Там можна закріпити одне правило на Live або Shadow, якщо це потрібно вашому серверу (наприклад, правило, яке постійно позначає один із ваших власних скриптів); рядок state у Config.Rules закріплює його у файлі конфігу і важливіший за desk.

Розумний порядок:

  1. Watch на кілька днів звичайної гри.
  2. Прочитайте, що зробили б правила: вкладка Right now, sentinel:diag rules (стовпець shadow рахує, скільки разів правило дало б бали) і sentinel:diag decisions 100.
  3. Закріпіть на Shadow будь-яке правило, яке позначило людину, якій ви довіряєте, і повідомте нам.
  4. Перемкніться на Recommended. Тепер персонал бачить кейси і докази; нікого не карають автоматично.
  5. Strict — коли ви довіряєте тому, що показує Recommended.

Повернутися назад можна будь-коли: Watch у desk або sentinel:level watch.

7. Консоль персоналу (F7)

Натисніть F7 у грі (або введіть sentinel:console у F8). Кожен гравець може змінити клавішу в налаштуваннях гри (Key Bindings, FiveM). Esc закриває консоль.

  • Right now простими словами каже, що відбувається на вашому сервері: хто схожий на загрозу і чому, що доведено, що пояснено (ревайв, власний телепорт скрипту) і що потребує вашої уваги. Кожен гравець, який має значення, отримує один рядок: що він зробив, що це, ймовірно, таке, наскільки Sentinel упевнений (Unusual, Suspicious, Very likely, Proven), що Sentinel уже зробив, і один наступний крок.
  • Case files: спершу відкриті кейси, кожен зі своєю знахідкою, доказами, кліпами екрана, печаткою (чи ще сходиться ланцюжок хешів кейсу) і клавішами REVEAL, QUARANTINE, CLEAR і BAN (CLEAR і BAN просять натиснути вдруге).
  • Duty map: гравці онлайн на 3D-моделі острова. Рельєф вимірює гра першого члена адміністрації, і він зберігається в data/map/.
  • Play replay закриває консоль і відтворює інцидент у приватному світі; натисніть Backspace, щоб повернутися.
  • Owner (лише місце власника): First run, Protection, Keys, Staff, Internal affairs і Server check.

Команди, які вводять у грі, пишуться в F8 без скісної риски або в чаті зі скісною рискою (/sentinel:diag).

8. Браузерна панель

Той самий desk у веббраузері, коли ви не в грі:

  • на ПК сервера: http://127.0.0.1:<port>/zerodev_sentinel/panel/ (порт — це порт вашого сервера, за замовчуванням 30120)
  • з іншого місця: http://<server address>:<port>/zerodev_sentinel/panel/ або ваша власна HTTPS-адреса перед ним

Вхід. Використовуйте одноразовий код: введіть /sentinel panel у грі (код показується лише вам, діє один раз, 5 хвилин) або виконайте sentinel:panel <id or account> у консолі сервера. Сесія триває 8 годин; SIGN OUT і END ALL MY SESSIONS завершують її. Ваша роль і перемикачі діють у браузері так само, як у грі.

Live view. Адміністрація з перемикачем live view може дивитися екран будь-якого гравця онлайн із панелі або консолі. На диск нічого не зберігається, доки ви не натиснете Save to case.

Прослуховування. Щоб слухати голосовий чат цього гравця, потрібні перемикач listen (за замовчуванням лише у власника) і pma-voice. Звук відтворюється через вашу власну гру, тож будьте в грі на тому самому сервері.

Кожен перегляд наживо і кожне прослуховування записуються в журнал адміністрації та в кейс гравця, а гравцям під час першого входу повідомляють, що адміністрація може дивитися й слухати (сповіщення про запис, Config.Notice).

9. Кейси, карантин, кік, бан і апеляції

Коли щось знайдено, Right now називає гравця простими словами: що він зробив, наскільки Sentinel упевнений і що він із цим зробив. Відкрийте кейс, щоб побачити докази (позиції, кліпи екрана, запечатані SHA-256, 3D-повтор), і скористайтеся клавішами:

  • REVEAL: показати ідентифікатори гравця.
  • QUARANTINE: перемістити гравця зі справжнього світу в приватний routing bucket, доки адміністрація не погляне. sentinel:release <server id> повертає його назад.
  • CLEAR: чита немає; закриває кейс і зупиняє його бан у черзі.
  • KICK: геть із сервера, з причиною, яку гравець прочитає.
  • BAN: через ban wave, з кодом апеляції.

Ban wave. Бани, зокрема BAN, натиснутий у консолі, стають у чергу на ban wave і застосовуються лише на Strict, у випадковий час через 2–24 години за замовчуванням (Config.Actions). sentinel:wave показує їх список, sentinel:wave now <account> застосовує один негайно, sentinel:wave cancel <account> скасовує його.

Апеляції. Забанений гравець бачить код апеляції в повідомленні про відмову (8 літер і цифр). Він не може зайти, щоб подати апеляцію, тому вона потрапляє до вас з-поза гри:

  1. Через вашу адміністрацію. Гравець надсилає код вашій адміністрації (тікет у Discord, пошта). Член адміністрації записує її командою sentinel:appeal <code> <text>.
  2. Через вебмаршрут. Sentinel відповідає на власній адресі вашого сервера: http://<server address>:<port>/zerodev_sentinel/appeal. Він приймає лише POST із JSON { "code": "...", "text": "...", "contact": "optional" } (текст від 10 до 2000 символів), тож він призначений для форми на вашому сайті, а не як сторінка, на яку відправляти гравців. Кожен прийнятий запит отримує ту саму відповідь, 202 «received», незалежно від того, чи збігся код із баном. Забагато запитів з однієї адреси (5 за 10 хвилин) або загалом (30 за хвилину) отримують 429. За власним зворотним HTTPS-проксі задайте set sentinel_http_proxy true, щоб ліміти рахували адресу відвідувача.

Текст відмови не каже, куди подавати апеляцію. Розкажіть гравцям у своїх правилах або напишіть власний текст зі своїм посиланням у Config.Bans.message (залиште %s, він стає кодом), наприклад 'You are banned. Appeal at discord.gg/yourserver with code %s'.

Адміністрація вирішує в консолі або командою sentinel:decide <case or code> accept|reject [note]. Accept знімає всі активні бани цього акаунта чи кейсу і скасовує бан у черзі на ban wave; reject залишає бан. Рішення остаточне й записується в журнал кейсу. sentinel:appeals показує список відкритих.

10. Репорти та Internal affairs

Репорти гравців. Будь-який гравець вводить /report <server id> <what happened>, щоб поскаржитися на гравця або члена адміністрації. Останні дві хвилини навколо обох гравців зберігаються в кейс. Адміністрація закриває репорт як actioned (вжито заходів), no breach (порушення немає), no proof (доказів немає) або duplicate (дублікат). Репорти на адміністрацію потрапляють лише до власника.

Internal affairs (лише власник, на owner desk): що зробив кожен член адміністрації і на що варто поглянути (видачі самому собі, ховання під час бою, бани без кейсу, телепорти до гравців). Щотижневий звіт про чесність записується в data/reports/; sentinel:staff report записує його зараз. Ніщо в журналі адміністрації не карає адміністрацію.

11. Захист ресурсу

Без жодних налаштувань Sentinel спостерігає за кожним івентом, який гравці можуть надіслати вашим скриптам, і оцінює гравця. Він не може зупинити виконання handler іншого ресурсу. Щоб зупинити поганий виклик до того, як скрипт запуститься, додайте guard у цей скрипт.

  1. sentinel:audit показує список івентів кожного запущеного ресурсу, які можуть викликати клієнти, з оцінкою за тим, що роблять їхні handler (наприклад, handler, який видає гроші на суму, яку обирає клієнт). Використовуйте його, щоб вирішити, які ресурси захистити першими.
  2. sentinel:guard <resource> виводить рядок, який треба додати, і server_scripts ресурсу в тому вигляді, який вони матимуть. Рядок guard має бути першим серверним скриптом. Команда лише виводить; вона не змінює жодного файлу.

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

  1. Перезапустіть цей ресурс. sentinel:guard <resource> тепер каже «guarded since ...». sentinel:guard без аргументів показує список усіх захищених ресурсів.
  2. Додавайте правила командою sentinel:patch. Доки в ресурсу немає правил, його guard пропускає кожен виклик, крім викликів від гравців у карантині, які відкидає кожен guard. Приклад: щонайбільше 3 покупки за 10 секунд, назва предмета до 32 символів і кількість від 1 до 10; відхилений виклик рахується як доказ ("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}

Для callback фреймворку пишіть callback:<name> як івент: sentinel:patch es_extended callback:esx:getPlayerNames {"args":[{"type":"table","maxItems":4}]}. sentinel:patch <resource> показує список правил ресурсу; sentinel:patch <resource> <event> off видаляє одне.

Guard ніколи не редагує файли й ніколи не змінює те, що отримує handler. Це простий, читабельний Lua в guard/guard.lua.

12. Ключі Discord і сховища кліпів

Найпростіший спосіб — owner desk, KEYS: вставте кожне значення й натисніть SAVE. Ключі зберігаються лише на сервері; desk і кожна відповідь кажуть лише «set» і більше ніколи не показують ключ.

Рядок на desk Що це Або в server.cfg (використовуйте set, ніколи setr)
Токен Discord-бота бот, якого ви створили на discord.com/developers і запросили на свій сервер set sentinel_discord_token "..."
ID сервера Discord клацніть правою кнопкою на своєму сервері, Copy Server ID (режим розробника увімкнено) set sentinel_discord_guild "..."
ID каналу сповіщень куди публікуються кейси, з кнопками для вашої адміністрації set sentinel_discord_channel "..."
ID каналу апеляцій куди публікуються апеляції set sentinel_discord_appeals "..."
Ключ FiveManage медіа-ключ із fivemanage.com; кліпи завантажуються туди set sentinel_fivemanage_key "..."
Вебхук для кліпів замість FiveManage: Discord-вебхук, який отримує кліпи set sentinel_clip_webhook "..."
Сховище кліпів fivemanage, discord, off або автоматично (перше, яке задано) set sentinel_clip_storage "..."

Ключ у server.cfg має перевагу над desk, і desk про це каже. Кнопки в Discord підпорядковуються тим самим ролям і перемикачам, що й консоль. Без жодного з них кейси та кліпи залишаються на вашому сервері (data/), а консоль і панель їх показують.

Простіші сповіщення через вебхук досі працюють: set sentinel_webhook "https://discord.com/api/webhooks/<id>/<token>" або sentinel:webhook set <url> у консолі сервера. sentinel:webhook test надсилає тестове повідомлення; sentinel:webhook показує стан, ніколи не виводячи URL; sentinel:webhook clear видаляє збережений.

13. Що ловить кожне правило

Кожне правило, спрацювавши, пише просте речення про те, що воно побачило і що виключило. Перш ніж правило зарахується проти когось, Sentinel перевіряє причини, які могли б це пояснити (респаун, ревайв, дія адміністрації, один із ваших власних скриптів, який переміщує гравців або платить їм). Пояснена знахідка записується в лог і ніколи не дає балів.

  • Tier A — це доказ: те, що робить лише чит (івент-приманка, який не викликає жоден справжній скрипт, підроблений запит).
  • Tier B — сильний: члену адміністрації варто поглянути. Сам по собі він відкриває кейс, лише коли дві різні родини правил сходяться або та сама повторюється.
  • Tier C — слабкий: він додає до рахунку й ніколи не діє сам.

Рух

Правило Що ловить Чим пояснюється Tier
teleport Стрибок понад 150 м (або в 3 рази більше за можливе) між двома вибірками спаун, респаун або ревайв, зміна routing bucket, адміністрація, івент телепорту вашого скрипту B
foot_speed Біг понад 12 м/с протягом 1,5 с пішки, не в падінні, не в ragdoll спаун, респаун, адміністрація, ваш скрипт B
air_float Рух у замороженому стані (noclip); «падіння» без зниження (fly); швидкий рух за координатами, коли гра каже, що гравець стоїть на місці (speed-меню) спаун, респаун, адміністрація, ваш скрипт B
foot_rise Підйом прямо вгору швидше за 4 м/с пішки протягом 3 с спаун, респаун, адміністрація, ваш скрипт B
vehicle_speed Транспорт, швидший у 1,3 раза за найбільшу швидкість, якої його клас досягає на вашому сервері адміністрація, ваш скрипт B

Світ

Правило Що ловить Чим пояснюється Tier
entity_blocked Спаун моделі, яку ви заблокували ваші скрипти, які її спаунять B
entity_rate / entity_model_rate Спаун значно більшої кількості сутностей (або однієї моделі) за хвилину, ніж це роблять гравці та скрипти ваші скрипти, які спаунять B
entity_untrusted Сутності, створені клієнтом, для яких немає скрипту, що їх спаунить ваші скрипти, які спаунять B
entity_disguised Сплеск однакової моделі фонового педа навколо одного гравця (меню маскує свої спауни під трафік) спаун, респаун, зміна bucket B
explosion_weapon / explosion_rate / explosion_hidden / world_distance Вибухи, яких зброя в руках зробити не може, забагато вибухів, невидимі вибухи або вибухи далеко від гравця вибухи ваших скриптів B
projectile_weapon / projectile_rate Снаряди, якими зброя не може стріляти, або їх забагато B
ptfx_rate Флуд ефектами частинок (поширена атака на краш і лаги) B
fire_rate Пожежі, які розпалюються швидше, ніж дозволяє будь-яка зброя B

Бій

Правило Що ловить Tier
damage_plausibility Шкода, більша за можливе значення для зброї B
hit_range Влучання з-поза дальності зброї B
shot_rate / kill_rate Стрільба швидша, ніж дозволяє зброя; кількість убивств за хвилину значно вища, ніж на вашому сервері B
silent_aim Влучання туди, куди гравець не цілився, неодноразово B
aim_stats / aim_stats_backed Частка хедшотів і кути різких доведень прицілу далеко за межами показників гравців вашого сервера за 30+ боїв C (B разом з іншою родиною)
esp_los_backed Неодноразове прицілювання в гравців, які, за даними свідків, сховані за стінами від C до B

Івенти та запити

Правило Що ловить Tier
bait_event Виклик підкладеного івенту, який не використовує жоден справжній скрипт (чит-меню шукають такі й запускають їх) A
bait_statebag / statebag_write Запис у state bags, які має писати лише сервер (зробити себе адміном, прапорці godmode), або надто великі state bags A / B
events_before_ready / _trap Івенти, надіслані ще до того, як гравець заспаунився (інжект до входу) B / A
event_rate / event_shape Івент, який викликають значно швидше, ніж зазвичай, або з аргументами, не схожими за формою на звичайні виклики вашого сервера B
event_flood 500+ викликів за 10 с; при власному кіку FiveM за переповнення показується список івентів, яких було найбільше B
guard_rule / guard_hard Порушення правила, яке ви задали для захищеного івенту (кількість, частота, відстань) B / A

Економіка

Правило Що ловить Tier
money_nowhere / item_nowhere Гроші або предмети, яких не видавав жоден магазин, робота чи скрипт (dev-івенти, злиті івенти продажу в магазинах) B
economy_repeat Івент нагороди або роботи, оплачений 10 разів за 30 с (фарм через виклик у циклі) B
money_jump / money_rate Раптовий стрибок балансу або темп заробітку, значно вищий, ніж на вашому сервері B
economy_trap Отримання підкладеної нагороди, яку не платить жодна справжня робота A
weapon_not_owned Зброя в руках, якої інвентар ніколи не видавав B

Гра гравця (свідок)

Правило Що ловить Tier
godmode Сервер бачить гравця невразливим протягом 30 с (не спільна безпечна зона) B
witness_backed Ознаки з гри, підтверджені власним поглядом сервера (godmode, невидимість, відсутність колізії) B
witness_bait Гра відповідає на перевірку, про яку не мала б знати A
witness_tamper Власні перевірки Sentinel у грі було перехоплено або змінено B

Ідентичність і файли

Правило Що ловить Tier
ban_fingerprint Забанений гравець повернувся з нового акаунта (апаратні токени, ідентифікатори, відбиток браузера) A / flag
young_account Зовсім новий акаунт (лише додає вагу) C
scanner_error / too_large Ресурси, які сканер скриптів не зміг прочитати, або надто великі файли, на які варто поглянути info

Чого не обіцяє жодне правило

Sentinel оцінює те, що може бачити сервер, і те, що повідомляє гра гравця. Він не читає інші програми на ПК гравця, і жоден античит не може обіцяти, що кожен чит буде спіймано. Кожна знахідка йде разом зі своїми доказами, тож ваша адміністрація вирішує на підставі фактів.

14. Команди та конфігурація

Кожна команда є на сторінці команд, а кожен ключ конфігу — на сторінці конфігурації; обидві згенеровано із самого ресурсу. Ті, якими ви користуєтеся найчастіше:

Команда Що воно робить
/sentinel owner <code> зайняти місце власника в грі за кодом із консолі
/sentinel panel одноразовий код входу для браузерної панелі (лише адміністрація)
/report <server id> <what happened> будь-який гравець скаржиться на гравця або члена адміністрації
sentinel:health стартова рамка ще раз
sentinel:diag що вирішив Sentinel і чому
sentinel:level watch\|recommended\|strict змінити рівень захисту і зберегти його
sentinel:wave бани в черзі на ban wave
sentinel:appeals відкриті апеляції
sentinel:audit ризиковані івенти кожного запущеного ресурсу
sentinel:guard <resource> рядок, який захищає ресурс
sentinel:advisor налаштування FiveM, які варто змінити на вашому сервері

Файли конфігу в config/ (config.lua, protection.lua, watch.lua) і переклади в config/locales/ відкриті для вас, як і адаптери фреймворків у bridge/ та guard-файл у guard/. Зберігайте в них коректний Lua і перезапускайте zerodev_sentinel після змін. Для першого запуску редагувати конфіг не потрібно.

15. Стартова рамка і порадник із захисту

За мить після того, як сховище готове, Sentinel виводить рамку в консолі сервера. Рядок FAIL означає, що Sentinel не може працювати як слід; рядок WARN означає, що він працює з меншими можливостями (наприклад, докази без дайджестів). Виведіть її знову будь-коли командою sentinel:health.

Рядок Що перевіряє Коли не OK
Build Версія та мітка збірки з fxmanifest.lua. -
OneSync Конвар onesync. Sentinel читає позиції, сутності та ігрові події через OneSync. задайте set onesync on у server.cfg
Copies running Скільки копій ресурсу запущено, хоч би як називалася їхня папка. Має бути 1. залиште одну копію Sentinel; зупиніть іншу папку
Сховище Яке сховище обрано (mysql або kvp) і чи воно готове. див. sentinel:diag storage
Evidence folder Тестовий запис і читання в data/archive усередині ресурсу. створіть папку data/archive усередині ресурсу Sentinel і переконайтеся, що сервер може в неї писати
SHA-256 Чи відповідає node/util.js; він знімає відбиток із кожного доказу. докази зберігаються без дайджестів; перевірте консоль на помилку Node
Protection Рівень захисту, його режим і звідки він узявся. -
Правила Скільки правил у режимі live і скільки в shadow. -

Після стартової рамки порадник виводить налаштування FiveM, які варто змінити на вашому сервері (Config.Advisor.atStartup = false виводить його лише за командою sentinel:advisor). Для кожного налаштування він показує поточне значення, рекомендоване, що воно блокує, що може зламати, і рядок для копіювання. Він лише читає значення; він ніколи не змінює server.cfg. Перевірте рядок на своєму сервері, перш ніж залишити його.

16. Мови і що записується

Тексти для гравців і адміністрації беруться з config/locales/<code>.lua, у цій збірці 25 мов. Config.Locale обирає мову; з Config.GameLanguage = true гравець, чия гра працює мовою, яку пропонує GTA, читає Sentinel цією мовою, щойно опиниться в грі.

Sentinel тримає в пам'яті для кожного гравця приблизно останні дві хвилини позицій та івентів (Config.Recorder) і записує їх в архів у data/archive/, коли відкривається кейс або адміністрація використовує sentinel:save. Під час розгляду він запитує в гри підозрюваного кліпи екрана (сегменти по 20 секунд) і зберігає їх у data/clips/. Він зберігає ідентифікатори, які FiveM дає серверу (IP-адреса записується, але за замовчуванням ніколи не використовується для відмови в підключенні), і, коли працює Discord, Discord ID. Під час першого входу кожен гравець отримує коротке сповіщення своєю мовою про те, що сервер записує гру і що адміністрація може дивитися й слухати (Config.Notice = false вимикає його; тоді повідомте їм у своїх правилах). Згадайте про це і у своїй політиці конфіденційності.

Старі архіви та кліпи в цій збірці не видаляються автоматично: очищайте data/archive/ і data/clips/ самі, коли вони вам більше не потрібні.

З oxmysql записи Sentinel лежать у таблицях zds_account, zds_ban, zds_setting, zds_pair, zds_exemption, zds_case, zds_schema, zds_report і zds_trail. Без oxmysql ті самі записи живуть у key-value сховищі ресурсу (ключі, що починаються з zds:). Бани завжди дублюються в key-value сховище, тож вони діють і тоді, коли база даних недоступна.

17. Оновлення

Нові версії публікуються в той самий asset у Keymaster. Sentinel зберігає свої докази у власній папці, тож перш ніж її замінити:

  1. Зробіть резервну копію з папки zerodev_sentinel папок config/ і data/ (архіви, кліпи, звіти, вивчені базові показники) і, якщо у вас oxmysql, таблиць zds_.
  2. Зупиніть сервер, замініть папку zerodev_sentinel новою (збережіть назву папки) і поверніть свою папку data/. Перенесіть змінені вами налаштування в нові файли конфігу, а не копіюйте старі файли поверх них.
  3. Запустіть сервер і прочитайте стартову рамку (sentinel:health).

Перед оновленням прочитайте примітки до релізу нової версії у списку змін.

18. Видалення

  1. Приберіть рядок guard з кожного ресурсу, який ви захистили (sentinel:guard показує їх список), і перезапустіть ці ресурси. Зробіть це першим: guard-файл зникне разом із папкою.
  2. Приберіть ensure zerodev_sentinel і рядки sentinel.admin / sentinel.staff із server.cfg, потім зупиніть ресурс. Якщо sentinel:lockdown змінив entity lockdown, зупинка Sentinel повертає початковий режим.
  3. Видаліть папку zerodev_sentinel. Разом із нею зникає data/ з усіма архівами, кліпами та звітами, тож скопіюйте все, що хочете зберегти.
  4. Якщо у вас oxmysql, видаліть таблиці zds_, перелічені в розділі 16, якщо бани й кейси вам більше не потрібні. Key-value записи залишаються у сховищі сервера під назвою ресурсу і без нього нічого не роблять.

Sentinel пише лише у свою папку, свої таблиці в базі даних і своє key-value сховище. Він не змінює інші ресурси та server.cfg.

Поширені запитання

Sentinel сам когось банить або кікає?

На Watch і Recommended — ні. Він стартує на Watch, де лише записує в лог, що зробив би. На Recommended адміністрація отримує докази й вирішує. Лише на Strict високий рахунок відправляє гравця в карантин, доки адміністрація не погляне, а знахідка рівня доказу ставить бан у чергу на ban wave.

Чи потрібна мені база даних?

Ні. З oxmysql Sentinel зберігає записи у вашій базі даних і під час першого запуску сам створює таблиці; SQL-файлу для імпорту немає. Без нього все зберігається у власному key-value сховищі ресурсу.

Чи працює він на QBCore і Qbox?

Так. Виявлення, кейси, кліпи, консоль, браузерна панель, Discord і owner desk однакові на кожному фреймворку. Слід грошей і предметів має власний адаптер для ESX, QBCore, Qbox і ox_inventory.

Як дати доступ моїм адмінам?

На owner desk, STAFF: оберіть гравця онлайн, оберіть роль, натисніть GRANT. Або й далі користуйтеся ACE: sentinel.admin дає Admin, а sentinel.staff дає Moderator.

Чи може забанений гравець подати апеляцію?

Так. У повідомленні про відмову є код апеляції. Гравець надсилає його вашій адміністрації, яка записує її командою sentinel:appeal, або ваш сайт надсилає його на маршрут апеляцій Sentinel. Адміністрація приймає або відхиляє її в консолі чи командою sentinel:decide.

Чи бачить він чит-програми на ПК гравця?

Ні. Sentinel оцінює те, що може бачити сервер, і те, що повідомляє гра гравця. Він не читає інші програми на ПК гравця.

Чи готове прослуховування голосового чату?

Для нього потрібні pma-voice і перемикач listen (за замовчуванням лише у власника), а звук відтворюється через вашу власну гру.

Що бачать гравці?

Під час першого входу — коротке сповіщення своєю мовою про те, що сервер записує гру і що адміністрація може дивитися й слухати (Config.Notice). Для чистого гравця більше нічого не змінюється.

Перекладено з англійської. Якщо щось тут розходиться з англійською сторінкою, правильною є англійська сторінка. English