WesnothMapEditor

From Wesnoth

Contents

The Wesnoth Map Editor

This document describes the map editor available in The Battle for Wesnoth.

Installation

To compile the editor using autotools, run configure with the --enable-editor flag.

Otherwise, the map editor is normally built and distributed by whoever packages for your system. Look for it in the same location as the wesnoth executable/application.

Operation

The editor will display a map on the left in its main window, a minimap analogous to the one in the upper portion of the right sidebar, and a tool palette below the minimap.

The basic way to edit map hexes is to select a palette tile in the sidebar by left-clicking on it, then left-click on a hex in the map to copy the selected tile there. The editor has undo, so experiment all you want.

To learn what the tool buttons above the palette and below the minimap do, hover your mouse over them; each has a tooltip.

Controls

Arrow keys                      Scroll (if map scrolling is enabled)
Left click                      On map: Paint foreground terrain. On right panel: select foreground terrain
Right click                     On map: Paint background terrain. On right panel: select background terrain
shift-left click                Mark terrain
shift-alt-left click            Mark connected terrain
ctrl-left click                 Select the terrain under the cursor as foreground terrain
ctrl-right click                Select the terrain under the cursor as background terrain
Click and drag marked terrain   Move the marked terrain
+                               Zoom in
-                               Zoom out
0                               Zoom default
u                               Undo
r                               Redo
ctrl-g                          Toggle hex grid
ctrl-l                          Toggle mouse scrolling
ctrl-s                          Save map
ctrl-alt-s                      Save map as
ctrl-q                          Quit map editor
t                               Set the starting position of a player
ctrl-n                          New map
ctrl-l                          Load map from file
f                               Flood fill with selected terrain
alt-f                           Flood map selection with selected terrain
shift-r                         Rotate selected map terrain
ctrl-x                          Cut selection from map
ctrl-c                          Copy selection from map
ctrl-v                          Paste selection to map
ctrl-r                          Revert map from file
ctrl-p                          Set map preferences
ctrl-alt-r                      Resize map
ctrl-f                          Toggle fullscreen
ctrl-a                          Select entire map
ctrl-alt-f                      Flip the map
ctrl-d                          Set draw mode
ctrl-e                          Refresh map display
b                               Redraw/update terrain transitions
ctrl-t                          Delay terrain transitions
alt-l                           Change editor language

Use the Command key rather that Ctrl on a Mac.

The keystroke functions are also accessible through the file menu, the edit menu, or the right panel.

This page was last modified 21:22, 29 February 2008.