Config & Performance
На этой странице описаны настройки tosun-ac/configs/anticheat_config.lua. Для каждой настройки: что защищает, влияние на производительность и рекомендуемое значение.
Золотое правило: увеличить значение мс/сек = меньше нагрузки CPU/БД (панель обновляется чуть позже). Уменьшить = быстрее реакция, но больше нагрузки. Держите каждый action на "log" первую неделю для настройки ложных срабатываний, затем переходите на "kick"/"ban".
Бюджет производительности — что чего стоит
| Функция | Стоимость | Вес |
|---|
LiveWatch (живой экран/видео) | Захват клиента + сеть + БД | 🔴 Высокий |
ResourceGuard.deepScan | CPU сервера (хеш каждого .lua/.js) | 🔴 Высокий |
BackdoorGuard / signatureScan | Периодический CPU + диск | 🟠 Средний |
| v12 VPN check | Внешний API при подключении (кэш) | 🟡 Низкий |
| Детекты (клиентский цикл) | CPU машины игрока | 🟢 Очень низкий |
LiveWatch — самая тяжёлая функция
ts.LiveWatch.interval (1500 мс ≈ 6,7 FPS): меньше значение = намного больше сеть+CPU. Рекомендуется: 1500 с tosun_render, 2500–3000 с screenshot-basic. quality 0,7 оптимально; maxConcurrent 3 для малых серверов, 5–8 для крупных.
ServerPerf — снижение лагов / хитчей
| Настройка | По ум. | Рекомендуется |
|---|
panelPlayerSyncIntervalMs | 12000 | 12000 (крупный сервер 15–20k) |
liveWatchDbPollMs | 4500 | 4500 |
configSyncIntervalSec | 120 | 120 (никогда <60 — риск overflow) |
Guards (CPU сервера)
ResourceGuard.deepScan = false (если включено, хешируется каждый файл; тяжело — включайте только при аудите).BackdoorGuard.scanIntervalMs 1800000 (30 мин); на крупных серверах 3600000, 0 = только запуск.BackdoorGuard.autoQuarantine = false (ложное срабатывание может остановить легитимный ресурс; сначала проверьте в панели).EventScanner.scanIntervalMs 3600000 (1ч) — низкая нагрузка.
Детекты
Детекты выполняются на клиенте игрока → почти нет нагрузки на сервер, очень низкий CPU клиента. Держите все включёнными; единственный риск — ложные срабатывания. Используйте ts.confirmHits, чтобы подтвердить детект 2–3 раза перед баном (сильно снижает FP, без затрат производительности).
v12 (VPN / очистка / heartbeat)
enableVpnCheck = true (ловит обход бана; внешний API при подключении, 3с таймаут, 24ч кэш).blockHosting = false рекомендуется (ложные срабатывания VPS/персонал).keepDetectionsDays 90 — на загруженных серверах 30–60, чтобы таблица была меньше.
Быстрые рекомендации
- Лаги? → увеличьте значения ServerPerf, увеличьте LiveWatch.interval, deepScan=false, увеличьте интервал BackdoorGuard.
- Максимальная защита? → все действия kick/ban, autoBlockInfected/autoQuarantine в пилоте, launcherGate (если поставляете лаунчер).
- Всегда: "log" первую неделю, confirmHits включён, управляйте чёрным/белым списком из панели, Debug=false.
Почти каждая настройка описана ниже по отдельности.
A) Основные настройки
| Настройка | По ум. | Описание / Рекомендация |
|---|
Debug | false | Логи разработчика — false в продакшене |
Locale | "tr" | Язык (tr/en/de/fr/es/pt/ru/zh) |
punishType | BAN | Наказание по умолчанию: LOG / KICK / BAN |
banIDFormat | 1 | 1=ABCD-1234, 2=#1234 |
autoSQL | false | Создать таблицы при первом запуске → затем false |
showReason | true | Показывать игроку причину бана |
spoilerIP | true | Скрывать IP в логах (приватность) |
needDiscord | false | Требовать привязку Discord при входе |
txAdminAuth | true | Признавать админ-права txAdmin |
NuiNeverBanUnauthorized | true | Неавторизованный NUI → только лог (без бана) |
screenshotModule | screenshot-basic | Источник скриншотов (tosun_render плавнее) |
B) Детекты — полный список (держите все включёнными, ~без нагрузки)
Все выполняются на клиенте; без нагрузки на сервер. Риск — ложные срабатывания → первую неделю punishType="LOG", confirmHits включён.
Aim / Бой
antiAimbot / antiSilentAim | Авто-/тихий аим |
antiInstantAim / antiMicroJitter / antiGimbalLook | Aim-snap / микро-джиттер / обзор 360° |
antiSpoofedShot / antiBulletTracer | Поддельный выстрел / источник пули |
antiNoRecoil / antiRapidFire / antiMagicBullet | Без отдачи / быстрый огонь / wallbang |
antiInfiniteAmmo / antiExplosiveAmmo | Бесконечные / взрывные патроны |
antiDamageBoost / antiWeaponDamageBoost / antiDamageMod | Множитель урона (лимит weaponDamageMultMax 1.10) |
antiMeleeDamageBoost / antiMeleeDefenseBoost | Урон/защита в ближнем бою (1.08/1.12) |
antiThermal / antiNightVision / antiRadar | Тепловизор/ночное/радар (радар по умолч. выкл) |
antiVDM / antiKill / antiTaze | VDM / неавторизованное убийство / taze-грифинг |
Движение / Тело
antiGodMode / antiPlayerInvincible | Неуязвимость |
antiNoClip / antiVehicleNoClip | No-clip (noclipHeightMin 3м, noclipFlatSpeedMin 3 м/с) |
antiTeleport / antiTeleportInVeh | Телепорт (teleportDistance 0=авто, авто 90м) |
antiFastRun / antiOnFootSpeedHack / antiSprintHack | Скорость (onFootSpeedMax 12 м/с, runSprintMultMax 1.15) |
antiSpeedHack | Скорость + handling авто |
antiSuperJump / antiInfiniteRoll | Супер-прыжок / бесконечный перекат |
antiInfiniteStamina / antiStaminaRecoveryHack / antiSwimMultHack | Множители выносливости/плавания |
antiHealthRegenSpike / antiArmorRegenSpike | Скачок HP/брони (55 / 65 в сек) |
antiIllegalExtraHealth / antiIllegalExtraArmor | Превышение лимита (200 / 100) |
antiInvisible / antiSmallPed / antiPedSwap | Невидимость / маленький пед / смена педа |
antiFreeCam / antiSpectate / antiBlips | Freecam/спектейт/blip ESP (freecamMaxDistance 45м) |
Транспорт
antiVehicleGodmode / antiVehicleHealthHack | Неуязвимость/HP авто (vehHealthCapMax 1100) |
antiVehicleTopSpeedMod / antiVehCheatPower | Макс. скорость/мощность двигателя (1.10 / 1.12) |
antiVehiclePlayerDmgBoost / antiVehicleDefenseBoost | Множитель урона/защиты авто |
antiVehicleGravityAbuse | Злоупотребление гравитацией (0.35–16.0) |
antiBlacklistedVehicles / ...Spawn | Авто из чёрного списка / спавн |
antiBlacklistPlate / antiPlateChange | Номер из чёрного списка / смена номера |
Спавн / Сущности / Визуал
antiEntitySpawn / antiSpamPed / antiPeds / antiAIs | Массовый спавн авто/объектов/педов |
antiBlacklistedWeapon / antiGiveWeapons / antiRemoveWeapons | Оружие из ЧС/неавторизованное |
antiObjectAttach / antiAttachChainAbuse | Злоупотребление attach объектов (глубина 4) |
antiExplosionBlacklist / antiExplosiveAmmo | Чёрный список взрывов |
antiOverlay / antiMenus / antiNUIDevTools | Overlay / мод-меню / NUI DevTools |
antiPickups / antiClipboardPaste | По умолчанию ВЫКЛ (приватность/FP) |
Система / Целостность
antiResourceInjection / antiResourceClone / antiCustomNative | Runtime-инъекция / клон манифеста / native hook |
antiFileTampering / antiCipherBypass / antiHWIDSpoof | Подмена файлов / cipher spoof / смена HWID |
antiResourceStop / antiResourceStart / antiModuleStop | Неавторизованная остановка/запуск ресурсов/модулей |
antiStatebagCrash / antiServerEventSpam / antiCommandSpam | Statebag-краш / спам событий-команд |
antiClearTasks / BlacklistedTasks / antiFold | Злоупотребление ClearTasks / задача из ЧС |
fakeTriggers / messageBlacklist | Honeypot фейк-событие / запрещённый чат+OCR |
antiLowFPSMacro | Макрос при низком FPS (lowFPSThreshold 6) |
C) Пороги / допуски (настройка ложных срабатываний)
confirmHits (noclip 3, teleport 3, fastrun 2…) | Подтвердить N раз перед баном — сильно снижает FP |
spawnGraceSecondsMs 35000 | Окно без детектов после спавна |
noclipStrikeMax 3 / fakeTriggerStrikeMax 2 | Допуск последовательных срабатываний |
instantAimDegPerFrame 75 / gimbalLookDegPerFrame 270 | Пороги угла aim/обзора (увеличить = меньше FP) |
maximumModifier 2.0 | Глобальный лимит множителя |
D) Системные блоки (action: log→kick→ban)
| Блок | Что делает / Рекомендация |
|---|
shield | Native hooks + скрытый NUI fingerprint/heartbeat + WebGL-скриншот/видео как доказательство при бане. nuiHeartbeatAction сначала "log" |
nativeGuard | Скан RAM/памяти через внешний tosun-guard.exe. action "log"→"kick", requireGuard true если поставляете guard |
shieldAi | Рейт-лимит спавна AI объектов/авто/педов (maxVehiclePerSec 4). action "cancel" |
shieldExplosion | Блок невидимых/беззвучных взрывов (action "ban") |
premiumGuard | Guard particle/projectile/sound/ragdoll/requestControl + рейт-лимит. Все сначала "log" |
guard (watchdog) | Живучесть отдельного ресурса tosun-guard. action "log" (нет FP если guard отсутствует) |
v16 serverMovement | Серверный телепорт (teleportSpeedFlag 150 м/с, action "log") |
cloudBridge | Threat-score + центральный запрос threat-intel (threatIntelMinScore 70, "log") |
launcherGate | Вход только через лаунчер — оставьте false, если не поставляете лаунчер |
licenseLock | Блокировка лицензии продукта — "log", затем "reject" в продакшене |
Framework.moneyCheck | Чит денег (moneyCheckThreshold 5M жёстко, moneySoftThreshold 75k мягко) |
PhoneNotify / connectingCard / AdminMenu | Телефон-уведомления / карта подключения / админ-меню |
E) Готовые наборы (пресеты)
| Сценарий | Рекомендуется |
|---|
| RP-сервер (сбалансированный) | Все action = "log" (первая неделя) → затем "kick"; confirmHits on; blockHosting=false; LiveWatch on; launcherGate=false |
| Хардкор / PvP | действия "ban"; nativeGuard.action="kick"; shieldExplosion="ban"; ужесточить пороги; premiumGuard "kick" |
| Мало RAM / VPS | deepScan=false; LiveWatch.interval 3000; повысить значения ServerPerf; BackdoorGuard.scanIntervalMs 3600000; keepDetectionsDays 30 |
| Максимальная защита | launcherGate=true (если есть лаунчер); requireGuard=true; autoBlockInfected/autoQuarantine пилот; все действия "ban"; licenseLock "reject" |
F) Снижение ложных банов
- Первую неделю
punishType="LOG" + каждый блок action="log" — наблюдайте за реальными игроками и настраивайте.
- Используйте
ts.confirmHits, чтобы подтвердить детект 2–3 раза перед баном.
- Ослабьте пороги: увеличьте
instantAimDegPerFrame, maxVehicleTeleportDistance, onFootSpeedMax и т.д.
- Постоянное исключение: панель → AC → Whitelist. Для временного/по-активности исключения — exports:
exports['tosun-ac']:AddWhitelist("license:abc", 3600) -- исключён на 1 час
exports['tosun-ac']:WhitelistArea(src, "parkour", 120) -- на время активности
exports['tosun-ac']:BypassDetection(src, {"antiTeleport","antiFastRun"}, 8000)
exports['tosun-ac']:SetPlayerExempt(src, true, 60000, "odezhda")
G) Устранение неполадок
| Симптом | Решение |
|---|
| AC не подключается (красный heartbeat) | Совпадает ли ac_api_key панели с webPanelKey FiveM? Является ли fivem_url адресом игрового сервера (не веб-панели)? Запущен ли tosun-ac? |
| Игроки не могут зайти | launcherGate.enabled=false (без лаунчера); увеличьте firstHeartbeatDeadline (тяжёлые серверы); при VPN blockHosting=false |
| Лаги / хитчи | Повысьте значения ServerPerf; повысьте LiveWatch.interval; ResourceGuard.deepScan=false; повысьте BackdoorGuard.scanIntervalMs |
| Ложный VPN-бан персонала/VPS | bypassStaffIpCheck=true; blockHosting=false; добавьте персонал в AdminBypassIdentifiers |
| Забанен легитимный игрок (FP) | Поставьте этот action="log"; увеличьте confirmHits; ослабьте порог; исключите через export |
| Ошибка reliable network overflow | Не уменьшайте значения NetworkJoin; держите configSyncIntervalSec ≥ 60 |
Полный список всех ключей детектов и вкл/выкл из панели: панель → Настройки AC.