Entity Editor
Mastering Entity manipulation on a Map
The Entity Editor is a robust toolset located within the Map Editor of the GEM RTS engine, specifically designed for effective management of entities on game maps. It integrates into the first tab of the Map Editor's side menu.
Primary functions of the Entity Editor:
efficiently place and arrange various game entities such as buildings, objects of flora and environmental elements across the map;
modify the placement and orientation of existing entities to fine-tune the map layout;
configuring the properties of entities on the map.
Switching to the Entity Editor can be done in two ways
Click on the tab icon in the side menu of the Map Editor.
Press the '1' key on the keyboard.
Components of the Entity Editor window
List of object assets
The main component of the Entity Editor window is the list of assets for placing entities on the map.
Assets are categorized into thematic folders to streamline the selection process and enhance workflow efficiency.
| Name | Description |
|---|---|
-fauna | Animal unit assets |
-human | Infantry unit assets. Sorted by unit nationality and named according to the unit's role in the game. |
-vehicle | Vehicle unit assets. Sorted by types of military and civilian vehicles and named after real vehicles. |
construction | Buildings and decor objects. Assets are sorted into thematic categories. |
flora | Flora objects: trees, bushes and grass. |
fx | FX special effects assets. Sorted into thematic folders. Most are designed for in-game effects spawning and are not saved when placed on the map except for some effects from the common, smoke, and water folders. |
humanskin | A technical folder with infantry unit skin models, which are the basis for assets in the -human folder. |
inventory | A technical folder with inventory models. Used for setting up unit inventory. |
landscape | Assets for ground surface elements: stamps, stones, and slopes. Sorted into thematic folders. |
particle | A technical folder with unit part assets used by the engine during gameplay. |
service | A technical folder with service object assets used by the engine during gameplay. |
The 'Search entity' field can be used to search for an asset in the list by its name or a specified mask.
Asset folders for units (-fauna, -human, -vehicle) are intended for placement on the map exclusively in the Mission Editor. An exception is the placement of units for the purpose of creating ambient elements of the map - corpses of infantry and destroyed vehicles.
Assets from technical folders are necessary for the engine's operation and are not intended for placing entities on maps. An exception exists only for certain special effects and service object assets
Additional options in the Entity Editor
The Clip camera position ensures the camera behavior in the editor is the same as in the game
The Rotation lock angle option locks the rotation of a selected entity on the map to the angle specified in the parameter field.
Placing entities on the map
To place an entity:
Select the desired asset from the Entity list.
Click on the map where you want the entity to be placed, using the LMB.
Previewing entities
A preview of the entity from the asset is available. To preview an entity , select its name in the list and hover the mouse cursor over the map area.
Preview functionality is unavailable for entities containing structure
Selecting entities
An entity can be selected on the map in three ways.
Click the LMB on the visual center of the entity
Drag the selection frame using LMB
Use the console command "ed_select name" to mass select based on names
Operations with selected entities
Moved across the map by holding the right mouse button (RMB).
Rotated around the object's center by holding the 'C' key and moving the mouse up/down.
Tilted relative to the vertical axis by holding the 'X' key and rotating the mouse.
Resized using the 'scale' modifier by holding the 'S' key and moving the mouse up/down.
Moved along the vertical axis by holding the 'A' key and moving the mouse up/down.
| Action | Shortcut |
|---|---|
Move across the map | Hold RMB |
Rotate around the object's center | Hold 'C' + Move Mouse Up/Down |
Tilt relative to the vertical axis | Hold 'X' + Rotate Mouse |
Resize using the 'scale' modifier | Hold 'S' + Move Mouse Up/Down |
Move along the vertical axis | Hold 'A' + Move Mouse Up/Down |
Entity properties window
The game entity properties window opens below the asset list window when an entity is selected on the map.
Last updated
