                        ------====##########====------

                                    EDITOR

                               ----==#####==----

Contents:
1. Map editor
2. Men
 2.1 Player
 2.2 Other characters
3. Items/Miscellaneous
4. Campaigns
 4.1 Campaign file list editor
5. Instructions
 5.1 Building
 5.2 Characters
 5.3 Items
 5.4 Availability
6. Send your missions to me

Keys:
1     - Map editor
        F  Fill
        R  Rect
        A  Auto-ins
2     - Men
        +  Next character
        -  Prev character
3     - Items/Miscellaneous
        +  Next item
        -  Prev item
Space - Toggle between full-screen/edit display
PgUp  - One level up
PgDn  - One level down

                               ----==#####==----

1. MAP EDITOR
Menu commands:

Load       Left  - type filename
           Right - select from file list
Save       Left  - type filename
           Right - save without asking filename
Quit      
Clear      Clears all/floor with the currently selected block
           Left  - all
           Right - the current floor
Fill       Fill area with currently selected block
Rect       Create a rectangle. Press on the map and the Rect turns red. Click
           on the map again (in greater x,y coordinates) and the rectangle is
           ready.
Auto-ins   Helps with some blocks, especially with walls. When auto-ins
           is supported on selected block the Auto-ins background is grey.
Run check  Runs a check routine which goes through men waypoints, items and
           mission objectives.

                               ----==#####==----

2. MEN

Use Prev and Next buttons on the left to select character you want to modify.
Click right button on left top corner to center the character if it's in the
map. Clicking on the Z with left button goes upper level on the map, right
lower level.


2.1 When left-top corner reads 'player'

In this screen you edit player's mission details.

 Select mission type with arrow buttons. Go to next or previous mission
 objective with upper buttons.

 Mission types:
 - Escort person: Select the person you want to escort by scrolling the list.
   Then make sure that 'Place' is highlighted. Click on the map to select the
   place you want to escort the person.
 - Prevent person from going: Select the person you want to stop by scrolling
   the list. 'Place' must be highlighted. Click on the map to select the place
   where the person shouldn't go. Make sure that the person IS GOING TO THAT
   POINT, otherwise the mission won't work right.
 * Eliminate person: Select the person that must be killed from the list.
 * Destroy place: 'Place' must be highlighted. Click on the map at the block
   that must be destroyed.
 * Destroy all these places: You can select the block from the list or by
   selecting 'Place' and clicking on the map.
 * Bring item to point: Select item group first from the list. Then scroll
   the upper list to correct item. Make sure that player can have this item.
   If you use items after the '-' sign make sure the item is in the ground,
   since they are not available in the mission briefing. In this case use
   first 'take item from' with the same item, it clears the picture to player.
   Make sure 'place' is highlighted and then click on the point where the
   item should be taken.
 * Take item from: Select item group first from the lower list. Then scroll
   the upper list to correct item. Make sure this item exists and is on the
   map (from the Item submenu). Make sure 'place' is highlighted and then
   click on the point where the item should be taken from.
 * Patrol in: Make sure 'Place' is highlighted and click on the map.
 * Patrol unnoticed in: Same procedure as in 'patrol in', but in this mission
   type NOBODY must detect the player, otherwise the mission is failed. Can't
   be used with 'escort person' mission type.

 The characters will have a random starting point in missions which are
 marked with an asterisk (*).

Begin/End Buttons
 Highlight Begin and click on the map to select player's begin point, and
 End to select player's exit point.

Right-clicking on Place/Begin/End buttons centers that point to map screen.

Max civil casualties
 This is the maximum amount of civil casualties that can be occured in this
 mission. If this value is exceeded the mission is failed.

Short description
 Write here a short, meaningful description. It will be shown in the first
 Mission menu at the game.

Longer description
 Here you can write a longer, more detailed description of the game.

   Arrow keys move around
   Delete - deletes a row
   Home   - beginning of the line
   End    - go to the end of line
   PgUp   - top
   PgDn   - bottom

The arrows on the right below the character turn character's view direction
in the beginning of the mission.


2.2 When left-top corner reads a number

This screen edits other characters of the mission.

Endurance display (Head...)
 Click on the bars to adjust the endurance levels.

Skill display (Aggressivity...)
 Click on the bars to adjust the skill levels.
  - Aggressivity: Affects on enemy's firing speed 
  - Close Combat: Hitting with knifes/nightstick/bows
  - Hearing: Detecting range
  - Lock Picking: Not used
  - Medical: How fast enemy ties wounds
  - Pistol: Revolver and pistol firing
  - Rifle
  - Shotgun
  - Stealth: How silent enemy is
  - Strength: Affects on recovering from recoil, and so to firing speed
  - Submachinegun


Equipment display
 Red: Character's weapon
 Light blue: Character's helmet
 Darker blue: Character's body shielding

Waypoint display (green)

 Right button - previous choice
 Left button  - next choice

 You must select a waypoint type before you set it in the map.
 Maximum number of waypoints is 50 (0-49) for one character.

 Path           Show/hide path
 Autonext       When you click left button on the map, go automatically to
                next waypoint/add automatically new waypoint

 Waypoint types:
  - Move
  - Move fast: Runs from this waypoint to next one
  - Force move: Moves from this waypoint to next one, no matter what happens
  - Guard: Guard on this place for a while
  - Force guard: Guard on this place no matter what happens.
  - Follow player: Character follows player when he is close enough.
  - Drop weapon: Character drops his current weapon. NOTE: This command is
    executed right after the previous waypoint, so if you want person to drop
    weapon, FIRST put 'move' waypoint to where you want the dropping, SECOND
    put 'drop weapon' and THIRD put 'move' near the drop waypoint. If you put
    the third one too far the character will drop weapons all the way to the
    waypoint.
  - Wait for someone: Character doesn't move until he detects someone
  - Wait for: Character waits for determined time. The time IS NOT absolute,
    it's only about-measure how long the break is. NOTE: this waypoint is
    executed right after the previous waypoint, so if you want character to
    wait in some point, FIRST put the 'move' waypoint where you want him to
    go, and the NEXT waypoint should be 'wait'
  - Fire at will: Character is hostile towards player
  - Hold fire: Character will not fire towards player until he is shot by
    player
  - Loop to wp: Select waypoint from +- display. Character goes to waypoint
    you select here and continues the loop from there.

 It is recommended that you use 'Loop to WP' command that the characters
 continue their moving even the mission would last for a long time. For
 example make a guarding character to move around a building, and then
 loop the waypoint so that he goes around the building in continous loop.

                               ----==#####==----

3. ITEMS/MISC

Click right button on the top left corner to center the item, if it's in the
map.

The items/misc screen includes the following displays:
- Items on ground/availability
  - press 'available' to change item either available or unavailable (only
    when Weapon items are selected, a red background)
- World map which shows where the mission takes place. 
- Difficulty level
- Availability level: A general availability level. Affects on all equipment
  except miscellaneous. Press set button to apply it to all weapons
- Guard sound: Select here what kind of 'stop' sound the soldiers and police
  make. By the way, 'bad guys' don't warn - they only shoot 
- Scenery sound: Select what kind of background noises suit the mission
- Max item weight: Maximum total weight of items allowed on mission
- Max item cost: Maximum total cost of items allowed on mission
- All floors shown in mission briefing: Highlight this if you want that all
  floors are shown in the mission briefing. Otherwise it is displayed as a
  satellite picture

Availability:
 When weapon name is white it should be available. It may be forced to be
 otherwise by pressing 'available' text.

Placing items:
 Select first right item group (by color: weapon, ammo, helmet, shield,
 miscellaneous) and then the right item from arrows (right button goes 10
 items with one click). Then place the item to the map.

Remember that items will not show during the game if they are 'under' the
block they are in. For example, a tall object such as a table hides the
items on the same coordinates. 

                               ----==#####==----

4. CAMPAIGN

With this tool you may create a multi-mission, continuing campaign. Actually
it is a list of files which have to be played consequently, in order.

- Load: Get the selected campaign file
- Cancel: Go back
- New file: Create a new campaign file. You will be asked to enter the
  filename and a short description of the new campaign. After you've
  entered these the file is created and you will be taken to file list editor. 
- Ch dir: Change directory

4.1 Campaign file list editor
 Once you have loaded the campaign you see a list and few buttons. Maximum
 amount of files in the single campaign is 100.

 - Description: A campaign description. Click on the grey area to re-enter
 - Add to list: Add a new mission file to the list to selected place
 - Remove: Clear the currently selected place from the list
 - Clear list: Clear the whole list
 - Save: Save this campaign
 - Go back: Back to editor

                               ----==#####==----

5. INSTRUCTIONS

5.1 Building
- Leave enough space for important areas
- Corridors should be 3 blocks wide
- Leave space between trees and bushes so that characters may move freely
  between them
- Create more than one entrance to each building, that gives player a lot
  more opportunities to choose his route
- Try to make buildings real-like. Get ideas from real life

5.2 Characters
- Make enough characters for each mission, remember bypassers and policemen.
- It's better to make few good enemies than ten bad ones.
- Make characters move around. In most missions they begin from random
  waypoint.
- Place waypoints far enough from each others. A few blocks should be enough.
  It takes some time for the character to orientate into right direction.
- Equip enemies with realistic equipment. Mafia men probably won't have
  automatic rifles, helmets and rigid armors. Army units in China probably
  don't use M-16 rifles. And so on.

5.3 Items
- Try to put some items on each mission. First aid kits to cupboards.
  Toolkits to garage.
- Don't put many weapons to the scenery, unless it is a weapon cache. Don't
  make it too easy for the player.
- If you put mines on the scenery, hide them 'under' the blocks. Bushes or
  crates hide them just fine
- Remember that grenades and demolition packs begin their countdown when the
  mission begins, so they explode a moment after that.

5.4 Availability
- Try to set the availability realistically. If the mission is in Africa the
  availability level is a lot lower than in USA
- Don't give player too much money
- Disable some better weapons and make player choose between some more
  adequate weapons

                               ----==#####==----

6. SEND YOUR MISSIONS TO ME

If you think you have created a great mission, send it to me! But first:

- Play the mission by yourself. Check that everything works just as you
  planned.
- Run Check! Look if everything is right, and repair those parts which need
  some adjustment. Remember that all notes are not errors, e.g. a person
  might be 'inside' a block (in a chair).
- Test for different possibilities, and if a failure is possible in the
  mission (for example, 'prevent person from going'), check that it works too
- Make a good mission description to the description field
- Be sure that you include both <mission>.001 and <mission>.002 files. If
  you've made a campaing, make sure you include the <campaign>.003 file.

I reserve the right to alter the mission if it seems necessary. If it passes
the quality check it will be distributed in the mission webpage.

Send your mission to address:
j.nyman@pp.inet.fi

The mission webpage is at:
http://personal.inet.fi/koti/j.nyman/freecombat.htm

                        ------====##########====------
