> 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/modeli/plan-nastroiki-modelei-tekhniki/eksport-v-igru-modeli-tekhniki.md).

# Экспорт модели техники в игру

{% hint style="info" %}
Для экспорта моделей в игру используйте [Плагин для 3ds Max](/gem-rts-v1-ru/modeli/plagin-dlya-eksporta-modelei-v-igru.md)
{% endhint %}

Модель экспортируется плагином в формат, который загружается игровым движком в Редакторе и непосредственно в игре.

## Подготовка к экспорту

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

В одной сцене может находиться несколько моделей, каждая из которых определяется по кости типа `basis`**.**\
Скрытая геометрия (кости и отдельные полигоны) исключается из экспорта.\
Если скрыть кость `basis`, то вся модель исключается из экспорта.

{% hint style="warning" %}
Если нет цели исключить модель из экспорта, то нельзя скрывать ее базовую кость.
{% endhint %}

В модели можно скрывать группы ненужных элементов. Необходимо учитывать, что вместе со скрытой костью скрываются и все прилинкованные к ней.

Источники освещения в экспорт не включаются.

{% hint style="danger" %}
Перед экспортом необходимо убедиться, что в сцене отсутствует кость с именем `root`, так как это зарезервированное имя для автоматически создаваемой базовой кости скелета в игре.
{% endhint %}

## Настройка базовой кости

Пивот базовой кости должен быть выставлен в начало координат.

В свойствах базовой кости модели требуется задать:

* `Type` - параметр определяет тип сущности в игре
* `Model=path` - путь к папке модели в ресурсах игры.

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

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

* **Путь к ресурсам игры** и **исходный каталог с общими текстурами** должны быть абсолютными путями.
* **Каталог с общими текстурами в игре** — относительный путь, всегда указывающий на `texture/common/`.

## Файлы, создаваемые при экспорте

При экспорте модели из сцены в Gem RTS создаются следующие файлы:

* `.def` — текстовый файл, содержащий описание игровой сущности. Этот файл создается только при первом экспорте модели и в дальнейшем не перезаписывается, чтобы сохранить все настройки и привязки, выполненные вручную. Для удобства структурирования информации .def файла можно выносить части описаний в отдельные тематические файлы .`ext`.
* `.mdl`— текстовый файл, в котором хранится информация о костях, их иерархии, типе, свойствах, ориентации и координатах.
* `.mesh` — бинарный файл, содержащий набор геометрических мешей, формирующих визуальную часть 3D-модели; используется для отображения модели в игровом движке.
* `.material` — текстовый файл, описывающий материалы, используемые в модели. В этом файле указываются параметры шейдеров, текстур и других визуальных эффектов, применяемых к поверхности модели.
* `.cmesh` — бинарный файл, содержащий совокупность всех мешей волюмов (complex volumes), используемые для физического взаимодействия модели с другими объектами игрового мира. Определяет форму и границы модели, применяемые в расчетах столкновений и физических эффектов.
* `.animation` — бинарный файл, хранящий данные об анимациях модели. В этом файле содержатся ключевые кадры, параметры костей и другая информация, необходимая для воспроизведения анимации.
* `.dds` — бинарные файлы текстур, используемых в модели. Эти файлы содержат сжатые изображения, применяемые к поверхности модели для придания ей реалистичного вида.

Все файлы, кроме `.def` (и его частей, вынесенные в .ext) могут перезаписываться при каждом экспорте, в зависимости от настроек, указанных в окне экспортера.

Параметры экспорта настраиваются в окне экспортера.

<figure><img src="https://lh7-us.googleusercontent.com/KVYS9P7Ycr81WACbL70n6eDABfVmj1h2jUssu1lm-uu042IDYBj-jRV40-GpmxFuXZPdxzuwbsRpmHL7RToPkIKrxx3Szl-1y3expU16lDNe8UfoNiqPQBPaNz0OkI8F7wJr4-5d83gyf-b0tPLZsD4" alt=""><figcaption></figcaption></figure>

Подробнее про настройки экспорта можно узнать из статьи [Плагин для экспорта моделей в игру](/gem-rts-v1-ru/modeli/plagin-dlya-eksporta-modelei-v-igru.md)