> 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/1-redaktor-sceny.md).

# \[1] Редактор сцены

## Общая информация про редактор сцены

Редактор сцены является частью Редактора Карт и предоставляет инструменты для структурирования объектов и управления объектами, выставленных на карте, что ускоряет доступ к объектам и упрощает процесс редактирования карты.\
Редактор сцены находится на вкладке `scene [1]` бокового меню Редактора карт. Окно редактора содержит две вкладки:

* Explorer
* Layers

## Explorer

### **Назначение**

**Explorer** предназначен для отображения всех объектов сцены в иерархическом дереве. Дерево отображает структуру объектов в соответствии с расположением папки объекта в ресурсах игры относительно папок `scene\entity`

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FWZUUzHMu0DkXlP2hfPbj%2FExplorer%20interface.png?alt=media&amp;token=8cb3477c-1520-4547-868c-1a45ac9a4ee4" alt=""><figcaption></figcaption></figure>

### Элементы интерфейса

* \[1] **Дерево папок** объектов, выставленных на карте
* \[2] **Окно свойств** выбранного экземпляра объекта `Properties for 'actor'`
* \[3] **Окно подсказок** для выбранного параметра из **Окна свойств**

### Функциональность

* **Выделение экземпляра объекта на карте**\
  При перемещении по дереву соответствующий экземпляр объекта автоматически выделяется на сцене.
* **Поиск** **экземпляра объекта на карте**\
  Двойной клик на названии экземпляра объекта в списке центрирует на нем камеру на карте
* **Поиск экземпляра объекта в списке дерева**\
  Выделение объекта на карте приводит к его выделению в дереве на вкладке Explorer. При выделении нескольких объектов в дереве подсвечивается только первый.
* **Быстрый доступ к свойствам экземпляра объекта**\
  Свойства выделенного объекта отображаются в Окне свойств
* **Синхронизация**
  * Удаление экземпляра объекта с карты приводит к их удалению из списка **Explorer**
  * Добавление экземпляра объекта через инструменты **Entity** или **Foliage** приводит к их добавлению в список **Explorer**

### Контекстное меню

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

|             |                                                                                 |
| ----------- | ------------------------------------------------------------------------------- |
| **Visible** | Делает объекты видимыми/невидимыми в зависимости от текущего состояния объектов |
| **Lock**    | Блокирует/разблокирует объекты для выделения                                    |

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden></th><th data-hidden></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>На видимом объекте в контекстном меню доступен пункт отключения видимости - Invisible</td><td></td><td></td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FTFhoEBuBXbdQhIOHXeuD%2Fexplorer%20invisible.png?alt=media&amp;token=579c6c75-80d6-4050-adca-538646004c77">explorer invisible.png</a></td></tr><tr><td>На невидимом объекте в контекстном меню доступен пункт отключения видимости - Visible</td><td></td><td></td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FyvFIdT6zgJGUq2al1r9B%2Fexplorer%20visible.png?alt=media&amp;token=8f5e0502-e2b0-409e-a42f-bc337bd19d07">explorer visible.png</a></td></tr><tr><td>На разблокированном объекте в контекстном меню будет доступен пункт блокировки объекта для выделения Lock</td><td></td><td></td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FhpG9jc1eAwlnCTwuZJxU%2Fexplorer%20lock.png?alt=media&amp;token=c0ba79c3-41cf-407c-a102-362b72c25777">explorer lock.png</a></td></tr><tr><td>На заблокированном объекте в контекстном меню будет доступен пункт разблокировки объекта для выделения Unlock</td><td></td><td></td><td></td><td><a href="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2FTNGhZvcHO6bH8ZHNXNau%2Fexplorer%20unlock.png?alt=media&amp;token=efa6c660-c2ad-4cab-90dd-a6dcf12cc44a">explorer unlock.png</a></td></tr></tbody></table>

{% hint style="info" %}
Контекстное меню работает как на отдельном элементе списка, так и на всей папке или ветке папок
{% endhint %}

{% hint style="info" %}
Переключение состояний **Visible** и **Lock** на папках с большим количеством объектов может занять время для обработки.
{% endhint %}

## Layers

Инструмент Layers предназначен для организации объектов карты в тематические слои, позволяя управлять их видимостью и доступностью для редактирования.

### Контекстное меню

Для работы по слоями используйте контекстное меню, которое вызывается нажатием ПКМ на пустом месте окна вкладки Layers либо на имени нужного слоя.

<figure><img src="https://2052154247-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fx2fkAZ6oKGGdByFhKPpa%2Fuploads%2Ft7ULPo8U6T3OKZf6iq8a%2Fscene%20Layers%20menu.png?alt=media&amp;token=469602c5-37b0-47b5-aec2-223a515a4675" alt=""><figcaption><p>Контекстное меню вкладки Layers</p></figcaption></figure>

<table><thead><tr><th width="216">Пункт меню</th><th width="197">Действие</th><th>Описание</th></tr></thead><tbody><tr><td>Create Empty Layer</td><td>Создать пустой слой</td><td>Доступно при вызове контекстного меню на пустом месте окна вкладки Layers или на любом слое</td></tr><tr><td>Add Selected Entities to New Layer</td><td>Добавить выделенные объекты в новый слой</td><td>Доступно при вызове контекстного меню на пустом месте окна вкладки Layers или на любом слое.<br><br>Предварительно необходимо выделить нужные экземпляры объектов на карте или с помощью Explorer</td></tr><tr><td>Add Selected Entities to Selected Layer</td><td>Добавить выделенные объекты в выбранный слой</td><td>Выделить нужные экземпляры объектов на карте или с помощью Explorer и вызвать контекстное меню на нужном слое.</td></tr><tr><td>Delete Layer</td><td>Удалить выбранный слой</td><td>Вызвать контекстное меню на слое, который необходимо удалить</td></tr><tr><td>Rename</td><td>Переименовать выбранный слой</td><td>Вызвать контекстное меню на слое, который необходимо переименовать</td></tr><tr><td>Invisible/visible</td><td>Скрыть или отобразить слой</td><td>Вызвать контекстное меню на нужном слое</td></tr><tr><td>Lock/Unlock</td><td>Заблокировать или разблокировать объекты слоя для выделения на карте</td><td>Вызвать контекстное меню на нужном слое</td></tr><tr><td>Remove Selected Entities from Layer</td><td>Удалить выбранный объект из текущего слоя</td><td>Вызвать контекстное меню на имени экземпляра, который необходимо удалить из слоя</td></tr></tbody></table>