# \[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="/files/23nYhxuC0om4szjDzTs3" 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="/files/KDwcQcwPPqzZ4ApjJn4x">/files/KDwcQcwPPqzZ4ApjJn4x</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="/files/G82yFR9Y0GNZLinynL3b">/files/G82yFR9Y0GNZLinynL3b</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="/files/2QGS3K9CoEWSsfWz21Tm">/files/2QGS3K9CoEWSsfWz21Tm</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="/files/sOd1wD1VNf3PzDEeJb71">/files/sOd1wD1VNf3PzDEeJb71</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="/files/xloOlCxi4ndxqiQ56Wap" 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>


---

# 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://docs.bestway.com.ua/editor/map-editor/1-scene-editor.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.
