How to use the Map Scripter
The Map Scripter edits real Age of Empires II map scripts without you writing any code. You start from one of the game's own maps, change what you want, and download an .rms file that the game loads like any other custom map.
What it works on
The scripter's list holds 149 maps taken from the game's own files: 85 land maps, 16 water maps and 48 hybrids. Each one keeps its official script, so a change you make sits on top of logic that already works. Your download still calls the game's shared include files for things like Town Centers and starting resources. That is why generated maps keep working in any normal DE install.
Step 1: Map Workshop
Click one map. That is all you need to do, and you could press Generate straight away. The first map you choose becomes the base.
Click more maps if you want a hybrid. A map script is split into sections, and the scripter shows them as rows: Player Setup, Land Generation, Terrain, Objects and so on. For any row, you can pick a different source map. For example, you could keep Arabia's land but take the objects from another map.
Hover a row to preview that section. A badge warns you when two sections may not work well together. Maps are written in a few different styles, and mixing styles is the main cause of odd results. If you are new to this, change one row at a time and test it.
Step 2: Start and biome
This step sets how players begin, which of the game's 22 biomes the map wears, and any prizes to fight over. Nomad start is switched off for maps that cannot support it, because only some scripts react to it.
Biomes are more than a colour change. The chosen biome also brings its own animals. See the biome guide for what each one does and how the scripter applies it.
Step 3: Resources and wildlife
The levels run from Scarce to Max. Wood scales the map's real forest. For animals, fish, gold, stone and relics, Scarce and Less scale down what the map already has, while More, Lots and Max add extra groups. Below the sliders, you can pick exact animal species.
A useful habit: change one resource by a large step, not all of them by a small step. Doubling gold while keeping everything else normal gives you a clear new style of game. Moving every slider slightly gives you a map that feels the same.
Step 4: Structures
Add pre-built walls, buildings, bridges and decorations on top of the map's own objects. This is the quickest way to give an ordinary map a new identity, such as neutral ruins in the middle of an open map.
Generate, test and share
- Press Generate .rms to build the script and preview it.
- Press Download .rms, then follow the install guide.
- Start a skirmish alone and look around before you bring friends. Try the player count you plan to use, because a map can feel very different at 2 and 8 players.
- Use Save to keep the setup in your browser, or Share to copy a link that reopens the exact setup.
Happy with the result? Publish it on the Share Maps page so that others can play and rate it.
Short on ideas?
Feeling Lucky? picks maps, mixes them and generates a script with no setup. Results are unpredictable by design, so treat them as a starting point and adjust what you like.
Common questions
Why does my map look different every game?
Official maps use randomness on purpose. Arabia alone rolls its forest distance, forest count and hills each game, as the Arabia guide explains. Your custom version keeps that randomness unless you change it.
Can I edit the script by hand afterwards?
Yes. It is a plain text file. The RMS guide explains how it is built.