Map Conversion Tutorial

Phrohdoh · Soldier **Joined**: 12 Feb 2015 **Location**: Texas, USA

This tutorial on github via gist.

=== Information ===

Author: Taryn Hill <Phrohdoh@gmail.com>
Date: 12th March, 2015

If you want to convert TS maps you need to have the TS mod installed.
If you want to convert RA2 maps you need to have the RA2 mod installed.

<mod id> = ts or ra2

In the provided examples I prefix the lines I am adding with a +.
Do not include this + in your file.

If you have any questions, comments, or concerns please do not hesitate to email me.

=== Section I: Convert TS/RA2 tilesets to OpenRA ===

1) Read 'Section III'

2) Run `OpenRA.Utility.exe <mod id> --extract <tileset name>.ini`
temperate.ini,
urban.ini,
snow.ini,
etc..

3) Run `OpenRA.Utility.exe <mod id> --tileset-import <extracted file>`
When you run this command you will need to pipe the result into a file, example:

OpenRA.Utility.exe ra2 --tileset-import urban.ini > tilesets/urban.yaml

4) Open mod.yaml and add a path (relative to the root of OpenRA) to your new file,
to the Tileset section, example:

TileSets:
./mods/ra2/tilesets/temperat.yaml
./mods/ra2/tilesets/snow.yaml
+ ./mods/ra2/tilesets/urban.yaml

5) Open sequences/misc.yaml
Add a sequence block like the others for your new tileset type, example:
You may have to tweak the `Offset` values.

build-valid-snow: place
Start: 0
Offset: 0, -15
+ build-valid-urban: place
+ Start: 0
+ Offset: 0, -15

You should be done now.

=== Section II: Convert TS/RA2 maps to OpenRA ===

1) Read 'Section III'

2) Run `OpenRA.Utility.exe <mod id> --import-ts-map /link/to/your.map`

3) Navigate to the mod directory (at mods/ts/, or mods/ra2/)

4) Make these changes (adjusted to the correct values):

Open the newly created map.yaml in maps/<map name>/
Change `Tileset: TEMPERAT` to the correct tileset.

You should now be able to play your converted map

=== Section III: Building OpenRA ===

1) Download and extract https://github.com/Phrohdoh/OpenRA/archive/map-ed.zip

2) Build OpenRA:
Linux / OS X: Open your shell and cd to the root of the extracted files then run `make dependencies`, `make`
Windows: Run make.cmd, use the commands `make dependencies` then `make`

That should be all you need to build the engine and utility.

Key Words: #Tutorials #OpenRA #Mapping #OpenRAUtility

Darkstorm · Commander **Joined**: 20 Jan 2008 **Location**: Texas

This isn't really about this tutorial specifically but there probably should be a tutorial section for OpenRA. I might put some easy stuff up there to get people started if it is created.