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.