Agency-Admin Веб-панель
Панель администратора для FiveM в стиле Agency с полноценной веб-панелью на твоем ПК.

1 Веб-панель в Agency Companion
В Agency-Admin есть полноценная админ-панель для твоего ПК: companion.agencyg.de/app/admin. Она работает внутри Agency Companion в браузере и связывается с твоим сервером через зашифрованное реле Agency, как и мобильное приложение. Не нужно открывать порты, и на твоём игровом сервере ничего не размещается.
| Страница | Что можно делать |
|---|---|
| Дашборд | Игроки онлайн, время тика, аптайм, ресурсы, деньги в городе, последние действия |
| Игроки | Все админ-действия из игровой панели, сообщения и предупреждения, просмотр экрана игрока в реальном времени |
| Живая консоль | Полная консоль сервера и выполнение команд от имени консоли сервера |
| Ресурсы | Запуск, остановка и перезапуск любого ресурса, пересканирование списка ресурсов |
| Конфиги | Файлы конфигурации всех ресурсов на твоём сервере, редактирование как настроек или как кода |
| Файлы | Файловый менеджер с редактором для твоих ресурсов |
| Баны, журнал действий, команда и ранги, управление сервером | Баны для офлайн-игроков, история всех админ-действий, перезапуск или остановка сервера с обратным отсчётом |
Веб-панель сделана для ПК. На телефоне или планшете используй приложение Agency Companion, в него встроен админ-модуль.
2 Подключение
В игре открой админ-меню, перейди в Web Panel и нажми Открыть в браузере или введи /webpanel. Браузер откроет панель и сразу выполнит вход.
На другом ПК открой companion.agencyg.de/app/admin и введи 6-значный код со страницы Web Panel. Код действует 5 минут.
Ты можешь подключить сколько угодно серверов, которыми управляешь, и переключаться между ними в панели. Каждое подключение это сопряжённое устройство, выйти из него можно в игре в разделе Настройки > Companion.
3 Права и безопасность
Браузер хранит токен устройства, как и приложение. Каждое нажатие проверяется на твоём сервере в реальном времени по рангу и правам админа, с тем же ограничением частоты запросов и тем же журналом действий, что и в игре.
| Право | Что открывает | Наследуется |
|---|---|---|
companion_console | Живая консоль и ресурсы | да |
server_power | Перезапуск и остановка сервера | нет, только высший ранг и ранги, которые ты отметишь |
web_files | Файлы и Конфиги | нет, только высший ранг и ранги, которые ты отметишь |
Without being in-game. Как и txAdmin, веб-панель работает и тогда, когда тебя нет на сервере. Agency-Admin запоминает права каждого админа с его последнего пребывания в игре, в том числе когда они приходят из ACE или фреймворка (права QBCore, группы ESX), и обновляет их, пока админ играет. Админ, который три минуты находится на сервере без доступа к панели, теряет запомненные права. Права, которые ты задал игроку в панели, и назначения рангов всегда имеют приоритет.
Консоль, пересканирование ресурсов и перезапуск сервера выполняются как консольные команды. Для них нужна одна строка в server.cfg:
add_ace resource.Agency-Admin command allow
4 Конфиги каждого ресурса
Страница Конфиги показывает файлы конфигурации каждого ресурса на твоём сервере, от любого автора, найденные автоматически: config.lua, shared/config.lua, config/*.lua, settings.lua, config.json и все файлы конфигурации, указанные в fxmanifest.lua ресурса. Ресурсам не нужно ничего регистрировать.
| Вид | Что показывает |
|---|---|
| Настройки | Каждое простое значение (true или false, числа, тексты) в виде переключателя или поля, рядом с комментарием из файла, сгруппировано по разделам. При изменении значения меняется только эта одна строка, форматирование и комментарии сохраняются. |
| Код | Весь файл с подсветкой синтаксиса. |
Сохранение сначала проверяет синтаксис на сервере, поэтому сломанный config.lua никогда не будет записан. Перед каждым сохранением старая версия сохраняется (последние 15 на файл, в Agency-Admin/config_backups). Сохранить и перезапустить сразу перезапускает ресурс, Предыдущие версии возвращает старую версию.
Конфиги, зашифрованные с помощью FiveM Escrow, отображаются с замком и не редактируются.
5 Новые сборки FXServer: одна строка на ресурс
Сборки FXServer примерно с 25770 изолируют файловую систему: ресурс может записывать в другой ресурс только если server.cfg разрешает это до запуска сервера. Работающий сервер эти строки игнорирует. Добавь по одной строке для каждого ресурса, конфиг которого хочешь сохранять из панели, затем один раз перезапусти сервер:
add_filesystem_permission Agency-Admin write qb-core
add_filesystem_permission Agency-Admin write Agency-Housing
Если строки не хватает, панель сообщит об этом при сохранении и покажет точные строки для копирования, для этого ресурса или сразу для всех ресурсов с конфигом. В txAdmin вставь их в CFG Editor.
6 Файлы
Страница Файлы открывает каждый ресурс на твоём сервере с файловым менеджером и редактором: просмотр, открытие, редактирование, сохранение, создание, переименование и удаление файлов и папок, с той же одной строкой на ресурс из раздела 5 для сохранения в другие ресурсы.
Новые сборки FXServer не позволяют ни одному ресурсу читать папку сервера, server.cfg или папки категорий вроде [standalone]. Поэтому над ресурсами панель показывает папки, собранные из установленных ресурсов, только для чтения, с примечанием. Внутри ресурса ты работаешь как обычно. server.cfg редактируется в txAdmin, в CFG Editor.
Файлы больше Config.WebPanelFiles.MaxEditKb (по умолчанию 1024 КБ) в редакторе не открываются. Config.WebPanelFiles.ReadOnly = true превращает файловый менеджер в просмотрщик.