# The Basics of the Editor Tools

## Getting Started

This section explains how to add 3D models to your metaverse project and other basic operations that will help you get started.

## Understanding your editor

Each 3D object will appear in the left column of the editor. You can click on a 3D model and place it in the virtual scene. You can also modify and change the direction, size, and other settings of its 3D model through the editor's tools.

If you need to modify the basic information of a 3D object again, please re-import the 3D model. Refer to [Adding Public/Private 3D Models](https://allimeta.gitbook.io/creators-manual/manage-your-world/edit-your-metaverse-world#add-public-private-3d-models).

If you need to remove a 3D model from the editor, please refer to [Managing 3D Models](https://allimeta.gitbook.io/creators-manual/manage-your-world/edit-your-metaverse-world#3d-model-management-tool).

The following sections describe how to use the World Editor, Land Editor, Module Editor, and Indoor Editor to handle your 3D models.

### 3D model coordinate axis direction

The editor supports every direction of the 3D model coordinate axis and can use the model setting field that supports the coordinate axis direction supported by the editor to change the coordinate axis direction. The "axis indicator" shows the X-axis in red, the Y-axis in green, and the Z-axis in blue. Click the left mouse button to move the 3D object.

* **Horizontal/vertical movement**
* **Fixed rotation**
* **Scaling**

<figure><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2F2vVmTRgy4ZT5P2B3uWXV%2Fimage.png?alt=media&#x26;token=da85d255-ca3f-4178-8391-9777067b8aa1" alt=""><figcaption><p>Coordinate axis indicator mode switch: (L) horizontal/vertical movement, (M) fixed point rotation, (R) object size scaling.</p></figcaption></figure>

On the right-hand side of the editor, you can use the model coordinate axis settings to more precisely edit the object's coordinate axis.

* Local Position: Horizontal/vertical movement
* Local Euler Angles: Fixed-point rotation
* Local Scale: Scaling in size

<figure><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FoZKvOeubJwBF9ZcXOesj%2Fimage.png?alt=media&#x26;token=3487dd7b-76a5-4ef8-bd26-a01fee3b579e" alt=""><figcaption><p>Transform component </p></figcaption></figure>

### Viewing window direction&#x20;

Click on the viewing window direction and rotate your perspective in place to quickly adjust the direction of the viewing window.

![](https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FKOMpwnEKbnpMCiai4Edc%2Fimage.png?alt=media\&token=ceb91770-e069-4adf-99c6-79a7e66e39eb)

### Editor Toolbar&#x20;

The editor toolbar contains commands that can help you work with 3D models. Here are the editor toolbar commands:

<figure><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2Fse4jSy2EbsATN2VJPWN5%2Fimage.png?alt=media&#x26;token=8145431b-caff-4b74-aaa4-5c160b9b08e9" alt=""><figcaption><p>Editor Tool Bar</p></figcaption></figure>

This table describes the items on the editor toolbar, which are listed from left to right in the order they appear.

<table><thead><tr><th width="204.33333333333331">Icon</th><th width="252">Item</th><th>Description</th></tr></thead><tbody><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FkcjsKtY24yAFSBkOuZpB%2Fimage.png?alt=media&#x26;token=a33ed7cf-04d5-4bad-ba1b-156acb6e017c" alt="" data-size="line"> / <img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2F4JO9SzdCOd2hK6dCdEUX%2Fimage.png?alt=media&#x26;token=95003333-7d6d-4da1-afa9-421be3d93e81" alt="" data-size="line"></td><td>Action mode on/off</td><td>Used for previewing functional 3D models such as advertisements, lighting, movements, etc.</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FMDXwndhBpDV1jIZrqd2G%2Fimage.png?alt=media&#x26;token=cb6b63e6-8558-4cb2-803a-dc74aa16c548" alt="" data-size="line"></td><td>Save</td><td>Save json</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2Fzf6lpD1Ma9MBRPHBshFv%2Fimage.png?alt=media&#x26;token=75e1f0fa-6f7e-4ad9-a8fd-f2c9aa25164e" alt="" data-size="line"></td><td>Load</td><td>Load json</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FslbfSqbMQTefFRWnWbch%2Fimage.png?alt=media&#x26;token=5d7db505-678a-4fde-b06e-0df453ea8e6e" alt="" data-size="line"></td><td>Export</td><td>Different editors have different export functions</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FCEEdzxp0zEVq4reGh9Tg%2Fimage.png?alt=media&#x26;token=11e865fb-d515-4906-b0ba-b40a4723bbbc" alt="" data-size="line"></td><td>Horizontal/vertical</td><td>horizontal/vertical adjustment of the model</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FighvHM3kSNOmyxCfZfbv%2Fimage.png?alt=media&#x26;token=5fd7f322-c04d-418d-8c2d-36a8af9bb5cb" alt="" data-size="line"></td><td>Pivot</td><td>rotate around a fixed point of the model</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FDEtIzkRJkAYZh2RsUUbg%2Fimage.png?alt=media&#x26;token=6560b5f7-0a96-4405-8ff0-6c8871b8e83f" alt="" data-size="line"></td><td>Sizing</td><td>resize/scale adjustment of the model</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2F6MApQbcst9Fmx3RfoMje%2Fimage.png?alt=media&#x26;token=0cae6b73-bda1-49fc-bbb5-111e188be090" alt="" data-size="line"> / <img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FBLtCB4faFZkHqUNctFXq%2Fimage.png?alt=media&#x26;token=e635d8af-8e82-4778-9b88-89f48ae29b91" alt="" data-size="line"></td><td>Switching coordinate axes</td><td>"Pivot" takes the model's bottom layer as the axis<br>"Center" takes the model's center as the axis</td></tr><tr><td><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FFqMlUxJfpM0jD2PuNzTD%2Fimage.png?alt=media&#x26;token=dbf7e4bd-c703-4d20-998a-a7e93e2e382a" alt="" data-size="line"> / <img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FV0SOlhp79Wf3VfuhVqEx%2Fimage.png?alt=media&#x26;token=02f7946c-8f03-409b-81bd-73a2f394355a" alt="" data-size="line"></td><td>NA</td><td>NA</td></tr></tbody></table>

{% hint style="info" %}
The 'Export' in the toolbar will have different export functions depending on the editor used.
{% endhint %}

{% hint style="info" %}
The toolbar items 'Save' and 'Load' will save and load JSON files differently depending on the editor used. For example:

* The world editor saves and loads worldData in JSON format.
* The land editor saves and loads landData in JSON format.
* The model editor saves and loads modelData in JSON format.
  {% endhint %}

### Panel

The editor's panel displays all available 3D models and allows users to quickly find the desired 3D model by clicking on its tags To add a new 3D model, please refer to the guide on [how to add 3D models to your editor](https://allimeta.gitbook.io/creators-manual/manage-your-world/edit-your-metaverse-world#add-public-private-3d-models).

Below is an example of the editor's model panel:

![](https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FkPtnq3eIQt4Tsex1974u%2Fimage.png?alt=media\&token=844d5f60-c406-44f6-84ca-da8e74944744)

### Hierarchy

The editor's hierarchy lists all 3D models placed in the virtual scene. You can quickly search for 3D models placed in the virtual scene using the <img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FWx5Gx0TUtZqGCnvmN7Ph%2Fimage.png?alt=media&#x26;token=84f5e6f1-24d7-4f1e-9fba-45ab2a41e510" alt="" data-size="line"> field.

Below is an example of the editor's hierarchy:

![](https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FFaRNiMPlMDnnLKaVSb6R%2Fimage.png?alt=media\&token=de6196b1-ddb2-430e-ae1e-266b0b639fbe)

### Inspector

The editor's Inspector is used to display and edit the attributes and settings of the currently selected 3D object or component. For example, if a 3D model object is selected, the property panel will show the object's position, rotation, scale, lighting, animations, and other attributes. Therefore, in a 3D model editor, the property panel is a very important tool used to help users quickly edit and adjust the properties and settings of objects or components.

<figure><img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FPpr18mzuvTpi73k275pK%2Fimage.png?alt=media&#x26;token=bbd50d8b-1646-4bee-8ecc-c8c8209ee378" alt=""><figcaption><p>Editor Inspector</p></figcaption></figure>

### Controlling Viewport

The "viewport" in the editor displays your virtual scene and 3D models. You can change the viewport's angle, position, and direction by following the instructions below. When you change the angle and direction of the viewport, a crosshair will appear <img src="https://3390105127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZVeXNinG07Q3o5fO739p%2Fuploads%2FhKknVkoTsekzBh2PJAO7%2Fimage.png?alt=media&#x26;token=988b0229-95dd-4876-a7f4-f9b70a8cd0ff" alt="" data-size="line">, and the viewport's angle and direction will be changed based on the crosshair as the pivot point.

* Rotate around a fixed point: Hold down the right mouse button to adjust the viewport direction.
* Zoom in/out: Use the mouse scroll wheel to zoom in or out on the viewport distance.
* Rotate around the pivot point: Hold down CTRL and drag with the right mouse button.
* View the front of the model: Press the F key on the keyboard to quickly switch the view angle to the front of the 3D model.

### Shortcuts

<table><thead><tr><th width="347.3333333333333">Command</th><th>MacOS</th><th>Windows</th></tr></thead><tbody><tr><td>Switch to "Horizontal/Vertical" mode</td><td>W</td><td>W</td></tr><tr><td>Switch to "Pivot/Around" mode</td><td>E</td><td>E</td></tr><tr><td>Switch to "Sizing" mode</td><td>R</td><td>R</td></tr><tr><td>Switching Axies point</td><td>Z / C</td><td>Z / C</td></tr><tr><td>Reverse</td><td>Shift + Z</td><td></td></tr><tr><td>Forward</td><td>Shift + Y</td><td></td></tr><tr><td>Copy</td><td>Ctrl + C</td><td>Ctrl + C</td></tr><tr><td>Paste</td><td>Ctrl + V</td><td>Ctrl + V</td></tr><tr><td>View model front</td><td>F</td><td>F</td></tr><tr><td>Pull in/out</td><td>mouse wheel forward/backward</td><td>mouse wheel forward/backward</td></tr><tr><td>Delete</td><td>fn + Backspace</td><td>Ctrl + Delete</td></tr></tbody></table>

### Use the Avatar scale

When starting to edit, it is recommended to use the built-in Avatar tool provided by AlliMeta as the scale for all metaverse 3D buildings. The Avatar tool in the editor and the Avatar scale in the 3D experience layer are 1:1.