> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/gem-rts-v1-ru/instrumentarij-gem-rts/plagin-dlya-eksporta-modelei-v-igru.md).

# Плагин для экспорта моделей в игру

## Установка и настройка плагина

Убедиться в том, что на компьютере установлен 3ds Max нужной версии.\
Для работы с плагином понадобится установленный 3ds Max не ниже 2017 версии.

Плагины для экспорта моделей в игру вместе с примерами моделей и необходимыми ресурсами для работы с плагином находятся в папке **modeling** в корневой папке с игрой.

{% hint style="info" %}
О том, как найти корневую папку игры описано в статье [Расположение локальных файлов игры и Профиля игрока](/gem-rts-v1-ru/bazovaya-informaciya-o-resursakh-v-gem-rts/raspolozhenie-lokalnykh-failov-igry-i-profilya-igroka.md)
{% endhint %}

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2Fg7ni3aspPI3eSPMykORt%2F%D1%81%D0%BE%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%BC%D0%BE%D0%B5%20%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8%20modeling.png?alt=media&amp;token=0954e79c-1db5-4ae1-bb38-593030991c47" alt="" width="563"><figcaption><p>Содержимое папки modeling</p></figcaption></figure>

### Выбрать папку с плагином нужной версии

Версии плагина под разные версии 3ds Max находятся в папке `modeling\plugins`

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FJl6gotd2w2Btf06erfat%2F%D1%81%D0%BE%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%BC%D0%BE%D0%B5%20%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8%20plagins.png?alt=media&amp;token=8b241e34-45a4-4efc-8791-c54ca9b93adc" alt="" width="563"><figcaption><p>Папка с версиями плагина для 3D Max</p></figcaption></figure>

Рассмотрим установку плагина на примере 3ds Max 2025.\
Для других версий 3ds Max процесс установки и настройки плагина аналогичный.

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

1. Запустить 3ds Max (можно ограничиться пустой сценой)
2. Перетащить архив с плагином gem3export.mzp в окно 3ds Max (принцип drag & drop)

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FbYqeIy8EJXsdQ8ULhg1e%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-06-10%20%D0%B2%2018.46.09.png?alt=media&amp;token=34b71b90-7677-46c1-acf7-0ba295117b8b" alt=""><figcaption><p>Установка плагина</p></figcaption></figure>

3. Закрыть программу 3ds Max
4. Зайти внутрь gem3export.mzp как в zip архив и открыть папку **max\_root:**
   1. Скопировать файл Gem3Export.dle в папку с плагинами:\
      `%path%\Autodesk\3dsMax\2025-64bit\ENU\Plugins`
   2. Скопировать файл nvtt.dll в корневую папку 3ds Max:\
      `%path%\Autodesk\3dsMax\2025-64bit\ENU`

      \
      где %path% - путь к папке 3ds Max \\

      <figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FNQDT8Xu1lG3DWis5eL8D%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-06-10%20%D0%B2%2019.08.24.png?alt=media&amp;token=6df9abf0-a7a9-44b0-9fda-f6c376f1e29a" alt=""><figcaption><p>Копирование файлов плагина</p></figcaption></figure>

### Настройка отображения меню GEM-материалов

1. Запустить 3ds Max.
2. В меню Custom Defaults Switcher переключить на MAX Legacy.

. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcrLGqX9qm6Tv0go8lOyNzBnb_qU9efDmOpkE2cRMmYhPvCkdu_Wuz0-c4M2Uq6i9Cw993xsKGSASrCfSm-_TEhbET8gK286DvlvnhbOgu87GHXsbuh9kErNyVI1GM0dTe6fLQKKut5rha0IzQkqjv4FC5Z?key=IEJet-GBuqv2DBGlKL1MdQ)

![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNRbmBwYW-ZKYHExlg4QDPT7td03ie3ZLDs5cWOjG7IROHDfE3-HugR6O2NfjpFVwtK0n1WqHJhk5fAzlkj5QF9jqfhjrXQ2NvMcnoRxo3rS9NLuZ-xbrBZo9MQ9pVOsRRLSBbJB5ZFU3MkqaMTmxBAhSF?key=IEJet-GBuqv2DBGlKL1MdQ)

3. Закрыть программу **3ds Max**

### Добавление панели плагина в утилиты 3ds Max

1. Запустить 3ds Max
2. В настройках утилит \[Utilities] нажать кнопку `More…`

<figure><img src="https://lh7-us.googleusercontent.com/sz0N_Pc8-UgvbvslOgKQc5PzeMejHcN5UupLW_cyZE_yrcPxs_qqCRYKDlZ4qCFYRZAlSxJfuX-dg8FGLrSg6f78rcsNkSEbQ9VyqaJUY_UUrbxwko9785PTbRuLmDNDVthJyDxhRXtngReH8u7z52w" alt="" width="375"><figcaption></figcaption></figure>

3. В открывшемся окне выбрать **GEMPlugin**

<figure><img src="https://lh7-us.googleusercontent.com/YsrmhDDOBD7B5XPWutEgx1E3HJqmmMMRZmjW-yp3IWtLft9hwTIJfxdFFsEhok1f6y61WHBymJgFyBJohEfth192eTIv4XFgZiYAF4YV9xRydXmAlPO5ZIxjDBUGXMvphhvTtn-eYTWvsRygyaw0vtk" alt="" width="375"><figcaption></figcaption></figure>

4. Нажать кнопку Ok, чтобы применить выбор.

Панель плагина добавлена, следующим шагом необходимо настроить параметры плагина

### Настройка параметров плагина

1. На панели плагина нажать кнопку **Options**

<figure><img src="https://lh7-us.googleusercontent.com/0_NJlxigOcKWmzlvVgFZWEq-up_gV0Y8xysCxcEwI7_xOlscAbKGQUYkNfD8DQVvogrnK7WWnQXV-pl6lmyiCAXklfY-Dtl98PHFmiOXatx4a7GaXJ9Ivs_iJlA278ewwJvAjdNrcsbnfG_j4XfsJcU" alt="" width="375"><figcaption></figcaption></figure>

Откроется окно **Gem3 export options**

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FSGQGJ06eDhUGWIQ47UrH%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202024-06-10%20%D0%B2%2019.29.45.png?alt=media&amp;token=4f93b1c8-6f4c-424f-97ff-13adcd6983b3" alt=""><figcaption><p>Окно настроек панели плагина</p></figcaption></figure>

2. В окне **Gem3 export options** в пункте **Game folder** указать путь к корневой папке игры - автоматически заполняться остальные поля в окне настроек.
3. Заменить путь в строке Additional Resources на путь к папке мода (предварительно необходимо [создать пакет для мода](/gem-rts-v1-ru/sozdanie-modov-k-igre/dobavlenie-novykh-kart-i-missii-v-igru.md#sozdanie-paketa-dlya-moda))
4. Добавить путь к папке с текстурами в блоке **External folders: Textures**. В этом поле можно указать путь к папке `modeling/models_samples/texture/common`
5. Дополнительно можно выбрать настройки окружения для отображения во вьюпорте. Для этого в блоке environment указать путь к папке с файлами настроек окружения - выбрать нужный файл из папки `set/environment/common`

{% hint style="warning" %}
Важно: все пути должны быть прописаны в нижнем регистре!
{% endhint %}

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FVd4Id1WPuTRoHr0Icwn9%2F%D0%9D%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B8%CC%86%D0%BA%D0%B0%20Gem3%20export%20options.png?alt=media&amp;token=3f9251a6-f8b5-44ed-96a7-0f5d70acce94" alt="" width="563"><figcaption><p>Пример настроек окна Gem3 export option</p></figcaption></figure>

6. Закрыть настройки.

### Добавление кнопки экспорта на панель инструментов

1. ПКМ на панели инструментов
2. Открыть **Customize**

<figure><img src="https://lh7-us.googleusercontent.com/aPf6k86Ub36izIPc7RfpMopvQdgnGkxHQ5tcnFAdxY45PzTnrFjgmNABfzbweSPXBWIhirPox9W6MEHjfD1sd17hCPwHWdLbdOdT4ZAsQ8LvWgWDLO2zgQJPxaNXx8UghT0K4PcPhTx3BFcSGfv4Ios" alt="" width="563"><figcaption></figcaption></figure>

3. Выбрать вкладку **Toolbars**
4. Найти в списке **Actions “Gem3 Export…”**

<figure><img src="https://lh7-us.googleusercontent.com/O2HqAefDgYjILayCvZyQ_ARan8eVUQVkmgzZaOR2HSOIIcg2v94ONyhJhum-XmZFI87HQvkTUTZliwvCK6i4rBSGh763eABdlO13l-7Fhace7wbaQGkDkVIJ7qNH5MT21MSCtnM4JUgbWJmtDi20DNU" alt="" width="563"><figcaption></figcaption></figure>

5. Перетянуть **GEM3 Export..** в нужное место на панели.

## Начало работы

### Конвертация материалов

После установки плагина при первом открытии max файла его старые материалы EclipseMtl и Gem2 автоматически конвертируются в Gem3 материал.

Если текстуры или схемы не найдены, откроется окно, в котором можно выбрать папку с текстурами и схемами. Либо воспользоваться функцией Auto repair, которая найдет папку с текстурами, согласно путей, прописанных в файлах mdl common, находящихся рядом с открытым max файлом.

### Настройка viewport

Чтобы материалы во вьюпорте выглядели точно так же, как в игре, надо выключить gamma в настройках 3ds max.

1. Открыть меню вкладки **Rendering**
2. Выбрать пункт **Gamma/Lut setup**

   <figure><img src="https://lh7-us.googleusercontent.com/xH6CM0X8waHuQTqCnqbWMv4GtogMJo6ugUYRPDTvEbLrHdisweqkeNb6l5_CcDVcFOfAVzmXmCMam36jjtokW5hGuOMMJwHI3cGzAEHEVjA8E9UihfzN9G2_OV_GeD8wEj7RDV2oJIcGNH5QQ3LR2j8" alt=""><figcaption></figcaption></figure>
3. В открывшемся окне **Preference Settings** выбрать вкладку **Gamma and LUT**
4. Снять флажок в чекбоксе **Enable Gamma/LUT Correction**:

<figure><img src="https://lh7-us.googleusercontent.com/hUdfiEe9wFs-_8IZ2zEJD42qcsEI-n9knkKIDGgwpbtjgzhtqQO2lpJ7VXjbyJdslO74GEzjazboKmqVpzJryf1nQf3jrQ0MnwkN4XmZM45Dfn41L8bnDKOBtgK1VzHttWj4d2sWvddeqLDk_YWz3-g" alt=""><figcaption></figcaption></figure>

5. В меню режима отображения окна вьюпорта в пункте **Viewport Background** выставить флажок **Environment Background**

<figure><img src="https://lh7-us.googleusercontent.com/g0yGXCiaO7NK0ZP4XN8S1rKfDW09MQiakaz_6pMAR77D9MdoxFJn_dCcbQ09T3qQ7va3_Ri1fLu3I0N_u0f7C1fEhuhRWSU9pUx8yNe3srBqjlrBxhnj7XqrsO7deVWEJHEVySLJTZkpZQpQ_r60m_8" alt=""><figcaption></figcaption></figure>

6. Настроить отображение качества текстур в окне Viewport.
   1. Открыть меню окна Viewport
   2. Выбрать пункт Viewport Configuration
   3. В открывшемся окне на вкладке Display Performace выставить нужное значение настроек текстур Texture Maps.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2F5c7i62F2uBRAAvR3EU0t%2F%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B8%CC%86%D0%BA%D0%B0%20%D1%82%D0%B5%D0%BA%D1%81%D1%82%D1%83%D1%80%20%D0%B4%D0%BB%D1%8F%20%D0%B2%D1%8C%D1%8E%D0%BF%D0%BE%D1%80%D1%82%D0%B0.png?alt=media&amp;token=927058da-a6b1-4885-ae78-91e40ffa26ed" alt=""><figcaption><p>Настройка качества отображения текстур</p></figcaption></figure>

{% hint style="warning" %}
Большое значение параметра Texture Maps увеличивает нагрузку на оперативную память. Рекомендуемое значение 2048.
{% endhint %}

### Экспорт

При нажатии на кнопку экспорта необходимо выставить флажки:

* Gem RTS compatible;
* Don’t rename bones.

Остальные флажки выставляются ситуативно, в зависимости от того, что из какие компоненты сцены необходимо заэкспортить. Геометрия, текстуры, свет и камеры, анимации можно экспортить как все вместе, так и по отдельности.

<figure><img src="https://lh7-us.googleusercontent.com/RieaWQhtyNCNX_9EkfPnhCi4MkIjN_K7Us0pMs_jkOxPkCgw0IvgQWCIeMYDVY0-XGyo5J4a2TLSQUG1dgQIvNQ19Pbi59sl21vf3S3V4IQ3Or6fttFyPJc-eKDQ3xjJs8jJdn8PjORFW-NlEs31Q2Q" alt="" width="563"><figcaption></figcaption></figure>

По умолчанию экспорт модели осуществляется в папку `modeling\scene\entity\`.\
Можно установить путь экспорта непосредственно в папку с модом, вписав его в поле [Additional Resources](#nastroika-parametrov-plagina) в свойствах панели плагина.

## Необходимые ресурсы

<table><thead><tr><th width="472">Ресурсы</th><th>Расположение</th></tr></thead><tbody><tr><td>Ресурсы, необходимые для корректной работы плагина</td><td>modeling/resource</td></tr><tr><td>Примеры моделей</td><td>modeling/models_sample</td></tr><tr><td>Tекстуры и схемы</td><td>texture/common</td></tr></tbody></table>