Welcome to the Wolfire Blog! This is where we keep everyone up to date on our progress on Overgrowth and other new stuff. Be sure to subscribe to get the latest news! Also, be sure to check out the forums for even more up to date news - or get on IRC for up to the second updates.

Map Editor Controls

Add Comment! By Phillip Isola on March 7th, 2009

As we highlighted yesterday, there's been a recent explosion in Overgrowth level bulding in the Secret Preorder Forum. I've been really blown away by all this. One of the things that amazes me is that the modders have been managing to do so much with so little formal instruction from us; we haven't had a readme since around Alpha 1. But now, to encourage even more level building activity, and to encourage more powerful use of the tools, I've finally updated the instructions. In addition, some time ago we made a crash course video tutorial on the map editor. I'd suggest watching the video first, as it gives a good visual overview. After that, you can use this post to learn about our editor's precise details, specific controls, and latest features.

Extended panorama

Note: I'll sometimes refer to 'cmd' in the following. PC users should use 'ctrl' in place of 'cmd'. Also, please keep in mind that the editor is a work in progress and the specific controls are still very much subject to change.

Camera Movement

Control Behavior
Forward 'w' Moves camera forward.
Backward 's' Moves camera backward.
Left 'a' Pans camera left.
Right 'd' Pans camera right.
Up shift + 'w' Moves camera up.
Down shift + 's' Moves camera down.

Tool/Mode Selection

Translate
Click 'translate' button or press '4' Sets tool to translate tool. When hovering over a selected object, cursor will indicate the currently chosen tool.
Scale
Scale
Click 'scale' button or press '5' Sets tool to scale tool.
Rotate
Click 'rotate' button or press '6' Sets tool to rotate tool.
Paintbrush
Click 'paintbrush' button or press '3' Sets tool to paintbrush tool.
Omni press '7' Sets tool to omni tool. The omni tool combines the translation, scale, and rotate tools. See 'Transformation' section for details on how the omni tool decides which of its states to act in.
Game mode press '8' Sends in Rabbot!
Editor mode press '9' Back to editor mode.

Object Creation

Load objects
cmd-l (or click 'load' button) + left-mouse-click Opens up a dialogue box in which the user may specify an xml file containing object data (anything in "./Data/Objects" or "./Data/Levels"). Places selected objects in scene, centered at mouse click.
Copy objects cmd-c Copies all selected objects (and their relative placement) into a copy buffer.
Paste objects cmd-v Adds to scene all objects in the copy buffer. Centers objects at mouse location.
Paintbrush
Set tool to 'paintbrush' + hold 'p' + left-click-and-drag Quickly adds semi-randomized objects to the scene, centered about mouse location. Let go of 'b' to move camera. Control paintbrush properties with sliders and checkboxes in the 'Misc' UI panel. More info here.

Object Selection

Select single object double-left-click on object Selects clicked on object and deselects all other objects. If the object is part of a group, the whole group is selected. Bounding box and slight glow indicate object is selected.
Toggle-select objects shift + double-left-click on objects Toggles whether or not clicked on object is selected. Preserves other existing selections.
Box select objects left-click + right-click + drag, or left-click + 'b' + drag Selects all objects whose centers lie within box drawn on screen. Deselects all other objects.
Box toggle-select objects shift + left-click + right-click + drag, or shift + left-click + 'b' + drag Toggles selection state for all objects whose centers lie within box drawn on screen. Preserves other existing selections.
Select all cmd-a Selects all objects.
Deselect all double-left-click away from all objects Deselects all objects.

Transformations

For all transformations:

  • In order to transform an object you must first select it.
  • Hold ctrl to make movements snap by discrete increments.
  • Hold alt to transform a clone of an object (or multiple objects), leaving the original object behind
  • Left-click controls a 'generic' version of the transformation; right-click controls a version of the transformation contextually specific to the clicked on face. Holding shift locks the transformation to a single axis.
  • Groups are transformed about the group center. Ungrouped objects, even if multiple are selected and transformed at once, are transformed about their own individual centers.

Translation

Set tool to 'translation', or set tool to 'omni tool' and hover mouse over central region of a bounding box face, or set tool to 'omni tool' and hold 't'.

Camera relative left-click + drag Translates clicked on object along plane parallel to the screen.
Locked to plane right-click + drag Translates clicked on object along plane of clicked on face.
Locked to line shift + right-click + drag Translates clicked on object along normal of clicked on face.

Scale

Set tool to 'scale', or set tool to 'omni tool' and hover mouse near bounding box vertices, or set tool to 'omni tool' and hold 'e'.

All dimensions left-click + drag Scales clicked on object in all dimensions (x, y, and z) at once.
Locked to plane right-click + drag Extends clicked on object along plane of clicked on face.
Locked to line shift + right-click + drag Extrudes clicked on object along normal of clicked on face.

Mirror

Just use the right-click scale tool, and scale down the object until it flips and its mirror image begins scaling up!

Rotation

Set tool to 'rotation', or set tool to 'omni tool' and hover mouse near bounding box edges, or set tool to 'omni tool' and hold 'r'.

Free left-click + drag Rotates clicked on object as if you are pushing the surface of a ball.
Locked to axis right-click + drag Rotates clicked on object about normal of clicked on face.

Grouping

Group objects cmd-g All selected objects and groups are joined into a new group. Groups are hierarchical, so grouped groups are treated as subgroups. Objects in a group are selected as a unit and transform as a unit.
Ungroup objects cmd-shift-g All selected groups are disbanded at their outermost level.

Undo/Redo

Undo action cmd-z Undoes the last completed action.
Redo action cmd-shift-z Redoes the last undone action. Redo-able actions are cleared whenever the user completes a new action.

Object Removal

Delete objects delete or backspace Deletes all selected objects.

Saving

Auto-save Automatic Every 30 seconds or so the program automatically saves the entire level to the file "./Data/Levels/autosave.xml"
Save level cmd-s Saves entire level to the same path as the level was opened from, overwriting the old level file.
Save selected objects cmd-shift-s Saves-as all selected objects to a path specified by the user in a dialogue box.

I hope I did not miss anything major, but if I did, please let me know in the comments. As always, thoughts and suggestions will be appreciated!