Главная/Документация/Модификации/Проблемы с модификациями

Проблемы с модификациями

Проблемы с модификациями

Модификация не работает

На примере модификации SuicideButton версии 1.0.0, зависящей от MagicByteSharedLibrary. Название модификации и её версия в Вашем случае могут отличаться.

  1. Откройте последний скрипт-лог Вашего сервера.
  2. Найдите в нём строку:
[01:54:58][MagicByteSharedLibrary] Loading addon 'SuicideButton' (version 1.0.0).

Если данная строка отсутствует, скорее всего, Вы некорректно установили PBO-файл модификации.

  1. Далее найдите строку:
[01:54:58][MagicByteSharedLibrary] Addon 'SuicideButton' (version 1.0.0) has been loaded.

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

  • Вы не переместили папку MagicByte из архива скачанной модификации в папку профиля сервера;
  • при покупке доступа к модификации были указаны некорректные данные;
  • модификация не смогла пройти проверку лицензии.
  1. Если обязательная зависимость не установлена, не смогла запуститься или её версия не соответствует требуемой, в логе могут присутствовать следующие строки:
[01:54:58][MagicByteSharedLibrary] Error: Addon 'SuicideButton' is missing hard dependency 'MagicByteSharedLibrary' (expected version 2.0.0).
[01:54:58][MagicByteSharedLibrary] Error: Addon 'SuicideButton' is missing hard dependency 'MagicByteSharedLibrary' (expected version 2.0.0, found version 1.0.0).

В этом случае модификация работать не будет.

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

Если установлена неподходящая версия зависимости — обновите её до требуемой версии.

  1. Если не установлена опциональная зависимость, она не смогла запуститься или её версия не соответствует ожидаемой, в логе могут присутствовать следующие строки:
[01:54:58][MagicByteSharedLibrary] Warning: Addon 'SuicideButton' is missing soft dependency 'MagicByteSharedLibrary' (expected version 2.0.0).
[01:54:58][MagicByteSharedLibrary] Warning: Addon 'SuicideButton' is missing soft dependency 'MagicByteSharedLibrary' (expected version 2.0.0, found version 1.0.0).

В этом случае модификация продолжит работать, однако некоторые её функции могут быть недоступны.

  1. Если Вы используете MagicByteSharedLibrary версии 2.1.0–2.1.5, проверьте наличие следующей строки:
[01:54:58][MagicByteSharedLibrary] Unix timestamp fetch failed.

Если она присутствует, попробуйте перезапустить клиент и сервер.

Если проблема сохраняется — обновите MagicByteSharedLibrary до актуальной версии.

Ошибки проверки и синхронизации модификации

В логах MagicByteSharedLibrary могут появляться специальные коды ошибок. По ним можно определить этап, на котором возникла проблема.

Ошибки на сервере

ValidationServerListNotAvailable

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

Проблема обычно связана с невозможностью сервера установить соединение с сервисами MagicByte.

Проверьте доступ сервера к сети Интернет и отсутствие блокировок исходящих соединений.

NoValidationServersAvailable

Полученный список серверов валидации оказался пустым.

В большинстве случаев это временная проблема на стороне инфраструктуры валидации.

Попробуйте перезапустить сервер. Если ошибка сохраняется продолжительное время, сообщите о ней в техническую поддержку.

ValidationServerNotAvailable

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

Проверьте:

  • наличие доступа сервера к сети Интернет;
  • настройки Firewall;
  • отсутствие блокировки исходящих HTTP/HTTPS-запросов;
  • отсутствие временных сетевых проблем на стороне хостинга.

ClaimDenied

Сервер валидации отклонил выдачу токена лицензии.

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

Проверьте корректность данных, указанных при покупке или выдаче доступа к модификации.

TokenInvalid

Полученный токен лицензии не прошёл проверку.

Попробуйте перезапустить сервер.

Если ошибка возникает повторно, убедитесь, что используется актуальная версия модификации и MagicByteSharedLibrary.

Если проблема сохраняется, приложите лог сервера к обращению в техническую поддержку.

Ошибки на клиенте

ServerSyncFailure

Клиенту не удалось синхронизировать состояние модификации с сервером.

Ошибка означает, что процесс синхронизации состояния модификации по направлению сервер → клиент завершился неуспешно.

Попробуйте:

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

Если ошибка сохраняется, приложите скрипт-логи клиента и сервера к обращению в техническую поддержку.

ServerSyncResult

В результате синхронизации состояния модификации сервер → клиент клиент получил состояние «не загружен».

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

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

Информация

Клиентские ошибки ServerSyncFailure и ServerSyncResult часто являются следствием проблемы на стороне сервера. Поэтому при их появлении рекомендуется сначала проверить серверный скрипт-лог.

Как сообщать о проблемах с модификацией

Открывая тикет о проблеме с модификацией, сразу предоставьте:

  1. Подробное описание проблемы: что именно произошло и какого поведения Вы ожидали.
  2. Подробные шаги для воспроизведения проблемы. Укажите, какие действия необходимо выполнить, что при этом происходит и в какой момент появляется проблема. Описание должно быть максимально подробным и содержать каждое важное действие и изменение на экране. Также можно приложить скриншоты или видео. На скриншотах рекомендуется выделить проблемное место, однако текстовое описание всё равно необходимо.
  3. Скрипт-лог сервера и лог консоли сервера.
  4. Если проблема возникла на клиенте — также приложите скрипт-лог клиента.
  5. Если в логах присутствует один из кодов ошибок, описанных выше, обязательно укажите его в сообщении.