Инструкция по созданию аддонов

В модификации X-Ray Multiplayer Extension, есть возможность создания аддонов с измененными файлами из папки *gamedata.* Для создания аддона, необходимо:

* Распаковать игровые архивы X-Ray Multiplayer Extension любым распаковщиком игровых ресурсов для Зова Припяти, например, Universal Extractor 2.0.
* Отредактировать интересующие файлы. Для примера, отредактируем файл русскоязычной локали для главного меню *ui\_st\_mm.xml*, находящийся в директории *gamedata/configs/text/rus* в распакованной версии игры.

```
 <!--Оригинальный файл-->
 <string id="ui\_mm\_network\_game">
 <text>ИГРАТЬ</text>
 </string>

```

```
 <!--Отредактированный файл-->
 <string id="ui\_mm\_network\_game">
 <text>СТАРТ</text>
 </string>

```

* Запаковать измененные файлы стандартным запаковщиком ресурсов *xrCompress*, поставляемым с официальным SDK Зова Припяти. Положить рядом с файлом *xrCompress.exe* конфигурационный файл сборки формата *ltx* с произвольным именем, например, *settings\_xrmpe\_addon.ltx.* Сконфигурировать запаковку, отредактировав этот файл.

```
[options]
;список игнорируемых расширений файлов при запаковке
exclude_exts = *.ncb,*.sln,*.vcproj,*.old,*.rc,*.scc,*.vssscc,*.bmp,*.smf,*.uvm,*.prj,*.tga,*.txt,*.log,*.psd,*.7z,*.rar

;секция include_folders используется для добавления измененных директорий в аддон
;здесь также можно указывать подпапки, например, в нашем случае, можно указать configs\text\rus
[include_folders]
configs = true

;секция include_files используется для добавления конкретных измененных файлов в аддон
;в основном, мы используем эту секцию для добавления измененных файлов в корне gamedata, например
;particles.xr или shaders.xr
[include_files]

[header]
auto_load = true ;не изменять
creator = "gsc and xrmpe"
entry_point = $fs_root$\gamedata\ ;не изменять
level_name = single
level_ver = 1.0
link = vk.com/xr_mpe
```

* Создать рядом с файлом *xrCompress.exe* папку с произвольным именем для модифицированных файлов, например, *addon\_input.* Скопировать в эту папку все модифицированные файлы с сохранением оригинальной структуры.

* Создать рядом с файлом *xrCompress.exe* файл формата *bat* с произвольным именем, например, *addon\_pack.bat* и сконфигурировать его:

```
xrCompress.exe addon_input -ltx settings_xrmpe_addon.ltx -store

```

* Запустить файл *addon\_pack.bat* и дождаться окончания запаковки. По окончании запаковки у Вас должен появиться файл формата *pack\_#0.* Измените его расширение на *db.*

* В корневой директории **игры** создать папку *addons.*

* В директории *addons* создать папку с произвольным именем, например, *xrmpe\_addon*.

* Поместить в созданную папку *xrmpe\_addon* файл с расширением *db.*
* Для запуска аддона необходимо добавить параметр запуска игры *-mod=%имя\_папки\_аддона%.* Например: *-mod=xrmpe\_addon*. Параметр запуска необходимо добавить как для клиента, так и для сервера во избежание ошибки *Различные версии*.

## Важная информация

Внимание! Если вы хотите добавить новые строки в файлы локали (configs/text), то следует назвать файл именем, которого не существует в базовой версии xrMPE. Если вы хотите изменить какой-то конфигурационный файл (\*.ltx) или файл разметки (\*.xml) (не путать с файлом локали, **локали находятся исключительно в** **configs/text**), убедитесь, что для этого файла не существует аналога с припиской \_addon. Эти файлы созданы специально, чтобы не перегружать потенциально важные для будущих обновлений xrMPE файлы в пользовательских аддонах. Если такие файлы имеются, то добавляйте новые строки именно в них. На данный момент добавлены следующие файлы с припиской *\_addon*:

* `ui_custom_msgs_addon.xml`
* `progress_bars_addon.xml`
* `map_spots_addon.xml`

Список будет обновляться по мере добавления файлов.