Map Editor

From Wiki | RPG in a Box
Revision as of 19:04, 14 February 2016 by Justin (Talk | contribs)

Jump to: navigation, search

Overview

The Map Editor is where everything comes together. You will use this editor to create the maps for your game using the available tiles, objects, scripts, etc.


Components

Toolbar

  • Page white add.png New: Opens the New Resource dialog with Map selected as the resource type.
  • Disk.png Save: Saves the map. This will become enabled any time changes have been made to the map.
  • Disk multiple.png Save As: Saves the map to a new file with a different name. A dialog will open to prompt for the new name. Once saved, the map will be opened in a new tab.
  • Clear.png Clear: Removes all tiles and objects from the map.
  • Grid.png Toggle Grid: Enables/disables the tile grid lines.
  • Navigation.png Toggle Navigation Paths: Enables/disables the navigation paths. These will appear as green lines between tiles and indicate the paths that the player can walk along.
  • Flag blue.png Toggle Markers: Enables/disables markers. These markers are labels in the 3D view and can be used to quickly identify which objects have scripts, which characters have dialogue, locations of lights, etc.
  • Bricks.png Place Mode: Switches to placement mode for placing tiles and objects.
  • Brick edit.png Edit Mode: Switches to editing mode for selecting/rotating/deleting/etc. tiles and objects.

Properties Panel

The Properties panel displays various information pertaining to the map, most of which can be edited.

  • Music.png Background Music: The selected song file will be looped as background music when the current map is loaded in-game. The option box will display any OGG files located within your project's "music" folder.
  • Shape group.png Groups: This item can be expanded to show all currently defined groups for the current map. For each group, there are 3 action buttons available:
    • Shape handles.png Select: Select all resources in this group.
    • Eye.pngHidden.png Hide/Show: Hide/show all resources in this group.
    • Shape ungroup.png Ungroup: Remove the definition for this group so the resources are no longer grouped.
  • Weather sun.png Ambient Light: The map's ambient light casts light evenly across everything. This light's color can be adjusted and it can be turned on or off.
  • Weather sun.png Directional Light: The map's directional light simulates sunlight and is cast downward at an angle. This light's color can be adjusted and it can be turned on or off.
  • Lightbulb.png Point Light: Any point lights added to the map will be listed underneath the directional light. Several attributes can be adjusted, including color, intensity, and diameter. The arrow buttons can be used to modify the position of the light. Clicking on one of the point lights in the Properties panel will move the camera to the light's position.

3D View

The main 3D view is used to visually edit the map. See the Controls/Shortcut Keys section further down for details on working in the 3D view. In the bottom-right corner of the 3D view, the current (X, Y, Z) coordinate will be displayed according to the mode you are in. In Place Mode, this shows where the resource will be placed. In Edit Mode, this shows the coordinate of the resource that is selected.

Map editor 3d view.png

Resource Selection Sidebar

On the right-hand side of the application, there is a sidebar containing two tabs: Tiles and Objects. These display lists of the resources available to place into your map. Each resource is shown as a 3D preview that rotates if selected. If desired, you can double-click on a resource to open it in the Voxel Editor, or single-click to select it and then click on the small button that appears in the top-right corner.

Resource container.png

Minimap

Below the Game Explorer panel, there is a tab containing a minimap. This is simply an overhead view of the current map.

  • Magnifier zoom in.png Zoom In
  • Magnifier zoom out.png Zoom Out

Minimap.png


Controls/Shortcut Keys

Camera

  • Middle Mouse Button + Drag: Rotate camera
  • Shift + Middle Mouse Button + Drag: Move camera
  • Scroll Wheel Up: Zoom camera in
  • Scroll Wheel Down: Zoom camera out

Place Mode

  • Left Mouse Button: Place tile/object
  • Right Mouse Button: Rotate pending tile/object
  • A: Raise placement grid by one unit
  • Z: Lower placement grid by one unit
  • X: Reset placement grid to zero

Edit Mode

  • Left Mouse Button: Select tile/object
  • Control + Left Mouse Button: Select multiple tiles/objects
  • Right Mouse Button: Context menu
    • Arrow rotate clockwise.png Rotate Clockwise (R): Rotate the selected tiles/objects clockwise.
    • Arrow rotate anticlockwise.png Rotate Counterclockwise (T): Rotate the selected tiles/objects counterclockwise.
    • Delete.png Delete (D): Delete the selected tiles, objects, or characters.
    • Shape group add.png Add to Group... (G): Add the current selection to a group.
    • Application form edit.png Properties... (P): Edit the properties for the selected tile, object, or character. For objects, you can use the properties dialog to attach a script or define it as a container and add items to it. For characters, you can use this to specify whether the character is an NPC or an enemy and choose a dialogue or battle to start.
    • User go.pngUser delete.png Set Path as Walkable/Unwalkable (W): Toggle the walkability of tiles (two adjacent tiles must be selected).
    • Page white copy.png Copy (X,Y,Z) Coordinate (C): Copy the (X,Y,Z) coordinate of the selected tile, object, or character to the clipboard.
    • Lightbulb add.png Add Light (L): Add a point light at the location of the selected tile, object, or character. The light's properties can then be edited in the Properties panel.