SHORT INTRODUCTION TO THE HIT&RUN MAP EDITOR - MAPEDIT
(c)DohSoft 2000-2002, http://dohsoft.cjb.net
clemens.hofreither@gmx.net

First of all, please note that this map editor was left in what might be called beta state. It worked for us to create the game, so if it works for you, that's great, have fun; however, it's not polished or anything and I'm positive there are bugs in it, so if it gives you any problems, feel free to mail me, I'll see what I can do.
I'm sorry for the HIGHLY chaotic character of this document; I'm doing this really quickly, and this is becoming some mixture of documentation, tutorial, glossary, random bits and... uh, whatever. Mail me if I have to clarify anything.

All maps must be placed in the \maps subdirectory of your H&R installation. To get them into the game, you need to make a maplist.dat file and replace the one in the root directory of your H&R installation.

Format of the maplist.dat file:

Any number of lines with:
[map-filename] [map-name] [x] [y]

where:
 map-filename is the filename of the map, including leading maps\ and .map extension
 map-name is the short name of the map, normally the geographic location of the map
 x and y are the pixel coordinates on the world map; use the supplied worldmap.png image file for reference

The listed maps will automatically be sorted by their cash value, which you can set in MAPEDIT in Edit > Map properties.

When you finish a map pack, be so kind and zip up the MAP files and the maplist.dat and mail them to me so I can make it available to other people. Supply some readme file if you feel like it. Full credit guaranteed.
NOTE: If any of you want total linearity, ie. only one map to choose at any time, tell me about it; if there are requests, I might make that an option. Otherwise, there are three maps to choose from at any time.
NOTE: The same applies to new map objectives. Tell me what you want, I'll see what I can do.

***************************** EDITING MAPS ******************************

Before you can start editing a map, you will have to select a "tileset", that is, the set of tiles you will be using along with their attributes. MAPEDIT will prompt you to do so automatically if you choose to create a new map.
I'm the first to admit that the tilesets provided with H&R aren't exactly high quality, so if anyone wants to try and make something better, I'll happily provide them with all the tools and information they need and offer the result on the homepage.

So, choose "New..." in the File menu, select some dimension of about 20x20 tiles, and let's get started.

In the default edit mode, Terrain mode, you have a tile selector to let you paint the terrain. What is not so obvious is that by holding the Control key you can select multiple tiles at once and paint them randomly. This is especially useful for filling a map with a basic pattern: select some ground tiles, then do Edit > Fill map with selection.

In Enemies mode, you can place enemies (doh!). Just select one and click on where you wanna have him. Rightclick him to delete him or edit his properties, namely type, initial heading in degrees (this won't be represented in MAPEDIT's view; that's one of the "not so polished" things I talked about...) and first waypoint (more about that later).

Starting position mode is easy too: just click on where you want the player to start.

Target area mode is only required for "Assassinate", "Rescue" and "Airstrike" maps. Click, hold and drag the mouse to define a rectangular target area. Its meaning differs from map type to map type:
Assassinate: put a single target area square on top of the person you want the player to kill. This doesn't mean that enemy has to stay there, it's just to tell the game who is meant to be killed.
Rescue: Draw the target area where you want the player to bring the hostage once rescued.
Airstrike: Draw the target area on top of whatever you want the player to tag with his laser and then be destroyed by the jet.

Waypoints mode is a bit complex. Here you can place new waypoints (left click) and edit/delete them (right click). When you edit a waypoint's properties, you can enter a name (I usually just use stuff like "a1", "a2", ...) and chain waypoints together by entering the next waypoint's name (or select it from the drop-down box). Of course you can form circles by making the last waypoint chain to the first; otherwise, the enemy will stop at the last waypoint. To make an enemy follow a path, just enter the name of the first waypoint in the enemy's "First waypoint" field in the properties.

The last thing you should know about is Map properties in the Edit menu. Here you can set the map type (objective), the amount of money the player will receive when succeeding in the mission and the briefing. Again, maps will be sorted by ascending cash value in the game list, so enter something sensible there.

KNOWN BUGS: When you open a map of a different size, the scroll bars aren't adjusted automatically, just restore/maximize the window to fix that.

CHEATS: I never wanted to tell you guys about this, but I know how important it is to efficiently test a map. Please don't use this to spoil the game (you can show off to your friends though :).
* On the equipment screen, press C, L and E simultaneously to gain money.
* The remaing cheats are console cheats. During a game, press backspace and enter:
* CALLMEZEUS for god mode (invincible)
* BULLETSKEEPFALLINGONMYHEAD for infinite ammo
* YOUCANTSEEME for invisibility
* IAMWATCHINGYOU to display the view ranges of the enemies (coool -  la Commandos)
All these console cheats can be toggled off again by entering them a second time.
There are some more, but I'm sure some of you guys won't have troubles finding them. Those are the most useful for testing maps anyway.

*************************************************************************

That should get you started editing maps for H&R. I know this document isn't complete, but you should be able to figure out most things by common sense or trial and error, so have fun. In fact I didn't intend to write this much...
I'm of course open to any questions or comments.

Clemens Hofreither (DohSoft), March 25 2002
clemens.hofreiter@gmx.net
