> 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/editor/map-editor/1-scene-editor.md).

# \[1] Scene Editor

## General Information about the Scene Editor

The Scene Editor is part of the Map Editor and provides tools for structuring and managing entities placed on the map. This accelerates access to entities and simplifies the map editing process. The Scene Editor is located under the **`scene`**`[1]` tab in the side menu of the Map Editor.\
The editor window contains two tabs:

* Explorer
* Layers

## Explorer

Explorer is designed to display all entities in the scene in a hierarchical tree structure.\
The tree reflects the structure of entities according to the folder location of the entity in the game resources relative to the `...\scene\entity` folders.

### Interface elements

<figure><img src="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2Fda3YuNA0pw7iSsAGqDT7%2FExplorer%20interface.png?alt=media&amp;token=d42e8eb0-81fb-444c-950b-9a19ee0bfa8a" alt=""><figcaption></figcaption></figure>

* \[1] Folder tree of entities placed on the map
* \[2] Properties window for the selected entity instance, **Properties for 'actor'**
* \[3] Hints window for the selected parameter from the Properties window

### Functionality

* **Selecting an entity instance on the map**\
  Navigating through the tree automatically highlights the corresponding entity instance in the scene.
* **Finding an entity instance on the map**\
  Double-clicking the name of an entity instance in the list centers the camera on it in the map.
* **Finding an entity instance in the tree list**\
  Selecting an entity on the map highlights it in the Explorer tree. If multiple entities are selected on the map, only the first one will be highlighted in the tree.
* **Quick access to entity instance properties**\
  The properties of the selected entity are displayed in the Properties window.
* **Synchronization**
  * Deleting an entity instance from the map also removes it from the Explorer list.
  * Adding an entity instance via the Entity or Foliage tools adds it to the Explorer list.

### Context Menu

Right-clicking on a folder in the tree opens a context menu with options for managing entity states:

|         |                                                                  |
| ------- | ---------------------------------------------------------------- |
| Visible | Toggles the visibility of entities based on their current state. |
| Lock    | Locks or unlocks entities for selection.                         |

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>For a visible entity, the context menu will offer the option to make it <strong>Invisible</strong></td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2F8neCCCaGSYj2fIY3yoYS%2Fexplorer%20invisible.png?alt=media&amp;token=87393633-0f37-4ec1-9b51-e2a161525f1a">explorer invisible.png</a></td></tr><tr><td>For an invisible entity, the context menu will offer the option to make it <strong>Visible</strong></td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FghvuqwlyDuOwfPiWTQBt%2Fexplorer%20visible.png?alt=media&amp;token=61e96242-36fa-4210-9f4e-35d007ca22b5">explorer visible.png</a></td></tr><tr><td>For an unlocked entity, the context menu will offer the option to <strong>Lock</strong> it for selection</td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FxUhBhXbRkOWEahP6K9zG%2Fexplorer%20lock.png?alt=media&amp;token=c4b723a9-57c3-4ae8-8889-43dc21a3688c">explorer lock.png</a></td></tr><tr><td>For a locked entity, the context menu will offer the option to <strong>Unlock</strong> it for selection</td><td><a href="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FlVj1nGDg7W2urUKOS6tM%2Fexplorer%20unlock.png?alt=media&amp;token=9bcc5b61-62e9-418e-852e-94d670468b15">explorer unlock.png</a></td></tr></tbody></table>

{% hint style="info" %}
The context menu is available for individual items in the list as well as for entire folders or branches of folders.
{% endhint %}

{% hint style="info" %}
Switching the **Visible** and **Lock** states on folders with a large number of entities may take some time to process.
{% endhint %}

## Layers

The **Layers** tool is designed to organize map entities into thematic layers, allowing control over their visibility and editability.

### Context Menu

To work with layers, use the context menu, which is accessed by right-clicking on an empty space in the Layers tab window or on the name of the desired layer.

<figure><img src="https://2358506489-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2UV9d5d9aTZPISbocWyo%2Fuploads%2FvSDgiX1yNpG6TUOBh1TZ%2Fscene%20Layers%20menu.png?alt=media&amp;token=088c7eeb-2bdc-4d3c-a020-d4462b7015e4" alt=""><figcaption><p><strong>Context Menu Options in the Layers Tab</strong></p></figcaption></figure>

<table><thead><tr><th width="187">Menu Item</th><th width="216">Action</th><th>Description</th></tr></thead><tbody><tr><td>Create Empty Layer</td><td>Create an empty layer</td><td>Available when the context menu is accessed on an empty space in the Layers tab or on any layer.</td></tr><tr><td>Add Selected Entities to New Layer</td><td>Add selected entities to a new layer</td><td>Available when the context menu is accessed on an empty space in the Layers tab or on any layer. Before this, select the desired entity instances on the map or using Explorer.</td></tr><tr><td>Add Selected Entities to Selected Layer</td><td>Add selected entities to the selected layer</td><td>Select the desired entity instances on the map or using Explorer, then open the context menu on the desired layer.</td></tr><tr><td>Delete Layer</td><td>Delete the selected layer</td><td>Open the context menu on the layer you want to delete.</td></tr><tr><td>Rename</td><td>Rename the selected layer</td><td>Open the context menu on the layer you want to rename.</td></tr><tr><td>Invisible/Visible</td><td>Hide or show the layer</td><td>Open the context menu on the desired layer.</td></tr><tr><td>Lock/Unlock</td><td>Lock or unlock the layer's entities for selection on the map</td><td>Open the context menu on the desired layer.</td></tr><tr><td>Remove Selected Entities from Layer</td><td>Remove the selected entity from the current layer</td><td>Open the context menu on the name of the Entity instance that you want to remove from the layer.</td></tr></tbody></table>
