======Map Editor======
----

=====Overview=====
The **Map Editor** is where everything comes together. You will use this editor to build your game world using the tiles, objects, and characters that you've created in the [[Voxel Editor]]. There are three different "modes" available in the Map Editor:
  * **Place**: This mode is used to place tiles, objects, and characters into the map.
  * **Edit**: This mode is used for making modifications to existing tiles, objects and characters, for example, to delete or rotate a tile, attach a script to an object, add dialogue to a character, etc.
  * **Connect**: This mode is use to add, remove, or edit [[navigation_and_interaction|navigation paths]] between tiles.

=====Main Toolbar=====
^Icon^Function^Description^Shortcut Key^
|{{:wiki:new_resource.png?nolink|}}|New Resource|Opens the [[New Resource dialog]] (with "Map" selected for the resource type).|
|{{:wiki:disk.png?nolink|}}|Save|Saves changes to the map.|
|{{:wiki:disk_multiple.png?nolink|}}|Save As|Saves a copy of the map to a new file.|
|{{:wiki:undo.png?nolink|}}|Undo|Reverts the most recent modification made to the map.|Ctrl + Z|
|{{:wiki:redo.png?nolink|}}|Redo|Reapplies the last modification that was undone.|Ctrl + Y|
|{{:wiki:clear.png?nolink|}}|Clear Map|Removes all tiles, objects, and characters from the map.|
|{{:wiki:map.png?nolink|}}|Generate Auto-Tile Config|Generates an auto-tile configuration using the current map's tile layout. See [[Auto-Tiling]] for more information.|
|{{:wiki:grid.png?nolink|}}|Toggle Grid|Enables/disables the grid lines used for tile placement.|
|{{:wiki:arrow_out.png?nolink|}}|Toggle Navigation Paths|Enables/disables the grid lines indicating the map's [[navigation_and_interaction|navigation paths]].|
|{{:wiki:flag_blue.png?nolink|}}|Toggle Markers|Enables/disables the marker icons for scripts, dialogue, lights, etc.|
|{{:wiki:tile_add.png?nolink|}}|Place Mode|Switches to Place Mode for placing tiles, objects, and characters.|F1|
|{{:wiki:select_edit.png?nolink|}}|Edit Mode|Switches to Edit Mode for modifying existing tiles, objects, and characters.|F2|
|{{:wiki:navigation.png?nolink|}}|Connect Mode|Switches to Connect Mode for modifying the map's [[navigation and interaction]].|F3|
|{{:wiki:arrow_switch.png?nolink|}}|Randomize Rotation|Enables/disables random rotation of resources. When enabled, the current rotation will be randomized each time a resource is placed into the map.|
|{{:wiki:camera_free.png?nolink|}}|Free Camera|Enabled/disables the free camera mode.|
|{{:wiki:eye.png?nolink|}}|First-Person Camera|Enabled/disables the first-person camera mode. To enter this mode, you must first have selected a single tile while in Edit mode.|
|{{:wiki:camera_add.png?nolink|}}|Save Camera Position|Opens the Save Camera Position dialog allowing the current [[camera_positions|camera position]] to be saved for later use. The saved [[camera positions]] are listed on the [[Map Properties]] panel.|

=====Controls=====
====General====
^Control/Key^Description^
|~/` (Hold)|Hide all visual indicators while holding (navigation paths, grid lines, marker icons, etc.)|
|Shift + ~/`|Toggle off all visual indicators (navigation paths, grid lines, marker icons, etc.)|

====Default Camera====
^Control/Key^Description^
|Shift + Middle Mouse Button + Drag|Move camera|
|Middle Mouse Button + Drag|Rotate camera|
|Scroll Wheel Up or Ctrl + Middle Mouse Button + Drag Up|Zoom camera in|
|Scroll Wheel Down or Ctrl + Middle Mouse Button + Drag Down|Zoom camera out|

^Control/Key^Description^
|Shift + Arrow Keys|Move camera|
|Ctrl + Left/Right Arrow Keys|Rotate camera|
|Ctrl + Up/Down Arrow Keys|Zoom camera in/out|

^Control/Key^Description^
|C + Mouse at Edge of View|Move camera|
|Ctrl + C + Mouse at Left/Right Edge of View|Rotate camera|
|Ctrl + C + Mouse at Top/Bottom Edge of View|Zoom camera in/out|

^Control/Key^Description^
|Shift + Space + Move Mouse|Move camera|
|Space + Move Mouse Left/Right|Rotate camera|
|Ctrl + Space + Move Mouse Up/Down|Zoom camera in/out|

====Free Camera====
^Control/Key^Description^
|Middle Mouse Button + Drag|Look around|
|Shift + Middle Mouse Button + Drag|Move camera horizontally|
|W, Scroll Wheel Up|Move forward|
|S, Scroll Wheel Down|Move backward|
|A|Move left|
|D|Move right|
|Q|Move down|
|E|Move up|

^Control/Key^Description^
|Space + Move Mouse|Look around|
|Shift + Space + Move Mouse|Move camera|

====First-Person Camera====
^Control/Key^Description^
|W/S|Move forward/backward|
|A/D|Turn left/right|
|Middle Mouse Button + Drag|Look around|
|M|Move to selected tile|

====Place Mode====
^Function^Control/Key^Description^
|Place Resource|Left Mouse Button|Place tile/object/character|
|Rotate Resource|Right Mouse Button|Rotate pending tile/object/character|
|Pick Resource|Alt + Left Mouse Button|Pick the selected resource for placing (i.e. eyedropper tool)|
|Pick Grid Level|Ctrl + Left Mouse Button|Move the grid level/height to match that of the selected tile|
|Pick Tile and Grid Level|Ctrl + Alt + Left Mouse Button|Pick the selected tile for placing and move the grid level/height to match that of the selected tile|
|Raise Grid|A|Raise placement grid by one voxel|
|Lower Grid|Z|Lower placement grid by one voxel|
|Reset Grid|X|Reset placement grid to zero|
|Raise Grid (Step)|Ctrl + Scroll Wheel Up|Raise placement grid by an amount equal to the map's tile width in voxels|
|Lower Grid (Step)|Ctrl + Scroll Wheel Down|Lower placement grid by an amount equal to the map's tile width in voxels|
|Raise Grid (Half Step)|Alt + Scroll Wheel Up|Raise placement grid by an amount equal to half of the map's tile width in voxels|
|Lower Grid (Half Step)|Alt + Scroll Wheel Down|Lower placement grid by an amount equal to half of the map's tile width in voxels|

====Edit Mode====
^Control/Key^Description^
|Left Mouse Button|Select a tile/object/character.|
|Right Mouse Button|Open context menu containing actions for the selected resources.|
|Shift + Left Mouse Button|Add tiles/objects/characters to current selection.|
|Shift + Alt + Left Mouse Button|Remove tiles/objects/characters from current selection.|
|N|Cycle through the available navigation types if two adjacent tiles are selected.|
|R|Rotate the selected tiles/objects clockwise.|
|T|Rotate the selected tiles/objects/characters counterclockwise.|
|Y|Rotate the selected tiles/objects/characters to a random angle.|
|Delete|Delete the selected tiles, objects, or characters.|
|G|Add the current selection to a group.|
|P|Open the properties dialog for the selected tile/object/character. See [[Entity Properties]].|
|C|Copy the (X,Y,Z) coordinate of the selected tile/object/character to the clipboard.|
|L|Add a positional light at the location of the selected tile/object/character. The light's properties can then be edited from the [[Map Properties]] panel.|

====Connect/Navigation Mode====
^Control/Key^Description^
|Left Mouse Button + Drag|Connect two adjacent tiles using the currently selected [[navigation_and_interaction|navigation type]].|
|Right Mouse Button + Drag|Remove existing navigation path between two adjacent tiles.|
|Delete|Remove all navigation paths connected to the tile over which the mouse is hovered.|

~~NOTOC~~