> 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/redaktor/redaktor-kart/redaktor-entity.md).

# \[2] Редактор Еntity

Описание набора инструментов для работы с объектами на карте

Группа инструментов `Entity` находится на первой вкладке бокового меню [Редактора карт](#user-content-fn-1)[^1].

**Назначение группы инструментов Entity:**

* расстановка объектов на карте;
* редактирование размещения объектов, выставленных на карте;
* настройка свойств объектов, выставленных на карте.

{% hint style="info" %}
Для успешной работы с инструментами группы Entity полезно освоить [режимы управления камерой](/gem-rts-v1-ru/redaktor/upravlenie-kameroi.md#upravlenie-kameroi-v-redaktore) в редакторе.
{% endhint %}

Переключиться в режим работы с объектами можно двумя способами:

* нажать на иконку вкладки в боковом меню редактора карт;
* нажать на клавиатуре клавишу 1.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FDvP12xgXNBuzFlKU9cDF%2FC%D0%BF%D0%B8%D1%81%D0%BE%D0%BA%20Entity.jpg?alt=media&amp;token=f06a7d98-d859-4a99-a86e-f10bbcdf6127" alt="" width="563"><figcaption></figcaption></figure>

## Компоненты окна Entity

Основной компонент окна **Entity** - список ассетов для выставления объектов на карту.

### Список ассетов объектов

Ассеты объектов разложены по тематическим папкам, согласно их назначению.

<table><thead><tr><th width="159">Название</th><th>Описание</th></tr></thead><tbody><tr><td>-fauna</td><td>Ассеты юнитов животных</td></tr><tr><td>-human</td><td>Ассеты юнитов пехотинцев.<br>Ассеты разложены по категориям, согласно принадлежности юнита к нации, и имеют названия, согласно назначению юнита в игре.</td></tr><tr><td>-vehicle</td><td>Ассеты юнитов техники.<br>Ассеты разложены по категориям, согласно видам военной и гражданской техники, и имеют названия, соответствующие реальным машинам</td></tr><tr><td>construction</td><td>Строения и объекты антуража.<br>Ассеты разложены по тематическим категориям</td></tr><tr><td>flora</td><td>Объектов растительности: деревьев, кустов и травы</td></tr><tr><td>fx</td><td>Ассеты спецэффектов VFX.<br>Ассеты разложены по тематическим папкам.<br>Большинство ассетов предназначено для спавна эффектов в игре и при выставлении на карту в ней не сохраняются.<br>Для выставления на карту используются только некоторые эффекты из папки <strong>common, smoke</strong> и <strong>water</strong></td></tr><tr><td>humanskin</td><td>Техническая папка с моделями скинов юнитов пехоты, которые являются основой для настройки пресетов юнитов из папки -human</td></tr><tr><td>inventory</td><td>Техническая папка с моделями инвентаря.<br>Используются для настройки инвентаря юнитов</td></tr><tr><td>landscape</td><td>Ассеты элементов поверхности земли: штампов, камней и откосов. Разложены по тематическим папкам</td></tr><tr><td>particle</td><td>Техническая папка с ассетами частей юнитов, которые использует движок во время игры</td></tr><tr><td>service</td><td>Техническая папка с ассетами сервисных объектов, которые использует движок во время игры</td></tr></tbody></table>

Поле `Search entity` можно использовать для поиска нужного ассета в списке по его имени или по заданной маске.

### Дополнительные опции редактора Entity

Установка опции `Clip camera position` фиксирует поведение камеры при управлении камерой в редакторе, аналогично ее поведению в игре.

Установка опции `Rotation lock angle` фиксирует возможность поворота выделенного на карте объекта на угол, значение которого указано в поле параметра.

## Выставление объектов на карту

Чтобы выставить объект на карту, необходимо выбрать название его пресета в списке рабочего окна `Entity` и кликнуть ЛКМ в нужном месте карты.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FQtu391nHvbdEn672r0Av%2F20240426171350_1.jpg?alt=media&amp;token=c89062ab-9f5a-485b-a46c-aded41bf1cfd" alt=""><figcaption><p>Выставление объектов на карту</p></figcaption></figure>

{% hint style="warning" %}
Папки с пресетами юнитов (-fauna, -human, -vehicle) предназначены для выставления на карту исключительно в редакторе миссий.\
Исключением является выставление юнитов с целью создания антуражных элементов карты - трупов пехоты и [разрушенной техники](/gem-rts-v1-ru/redaktor/redaktor-kart/specifika-redaktirovaniya-kart/razrushennaya-tekhnika-kak-anturazh-karty.md)\\
{% endhint %}

{% hint style="info" %}
Ассеты из технических папок необходимы для работы движка и не предназначены для выставления объектов на картах.\
Исключение существует только для некоторых пресетов спецэффектов и сервисных объектов.
{% endhint %}

Для объектов доступен предпросмотр из ассета.\
Для предпросмотра объекта необходимо выбрать его имя в списке и вынести курсор мыши на поле карты.

{% hint style="info" %}
Предпросмотр недоступен для объектов, содержащих структуру
{% endhint %}

## Выделение объекта на карте

Выделить объект на карте можно тремя способами.

* Кликнуть ЛКМ на визуальный центр объекта;
* Зажать ЛКМ и растянуть рамку на нужный объект или группу объектов;
* С помощью консольной команды ed\_select name можно выделить все объекты на карте с заданным именем.

## Операции с выделенными объектом

Выбранные объекты можно:

* перемещать по карте, зажав ПКМ;
* вращать относительно центра объекта зажав клавишу `С` на клавиатуре и двигая мышью вверх/вниз;
* наклонять объект относительно вертикальной оси, зажав клавишу `X` и вращая мышью;
* изменять размер объекта с помощью модификатора scale, зажав клавишу `S` на клавиатуре и двигая мышью вверх/вниз;
* перемещать объект вдоль вертикальной оси, зажав клавишу `A` и двигая мышью вверх/вниз;
* настраивать свойства объекта.

## Окно настроек объекта

Окно настройки свойств game entity открывается ниже окна со списком ассетов при выделении объекта на карте.

[^1]: При запуске редактора пользователь по умолчанию попадает в Редактор карт и может вернуться в него из других редакторов по нажатию функциональной клавиши **F2** на клавиатуре.
