Софт INIfier

INIfier позволяет заменить содержимое Unity TextAsset без обновления/замены самих файлов ресурсов. Это в основном полезно для разработчиков, которым необходимо заменить TextAssets в рамках своих модификаций, и не предназначено для конечных пользователей. Несмотря на это, оно все же может быть полезно пользователям, например, если в TextAsset хранится текст, который они хотели бы перевести на другой язык.

Обычно для этого необходимо обновить файлы .assets из игры и распространить обновленные файлы или патч, которые могут потребовать повторной разработки и распространения с каждым новым обновлением игры. С помощью INIfier, пока имя ресурса не изменится, вы можете продолжать использовать один и тот же файл замены в любой версии игры. И пока файл не будет перезаписан или удален, его не нужно создавать заново при каждом запуске или обновлении игры.

Установка (для конечных пользователей)

Установите Unity Mod Manager для целевой игры. Добавьте файл .zip из этого мода в Unity Mod Manager. Мод будет включен по умолчанию, но его можно включить или выключить с помощью меню UMM в игре (по умолчанию Ctrl+F10 для открытия/закрытия). Если модификация включена, она будет заменять текст/байты при каждом их чтении из TextAsset, если отключена, то при чтении текста/байтов будет возвращаться исходное содержимое. Если текст из TextAsset хранится в другой переменной или кэшируется, а не перечитывается из ресурса каждый раз, INIfier будет обрабатывать только первое чтение.

Использование (для авторов модификаций)

Ссылайтесь на .dll в вашем проекте, чтобы использовать методы INIfier. Также включен файл .xml, чтобы обеспечить интеллектуальный ввод для доступных методов.

Есть 2 способа заменить файл

• Предоставьте файл .ini для замены вместе с модом, чтобы пользователь мог поместить его в каталог INIfier/Assets
• Зарегистрируйте файл для замены программным способом

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

Заменяемая строка или массив байтов хранятся в файле .ini в папке Assets внутри каталога мода INIfier, созданного Unity Mod Manager. Если вы используете методы INIfier для работы с файлами замены, вам не нужно заботиться о фактическом расположении папки Assets.

Файл будет использоваться вместо свойств «text» или «bytes» в экземпляре TextAsset. Каждый TextAsset имеет имя, которое должно совпадать с именем файла замены. Если файл для замены не существует, INIfier создаст файл .found (но не перезапишет существующий файл .found) с тем же именем, что и TextAsset, и поместит в него содержимое. В зависимости от того, было ли вызвано свойство «text» или «bytes», файл .found будет записан в виде строки или массива байтов. Все файлы, использующие свойство «text», будут читаться/записываться в формате UTF8.

Вы можете добавить требование для INIfier в файл json с информацией о модификации. Вы должны использовать идентификатор INIfier, а не имя. Перед идентификатором должно быть 3 пробела (поскольку модификации загружаются в алфавитном порядке, это помогает INIfier исправить соответствующие методы, прежде чем что-либо другое сможет использовать TextAsset), поэтому используйте строку « INIfier-1.0.0»