Agency-Admin: Профессиональные инструменты модерации для настоящих сообществ FiveM

Разрыв между любительскими и профессиональными инструментами

Большинство админ-меню FiveM — любительского уровня: кнопки для выдачи оружия, телепортации, noclip и тому подобное. Agency-Admin создан для сообществ, которые относятся к модерации так же серьёзно, как команда модераторов в настоящей игровой студии.

Логирование действий с контекстом

Каждое действие администратора записывается в защищённый от изменений лог с ID администратора, целью, действием, временной меткой и причиной. Больше никаких загадок "кто дал этому игроку Rhino?". Логи можно запрашивать через админский интерфейс с фильтрами по администратору, диапазону времени и типу действия. Это базовая инфраструктура ответственности, которая действительно нужна командам персонала.

Уровни разрешений

Три встроенных уровня: модератор (кик, тайм-аут, базовые проверки предметов), админ (бан, выдача предметов, телепортация), старший админ (изменения конфигурации, управление разрешениями, администрирование базы данных). Действия каждого уровня строго ограничены, модератор не может повысить себя, найдя лазейку. Мы тестировали эту модель в нескольких крупных сообществах за последние два года.

Управление банами

Баны поддерживают длительность, причину, URL с доказательствами (скриншот или видео), статус апелляции и заметки по рассмотрению. Когда забаненный игрок пытается зайти снова, он видит сообщение с причиной и, если настроено, ссылку на апелляцию. Прозрачная модерация — эффективная модерация.

Обнаружение угроз в реальном времени

Agency-Admin ships with a configurable detection layer that flags suspicious patterns: sudden money spikes, impossible teleports, rapid item duplication, unusual weapon spawns. Flags surface in the admin dashboard with full context. We're not an anticheat, we're a detection tool that makes admin response time drop from hours to minutes.

Установка & настройка

Agency-Admin requires oxmysql for log persistence. Import admin.sql в вашу базу данных, добавьте ресурс на сервер и добавьте ensure agency-admin в server.cfg. Первоначальное назначение админов происходит через config.lua; укажите свои самые доверенные идентификаторы как старших админов. Все остальные выдачи разрешений управляются через внутриигровой интерфейс.

Ресурс автоматически определяет ваш фреймворк при запуске. В комплекте есть хуки разрешений для QBCore и ESX; для standalone-сборок функцию Config.IsAdmin(src, level) нужно реализовать вручную.

Параметры конфигурации

Параметр config.lua охватывает настройки разрешений и обнаружения:

• Уровни разрешений; имена и возможности каждого уровня полностью переопределяемы. Стандартная трёхуровневая модель — это отправная точка, а не требование.
• Пороги обнаружения; настройте порог резкого увеличения денег, лимит дистанции телепортации и скорость изменения количества предметов, которые вызывают флаги.
• Discord webhook; все действия админов и флаги обнаружения могут одновременно отправляться в канал Discord вместе с внутриигровым логом.
• URL апелляции по бану; URL, показываемый забаненным игрокам в их сообщении о бане.
• Хранение логов; сколько дней логи действий администраторов хранятся до автоматической очистки. По умолчанию 90 дней.
• Режим скрытности для старших админов , старшие администраторы могут просматривать сервер анонимно, не отображаясь в списках игроков.

Совместимость с фреймворками

Agency-Admin works on QBCore, ESX, and standalone setups. The permission layer is the only framework-touching piece, everything else (UI, logging, ban system, detection engine) is framework-agnostic. For custom frameworks, the compatibility shim is four functions in config.lua.

Почему это важно для ролевой игры

Состояние сервера напрямую связано с качеством модерации. Сообщества с видимой, последовательной и подотчетной модерацией удерживают игроков дольше, чем те, кто полагается на неформальные решения. Журнал аудита Agency-Admin — ключевой механизм подотчетности: когда решение модерации оспаривается, журнал предоставляет точный контекст того, что произошло, когда и кто это разрешил.

Слой обнаружения меняет позицию команды администраторов с реактивной на проактивную. Вместо того чтобы ждать жалоб игроков на подозреваемого читера, панель управления выявляет подозрительные паттерны до того, как они нанесут ущерб всему серверу. Обнаружение дюпа денег в первый час наносит гораздо меньше вреда, чем если он работает два дня незамеченным.

Система уровней разрешений защищает от внутренних рисков. Новый модератор с таким же доступом, как у старшего администратора, представляет собой проблему безопасности и ответственности. Точно ограниченные разрешения означают, что даже если сотрудник пойдет против правил, радиус ущерба ограничен их уровнем.

Часто задаваемые вопросы

Могу ли я добавить пользовательские команды администратора, интегрированные с системой разрешений?

Да. Используйте exports['agency-admin']:RegisterCommand(name, tier, handler) для регистрации пользовательских команд, которые наследуют проверки разрешений и автоматическое логирование Agency-Admin. Ваша команда отображается в списке команд в админском интерфейсе и логируется так же, как встроенные действия.

Как система банов обрабатывает VPN/альтернативные аккаунты?

Agency-Admin logs the full identifier set (license, steam, discord, IP) at ban time. On reconnect attempts it checks all identifiers, not just the one used for login. For servers with persistent ban evasion issues, the dashboard includes a flagging system for suspicious identifier patterns.

Могут ли модераторы видеть флаги обнаружения до принятия мер?

Флаги видны всем администраторам на уровне или выше минимального настроенного уровня для данного типа флага. Флаги резкого увеличения денег видны всем администраторам; флаги невозможного телепорта по умолчанию видны только техническим администраторам. Все просмотры флагов также логируются, администраторы могут видеть, какие флаги проверяли их коллеги и какие действия (если были) были предприняты.

Конфликтует ли Agency-Admin с другими админ-меню, такими как vMenu или qb-adminmenu?

Нет конфликта. Agency-Admin может сосуществовать с другими меню, они работают на разных клавишах и не разделяют состояние. Некоторые серверы запускают Agency-Admin вместе с устаревшим админ-меню во время перехода, используя Agency-Admin для логирования и обнаружения, сохраняя знакомые команды для опытных сотрудников.

Требования

• Сервер FiveM (QBCore, ESX или standalone)
• oxmysql
• Аккаунт cfx.re с действующей лицензией Agency-Admin
• Опционально: Agency-Reports (для интегрированной обработки жалоб игроков)

Формирование культуры персонала вокруг инструментов

Лучшие админские инструменты мира не помогут, если культура персонала не поддерживает подотчетность. Журнал аудита Agency-Admin наиболее ценен в сообществах, где сотрудники знают, что их действия логируются, и принимают это как стандартную процедуру, а не как слежку.

Установите с самого начала, что все действия администраторов проходят через интерфейс с логированием. Сопротивляйтесь искушению обходить логирование «только в этот раз» для быстрых исправлений, ценность журнала в полноте. Журнал с пропусками почти так же плох, как его отсутствие, когда нужно восстановить события.

Используйте флаги обнаружения на еженедельных обзорах персонала, а не только когда что-то идет не так. Анализ флагов за неделю, даже если ничего примечательного не произошло, помогает понять, как выглядит норма, что делает аномалии очевидными при их появлении.

Система уровней разрешений работает лучше всего, когда продвижение по уровням — значимые этапы. Модератор, получивший доступ администратора после трех месяцев чистой работы с логами, имеет контекст и заинтересованность, которых не дает мгновенное предоставление полного доступа.