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

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

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

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

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

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

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

<figure><img src="/files/vQjqDu5omZgRFu7Lwm26" 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="/files/Ic41sNbYea0aaIT4zuEG" alt=""><figcaption><p>Выставление объектов на карту</p></figcaption></figure>

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

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

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

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

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

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

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

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

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

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bestway-1.gitbook.io/documentation/gem-rts-v1-ru/redaktor/redaktor-kart/redaktor-entity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.