EDEE Map Converter Tutorial


Part 1 - The Interface

EDEE Map Converter

Using MapConv is simple since there are only 4 buttons.


Part 2 - The Text File

The heart of the EDEE map and scenario converter is the text file. See conv1.txt (which comes with the download) for a complete list of instructions and commands. Use Notepad to make your own or download the examples listed at the bottom of the page.

The conversion parameters work on either a map or scenario file.

The text file is based on a single instruction. Shown below are some common uses for a text file:

FOR MAP SIZE EXPANSION/CONTRACTION

The [Resize] command does quite a few things, but you can only only do some things one step at a time.

[RESIZE][<Terrain Id>][<direction>][<+/- number of rows or cols>][<horz warp> T/F][<vert wrap> T/F]

Caution: You can only work with one direction (top, bottom, left or right) at a time.
Caution: If resize is defined, only map size changes will take place, all other non-sizing params are ignored

Examples explained:
[RESIZE][C][TOP][-6][F][F] = Resize at the top by deducting 6 rows; the [C] clear terrain is ignored since nothing is added; wrap flags are ignored
[RESIZE][C][TOP][+6][F][F] = Resize at the top by adding 6 rows of Clear terrain; wrap flags ignored
[RESIZE][s][TOP][0][T][T] = Assuming applied to a map or scenario with no-wrap - Resize is 0; the wrap edge graphic is replaced with shallow sea terrain ; wrap changed to full

Changing the Unit DB type

The [UNIDB] changes the unit database. Used when you want to change the Unitdb (mod) of a map or scenario. If you have a map/scenario that uses the default UnitDB (standard units) and you want to use a custom mod, like UltraDB or SoloMod instead. Or if you have a map/scenario that uses a custom mod and you want to switch back to the default units.

[UNIDB][HCDB] where [HCDB] is the name of the directory of the unit db or new mod.
Examples explained:
[UNIDB][HCDB] = change map/scenario to use the default units
[UNIDB][UltraDB] = change the map/scenario to use the UltraDB mod units
[UNIDB][Solo] = change to the Solo mod
[UNIDB][Speed_1-65C] = change to Speed mod.
For other mods, look for the specific directory under EDEE\Data\Unit\


Part 3 - Using MapConv

This tutorial assumes you know the map or scenario has something to convert like the size, the wrap or the unit database, etc.
If unsure, load the map into EDEE to find out details first.

Caution: Do not overwrite the same file when you convert a map or a scenario.
The reason? Attempting to save over the existing filename, EDEEMapConv will write an empty (0 byte) file.
You lose both the original and the conversion.

Example - converting mymap12.emp becomes mymap12A.emp
Example - change a scenario back to the default UnitDB "myscenario12.esn becomes myscenario12_defaultDB.esn

Changing the Unit DB (unit mod)

Assume you have a scenario designed for Speed Mod called "3way_A_Speed165c.esn" and you want to use the UltraDB or Solo mod with it.
Run EDEEMapConv
Click on the Select file input and load the text file for Ultra or Solo. The text file name will appear under the button.
Click on the Convert Scen button and locate the "3way_A_Speed165c.esn" file and click on it (Select Scenario File to Convert).
The file is processed and you get a file save box to save it under a new name (Resulting Scenario File).
Done.

Converting a no-wrap map to full wrap

Note: The map may require additional editing in EDEE's Map Editor.
Assume you have a map without any wrap that you want to make full E/W and N/S wrap - there are 2 ways of doing this. Simple way takes one step, accurate method takes 4 more steps.
Simple way:
Run EDEEMapConv
Click on the top button (Select file input) and load the text file "setwrap.txt"
This text file does 2 things in one step. The first thing it does is to change the wrap flags to T for both directions. It next processes the file to change the map edge graphic to the Sea (deep) graphic.
Click on the Map or Scenario button and locate the file to convert.
The file is processed and you get a file save box to save it under a new name.
What happens? In the simple method, you get the same map or scenario but the no-wrap border graphic is replaced with the deep water terrain graphic. In effect you have an extra top and bottom row of water and an extra left and right column of water terrain surrounding the map.
Removing these extra rows and columns has to be done one step at a time, first the TOP row, then BOTTOM, then LEFT and RIGHT, each time having to load in a new text file, locate the scenario, convert and save. Five steps.
See file downloads for One Step or 5 Step methods.


file downloads

One Step - Full Wrap

5 Step - Full Wrap

Convert to Default DB

Convert to Solo Mod

Convert to Speed Mod

Convert to UltraDB