Skip to content

Eddie's Map Editor: user guide

How to make and change a TripleA map with the editor, tool by tool and control by control. The pages use the editor's own words: a heading is a tool or a control as you see it on screen, and the numbers in a picture are explained below it. For installing the editor see the README on GitHub.

The pictures show the dark theme. The editor follows TripleA's look: with a light TripleA it is light, with the same controls in the same places.

Start here

  • The window

    The header, the sidebar, the map beside the tools, the keys, saving and undo.

  • Menus

    The File menu, the map picture menu, View, Paint, Places, Sort and the ⋯ list.

  • New map

    The wizard that starts a map from a picture in three steps.

  • Home

    What to do next, the problems, the overview and a tile per tool.

The tools

The window

The window

  1. File opens the File menu: open, new, recent, rename, export, publish, play with, the folder, close, Show all options.
  2. Save state. "All saved", or "• Not saved" in orange, and "not checked" until Check ran. The Save button appears beside it once there is something to save.
  3. Undo (Ctrl+Z) takes the last step back. Every change is a step, also a save does not end the chain.
  4. Redo (Ctrl+Y) does it again.
  5. Check (F6) loads the map as TripleA does, plays the first round in memory and lists what stops the game. The result shows as a pill beside the save state and on Home.
  6. Play (F7) saves, runs the same check on the saved files and starts TripleA with the map.
  7. The sidebar lists the tools in groups: Home, Map, Players, Units & economy, Game flow, Texts & sound, Share. Alt+1 to Alt+9 open the first nine. The chosen tool has a bar at its left.
  8. Advanced folds the Attachments and Files tools in and out. The editor remembers it.
  9. Guides & links opens TripleA's map making guides and the places to ask for help.
  10. « at the bottom of the sidebar shows icons only, to give the map room; the icons' tool tips still name the tools.
  11. ? beside a tool's title explains the tool. Many fields have their own "?".
  12. Hide hides the hint line under the title. The "?" still has it.

One of Check, Save and Play is highlighted: the one that comes next.

The map beside the tools

Most tools show the map. Its toolbar, views and legend are described on the Territories page, since that tool uses them most. The row under the toolbar shows a goal while you follow a step of Home's guide, and a progress bar while the map's picture is read from its tiles or a resize works.

Keys

Key Does
Ctrl+O Open a map
Ctrl+N New map
Ctrl+S Save
Ctrl+Z, Ctrl+Y Undo, Redo
F6 Check
F7 Play
F8 Export as zip
Ctrl+W Close map
Alt+1 … Alt+9 The first nine tools
Ctrl+0 Fit the map
Ctrl+wheel Zoom the map
Delete In a table: remove the chosen row

Saving and undo

Every change is a step. Undo takes it back, also after a save. Save writes only what changed and keeps the first version of each file as .bak. The Save button's tool tip lists what the next save writes, for example "Saves 3 files: 300BC.xml, place.txt, map.properties". A save never writes a half file: it writes beside the file and moves it into place.

"More" rows and Show all options

Options the game reads rarely sit behind a "▸ More … options (n)" row. Click it to open it; the editor remembers which rows are open. Show all options in the File menu opens every such row in every tool, now and next time.

A tool with many things, such as Territories or Units, has a list on the left with a search field above it. Type a part of a name. Where the list has groups, a header row folds a group. Click a row to choose it; the right side then shows what it has, with "← All …" at the top to go back to the list.

When something goes wrong

A unit shows as a name badge on the map

The editor found no picture for it: none in units/<nation>/, none in units/ itself, and none among the game's own. Upload one in Units.

Gives support says None, stacking limits are blank

The support or limit may be written in Attachments for every unit or nation of a variable (foreach); the tools show those read-only.

A size in Resize map is greyed out

The picture is not saved yet: save first, then it is resized from its tiles at any size.

The game does not start

Check (F6) says why and links the tool.

The toolbar's words are cut, like \"Draw bord…\"

The window is narrow for the inspector shown; widen it, or hide the sidebar's words with «.

Found a bug or miss a feature? Open an issue at github.com/xXEddieXxx/eddies-map-editor/issues.