╔═════════════════════════════════════════════════════════════════════════════╗
║  RESOURCE.HLP - SRE Configuration File Help                                 ║
╟─────────────────────────────────────────────────────────────────────────────╢
║  The format of the resource file "RESOURCE.DAT" is the name of the          ║
║  parameter on the left and the value(s) on the right.                       ║
║                                                                             ║
║  Strings can be optionally enclosed in double quotes; SRE reads one WORD:   ║
║  if you put "hello there", it'll read the entire string 'hello there'; if   ║
║  you put hello there, it'll read the first word, 'hello'.                   ║
║                                                                             ║
║  Numbers can be input in decimal, hex (with 0x before the hex number), or   ║
║  octal (with 0 as the first digit).  This is in the format specified by the ║
║  'C' language.                                                              ║
║                                                                             ║
║  Booleans can be false values or true values; false values include 'off',   ║
║  'false', '0', 'f', and 'no'; true values include 'on', 'true', '1', 't',   ║
║  and 'yes'.                                                                 ║
║                                                                             ║
║  Comments start with ";", "%", or "#".                                      ║
║                                                                             ║
║  All of the Boolean resources can be specified on the command line.  For    ║
║  example, you can run any of:                                               ║
║     SRE /SpecialEffects                                                     ║
║     SRE /SpecialEffects=T                                                   ║
║     SRE /SpecialEffects=1                                                   ║
║     SRE /SpecialEffects=Y                                                   ║
║  to turn on special effects; you can run any of:                            ║
║     SRE /NoSpecialEffects                                                   ║
║     SRE /SpecialEffects=F                                                   ║
║     SRE /SpecialEffects=0                                                   ║
║     SRE /SpecialEffects=N                                                   ║
║  to turn off special effects.  You can also use -SpecialEffects instead of  ║
║  /SpecialEffects.  (SRE also respects whatever your switch character may be ║
║  set to.)                                                                   ║
╚═════════════════════════════════════════════════════════════════════════════╝

CheckTimeLimit : Boolean = no
   Would you like SRE to read the time limit from the doorfile?  SRE
   expects the value in minutes; if your value is in seconds, SRE will
   give your users 60 times as much time as they should have.  I will
   add an option if there is a demand for it to take the value in
   seconds instead of minutes.  DORINFO1.DEF and DOOR.SYS both give
   time values in minutes.

LockBaudRate : Number = none
   This replaces SRLOCK.  You can (and probably should) use this to
   tell SRE at which speed your modem is locked.  In the future, SRE
   will use both the unlocked baud rate and the locked baud rate to
   correctly handle special effects.  If you are using multiple lines
   that have different baud rates, you will still need SRLOCK to handle
   that correctly.  (Until I find another solution)

ComN : (port) Number (interrupt level) Number
   You can define Com1 through Com8.  Currently, the SRE modem routines
   only work with IRQ levels 3 and 4.  I'm trying to get them to work
   with other IRQ levels.  (You can try IRQ other than 3 or 4, and see
   if it works -- it might!)  Normally, COM1 through COM4 are already
   defined.  You don't have to mess with this unless your COM port isn't
   the standard port 3F8/2F8/3E8/2E8 with IRQ 3/4/3/4.  Example:
              Com7                    0x3E8 4

TimeOut : Number = 300 seconds
   This is the number of seconds to wait before printing the warning
   "30 seconds before timeout!".  30 seconds past the amount you specify
   here, SRE will return to the BBS.

ExtendedSwapping : Boolean = no
   If this is 'yes', SRE will attempt to swap to extended memory instead
   of disk.  This or ExpandedSwapping will speed up the game a lot.

ExpandedSwapping : Boolean = no
   If this is 'yes', SRE will attempt to swap to expanded memory instead
   of disk.  If both Extended and Expanded options are selected, SRE
   will first try extended, and if that fails, it will try expanded.

StatusBar.Game.Name : String = ""
   If you want some sort of name to show up on the status bar, put it
   here.  This is so that if you run many games, you can 'name' each one
   so that you'll know which one is running by looking at the status bar.
   For example, if you're running a contest, you could write "Contest"
   in this string to have the status bar display that the game is a contest
   game.

Output.Comma : Boolean = yes
   If 'yes', commas are shown for numbers 5 or more digits long.  If 'no',
   no commas are output.

VGA : Boolean = no
   If 'yes', SRE will do VGA effects.  I haven't put too many in yet, but
   if there is a demand, I'll add more later.

BlankLocalScreen : Boolean = no
   If 'yes', SRE will blank the local screen while a remote user is playing
   the game, so that the sysop won't be able to watch the user play.

UserBreak : Boolean = yes
   If 'yes', SRE will allow the user to break out of the program with ^C
   or ^D.  If your users are abusing this feature, you can disable it.

SafeSave : Boolean = yes
   If 'yes', SRE will save the user's data often enough to prevent cheats.
   If 'no', SRE will run faster because it won't be saving 20 times a turn,
   but if a user hangs up or presses ^C (see UserBreak, above) in the middle
   of a turn, he may do nasty things, such as investing in the bank (which
   is saved immediately), and then pressing ^C so that the payment for
   the bonds is not recorded.

SpecialEffects : Boolean = on
   For locked baud rates, it's not always good to keep special effects
   (the pause cursor) on, since it might overflow the modem buffer and
   cause sluggish displays for users on at low speed.  You should try
   leaving it on, and if users complain, then turn it off.

BIOS : Boolean = no
   If you set this to 'yes', SRE will write to the BIOS instead of to
   the screen.  It makes it "well-behaved" according to DesqView and
   MS-Windows.

ANSI : Boolean (or -1) = -1
   The default is -1; if you set 'yes' or 'no', SRE will force ANSI or
   non-ANSI modes.

IBMCharacters : Boolean (or -1) = -1
   The default is -1; if you set 'yes' or 'no', SRE will force output
   of IBM characters or output of only the low part of the ASCII set.
   (If you like to experiment, try running with ANSI, but without
   IBMCharacters to see some unusual combinations!)

LOG : Boolean = no
   If this is 'yes', SRE will write each user's actions into a LOG
   file called SRE.LOG.  It will overwrite the previous SRE.LOG file.
   You can use this in combination with the INSTRUCTIONS parameter
   to save the instructions to a file in ANSI or non-ANSI modes, but
   this is easier to do if you use the command-line parameters.

Local : Boolean = off
   If this is 'on', SRE will force local play, regardless of the COM
   port specified in the doorfile.

╔═════════════════════════════════════════════════════════════════════════════╗
║                        Game-Related Resources                               ║
╚═════════════════════════════════════════════════════════════════════════════╝

Menu : Boolean = no
   If you want the secret Startup Menu, set this to 'yes'.  It's another
   bonus for reading the docs.  :-)

HelpMode : Number = 1
   If this is 0, the help strings are entered by typing in the entire
   string, or pressing <TAB> to complete the word.  If this is 1, the
   topics can be entered by just typing "enough", and it will automatically
   fill in the rest of the word when it can.  If this is 2, the topics
   are typed as far as possible whenever a key is pressed (like pressing
   <TAB> after every key).  You can experiment with this by changing
   the mode here and running "SRE HELP".

Statistics.Top : Number = 25
   If you want SRE STATISTICS to show only the top 10, put a 10 here;
   the default is 25, so it will show everyone in the statistics listings.

Statistics.ShowName : Boolean = yes
   If this is true, SRE STATISTICS will display empire names rather than
   the distribution of planets owned.

Treaty : Boolean = on
   If this is 'off', no diplomacy will be allowed.  Remember that diplomacy
   is required for trading, so trading will be disabled as well.

Treaty.Neutrality       : Boolean = on
Treaty.FreeTrade        : Boolean = on
Treaty.MinorAlliance    : Boolean = on
Treaty.ArmedDefense     : Boolean = on
Treaty.CruiserDefense   : Boolean = on
Treaty.TotalDefense     : Boolean = on
Treaty.Break            : Boolean = on
   These control which treaty options are allowed.  By default, all of
   them are shown on the menu (they are all 'on').

Attacks.Nuclear  : Boolean = yes
Attacks.Chemical : Boolean = yes
   These control (individually) whether nuclear & chemical attacks are
   enabled.  These work ONLY if you've selected "Special Attacks" as
   well, AND you are registered.

Attacks.Maximum : Number = -1
   This is the number of attacks (other than pirate raids) that a player
   may make in each maintenance interval (usually a day).  -1 is no limit.

FoodMarket.Name : String = "the Solar Realm Food Market"
   This is the name of the food market.  It defaults to "the Solar Realm
   Food Market".

Messages : Boolean = yes
   If 'no', messages are disabled.

PlanetsPerTurn : Integer = -1
   If this is defined ( >= 0 ), then the players are limited to buying
   this many planets per turn.

Trading : Boolean = yes
   If 'no', trading is disabled.

Trade.Expire : Integer = 4
   This is the number of days a trading deal can sit there before being
   sent back to the sender.  This prevents empires from keeping their
   items in a trade deal for a long time, because they don't have to pay
   for maintenance while it's in trading.

Scores : Boolean = yes
   If 'yes', after each user plays, the scores are written to SRESCORES.TXT
   (text file) and SRESCORES.ANS (ANSI file).

Sysop.Name : String = "your sysop"
   If you want to customize the game a bit with your name, put your name
   here and you'll show up as a character in the game.

DeleteDeadPlayers : Boolean = yes
   If this is 'yes', the maintenance will delete dead and non-active players
   so that your game will not become cluttered with empires.  If you are
   running a tournament, you may wish to set this to 'no' so that players
   that are dead are left on the scores list.

InactiveTimeOut : Integer = 10
   This is the number of days for which a player can be inactive before
   getting automatically deleted by SRE.  This prevents the game from
   filling up with players that never play.
