Provided by: crimson_0.5.1-1_i386 bug

NAME

       crimson - a hex-based tactical combat game

SYNOPSIS

       crimson [--level level] [--width w] [--height h] [--fullscreen 1|0]
               [--sound 1|0]

       crimson {--help | --version}

DESCRIPTION

       Crimson Fields is a tactical war game in the tradition of the popular
       Battle Isle. Two players command a number of units on a map of
       hexagons, trying to accomplish mission objectives ranging from
       defending important locations to simply destroying all enemy forces.
       Damaged units may be repaired or replaced by new recruits, while
       victorious squadrons will improve their abilities so they will be even
       more difficult to beat next time.

       The game can be played against a human adversary in hot-seat mode, over
       a network, or via e-mail, or against a computer player.

       The level editor cfed(6) can be used to create your own levels.

OPTIONS

       If called without options crimson will open its main window using the
       settings from the last session or the defaults if no previous settings
       exist.

       --level level
           Skip the level selection window and load the mission file level.
           The file may be either a standard level file or a saved game. When
           starting a new game this way you will be playing a single map
           against the computer without any handicaps.

       --width w
           Set screen width to w. Minimum screen width is 320. Default is 800.

       --height h
           Set screen height to h. Minimum screen height is 240. Default is
           600.

       --fullscreen 1|0
           Turn fullscreen mode on/off. The default is to start in windowed
           mode.

       --sound 1|0
           Turn sound on/off. The default is on.

       --help
           Print a usage message on standard output and exit.

       --version
           Print version information on standard output and exit.

       The display and sound options given to crimson on startup will be saved
       to file and restored on the next program start.

GETTING STARTED

   Introduction
       The once peaceful planet Nexus has been invaded by beings calling
       themselves the Empire of Kand who are determined to conquer Nexus or
       destroy it completely. The public unrest has become violent as the
       people attempt revolution against the invasion, but the Empire of Kand
       are quick to silence opposition. Nexus is on the verge of war and its
       people have formed factions to battle the Empire. As a member of one of
       the major rebel factions, the Free Nexus Army, your goals are obvious:
       to drive the intruders back to whichever part of the galaxy they came
       from and restore peace on planet Nexus...

       (This is the background story for most of the included missions and the
       default campaign. There may be maps with entirely different settings.)

   Main Menu
       The main screen presents a number of widgets to configure the game. The
       most important decision is whether you want to play a skirmish match, a
       campaign, or load a saved game. Skirmishes are stand-alone maps while
       campaigns consist of a number of maps which must be played (and won) in
       sequence. Each map that you advance to during a campaign will also be
       unlocked for skirmish matches. While campaigns can only be played
       against the computer, skirmishes can additionally be played as hot-seat
       matches (two players on one computer taking turns), e-mail matches (see
       the section called “PLAY-BY-E-MAIL”), or over a network, and when
       playing against the computer you get to choose which side you want to
       play on. For both game types you can optionally define a handicap, to
       make the game a bit easier or harder. What this means exactly depends
       on the map being played but in most cases a handicapped player will
       have fewer units or resources at his disposal than his opponent.

       The large box on the left lists all available skirmishes, campaigns, or
       saved games, while the box on the right displays a small image of the
       selected map or, for campaigns, the story. For skirmishes, the number
       in brackets shows the recommended number of players. Missions designed
       for one player are often rather unbalanced if played against another
       human since the computer plays so different from a human, although a
       handicap can sometimes fix this.

       After you have selected a map hit Start to enter the game.

   First Steps
       After starting the match you will be presented with the mission
       briefing. Here you are given your orders and objectives to win the map.
       As both players usually have different and conflicting goals, each
       player gets his own briefing session at the beginning of his first
       turn.

       After the briefing you will be presented with the map. This is your
       command center. From here you can issue most of the orders that will
       determine the outcome of the mission. The first player commands the
       yellow units while the second player or computer takes control of the
       blue units.

       The map consists of small regions of land (or water) each known as a
       hex (sometimes also called field or square). Left-clicking on a hex
       selects that hex and moves the cursor to it. If there is a unit on the
       selected hex then a small bar will appear in the lower left of the
       screen showing the rank of the unit, its type, and the squad size (see
       the section called “Experience” for more information about ranks). If
       there is instead a building or shop on the selected hex, the
       information bar displays the name of the shop and possibly some icons
       representing special attributes (see the section called “CRYSTALS” for
       details). Shops may occupy several fields, but they only have a single
       entrance, which is marked by the colour of the respective owner.
       Buildings with a white entrance are neutral and not controlled by any
       player.

       A right-click on one of your units generally brings up a context menu
       for that unit (this does not apply to enemy units). Here you can view
       the unit stats, or inspect its contents (transporters only). Other
       units like mine-sweepers may have special skills which also show up
       here. If the unit is not a transporter and does not offer any special
       skills, the menu is skipped and you are directly taken to the stats
       display.

       The stats window is basically divided in two parts. The top part shows
       the unit name and its values for speed, armour, and effectiveness
       against ground troops, aircraft, and ships in that order, from the top
       left to the bottom right. Most units have a weapon range of 1, meaning
       they can shoot at units one hex away (i.e. directly next to it). For
       units with different settings, the actual range is given in brackets
       after the weapon power. The second part of the window lists the most
       important terrain types. Shaded terrain indicates that the unit cannot
       cross that ground.

       Right-clicking anywhere but on a unit or pressing F1 pops up the Game
       menu where you can review your mission objectives, take a look at an
       overview map, or save your game, for example.

       You select one of your units by simply clicking on it. Large parts of
       the map will now be shaded to indicate that the unit cannot move there.
       Unshaded enemy units are potential targets. To move to an accessible
       field or attack a foe, simply double-click the respective hex. If you
       accidentally sent your unit to a hex you did not want it to go to,
       right-clicking on the unit gives you the option of reverting the last
       move, as long as it did not trigger any special events.

       If you click twice on one of your shops or a neutral one, you enter
       that building. Of course, you can also move units into shops, although
       only some units (Infantry in the default set) can move into shops not
       owned by you, and some buildings may not allow all unit types. Quite
       often buildings are important mission objectives. Taking the enemy
       headquarters, e.g., is a very common goal. But even if you do not
       specifically need to control a certain shop for victory, it can still
       be very helpful as it may be possible to repair or build units (see the
       section called “CRYSTALS”).

       When you have issued all orders, select End Turn from the Game menu.
       Your commands are then executed, fights are resolved, and your opponent
       gets his chance to strike back...

MOVEMENT

       Each unit may only move once each turn, and only if it did not initiate
       combat on the same turn.  Artillery and Anti-Aircraft Guns cannot
       attack if they have already been moved on the same turn. To move around
       on the map, a unit needs movement points. The number in the upper left
       corner of the unit information dialog (which can be brought up for one
       of your units by right-clicking it) indicates how many hexes the unit
       can move under optimal circumstances. The actual range is determined by
       several factors.

       For ordinary ground units the terrain can greatly reduce the range of
       action. The maximum can only ever be reached on roads, everything else
       will slow the unit down, and mountains more so than forest. For
       airborne units or ships, terrain is of no importance.

       Enemy units can be trapped in order to prevent them from using superior
       speed or to deny them access to certain areas of the map. A unit which
       attempts to cross a hex between two hostile units or one hostile unit
       and inaccessible terrain will be stopped immediately after passing
       through.

       A unit cannot leave a transport or building and enter another one on
       the same turn. Enemy buildings can only be conquered by infantry units.

COMBAT

   Results
       Basically the probability to hit an enemy unit in combat is the same
       for all unit types, although the attacker always gets a slight
       advantage. This hit probability is then modified by effects such as
       experience, distance to the target, terrain, or wedging (see below).
       Similarly, each unit gets assigned a probability for evading an attack
       which is then modified by experience, terrain effects and blocking. If
       a unit scores a hit it will increase its attack pool by an amount equal
       to its strength. A unit which successfully evades an attack will have
       its defence pool grow by an amount equal to its defence or armour
       value. Finally, each attack pool is compared to the enemy’s defence
       pool, and the resulting ratio determines the casualties on both sides.

   Terrain
       Terrain is an important factor in combat as it can heavily influence a
       unit’s effectiveness. For example, fighting on a road or open plains
       will greatly increase attacking strength but offers relatively poor
       defensive capabilities, whereas a unit in the mountains will profit
       from the higher position in both attack and defence. Terrain modifiers
       do not apply for aircraft.

   Wedging
       Friendly units can help increase the combat strength of an attacking
       unit without attacking themselves. For each friendly unit which is
       adjacent to and capable of shooting at the defender, the attacker will
       get a 10 per cent bonus. If the unit is adjacent to the defender, but
       cannot attack it the bonus is reduced to 5 per cent. A friendly unit in
       the back of the defender will earn another 5 per cent bonus, or 10 if
       it could also attack. It does not matter whether a wedging unit
       actually attacks the defender. Wedging does not work for long-range
       attacks.

   Blocking
       In a manner similar to wedging, defending units may improve their
       position in combat. For each friendly unit adjacent to the attacker and
       the defender, the defending unit will have its combat strength
       increased by 10 per cent. Just like wedging, blocking does not help
       against long-range attacks.

   Experience
       Veteran units are usually much stronger than newly assembled ones. If
       you manage to wipe out an enemy unit your unit will receive three
       experience points. If the enemy is only damaged you will still get one
       point. Every three experience points a unit advances to a new rank
       which improves its combat skills. Still, a seasoned infantry unit will
       have a very hard time against a group of recently recruited heavy
       tanks. Destroying mines does not earn any experience points.

CRYSTALS

       Crystals represent the resources required to maintain and enlarge your
       army. You need them to repair damaged units or build new ones.

   Repairs
       Units which have been damaged in combat can be repaired in any building
       equipped for this purpose (a workshop). To check whether a building is
       a workshop, click on it. For workshops a wrench icon will be displayed
       in the small info bar that appears in the lower left of the screen, and
       a repair button is available in the icon bar inside. Repairing will
       restore a unit to its full strength and requires an amount of 5
       crystals, no matter what kind of unit it is or how badly is was
       damaged. Apart from the crystal cost the unit loses one experience
       point for each rookie that fills up an empty slot.

       The ability to repair damaged units is not necessarily limited to
       shops. Some unit types may offer the same service (from the standard
       unit set, for example, the Aircraft Carriers can bring aircraft back
       into shape). Repairs in units works exactly the same way as in
       workshops, and you also need to supply the crystals to do so.

   Production
       To build new units you need some crystals and a factory (hammer icon).
       The amount of crystals required depends on the type of unit you want to
       build: A squad of light reconnaissance vehicles is cheaper than a group
       of heavy attack choppers. Most factories can not produce all unit
       types, even if you could afford it. If you click on the production
       button inside a factory, you are shown the list of units which can be
       built in this particular factory. Next to each unit type is the amount
       of crystals that will be consumed. Newly built units can only move on
       your next turn.

   Mines
       To replenish your supply of crystals you need mines. Mines are
       buildings which ’produce’ a certain amount of crystals each turn. They
       can not be identified from the outside. Many maps do not have any mines
       at all, so it is always a good idea to consider carefully what you
       spend your resources on. Crystals can be transferred from one building
       to another (e.g. from a mine to a factory) using any transporter unit.

PLAY-BY-E-MAIL

       If Crimson Fields is played in play-by-e-mail mode, the game will
       automatically be saved whenever a player ends her turn. The resulting
       save file can then be sent to your opponent using your favourite mail
       client program.

       On your first turn you will be asked for a password. You will be
       prompted for this password at the beginning of each of your turns to
       prevent your opponent from spying. Note, however, that the password
       only offers very mild protection if you are playing against deliberate
       cheaters. Choose your enemies carefully!

FILES

       Unix

           ~/.crimson/crimsonrc

           ~/.crimson/levels/

SEE ALSO

       cfed(6), bi2cf(6)

COPYRIGHT

       Copyright © 2000-2007 Jens Granseuer

       This software is distributed under the terms of the GNU General Public
       License[1] (GPL).

AUTHOR

       Jens Granseuer <jensgr@gmx.net>
           Author.

REFERENCES

        1. GNU General Public License
           http://www.gnu.org/copyleft/gpl.html

                                January 20 2007                     CRIMSON(6)