Быстрый старт
Tosun AntiCheat — Документация
Всё необходимое для защиты вашего FiveM-сервера от читов. Дорожная карта ниже показывает, с чего начать в вашей ситуации.
Быстрый старт — работает за 15 минут
Если вы начинаете с нуля, следуйте этому порядку:
| # | Шаг | Время | Гайд |
|---|---|---|---|
| 1 | Подготовьте базу данных Уже на QBCore/ESX? Существующей БД достаточно | ~5 мин | База данных (MySQL) → |
| 2 | Откройте аккаунт в панели Лицензионный ключ создаётся здесь | ~2 мин | Панель и сайт → |
| 3 | Установите античит Скачайте, распакуйте, добавьте 3 строки в server.cfg | ~5 мин | Установка → |
| 4 | Примените hardening платформы Самый ценный шаг — блокирует большинство читов сразу | ~3 мин | Установка § 7 → |
Что вам нужно?
| Ваша ситуация | Перейти к |
|---|---|
| Новая установка с нуля | Гайд по установке — по шагам, с объяснением зачем |
| Нет БД / не подключается | Гайд по базе — варианты, строки подключения, troubleshooting |
| Хотите сами хостить панель | Настройка панели — Nginx, SSL, cron, безопасность |
| Совместимость QBCore / ESX | Framework — определяется автоматически |
| Ложные баны | Настройки и производительность — окна подтверждения, исключения |
| Интеграция со своими скриптами | Exports — API исключений, банов и whitelist |
| Где мой лицензионный ключ? | Лицензионный ключ |
| Что-то не так | FAQ · Панель → Поддержка |
Как работает система
Три компонента работают вместе:
| Компонент | Где работает | Задача |
|---|---|---|
tosun-ac | Ваш FiveM-сервер | Детект, наказание, защита. Сам античит. |
tosun-ac-guardian | Ваш FiveM-сервер | Возвращает античит за секунду, если его остановили. |
| Панель | Web | Баны, детекты, живой мониторинг, настройки. |
Панель и сервер общаются в обе стороны автоматически: детекты попадают в панель мгновенно, изменения настроек доходят до сервера за ~30 секунд. Перезапускать сервер для смены настроек не нужно.
Наш подход к защите
1. Платформенный слой (не обходится). Собственные convar маршрутизации FiveM —
sv_entityLockdown, sv_stateBagStrictMode, sv_filterRequestControl. С ними сервер просто не ретранслирует вредоносный пакет.
2. Серверно-авторитетный слой. Выдача оружия, взрывы и урон идут через серверные net-events и сверяются с серверной реальностью.
3. Клиентский слой. Целостность нативов, OCR, сигнатуры меню — быстрый и дешёвый первый фильтр.
Честно: ни один античит не может обещать «читы абсолютно не пройдут». Поэтому мы делаем упор на серверные и платформенные слои. Hardening платформы — самое эффективное, что вы можете сделать.
Политика ложных банов
Мы избегаем обеих ошибок:
- Забанить невиновного. Физические детекты требуют нескольких подряд измерений и минимальной длительности и пропускаются при лаге/десинке.
- Пропустить читера. Читер не может намеренно вызывать лаг, чтобы вечно сбрасывать окно подтверждения — при превышении общего порога наказание всё равно применяется.
Детекты с более высоким риском ложных срабатываний используют временные баны (например, noclip 7 дней); окончательные детекты остаются постоянными. Настраивается здесь: Настройки и производительность.