Гайд по скриптовым библиотекам Симс 4: XML Injector, Lot51 и Toolbox
Если вы когда-либо скачивали мод и видели в его описании фразу «Требует XML Injector» или «Нужен Lot51 Core Library», вы уже сталкивались со скриптовыми библиотеками. Многие игроки обходят стороной моды с подобными пометками, считая их чем-то сложным или опасным для игры. На деле всё гораздо проще.
Что такое скриптовые библиотеки?
Скриптовая библиотека – это вспомогательный мод, который сам по себе не меняет игру и не добавляет в неё никакого контента. Он работает на фоне и служит опорой для других модов: предоставляет им готовые инструменты, которые те используют для своей работы. Думайте об этом как об общей платформе: вместо того чтобы каждый разработчик писал одно и то же с нуля, все пользуются одним проверенным решением.
Зачем они вообще нужны?
Чтобы понять смысл библиотек, нужно разобраться в одной особенности игры. Когда мод хочет добавить, например, новое взаимодействие для сима, ему приходится обращаться к определенным файлам игры. Если два мода лезут в один и тот же файл, возникает конфликт, и один из них перестаёт работать.
Библиотеки решили эту проблему: они позволяют «подсовывать» новые данные в игру аккуратно, не перезаписывая оригинальные файлы. Благодаря этому десятки модов одного типа могут работать бок о бок без каких-либо конфликтов. Плюс библиотеки дают доступ к возможностям, которых в базовом коде игры просто нет, и избавляют авторов от необходимости разбираться в программировании – не каждый моддер хочет или может писать скрипты на Python.
Самые популярные библиотеки
XML Injector
Абсолютный лидер по распространенности – на ней держится примерно 80% всех модов для Симс 4. Суть её работы в том, что она позволяет добавлять новые взаимодействия, черты и карьеры через простые XML-описания, полностью обходя стороной конфликты с файлами игры. Именно поэтому многие популярные авторы используют её как основу для своих работ.
Важный момент: XML Injector абсолютно безопасен для игры. Он ничего не ломает, не изменяет геймплей и не делает ничего заметного, просто тихо работает на фоне, обеспечивая работу других модов.
Lot51 Core Library
Библиотека от автора Lot51, заточенная под работу с объектами и анимациями. Помимо стандартного набора инструментов, в ней есть система обработки игровых событий, например, реакция на загрузку локации. Также поддерживает конфигурационные файлы и логирование, что упрощает отладку модов, которые на ней работают.
Toolbox
Эту библиотеку автор Lumpinou создала исключительно для собственных модов, чтобы не дублировать одни и те же скрипты в каждом из них. Она отвечает за кастомные уведомления и баффы. Без неё не работают многие моды этого автора, в частности, мод на реалистичную беременность (Relationship & Pregnancy Overhaul).
Как понять, какая библиотека нужна?
Никакой загадки здесь нет – это всегда написано в описании мода. Загляните в раздел Requirements, Dependencies или Требования на странице автора, и там будет перечислено всё необходимое. Если нужной библиотеки нет в папке Mods, мод просто не заработает.
При этом несколько разных библиотек отлично уживаются друг с другом и между собой не конфликтуют.
Как установить
Установка почти не отличается от установки обычного мода, но есть одно правило, о котором легко забыть: файл .ts4script должен лежать в корне папки Mods или в подпапке не глубже первого уровня вложенности. Уберете глубже – библиотека не загрузится, и мод будет молча не работать без каких-либо очевидных объяснений.
Сам процесс стандартный: скачайте архив с официального сайта автора, распакуйте и переместите нужный файл в папку Mods. Перед запуском игры убедитесь, что в настройках включены пользовательский контент и моды сценариев, крупные патчи EA иногда сбрасывают эти галочки, и тогда ни одна библиотека работать не будет.
Чтобы проверить, что XML Injector установлен правильно, в архиве есть тестовый файл XmlInjector_Test_v4.package. Положите его в Mods, зайдите в игру и кликните на любого персонажа, почтовый ящик или компьютер, там появятся тестовые взаимодействия. Если всё сработало, тестовый файл можно удалить.
Что делать, если что-то пошло не так
Самая частая ситуация – мод установлен, но не работает. В большинстве случаев причина банальна: нужная библиотека просто не установлена или её версия устарела. После каждого крупного обновления игры библиотеки нужно обновлять: старые версии нередко становятся причиной вылетов и непредсказуемого поведения модов. Если мод установлен правильно, библиотека на месте, но эффекта всё равно нет, проверьте глубину вложения файла .ts4script.
