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

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

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

1. Откройте последний скрипт-лог вашего сервера.
2. Найдите в нём строку (если данная строка отсутствует, Вы некорректно установили pbo-файл модификации):

```
[01:54:58][MagicByteSharedLibrary] Loading addon 'SuicideButton' (version 1.0.0).
```

3. Далее найдите строку (если данная строка отсутствует, Вы не переместили папку MagicByte из архива скачанного мода в папку профиля Вашего сервера или указали некорректные данные при покупке доступа к моду):

```
[01:54:58][MagicByteSharedLibrary] Addon 'SuicideButton' (version 1.0.0) has been loaded.
```

4. В логе также могут присутствовать следующие строки, если Вы не установили обязательную зависимость или ей не удалось запуститься (повторите этот раздел для неё), или если версия обязательной зависимости не соответствует ожидаемой (обновите мод-зависимость). При этом модификация не будет работать.

```
[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).
```

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

```
[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).
```

6. Если вы используете версии MagicByteSharedLibrary 2.1.0-2.1.5, проверьте наличие следующей строки. Если она присутствует, попробуйте перезапустить клиент/сервер. Если проблема сохраняется, обновите версию мода до актуальной.

```
[01:54:58][MagicByteSharedLibrary] Unix timestamp fetch failed.
```

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://workshop-guide.magicbyte.ru/mods/problemy-s-modifikaciyami.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.