Документация администратора

Код входа выдаётся ботом в личке по команде /login. Это исключает ручную регистрацию и связывает веб-сессию с реальным Telegram-аккаунтом.

После успешного входа создаётся отдельная веб-сессия. Её можно завершить кнопкой «Выйти», после чего повторный вход снова требует код из Telegram.

Панель показывает только те чаты, где у пользователя есть активность или назначенная роль бота. Случайный доступ к чужой группе через URL блокируется.

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

Показывает чаты, где у пользователя была активность, даже если он не администратор. Это помогает быстро вернуться к просмотру статистики.

Карточка общего экономического профиля: баланс, инвентарь, рост и базовые фермерские данные для общего режима экономики.

Короткий блок-напоминание о том, как работает вход, сессия браузера и ограничение доступа к группам.

Верхние карточки показывают размер аудитории, общий объём сообщений, карму и ваш текущий ранг в выбранной группе.

Блок показывает Telegram ID, роль бота и важный контекст по экономике группы. Это быстрая проверка, что вы действительно управляете нужным чатом и в нужном режиме.

На странице сразу видны локальная и общая панели экономики. Это помогает понять, какая модель хранения активов используется в чате и есть ли уже созданные аккаунты.

Несколько досок показывают активность, карму и гибридный рейтинг за всё время и за короткое окно. Эти блоки полезны для оценки живости группы и влияния участников.

Каждая настройка редактируется прямо в карточке: текстом, селектом или textarea. После сохранения панель обновляет текущее значение без полной перезагрузки страницы.

Кнопка «Сбросить» возвращает значение к серверному дефолту из конфигурации окружения. Это удобно, когда временная настройка больше не нужна.

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

У каждой настройки есть маленькая кнопка «?». Она ведёт сразу к нужному якорю в админ-документации, а при несохранённых изменениях сначала показывает список всех правок и предлагает сохранить их или перейти без сохранения.

Раздел ролей показывает все доступные роли, их ранг и набор прав. Это база для разграничения админских возможностей внутри чата.

Список рангов команд показывает, какая минимальная роль нужна для конкретной команды. Если список пуст, используются стандартные правила доступа.

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

Источник должен быть стандартным текстовым триггером бота. Новый алиас помогает адаптировать команды под словарь конкретного сообщества.

Существующие алиасы можно менять прямо из списка: исправлять источник, удалять запись или переименовывать пользовательский вариант.

Алиасы особенно удобны в чатах со своим сленгом или когда нужно сделать команды короче и интуитивнее для участников.

Администратор задаёт ключ, тип совпадения и ответ. Ответом может быть текст, media_file_id или комбинация полей для медиа-реакции.

Точное совпадение подходит для чётких команд, «содержит фразу» — для свободного текста, а «начинается с» — для шаблонов с аргументами после ключевой фразы.

В response_text можно использовать переменные вроде {user}, {reply_user}, {chat}, {text}, {args}, {date} и {time}. Тот же движок работает и в кастомных RP-действиях через /rpadd.

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

Если нужен стабильный ответ с уже загруженным Telegram-медиа, сохраните file_id и укажите media_type. Это избавляет от повторной загрузки файла.

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

Подходит для разбора спорных изменений: кто обновил настройку, когда сохранил триггер или удалил алиас.

Журнал аудита полезен при совместной работе нескольких администраторов, когда нужно восстановить контекст недавних правок.

На странице игр можно выбрать чат, режим и параметры партии. После запуска бот сам синхронизирует игровое сообщение в группе.

Панель сама подгружает изменения состояния, а также поддерживает ручное обновление сцены. Это снижает задержку между действиями в Telegram и вебе.

Для доступных режимов веб-страница показывает кнопки и формы действий: старт, остановка, переходы между фазами, служебные игровые операции.

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