Устранение неполадок
Начните с игры и версии адаптера, назначенного Network, выбранного сервера и времени ошибки. Данные в примере документации не являются credentials вашего контура.
| Симптом | Проверить | Следующий шаг |
|---|---|---|
| HTTP 200, операция не выполнена | status и формат ошибки выбранного сервиса | Обработать application error; не считать 200 успехом автоматически |
method_not_found | Правильный backend, точное имя Network, реализованная SSO route coverage | Свериться с OpenAPI; одинаковый prefix не означает одинаковый сервис |
token_invalid / access_denied | Тип токена, аккаунт, роль, выбранный сервер | Обновить авторизацию штатным потоком, не подставлять ключ другого контекста |
ozprotect_network_host_mismatch | Назначенный host сервера и фактический origin | Подключиться к выданному Network; не отключать dedicated/host guard |
| Socket.IO не подключается | /socket, namespace, WebSocket transport, auth payload | Не использовать plain WebSocket клиент или стандартный /socket.io путь |
| Команда получила timeout | Запись в БД, online-состояние сервера, поддержка команды и ACK | Проверить историю перед повтором; отдельно диагностировать запись и доставку |
| Настройки сохранились, игра не изменилась | Параметр runtime или DB-only, соединение и PushServerConfig | Проверить применение в расширении |
| Нет Steam/VAC/inventory у Minecraft | id_kind, game_id, UUID | Это другой тип профиля; не вызывать Steam с 19-значным ID |
| Checker показывает partial/unavailable/skipped | Выбранный каталог, доступность файлов, лимиты, отдельное согласие на процессы | Показать модератору ограничения; не называть компьютер чистым |
| Ошибка SQL при старте новой функции | Явные миграции и версия MySQL | Проверить схему и совместимость без импорта production dump в тест |
| AntiCheat не начинает сбор | Локальное согласие, выбранный endpoint/game context | Ознакомиться со scope и разрешить только нужный сбор; Minecraft binding ещё ограничен backend |
Что передать поддержке
Версию/commit компонента, игру и loader, шаги воспроизведения, очищенное имя ошибки, timestamp и фазу операции. Укажите, было ли это source review, fixture, локальный стек или настоящий игровой сценарий. Не прикладывайте .env, токены, коды сессий, webhook или дамп с данными игроков.
Известные границы
API settings UI содержит неподключённые Public API переключатели, см. интеграции. ID в игровом каталоге не подтверждает готовность адаптера, см. игры. Отключение consent-проверки, чужой токен или переписывание UUID mapping не являются способом исправления ошибки.