Документация 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 — для прослушивания голосового чата игрока из консоли или браузерной панели.

Framework важен только для двух вещей: следа денег и предметов (деньги и предметы, которые не выдал ни один магазин, работа или скрипт, циклы наград, откаты) и того, кто ваш персонал (ACE-группы, которые есть в любом framework). Обнаружение, кейсы, клипы, консоль, браузерная панель, Discord и owner desk работают одинаково на любом framework.

2. Установка за пять минут

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

Шаг 1: Положите папку в resources

Скопируйте папку zerodev_sentinel в свою папку resources. Сохраните точно такое имя папки: guard-файл отправляет данные в zerodev_sentinel, а sentinel:guard предупреждает вас, если папка называется иначе.

Шаг 2: Добавьте его в server.cfg

Запускайте его после oxmysql и вашего framework, чтобы хранилище и след денег нашли их при старте. Точный порядок для вашего framework указан в разделе 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. Ваш framework

Sentinel сам находит framework и 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. Предметы, которые обозначают деньги framework, остаются за частью framework.
  • Персонал: ACE-группы, как на QBCore.

Standalone (без framework)

server.cfg
set onesync on
ensure zerodev_sentinel
  • Работает всё, кроме следа денег и предметов: движение, мир, ивенты, ивенты-приманки, godmode, state bags, оружие, кейсы, клипы, replay, консоль, панель, Discord, роли и баны.
  • С ox_inventory и без framework предметы отслеживаются через 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. Браузерная панель

Тот же пульт в веб-браузере, на случай, когда вы не в игре:

  • на ПК с сервером: 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. Звук идёт через вашу собственную игру, поэтому будьте в игре на том же сервере.

Каждый live view и каждое прослушивание записываются в журнал стаффа и в кейс игрока, а игрокам при первом входе сообщают, что стафф может смотреть и слушать (уведомление о записи, 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 reverse proxy укажите 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

Player reports. Любой игрок вводит /report <server id> <what happened>, чтобы пожаловаться на игрока или члена стаффа. Последние две минуты вокруг обоих игроков сохраняются в кейс. Стафф закрывает жалобу с итогом: меры приняты, нарушения нет, нет доказательств или дубликат. Жалобы на стафф получает только владелец.

Internal affairs (только владелец, на owner desk): что сделал каждый член стаффа и что стоит проверить (права, выданные самому себе, скрытие в бою, баны без кейса, телепорты к игрокам). Еженедельный отчёт о честности записывается в data/reports/; sentinel:staff report записывает его сейчас. Ничто в журнале стаффа не наказывает стафф.

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

Без какой-либо настройки Sentinel наблюдает за каждым ивентом, который игроки могут отправить вашим скриптам, и оценивает игрока. Он не может помешать обработчику другого ресурса выполниться. Чтобы остановить плохой вызов до того, как скрипт выполнится, добавьте guard в этот скрипт.

  1. sentinel:audit выводит ивенты каждого запущенного ресурса, которые могут вызывать клиенты, с оценкой по тому, что делают их обработчики (например, обработчик, который выдаёт деньги в сумме, выбранной клиентом). Используйте его, чтобы решить, какие ресурсы защитить первыми.
  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 никогда не редактирует файлы и никогда не меняет то, что получает обработчик. Это простой, читаемый Lua в guard/guard.lua.

12. Ключи Discord и хранилища клипов

Проще всего через owner desk, KEYS: вставьте каждое значение и нажмите SAVE. Ключи хранятся только на сервере; owner desk и каждый ответ пишут только "set" и больше никогда не показывают ключ.

Строка на owner desk Что это Или в server.cfg (используйте set, никогда setr)
Discord bot token бот, которого вы создали на discord.com/developers и пригласили на свой сервер set sentinel_discord_token "..."
Discord server id правый клик по вашему серверу, Copy Server ID (режим разработчика включён) set sentinel_discord_guild "..."
Alert channel id куда публикуются кейсы, с кнопками для вашего стаффа set sentinel_discord_channel "..."
Appeals channel id куда публикуются апелляции set sentinel_discord_appeals "..."
FiveManage key медиа-ключ с fivemanage.com; клипы загружаются туда set sentinel_fivemanage_key "..."
Clip webhook вместо FiveManage: Discord-вебхук, который получает клипы set sentinel_clip_webhook "..."
Clip storage fivemanage, discord, off или автоматически (первое, что задано) set sentinel_clip_storage "..."

Ключ в server.cfg имеет приоритет над owner desk, и owner 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 с (не в общей safe zone) B
witness_backed Признаки из игры, подтверждённые тем, что видит сам сервер (godmode, невидимость, отсутствие коллизии) B
witness_bait Игра отвечает на проверку, о которой не должна знать A
witness_tamper Собственные проверки Sentinel в игре были перехвачены или изменены B

Идентичность и файлы

Правило Что ловит Tier
ban_fingerprint Забаненный игрок вернулся на новом аккаунте (hardware-токены, идентификаторы, отпечаток браузера) 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
Сборка Версия и метка сборки из fxmanifest.lua. -
OneSync Convar onesync. Sentinel читает позиции, сущности и игровые события через OneSync. укажите set onesync on в server.cfg
Запущено копий Сколько копий ресурса запущено, как бы ни называлась их папка. Должна быть 1. оставьте одну копию Sentinel; остановите другую папку
Хранилище Какое хранилище выбрано (mysql или kvp) и готово ли оно. смотрите sentinel:diag storage
Папка доказательств Тестовая запись и чтение в data/archive внутри ресурса. создайте папку data/archive внутри ресурса Sentinel и убедитесь, что сервер может в неё писать
SHA-256 Отвечает ли node/util.js; он делает отпечаток каждого доказательства. доказательства сохраняются без дайджестов; проверьте консоль на ошибку Node
Защита Уровень защиты, его режим и откуда он взят. -
Правила Сколько правил работают в 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. Обновление

Новые версии публикуются в тот же ассет в 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