# Модлоадинг

Многие моды требуют заменять файлы игры через [OpenIV](<https://gillian-guide.github.io/ru/resources/openiv/index.md>). Этого можно избежать с помощью модлоадера.

---

## [Fusion Overloader](<https://gillian-guide.github.io/ru/essential-modding/fusionfix/index.md>)

> [!WARNING]
>
> **Совместимость**
>
> Поддерживает и Complete Edition, и 1.0.8.0/1.0.7.0, если установлена последняя версия [FusionFix](<https://gillian-guide.github.io/ru/essential-modding/fusionfix/index.md>).

Этот модлоадер работает так: файлы загружаются из папки <mark>update</mark> *вместо* основных файлов игры, поэтому оригинальные файлы не заменяются.

---

### Установка модов, упакованных под Fusion Overloader

Скорее всего, они уже упакованы в папку <mark>update</mark>. Просто закиньте эту папку в корневую папку игры.

---

### Установка модов с файлами, которые идут в архивы `.img`

Пример: мод требует положить файл в `vehicles.img`.

> [!NOTE]
>
> **Для модов, которые предоставляют целиком архив `.img`**
>
> Если, скажем, мод собирает весь `vehicles.img`, а заменяет только одну машину - упаковывать нужно только эту отдельную машину. Можно, конечно, *не* отделять измененные файлы, но так вы сломаете совместимость с другими модами. Так что, пожалуйста, не делайте так.
>
> Если вы всё-таки хотите отделить измененные файлы, распакуйте архивы мода и ванильный в разные папки и сравните их чем-нибудь вроде [WinMerge](<https://winmerge.org/>).

1. Соберите все файлы, которые должны попасть в `.img`, в один архив `.img` (или несколько, если архивы превышают `1.5GB` - во избежание проблем) с помощью [OpenIV](<https://gillian-guide.github.io/ru/resources/openiv/index.md>).
2. Если у вас есть файлы, которые должны внедряться только в TLAD, TBoGT или IV, а не в остальные (т.е. мод дает отдельные файлы для базовой IV и EFLC), соберите отдельный `.img` для каждой части.
3. Создайте в папке <mark>update</mark> папку с названием вашего мода (если ее нет в папке с игрой, создайте).
4. Положите туда собранные `.img` файлы.
5. Если вы выполняли шаг 2, создайте еще папки <mark>IV</mark>, <mark>TLAD</mark> и <mark>TBoGT</mark> и положите отдельные `.img` файлы туда.

> [!TIP]
>
> **Приоритет**
>
> Если у вас несколько модов, заменяющих одни и те же файлы, и нужна система приоритетов, можно добавить перед названием число или символ (например, !).
>
> Что выше в папке при сортировке по **имени (по возрастанию)** - то и в приоритете.
>
> > **Ожидаемая структура папок**
> >
> > В этом примере Mod 2 должен иметь более высокий приоритет, чем Mod 1.
> >
> > - <mark>GTAIV</mark>\\
> >
> >   - <mark>update</mark>\\
> >
> >     - <mark>1 Mod 2</mark>\\
> >
> >       - `Mod2.ForEveryGame.img`
> >     - <mark>2 Mod 1</mark>\\
> >
> >       - `Mod1.ForEveryGame.img`
> >       - <mark>IV</mark>\\
> >
> >         - `Mod 1.IVOnly.img`
> >       - <mark>TLAD</mark>\\
> >
> >         - `Mod 1.TLADOnly.img`
> >       - <mark>TBoGT</mark>\\
> >
> >         - `Mod 1.TBoGTOnly.img`

---

### Установка модов с другими типами файлов

Пример: мод требует изменить `gta.dat`.

Пример 2: мод требует изменить `playerped.rpf` (сначала скопируйте ванильный файл и меняйте уже его).

> [!NOTE]
>
> Под другими типами файлов я имею в виду буквально любые заменяемые файлы, которые идут в <mark>pc</mark>, <mark>common</mark>, <mark>TLAD</mark> или <mark>TBoGT</mark>. Главное, чтобы это были не файлы `.img`.
>
> Просто положить файлы в папки модов не сработает.

1. Воссоздайте структуру папок из ванильной в <mark>update</mark>.
2. Положите заменяемые файлы точно так же, как в ванили, только в <mark>update</mark>.
3. Если два мода заменяют одни и те же файлы, объедините их с помощью инструмента сравнения (мне нравится [WinMerge](<https://winmerge.org/>)).

> [!NOTE]
>
> **Ожидаемая структура папок**
>
> - <mark>GTAIV</mark>\\
>
>   - <mark>update</mark>\\
>
>     - <mark>common</mark>\\
>
>       - <mark>data</mark>\\
>
>         - `WeaponInfo.xml`
>     - <mark>TLAD</mark>\\
>
>       - <mark>common</mark>\\
>
>         - <mark>data</mark>\\
>
>           - `WeaponInfo.xml`

---

## [IV Tweaker](<https://zolika1351.pages.dev/mods/ivtweaker>)

> [!WARNING]
>
> **Совместимость**
>
> Поддерживает только 1.0.8.0 и 1.0.7.0.

У этого модлоадера есть несколько преимуществ перед Fusion Overloader: например, он умеет внедрять не только `.img`, но и другие файлы, при этом оригиналы остаются целы. Он также позволяет увеличивать лимиты.

### Установка

1. Перейдите на [Zolika1351's Zone](<https://zolika1351.pages.dev/mods/ivtweaker>)
2. Прокрутите страницу вниз и скачайте архив.
3. Распакуйте архив `IVTweaker_vx.x.zip` в папку с игрой.

---

### Установка модов

> [!WARNING]
>
> **Для модов, которые предоставляют целиком архив `.img`**
>
> Если, скажем, мод собирает весь `vehicles.img`, а заменяет только одну машину - упаковывать нужно только эту отдельную машину. Можно, конечно, *не* отделять измененные файлы, но так вы сломаете совместимость с другими модами. Так что, пожалуйста, не делайте так.
>
> Если вы всё-таки хотите отделить измененные файлы, распакуйте архивы мода и ванильный в разные папки и сравните их чем-нибудь вроде [WinMerge](<https://winmerge.org/>).

1. Соберите все файлы, которые должны попасть в `.img`, в один архив `.img` (или несколько, если архивы превышают `1.5GB` - во избежание проблем) с помощью [OpenIV](<https://gillian-guide.github.io/ru/resources/openiv/index.md>).
2. Если у вас есть файлы, которые должны внедряться только в TLAD, TBoGT или IV, а не в остальные, соберите для них отдельный `.img`.

   - Можно также пропустить оба шага выше и использовать обычные файлы.
3. Создайте в <mark>modloader</mark> папку с названием вашего мода.
4. Положите туда собранные `.img` или обычные файлы.
5. Если вам пришлось выполнять шаг 3, создайте также отдельные папки для IV, TLAD или TBoGT и положите конкретные файлы туда.
6. Если мод не должен загружаться в других частях, можете добавить `GTAIVOnly`, `TLADOnly` или `TBoGTOnly`. Иначе отредактируйте `modloader.ini`, чтобы задать приоритет и условия загрузки модов.

> [!WARNING]
>
> **Ожидаемая структура папок**
>
> - <mark>GTAIV</mark>\\
>
>   - <mark>modloader</mark>\\
>
>     - <mark>Mod1</mark>\\
>
>       - `IVAnims.ForEveryGame.img`
>       - `WeaponInfo.xml`
>     - <mark>Mod1.TLADOnly</mark>\\
>
>       - `TLADOnly`
>       - `TLADAnims.img`
>       - `WeaponInfo.xml`
>     - <mark>Mod1.TBoGTOnly</mark>\\
>
>       - `TBoGTOnly`
>       - `TBoGTAnims.img`

---

### Настройка модлоадера

Чтобы настроить модлоадер, отредактируйте `modloader.ini` в <mark>modloader</mark>.

- Убедитесь, что правильно выставлен приоритет, чтобы ненужные моды не перекрывали другие (больше число - выше приоритет).
- Убедитесь, что моды, которые должны внедряться *только* в TBoGT или TLAD, отключены для IV (Ep0), моды *только* для TBoGT отключены для TLAD (Ep1), а моды *только* для TLAD отключены для TBoGT (Ep2).

  - Это не нужно, если вы оставили в папках файлы `GTAIVOnly`, `TLADOnly` или `TBoGTOnly`.

> [!WARNING]
>
> **Ожидаемая конфигурация**
>
> Для примера возьмем мод Improved Animations.
>
> ```ini
> [DisabledMods]
> IVImprovedAnimations=0
> TLADImprovedAnimations=0
> TBoGTImprovedAnimations=0
>
> [Priorities]
> IVImprovedAnimations=1
> TLADImprovedAnimations=2
> TBoGTImprovedAnimations=2
>
> [DisabledForEp0]
> TLADImprovedAnimations=1
> TBoGTImprovedAnimations=1
>
> [DisabledForEp1]
> TBoGTImprovedAnimations=1
>
> [DisabledForEp2]
> TLADImprovedAnimations=1
> ```

> [!NOTE]
>
> **Увеличение лимитов**
>
> Чтобы увеличить лимиты, отредактируйте `IVTweaker.ini`.
>
> Это может понадобиться, если вы ставите моды, которые, например, меняют текстуры машин - для них стоит поднять лимиты бюджета транспорта.

---

## Навигация
