ЭИК
Публикация

Устранение неполадок

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

Главный инструмент — консоль

Большинство проблем видно в консоли отладки игры. Включи её в настройках и поглядывай при загрузке контента: ошибки разбора XML и загрузки файлов сыплются туда с указанием файла и причины.

Контент не появляется

Если предмет или существо не загрузилось:

  • Файл не подключён — проверь, что он прописан в filelist.xml с правильным типом контента (тегом).
  • Кривой путь в file или texture — проверь %ModDir% и регистр имён.
  • Опечатка в типе контента — например, <Items> вместо <Item> в манифесте.
  • Мод не активен или стоит не в том порядке загрузки (меню Mods).

Ошибки синтаксиса XML

Симптом — мод вообще не грузится или ругается на разбор. Проверь:

  • Незакрытые теги (<Item> без </Item> или />).
  • Значения атрибутов без кавычек.
  • Несколько корневых элементов в файле — можно только один.
  • Неэкранированные спецсимволы: <, >, & внутри значений → &lt;, &gt;, &amp;.
  • Кривая кодировка — ставь UTF-8, иначе кириллица ломается.

Редактор с подсветкой XML (VS Code, Notepad++) подсветит непарные теги ещё до запуска игры.

Перезапись «не сработала»

Если <Override> не заменяет ванильный контент:

  • identifier не совпадает с оригиналом — проверь точное написание.
  • Потерял вложенные элементы — при перезаписи нужно перенести всё, что хочешь сохранить (см. перезапись).
  • Порядок загрузки — другой мод грузится позже и перезаписывает твой.

Конфликты модов

Если два мода меняют один и тот же контент, побеждает загруженный позже. Как найти конфликт:

  1. Отключи все моды, кроме своего.
  2. Проверь, что проблема ушла.
  3. Включай моды по одному, пока конфликт не вылезет.

Спрайты и текстуры

  • Чёрный или розовый прямоугольник вместо спрайта — кривой путь к текстуре или неверный sourcerect (координаты области в текстуре: x,y,ширина,высота).
  • Неправильный масштаб — проверь scale у <Item> и <Sprite>.

Полезные команды консоли

  • spawnitem <identifier> — заспавнить предмет для проверки.
  • spawn <speciesname> — заспавнить существо.
  • Перезагрузка контента — перезапуск игры или переподключение мода.

Чек-лист перед публикацией

  1. Консоль чистая — нет ошибок загрузки.
  2. Весь контент появляется и работает.
  3. Перезапись срабатывает, ничего не потеряно.
  4. Файлы в UTF-8, пути через %ModDir%.
  5. modversion и gameversion в filelist.xml актуальны.

Если всё чисто — можно публиковать мод.

← Ко всем разделам