Разделы документации

G-SERVER Docs

Диагностика и устранение неполадок

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

Проблема: Бот отказывается создавать каналы или категории

  • Базовая проверка: физически убедитесь, что бот G-SERVER успешно авторизован и находится в списке участников на вашем сервере.
  • Аудит прав доступа: критически важно, чтобы роль бота обладала глобальным правом Администратор (Administrator), либо, как минимум, жестким набором прав на управление каналами (Manage Channels) и управлением ролями (Manage Roles).
  • Проверка иерархии (Самая частая ошибка!): откройте настройки Discord сервера, перейдите во вкладку 'Роли' и перетащите системную роль G-SERVER как можно выше — она обязана находиться над любыми ролями, которыми бот должен управлять.
  • Ограничения Discord API: проверьте, не достиг ли ваш сервер жестких системных лимитов самого Discord (например, ограничение в 500 каналов или 250 ролей на один сервер).

Проблема: Веб-Дашборд выдает ошибку «Нет доступа» или 403 Forbidden

  • Рассинхронизация сессии OAuth2: нажмите кнопку «Выход» в интерфейсе сайта и выполните повторную авторизацию (Login) через Discord, чтобы принудительно обновить ваш токен доступа.
  • Проверка полномочий: система пустит вас в панель управления сервером только в том случае, если вы являетесь прямым Владельцем (Owner) сервера, либо обладаете подтвержденным правом 'Управление сервером' (Manage Server).
  • Задержка синхронизации: если бот был успешно установлен буквально пару минут назад, но сервер всё ещё не отображается в списке доступных на сайте, просто подождите завершения фоновой синхронизации (до 5 минут) и принудительно обновите страницу (Ctrl+F5/Cmd+R).

Проблема: Кнопки «Сохранить» или «Применить в Discord» не реагируют или выдают ошибку

  • Ошибки валидации (Подсвеченные красным поля): система не пропустит черновик. Обязательно корректно заполните подсвеченное поле, либо полностью удалите это незавершённое правило (нажав на крестик) перед попыткой сохранения.
  • Сбой привязки ID (Resource NotFound): возникает при ошибке проверки принадлежности выбранного канала/роли к вашему серверу. Нажмите кнопку принудительной 'Синхронизации структуры' на главной странице и выберите нужный объект заново.
  • Блокировка Premium (Payment Required): означает, что ваш триал-период или оплаченная подписка истекли именно для данного, конкретного сервера. Решение: приобретите и активируйте новый месячный лицензионный ключ в соответствующем разделе оплаты.
  • Статус «В очереди» (Queued) висит долго: это абсолютно нормальное явление в течение нескольких секунд, так как бот забирает новые задачи из брокера периодически (polling).
  • Timeout применения: если бот упорно не подтверждает задачу в течение более 60 секунд, сначала удостоверьтесь в его онлайн-статусе в Discord. Если бот в сети, смело повторите нажатие 'Применить' — существующая в базе задача будет безопасно продолжена, а не задублирована.

Проблема: Панели модулей (Тикеты, Верификация) были случайно удалены

Не паникуйте. Самый быстрый и безопасный способ восстановления — использование консольной команды !repair all. Если вам требуется точечно восстановить работоспособность только одного конкретного модуля, воспользуйтесь интерактивными кнопками на скрытой Панели Владельца в Discord, либо обратитесь за помощью в официальный канал поддержки.

КРИТИЧЕСКОЕ ПРЕДУПРЕЖДЕНИЕ: Категорически запрещается использовать команду полной инициализации (!setup) в качестве инструмента для 'ремонта' или обновления уже функционирующего, 'живого' сервера. Для целей обслуживания и восстановления данных используйте исключительно команды !repair all и !update.