****Sysop Documentation****
Version 1.27 Nuclear Warfare Copyrighted 1992-94 Custom Services
***All Rights are reserved***

The files and other doors can be found on the Amiga Zone BBS (609)953-8159.

This program is Shareware ,you may use it for 30 days without affecting
your conscience!  After that point, you are asked to send in $10 to
register Nuclear Warfare.

Registration:

registration will get you a key that will remove the reminder and delay
that occurs.  The key for registration is placed in the environment
variable NW_REGISTRATION.  Do not set this unless you actually register
since the program will check for fake keys and delay the user.  The key
is set with:

SETENV NW_REGISTRATION <your registration key>
SETENV NW_BBS_NAME     <your BBS name>


This is the released version, the public release of this game
Everything seems to work, but you never know!  See the History at the
end for changes.  This game has been tested with Citadel 68K and
DLG BBS systems but should work with any BBS program that supports a
cli door interface.

For Citadel:

To install this door you must be edit your configuration file
with the door command:

#door NW NW cit:doors anyone modem unlimited
 Nuclear Warfare ©1992 Custom Services
 <ctdlaux: >ctdlaux: "%d" cit:doors/nuke/

Note:  if you are running under an earlier OS than 2.04, you will need
to put the door entries like this with the redirection first because
1.3 will not handle it otherwise.  With later OS versions, you can have
the redirection anyplace on the command line.

Note:  You need to install the CTDLAUX: handler so the door can communicate
with the serial port.  This is also available on the Amiga Zone.

You must add the above lines to your ctdlconfg.sys file and reconfigure.
This door will not work locally from citadel, but will run from CLI with
the command:

 cit:doors/nw "Username" cit:doors/NUKE/


Note:  There is a special third parameter that is used for debug and
to force maintenance to run more than once a day.  If the third parameter
is present on the command line maintenance is run.  If the third
parameter is "debug", a special debug file is created.  Use this if you
run into a problem.  I will need this file.  If you wish to run maintenance
more than once per day, you will have to use a valid user and run it
with the third parameter present.  Any user will do, just run it locally
and quit.  A simple script can be setup to force maintenance at a certain
time with:

 .key user
 CD cit:doors
 nw <user> cit:doors/nuke/ force_maintenance  >NIL: <Quick_Quit


 The file "Quick_Quit" just has the commands:

  N  <-- answer to "do you want ANSII"
  Q  <-- quit out of news display(or game if no news)
  Q  <-- quit out of game.

This will run the game, and then quit.  The user name you use
can be any player's name.  I suggest that you use your own!  It does
not have to be done this way, maintenance will run with the first user
of the day automatically.

You must use the same user name all the time for local operations.
Upper and Lower case do not matter in the user name.

Nuclear Warfare will create all the files it needs.  The two parameters
are the Username and the directory.

This game is setup to work as a Citadel 68K door.  You must have the ctdlaux:
device to run this program as a door.  It will run locally in a shell window.

This game and the ctdlaux: handler have been tested under 1.2 thru 2.1 and
with citadel 3.32 thru 3.42.  This door includes the following files:

   NW_Sysop.docs    -  this file
   NW               -  Nuclear Warfare executable, Put in the "cit:doors/"
   nw.cfg           -  Config file, setup your filenames here(dummy file)
   Instructions.txt -  Game Docs Put this in the "cit:doors/nuke/"

You must create the directory cit:doors/nuke and copy the instructions and
config file.  In the current version, the config file must be present, and
you will get an error message for problems reading it.

For ease of use, I suggest that you protect the instructions and config files
from deletion.  That way, when you start a game, you just go into the
directory and delete the contents.

The Configuration File:

Note:  if you type in NW, it will display the configuration file format.

The Configuration file specifies four file names and two control parameters.
The filenames can be up to 80 characters long.  The two control parameters
allow you to customize the game slightly.

The first control parameter is a flag which must be Y or N.  If it is Y,
a player can abdicate or be killed and then later re-enter the game as
either the same(if the country is the next one to be used) or another
country.  If it is N, a player that abdicates or is killed will stay in
the country until the game ends.  If you have alot of players, you might
want to make this N(or if you have a tournament type game).  If you only
have a few players, a Y will be good since it will keep the interest of
those players.

The second control parameter determines how many days of news will be
saved in the old news file.  If you want a complete history, set it to
a large number.  Otherwise, set it to 5 or 6 days.  You want enough so
that a new player can see the history of the game.

Line 1: Power Index file name.
Line 2: Winners file log
Line 3: Flag: YES - a killed player can play again, No - must wait for
              the game to reset before you can play.
Line 4: Number of days to save old news
Line 5: Current News File
Line 6: Old News File
Line 7: The name of your BBS(See Registration).

Setup for DLG:

Follow the directions supplied for the Citadel installation.
Setup  the menu entry set up for your system:

[ 1] Letter:                   S
[ 2] Executable: (path/name)   Doors:Nw "%ALIAS" Doors:Nuke/
[ 4] Description:              Nuclear Warfare ©1992 Custom Services
[ 5] Type:                     Executable
[ 6] Help File:                DOORS_MAIN/S
[ 7] Lower level:              10
[ 8] Upper level:              255
[ 9] Hidden:                   NO
[10] Load type:                OVERLAY
[11] Ask user if sure:         NO
[12] Pend messages:            YES
[13] Cli mode:                 YES
[14] Pause on completion:      NO
[15] Log value:                None
[16] Activity string:          Playing Nuclear Warfare
[17] Priority:                 DEFAULT
[18] Edit help file

I do not run DLG, but was given this from a DLG Sysop that is currently
running Nuclear Warfare.  If you have questions, contact another sysop
that runs DLG.  The DLG sysop that has contacted me is 615-452-4098.


Skyline 2.0 BBS.

Here's the config string (sysops add this to their menu):

S 1 JMP:NW/NW "|" JMP:SPCEMP/ [Q%cy%c\

"S" = The menu command letter or number to activate the door.
 1   = The EOL option that Space Empire uses (doesn't change)
"JMP:NW/" = The directory the Space files are located.
'"|"' = Where Skyline inserts the User name.
"[Q%cy%c\" = The keys pressed to quit the door ('Q', then 'y').

If you have questions contact:

Dave Cole - Wolverine's Den (616)922-0987 - Official Skyline Support

Falcon BBS:

the falcon Menus.bbs command line for the docs?   >       B CON CFAI
"Doors2:spaceempire/space \"+FULLNAME;\" doors2:s >paceempire/



If you have questions, you can send "The Amiga Zone" 609-953-8159, mail
or ask in your nearest Citadel 68K room.

         Citadel Net:  Amiga or Citadel 68K room on any Citadel
            Internet:  Tony-Preston@cup.portal.com
                       apreston@isd.csc.com

          Snail Mail:  Tony Preston
                       Custom Services
                       P. O. Box 254
                       Moorestown, NJ 08057


History of Changes:

 Version 0.00-0.04 Early release at V0.04 for Beta testing.
         0.05      Fixed minor bug in the computer warfare routine
                   that could cause premature war declarations.
                   Fixed file save bug that caused a problem under
                   AmigaDos 1.3.
         0.06-0.10 Added the ability to abdicate and not kill the
                   player.  Also if A player dies, they may come back!
                   See the nw.cfg for information.  Also added the
                   survivor file and Power Index files.  Fixed a bug
                   in the spy message send so you know who sent the
                   information.  also fixed a message error.
                   Almost ready for the final release..
          1.00     fixed some error messages, fully setup the config
                   file and fixed a couple of minor bugs.
          1.08     Fixed it so you cannot fire at yourself.
                   Fixed an infinite loop if the game was full and
                   a new player entered.
                   Fixed two enforcer hits.
          1.11     fixed the database so it is always long word aligned.
                   fixed a problem with the user name for DLG systems
                   it will truncate to 20 characters.
                   Randomized the player entry(now you never know who
                   is who).
                   Fixed Abdicate and getting killed so you have to wait
                   for a maintenance run before being allowed to play.
          1.12     Corrected some debug output.  Re-wrote the maintenance
                   to be faster.  I have a 40 mhz 68030, I never noticed
                   a delay :).  Now, it is not as randomized, but quite
                   a bit faster.
          1.14     Corrected a bug with new players.  The older version
                   would hang if there were no computer players to replace
                   with the human.  Also speeded up the maintenance and
                   added some progress messages.
                   Randomized the random number generator.
                   made some other minor updates to fix some things.
      1.15-1.17    Adjusted the spy display so it is a little more readable
                   added a lock file feature so that the game protects
                   against more than one person playing at the same time.
                   Added an adjustment to the directory specified for the
                   configuration info, now you can leave off the "/" and
                   it should add it for you.
      1.18-1.25    Several internal releases to improve and change the
                   computer strategies.  There are several types of computer
                   players.  Added in the registration code so that the
                   only thing needed is the registration key.  This way I
                   only have one version to maintain.
      1.26         fixed a few typos.  Enhanced the Computer Players, a
                   couple of bugs in the strategy routine.
      1.27-1.30    fixed a couple of bug in the computer investments
                   routine.  Fixed a bug when a killed player plays and
                   maint. is ran, it never saved the data so maint. ran
                   again for the next player.
                   Fixed a bug where players that were dead or new people
                   when there was no more room were not able to do multiple
                   commands.  The bug caused one command, then exited.