git.pond.sub.org Git - empserver/blob - info/retreat.t

   1 .TH Command RETREAT
   2 .NA retreat "Set retreat conditions/paths for ships or fleets"
   3 .LV Expert
   4 .SY "retreat <SHIP/FLEET> <PATH> <CONDITIONS>"
   5 .SY "retreat <SHIP/FLEET> q"
   6 The retreat command allows you to examine or modify the retreat
   7 paths and conditions of your ships.
   8 .s1
   9 The first argument selects ships to view or give orders for.
  10 If a fleet designation is given when specifying orders, the orders
  11 apply to all members of that fleet.
  12 .s1
  13 With 'q' instead of a retreat path, the current retreat paths and
  14 conditions will be listed.
  15 The report format contains the following fields:
  16 .s1
  17 .in \w'ship type\0\0'u
  18 .L shp#
  19 the ship number
  20 .L ship type
  21 the type of ship; \*Qpatrol boat\*U, \*Qsubmarine\*U, etc,
  22 .L x,y
  23 the ship's current location,
  24 .L flt
  25 the fleet designation letter (set by \*Qfleetadd\*U command),
  26 .L path
  27 the current retreat path,
  28 .L as flt?
  29 whether these are fleet retreat orders,
  30 .L flags
  31 what conditions will trigger retreat.
  32 .in
  33 .s1
  34 For example:
  35 .EX retreat * q
  36 .NF
  37 shp#     ship type       x,y   fl path       as flt?  flags
  38    0 bb   battleship     2,0      jjuuj               i
  39 1 ship
  40 .FI
  41 .s1
  42 A player may give retreat orders for a ship or a fleet. Retreat
  43 orders include a set of conditions that determine when the fleet/ship
  44 will retreat, and a path that the fleet/ship will follow. When a condition
  45 is met for a particular ship, the \*Qas flt?\*U field is checked. If it
  46 is Yes, then every ship in that fleet with fleet retreat orders retreats
  47 along the specified path. If it is no, then the retreat orders apply to
  48 that ship only, and only that ship retreats.
  49 .s1
  50 When a ship is added to a fleet, it is given the retreat orders of the
  51 first ship in that fleet that has fleet retreat orders and is in the
  52 same sector, if any exist.
  53 .s1
  54 Retreat orders are wiped when a ship navigates.
  55 .s1
  56 Retreat conditions are:
  57 .nf
  58
  59         Condition       Meaning
  60         i               Retreat when the ship is injured,
  61                         i.e. whenever the ship is damaged by gun fire,
  62                         bombs or torpedoes
  63         t               Retreat when a sub torpedoes or tries to
  64                         torpedo the ship
  65         b               Retreat when a plane bombs or tries to bomb
  66                         the ship
  67         s               Retreat when the ship detects a sonar ping
  68         d               Retreat when the ship is depth-charged
  69         h               Retreat when helpless --- a ship is helpless
  70                         when it is fired upon, and no friendly
  71                         ships/sectors (including the ship itself) are
  72                         able to fire back at the aggressor
  73         u               Retreat upon a failed boarding attempt
  74         c               Cancel retreat order
  75 .fi
  76 .s1
  77 For example, if the battleship above was fired at, it would attempt to
  78 retreat 2 sectors, jj, using the normal amount of mobility for moving
  79 2 sectors. It would then look like:
  80 .NF
  81 shp#     ship type       x,y   fl path       as flt?  flags
  82    0 bb   battleship     2,0      uuj                 i
  83 1 ship
  84 .FI
  85 .s1
  86 .SA "ship, fleetadd, Ships"