home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / oxv111.zip / SYSOP.DOC < prev    next >
Text File  |  1994-06-17  |  42KB  |  809 lines

  1.                          IRON OX Version 1.11
  2.                     (C)opyright 1994, Joel Downer
  3.  
  4.                                SUMMARY
  5.  
  6. Iron Ox is an interactive, multiuser strategy game for 3-8 players.  The 
  7. game concept is the development of an outer space colony world:  Players
  8. claim land, produce goods, buy, sell, and steal from one another, and 
  9. prospect for luxite, the precious mineral that allows interstellar travel.  
  10. The door supports up to 255 simultaneous games involving up to 255 active 
  11. players.  
  12.  
  13. Iron Ox is self-maintaining (no nightly maintenance event), and includes 
  14. "sysop-friendly" features such as:
  15.  
  16. * detection and timeslicing for DESQview,
  17. * built-in multinode support and semaphoring (so several people can use
  18.   the door at one time),
  19. * support for a wide variety of door drop files (including DOOR.SYS,
  20.   DORINFO?.DEF, EXITINFO.BBS, CHAIN.TXT, CALLINFO.BBS, and SFDOORS.DAT),
  21. * support for direct serial communications or FOSSIL, and
  22. * comprehensive high-score and record listing with optional ANSI, ASCII,
  23.   and WC-code bulletins.
  24.  
  25. The game includes lighthearted humor -- for example, the colony sponsors
  26. "cultural contests" in which players can write bad poetry or disgusting
  27. recipes -- but it also supports complex strategy and intense
  28. competition.  The door requires that players have ANSI terminals, but
  29. does not require a color monitor.
  30.  
  31.                           EVALUATION VERSION
  32.  
  33. Iron Ox is distributed in an evaluation version, intended for you to try 
  34. out for thirty days.  The evaluation version of Iron Ox is a complete 
  35. and (I hope) enjoyable game.  If you like Iron Ox and wish to continue 
  36. using it after thirty days, please see "LICENSING/REGISTRATION 
  37. INFORMATION," below, for details on how to register.  A registration key 
  38. for Iron Ox will enable additional features that will make the game even 
  39. more exciting for your users!
  40.  
  41.                            GETTING STARTED
  42.  
  43. Iron Ox is a game that requires multiple players, so you won't be able 
  44. to take a very thorough "test drive" without putting it up for play on 
  45. your BBS.  If you want to take a look at the door before installing it, 
  46. though, you can run the program just by typing IRONOX -LOCAL from the 
  47. directory where you have unpacked the archive.
  48.  
  49.                               REQUIREMENTS
  50.  
  51. Iron Ox requires approximately 420K of free RAM to run properly.  It
  52. requires a minimum of 750K free disk space.  Depending on the number of
  53. active games you have going on at a time, it can take up as much as 
  54. 1,500K of disk space.  A hard drive is strongly recommended; on the
  55. other hand, if you're running a BBS without one, the performance of Iron
  56. Ox is probably the least of your worries. <g>
  57.  
  58. Beginning with version 1.10, Iron Ox includes internal comm routines,
  59. with support for non-standard IRQ's and for rates of up to 115Kbps, as
  60. well as support for a FOSSIL driver.  However, support for some
  61. specialized requirements (DigiBoards, shared IRQ's) is provided only
  62. through the FOSSIL standard.  Recent versions of several popular FOSSIL
  63. drivers are available through the systems listed in "Support," below.
  64.  
  65.                            INSTALLING IRON OX
  66.  
  67. I've learned to be very suspicious when door documentation says "This 
  68. door is very easy to set up," so I won't say that.  I'll let you judge 
  69. for yourself.
  70.  
  71. Iron Ox is an extremely flexible and configurable program, so this 
  72. section may be longer than you're used to.  If all you want to do is get 
  73. the game running with a basic setup, though, you'll only need to read 
  74. the first few paragraphs and spend about five minutes.  If you have any
  75. trouble, see "COMMON INSTALLATION PROBLEMS," below.
  76.  
  77. Installing Iron Ox involves three steps:
  78.  
  79. 1. Decompressing the Iron Ox archive into a door directory.  The 
  80.    examples in this file and the sample batch file assume that you have 
  81.    used the directory C:\DOOR\IRONOX\, but any directory will do.
  82.  
  83. 2. Renaming the file called SAMPLE.CFG to the name IRONOX.CFG.
  84.    Alternatively, you can run the program OXConfig to create a custom
  85.    configuration file (e.g., if you want to have high score bulletins).
  86.  
  87. 3. Creating a batch file by which your BBS can start Iron Ox.  Most of
  88.    the time, this batch file will include only one line:
  89.  
  90.    C:\DOOR\IRONOX\IRONOX.EXE
  91.     
  92.    (Note:  Substitute the path where you have installed the game for
  93.    C:\DOOR\IRONOX\ in the above example.)
  94.  
  95.    The game supports several command-line arguments, but you are likely
  96.    only to need those arguments if:
  97.  
  98.    (a) you don't run a FOSSIL driver and you want to specify things like
  99.        non-standard IRQ's.
  100.  
  101.    (b) you are running multinode with BBS software that doesn't include
  102.        the node number in the door information file, or
  103.  
  104.    (c) you use a number of different door drop files, and you want to
  105.        tell Iron Ox which one to use.
  106.  
  107.    In general, the considerations listed under (b) and (c) don't come up
  108.    for systems using DOOR.SYS, SFDOORS.DAT, CHAIN.TXT, or CALLINFO.BBS.
  109.    They are more likely to be issues for people running DORINFO systems.
  110.  
  111. You're ready to add the game to your BBS door menu and get rolling.  Enjoy!
  112.  
  113.  
  114.                          COMMAND-LINE ARGUMENTS
  115.  
  116. Iron Ox supports a number of command-line parameters.  If the
  117. documentation for any of these makes your eyes glaze over, your best bet
  118. is to skip over to the next one.  Chances are that if you don't
  119. understand it, you also don't need it.
  120.  
  121. /ACCEPT      This option tells Iron Ox not to mess with the
  122.              communications parameters currently set for your comm port
  123.              -- to open the port (or the FOSSIL driver, if appropriate)
  124.              as it stands.  It is intended to help people whose systems
  125.              do not respond correctly when a door program attempts to
  126.              reset communications parameters.  Advice:  Assume you
  127.              *DON'T* need this option unless the game doesn't work
  128.              without it.
  129.  
  130. /EDIT        This option activates the Game Editor subsystem, so that
  131.              games may be (E)dited as well as (S)tarted, (J)oined, and
  132.              (P)layed.  See "THE EDITOR," below.  WARNING:  This option
  133.              is *NOT* keyed to security level!  Do not use this option
  134.              for your normal door batch files unless your goal is to set
  135.              up a "Fantasy Game" or "Workshop" rather than a real game.
  136.  
  137. /LOCK        This option allows you to lock the bps rate Iron Ox uses to
  138.              communicate with your modem to a speed other than the one
  139.              specified in your door information file.  Example:
  140.  
  141.              IRONOX /LOCK:19200
  142.  
  143.              This option is only effective if you are using the internal
  144.              comm system (port-locking for FOSSIL drivers should be
  145.              controlled through FOSSIL driver setup).
  146.  
  147. /N:          This option allows you to indicate the current node number
  148.              when the game is run on a multinode system.  Example:
  149.  
  150.              IRONOX /N:3
  151.  
  152.              Note:  On most systems, the node number is included in the
  153.              door drop file and *THIS OPTION IS NOT NEEDED*.  The most
  154.              common systems where you *will* want to use this option are
  155.              DORINFO1.DEF BBS packages like RemoteAccess.
  156.  
  157. /NOFIFO      Some Western Digital 16550 cards have a bug that causes
  158.              them to lock up when their FIFO buffers are used.  This
  159.              flag tells Ox to disable its use of FIFO buffers.  Note:
  160.              If you've never heard of this FIFO bug before, assume that
  161.              it *DOESN'T* apply to you and do not use this option!  If
  162.              the problem applied to you, you'd know by now. <g>
  163.  
  164. /NOFOSSIL    If you *have* a FOSSIL driver, but do *not* wish to use it,
  165.              this flag will tell the game to ignore the driver and use
  166.              internal comm instead.  This option may be useful if you
  167.              are having problems with Iron Ox's FOSSIL support.  Note:
  168.              If you do not have a FOSSIL, you do not need this option --
  169.              Iron Ox will automatically default to internal comm if it
  170.              does not find a FOSSIL.
  171.  
  172. /P, /I       These options allow you to set the hexadecimal base address
  173.              and the IRQ number for a non-standard serial port.  Example:
  174.  
  175.              IRONOX /P:3F8 /I:4
  176.  
  177.              indicates that the game should use base address 3F8h, and
  178.              IRQ4 for serial I/O.  These arguments are *ONLY* needed if
  179.              you are using internal serial support; they are ignored if
  180.              you have a FOSSIL installed and have not used the /NOFOSSIL
  181.              argument.  Note:  The AT IRQ lines (9-15) are *NOT*
  182.              supported using these arguments.  Support for the AT IRQ's
  183.              is only available through a FOSSIL driver.
  184.  
  185. [pathname]   By default, Iron Ox looks for a door drop file in the
  186.              current directory -- it expects to be run from the node
  187.              work directory, as described above.  Also by default, it
  188.              will autodetect which dropfile to use by checking the
  189.              directory for the most current dropfile it supports (i.e.,
  190.              it does freshness-testing to avoid using stray dropfiles).
  191.  
  192.              You can specify the path where Iron Ox should look for its
  193.              dropfile and (if necessary) the name of the dropfile to
  194.              use.  Thus:
  195.  
  196.              C:\DOOR\IRONOX\IRONOX.EXE C:\WC30\WCWORK\NODE1\
  197.  
  198.              or, alternatively
  199.  
  200.              C:\DOOR\IRONOX\IRONOX.EXE C:\QBBS\DORINFO3.DEF
  201.  
  202.              Note:  This command-line option is usually not necessary.
  203.  
  204.                          MULTINODE SETUP
  205.  
  206. Iron Ox was written and tested from the ground up to run multinode. In
  207. general, multinode setup is *identical* to single-node setup:  All nodes
  208. can use the same configuration file, and (for the most part) they can
  209. use the same batch file, too.  Because the program supports FOSSIL
  210. drivers, it can handle issues like non-standard IRQ's *completely
  211. automatically* -- no need to treat individual nodes specially on FOSSIL
  212. systems.
  213.  
  214. Multiple players can use this door at the same time; Iron Ox handles all 
  215. file locking internally.  (Note:  The file-locking system supports node
  216. numbers up to about 1,000 -- if you need higher ones, contact me and I'm
  217. sure we can work *something* out. <g>)  The only requirement for running
  218. the game multinode is that you must be running DOS SHARE or some
  219. equivalent (like the built-in file-sharing in the OS/2 DOS box or the
  220. file-sharing facilities on LANs).  If you're running multinode *without*
  221. such a utility, of course, now would be a good time to start.
  222.  
  223. To set up the game for multinode play, create batch files for each node 
  224. along the lines in the single-node instructions, above.  The only times
  225. different nodes will need *different* batch files are
  226.  
  227. (a) when the game is run across a LAN on which the drive letter for the
  228.     game directory is different for different nodes, and
  229.  
  230. (b) when you are running nodes with non-standard IRQ's and you are *NOT*
  231.     using a FOSSIL driver.
  232.  
  233. (If you are running a multiline system where the node number is not
  234. included in the door information file, like RemoteAccess with
  235. DORINFO1.DEF, you will either need to use multiple batch files or use an
  236. environment variable to specify the node number with the /N option.  See
  237. "COMMAND-LINE ARGUMENTS," above.)
  238.  
  239. One more thing:  Because of a bug with either Borland's run-time
  240. libraries or with Quarterdeck's products (who's to blame for the bug 
  241. depends on whether you ask Borland or Quarterdeck <g>), you may find 
  242. that you need to flag your IRONOX.EXE executable file read-only to avoid 
  243. sharing violations when running multinode under DESQview or QEMM.  To 
  244. do this, just use the command ATTRIB IRONOX.EXE +R after unpacking the 
  245. game into your door directory.  If you ever need to uninstall Iron Ox,
  246. you can use the command ATTRIB IRONOX.EXE -R to "unflag" the file.
  247.  
  248. That's all it takes!  Iron Ox uses lock files to control simultaneous 
  249. use of files, so resources may remain locked if the system crashes while 
  250. someone is in the door.  However, each node will clear all of its locks 
  251. every time it enters or exits the door normally, so "lingering locks" 
  252. will be cleared automatically shortly after they arise.  If you have a 
  253. system that crashes frequently, adding a line like "DEL C:\DOOR\IRONOX\*.L*" 
  254. to your AUTOEXEC.BAT file will clear all locks immediately when the 
  255. computer reboots.
  256.  
  257.  
  258.                   COMMON INSTALLATION PROBLEMS
  259.  
  260. The most common mistake sysops make installing this program is trying 
  261. to get too fancy.  Don't copy your door information file to the game 
  262. directory.  Don't specify the dropfile path on the command line for 
  263. the game unless the game doesn't work without it.  Don't add a line to
  264. your batch file that changes to the game directory before execution.
  265. Don't add the game to your path.  Just create a batch file that looks
  266. like the one in "INSTALLING IRON OX," above.  Keep it simple.
  267.  
  268. Here are some installation problems that might come up:
  269.  
  270. 1. The game says it can't find my door dropfile!
  271.  
  272.    This game assumes that you are running it from the directory where 
  273.    your BBS dropfile is located.  Every BBS package I know of normally 
  274.    launches door execution from the directory where the dropfile is 
  275.    located, but if yours doesn't, you will need to specify the dropfile 
  276.    location and/or name on the command line.
  277.  
  278. 2. The game works fine locally, but doesn't work over a modem!
  279.  
  280.    If you are having trouble getting the internal serial support to
  281.    work, one good solution is to try a FOSSIL driver.  FOSSIL drivers
  282.    are an excellent choice for high-performance communications, and can
  283.    (if you wish) be loaded and unloaded from the batch file that
  284.    executes Iron Ox.  If you do not have a FOSSIL driver, they are
  285.    available from the systems listed under "Support," below, among many
  286.    other places.
  287.  
  288.    If you don't wish to use a FOSSIL, or if you're already *using* a
  289.    FOSSIL and are still having problems, the /ACCEPT, /LOCK, /P and /I
  290.    options explained in the section on command-line arguments may help
  291.    with the problem.  If not, feel free to contact me for further
  292.    assistance.
  293.  
  294. 3. I have a high-speed modem.  When low-speed callers go into the game, 
  295.    all they see is garbage on the screen!
  296.  
  297.    If you are using a FOSSIL, try locking the baud rate at which your 
  298.    computer talks to your modem (the docs for your FOSSIL driver will 
  299.    explain how to do this).  High-speed modems generally perform better 
  300.    when used with a locked port, and the combination of high-speed
  301.    modem, low-speed connect, and unlocked FOSSIL driver can cause
  302.    problems with this and some other doors.
  303.  
  304. 4. The game runs fine single-node, but if two people try to go in at 
  305.    once, I get a sharing violation!
  306.  
  307.    As I say in the section on multinode setup, either my compiler or 
  308.    Quarterdeck's products have a bug that causes sharing violations when 
  309.    you try to run an overlaid program multinode.  The work-around for 
  310.    this problem is to flag your IRONOX.EXE file read-only using the 
  311.    command ATTRIB IRONOX.EXE +R.  Even if you aren't using a Quarterdeck 
  312.    product like DESQview or QEMM, give this solution a try:  Odds are
  313.    good it'll correct the problem completely.
  314.  
  315. 5. The game is getting confused about what node it's running on!
  316.  
  317.    Iron Ox is designed to figure out the node ID on which it's running 
  318.    from the BBS drop file.  On some systems, however, determining the 
  319.    node ID from the drop file is not possible.  See the documentation
  320.    for the "/N" command-line parameter, above.
  321.  
  322.                            USING THE EDITOR
  323.  
  324. Iron Ox comes with a complete, built-in editor for general game
  325. statistics, players, the map, the general store, and contest entries.
  326. To simplify your remote maintenance tasks, this editor is coded to work
  327. through a modem as well as in local mode.  In the unregistered version
  328. of the game, the editor is "read-only"; in the registered version, you
  329. will be able to modify any of the information listed above.
  330.  
  331. To activate the editor, all you need to do is load the game with the
  332. /EDIT command-line flag.  The option to (E)dit a game will show up
  333. alongside the options to join, start, and play games.
  334.  
  335. IMPORTANT NOTE:  The option to edit games is *NOT* keyed to security
  336. level!  Therefore, you would not normally want to configure your batch
  337. files to load Iron Ox with the /EDIT parameter.  The only time you would
  338. want to make the editor available to players is if you were running some
  339. sort of a practice door or fantasy game.
  340.  
  341. The recommended use for the editor is to set it up as a separate menu
  342. option, and to key this menu option to an access level that will make it
  343. unavailable to anyone but you.  The editor uses the same file locking
  344. conventions as the game, so using the editor while someone else is
  345. online will not cause problems.
  346.  
  347. For the most part, the options in the editor are self-explanatory.  Here
  348. are a few notes about features that may not be:
  349.  
  350.                             Global Settings
  351.  
  352. Game Month         The game will not allow you to use this option to
  353.                    force a game to begin (i.e., when it is waiting for
  354.                    players) unless the game already has at least three
  355.                    players.
  356.  
  357.                               Map Editor
  358.  
  359. Volume of Luxite   This value determines the highest amount of luxite
  360.                    that can normally be produced by the plot in a given
  361.                    month (in other words, if the value is 5, the range
  362.                    will be 0 - 5).  Setting the value over 18 or so will
  363.                    probably make for silly production values.  Setting
  364.                    it over 25 will seriously imbalance the game in favor
  365.                    of the owner of the plot (if not a Rubblemuncher <g>).
  366.  
  367. "For sale"         This option is for corrective maintenance -- i.e., if
  368.                    the game won't let a player sell land because it
  369.                    thinks the land is already for sale.  I can think of
  370.                    no good reason to use this option at other times.
  371.  
  372.                              Player Editor
  373.  
  374. Is Character Dead  This option provides a quick-'n-handy way to kill or
  375.                    resurrect characters.  Be forewarned, however, that
  376.                    when when a character dies, all of his/her property
  377.                    is seized; resurrecting the character doesn't restore
  378.                    the property.  Please use this feature judiciously.
  379.  
  380. Last Turn Played   This value, combined with the game month, determines
  381.                    whether a player will be allowed into the game.  If
  382.                    you need to reset a player's session, the normal way
  383.                    to do so would be to adjust this value and set the
  384.                    "Claimed Land" variable to FALSE.
  385.  
  386.                           CONFIGURING IRON OX
  387.  
  388. The easiest way to fine-tune the configuration for your Iron Ox game is
  389. to run the utility called OXCONFIG.EXE, included in your IRONOX
  390. distribution archive.  OXCONFIG will let you adjust all options,
  391. explaining the function, default, and recommended value for each option.
  392.  
  393. OXCONFIG produces a file called IRONOX.CFG, which resides in the same
  394. directory as IRONOX.EXE.  In case you prefer using an ASCII text editor
  395. to fiddling with configuration programs, the following section documents
  396. the variables that appear in IRONOX.CFG and outlines how to modify them
  397. to change your configuration manually.
  398.  
  399. Keyword     Default           Function
  400.  
  401. SysopName    No One     This keyword determines the name that will be 
  402.                         used when the game describes who it belongs to.  
  403.                         If you decide to register this game, you will 
  404.                         need to enter your name here exactly as it 
  405.                         appears in your registration letter.  This 
  406.                         keyword is ignored in unregistered games.
  407.  
  408. BBSName   Unregistered  This keyword determines the system name that 
  409.                         will be used when the game describes the BBS to 
  410.                         which it is registered.  See "SysopName," above.
  411.  
  412. RegCode      (blank)    This is where you would insert the key code, 
  413.                         available from the author, that will activate the 
  414.                         "registered-only" features of the game.  See 
  415.                         "LICENSING/REGISTRATION INFORMATION," below.
  416.  
  417. Timeout       360       This keyword determines the amount of time, in 
  418.                         seconds, that the game will wait between keystrokes 
  419.                         before it decides that a user is "sleeping at the 
  420.                         keyboard" and boots him/her out.  This game can 
  421.                         require thought, so substantially reducing this 
  422.                         number is not recommended.  Note:  Timeout is 
  423.                         automatically disabled when the game is run in 
  424.                         local mode.
  425.  
  426. MaxGames       3        This keyword determines the maximum number of 
  427.                         games a player can participate in at one time.  
  428.                         Allowing players to participate in multiple 
  429.                         games will increase interest, but setting this 
  430.                         value too high would give high-speed callers a 
  431.                         big advantage in the monthly standings.  Note:  
  432.                         This keyword is ignored (hardcoded to 3) in the
  433.                         evaluation version of the game.
  434.  
  435. MinGameLength    14     In the registered version of Iron Ox, players
  436. MaxGameLength    14     may select games shorter or longer than 14
  437.                         turns.  These variables set bounds on game
  438.                         length.
  439.  
  440.                         Because all-time records are less meaningful
  441.                         when the door is configured to allow very long
  442.                         games, and the game can less entertaining if it
  443.                         continues long after all land is claimed, 14
  444.                         turns is recommended both for Minimum Length and
  445.                         Maximum Length.  Allowing games shorter than ten
  446.                         or longer than eighteen turns is discouraged.
  447.  
  448. ResetType               The allowed values for this variable are
  449.                         RESET_MONTHLY, RESET_DAYS, and RESET_DATE.  By
  450.                         default, the cumulative high scores for Iron Ox
  451.                         reset on the first of each month (i.e.,
  452.                         RESET_MONTHLY).  Choosing RESET_DAYS will cause
  453.                         the scores to reset every specified number of
  454.                         days.  Choosing RESET_DATE will cause the scores
  455.                         to reset on a fixed date.  These alternative
  456.                         options are most useful for organizing
  457.                         tournaments.  See the variables "ResetDays" and
  458.                         "ResetDate," below.  Note:  This option only
  459.                         affects cumulative scores.  The actual ongoing
  460.                         games never need to be reset or interrupted.
  461.  
  462. ResetDays               If you chose to reset every fixed number of days
  463.                         (see ResetType, above), this variable controls
  464.                         the number of days between score resets.  The
  465.                         value entered should be a positive whole number,
  466.                         e.g., 30 or 90.
  467.  
  468. ResetDate               If you chose to reset on a fixed date, this
  469.                         field controls the day for score reset.  Enter
  470.                         full month name, followed by day and year, thus:
  471.  
  472.                         January 1, 1995
  473.  
  474.                         This option is excellent for managing
  475.                         tournaments, because the reset date is displayed
  476.                         prominently in the high score screen.
  477.  
  478. StartGames    TRUE      This keyword determines whether players are 
  479.                         allowed to begin new games.  The only time you 
  480.                         would be likely to set this value to FALSE would 
  481.                         be if you were winding down a tournament with a 
  482.                         fixed duration.
  483.  
  484. Secure        FALSE     If you (the sysop) are playing in games, you 
  485.                         might not want to watch as other people play 
  486.                         their turns in the games in which you're 
  487.                         involved -- you could see something that would 
  488.                         give you an unfair advantage.  Setting Secure to 
  489.                         TRUE will cause the game to blank the local screen 
  490.                         when a remote player is playing in a game in 
  491.                         which zero-baud (local) players are involved.
  492.  
  493. NoLog         FALSE     This option allows you to disable the game's 
  494.                         automatic logging feature, which records basic 
  495.                         game events and errors in one or more files 
  496.                         called OX????.LOG (where the question marks are
  497.                         replaced by the node number).  Turning off 
  498.                         logging can save some disk space, but it can 
  499.                         also make problem-solving more difficult.  
  500.                         Recommended setting is FALSE (does not disable 
  501.                         the log).
  502.  
  503. ANSI_Score    (blank)   This keyword determines the name and path of the 
  504.                         ANSI Score bulletin the game will create.  Leaving 
  505.                         the space after the keyword blank, as it is in the 
  506.                         sample configuration file, indicates that you 
  507.                         want the game to create *NO* ANSI score bulletin.
  508.  
  509. ASCII_Score   (blank)   Name and path of the ASCII high score bulletin.
  510.  
  511. WC_Score      (blank)   Name and path of score bulletin using Wildcat!-
  512.                         style @ codes.
  513.  
  514. ANSI_Records  (blank)   Name and path of the ANSI all-time-records bulletin.
  515.  
  516. ASCII_Records (blank)   Name and path of the ASCII records bulletin.
  517.  
  518. WC_Records    (blank)   Name and path of the WC-style records bulletin.
  519.  
  520. DailyPrize       0      You may configure the game to award a daily, weekly, 
  521.                         and/or monthly time prize to the current leader in 
  522.                         the standings.  A value of 0 disables time prizes.  
  523.                         Time prizes are disabled in the unregistered version 
  524.                         of Iron Ox.
  525.  
  526.                         Here are some guidelines on prizes:  the prizes
  527.                         should go from very small (daily) to fairly
  528.                         generous (monthly).  Values of five minutes for
  529.                         daily, ten for weekly, and thirty for monthly
  530.                         might be reasonable.
  531.  
  532.                         Note:  Time prizes only work on systems that reread
  533.                         their door dropfiles on return from a door to 
  534.                         determine remaining time, like Wildcat! 3.x, 
  535.                         RemoteAccess, and so forth.
  536.  
  537. WeeklyPrize      0      See DailyPrize, above.
  538.  
  539. MonthlyPrize     0      See DailyPrize, above.
  540.  
  541. Note:  if you leave the name of any particular bulletin blank, or do not 
  542. include the keyword for it in the configuration file, that bulletin will 
  543. not be created.
  544.  
  545.                               ERRORLEVELS
  546.  
  547. In case your BBS software reads and uses errorlevels on door exit, here 
  548. are the errorlevels Iron Ox returns:
  549.  
  550.      0   -   Critical Error has occurred!
  551.      1   -   The user has dropped carrier.
  552.      2   -   The sysop has terminated the call; user off-line.
  553.      3   -   User time has expired; still on-line.
  554.      4   -   Keyboard inactivity timeout; user off-line.
  555.      10  -   Normal exit; user on-line.
  556.     255  -   Program integrity problem; please check log and contact me!
  557.  
  558.                     LICENSE/REGISTRATION INFORMATION
  559.  
  560. This program is copyrighted shareware.  You are licensed to try this 
  561. program for up to thirty days.  After 30 days, if you elect to continue 
  562. using Iron Ox, you must register.  The game costs only $20 (see 
  563. REGISTER.FRM for information on shipping and delivery options).  
  564.  
  565. Note:  If your registration for Iron Ox is postmarked *BEFORE SEPTEMBER 1,
  566. 1994*, you will receive a five-dollar discount on your registration!
  567.  
  568. The registered version of Iron Ox includes the following enhanced features:
  569.  
  570. 1. OX FACTORY:  Your colonies will no longer have to rely on the supply 
  571.    of oxen provided at the beginning of the game.  The game will use 
  572.    ore from the store to make more.
  573.  
  574. 2. EXTRA RACES:  In registered versions of the game, three extra,
  575.    specialized races are available to players:  the Photovore, a
  576.    sunlight-eating alien who specializes in plants and energy-making,
  577.    the Rubblemuncher, an amazing ore-miner who's allergic to luxite, and
  578.    the Metamorph, a creature who can actually *change shape* and assume
  579.    the abilities of different races during the course of the game.
  580.  
  581. 3. MORE GAMES PER PLAYER:  In the evaluation version, players are
  582.    allowed to play in three games at a time.  In the registered version,
  583.    you may set this value as low or as high as you like.
  584.  
  585. 4. TIME PRIZES:  If you own the registered version and use BBS software 
  586.    that "reads back messages" from doors, you can set (totally optional) 
  587.    daily, weekly, and/or monthly time prizes for the leaders in the 
  588.    standings!  This feature works on Wildcat!, RemoteAccess, Apex, 
  589.    QuickBBS, and many other systems.
  590.  
  591. 5. FULLY ACTIVE EDITOR:  In the unregistered version, the editor is
  592.    "read-only."  Registration allows you to adjust values as well as
  593.    view them.
  594.  
  595. 6. CONFIGURABLE GAME LENGTH:  In the registered version, your players
  596.    can choose games shorter or longer than 14 turns (you set the bounds
  597.    for the shortest and longest games allowed).  Great for boards where
  598.    users want to "play to the death." <g>
  599.  
  600. 7. TROJAN OXEN:  Trojan Oxen are a valuable defense against sabotage:
  601.    They look like ordinary oxen, but *fight back* if attacked.  Very
  602.    helpful in cutthroat games.
  603.  
  604. Please see REGISTER.FRM to find out how to register your copy of Iron Ox.  
  605. Iron Ox is the product of over a thousand hours of work.  I am committed 
  606. to supporting and improving Iron Ox (see "Future Plans" for some 
  607. indication of what I have in mind), but I need your help to continue 
  608. developing enhancements and new features.
  609.  
  610.                        ADDITIONAL LICENSE INFO
  611.  
  612. You are allowed (and encouraged) to distribute unmodified copies of 
  613. Iron Ox so long as you distribute the complete archive with all files 
  614. intact.  You may include unmodified, complete archive versions of the 
  615. shareware edition of Iron Ox in software collections (e.g., CD-ROMs) 
  616. so long as the documentation for the collection clearly indicates that 
  617. it contains shareware products and that the purchase of the collection 
  618. does not constitute a license for the use of said products.
  619.  
  620. Registration of this product entitles you to a unique registration code
  621. keyed to your name and the name of your BBS.  This key will allow you
  622. and your system's users to access the registered-only features of the
  623. program, and will deactivate all messages to the effect that the program
  624. is an "Unregistered Evaluation Copy."  Your registration is good for all
  625. future releases of Iron Ox:  If I should ever need to change the key
  626. system, you as a registered user will be entitled to receive a working
  627. new key via U.S. Mail or electronic mail.  Registrations are
  628. non-transferable without my direct permission.
  629.  
  630.                               SUPPORT
  631.  
  632. I am anxious for your feedback and ideas.  If you have problems getting 
  633. Iron Ox to run, please feel free to contact me.
  634.  
  635. I can be reached via crashmail or routed netmail at Fidonet address 
  636. 1:202/704, DoorNet address 75:7619/7, and NeverNet address 42:100/107.
  637.  
  638. The support BBS for Iron Ox, and for all games by Joel Downer and 
  639. Meerkat Software Concepts, is The Dreaming City.  The Dreaming City 
  640. has two lines:
  641.  
  642. Node 1:  USR Dual HST 14.4/ v.32 9600    (619) 462-8406
  643. Node 2:  ZyXEL 16.8 v.32bis              (619) 462-7146
  644.  
  645. I monitor the Fidonet DOORWARE, DOORGAMES and ON_LINE_GAMES conferences,
  646. the San Diego NET202_IRONOX echo, and the NeverNet NN_IRONOX echo.  I
  647. will attempt to reply promptly to echo messages, netmail messages, and
  648. messages in the IRONOX support conference on my BBS.
  649.  
  650. As of 5/25/94, I am working to get an IRONOX echo on the Fidonet
  651. backbone.  Request IRONOX from your Fidonet echomail hub for what I hope
  652. will be an excellent source of support and a great place for players to
  653. exchange information about the game.  If IRONOX is not yet available
  654. when you read this documentation, please ask your NEC to request that
  655. your REC approve it for backbone status!
  656.  
  657. I can be reached via the Internet as joel@dreamcty.jd.com.  For those
  658. with Internet access, this approach may provide the fastest and most
  659. reliable method of reporting problems or providing feedback except
  660. Fidonet crashmail.
  661.  
  662.                      IRON OX DISTRIBUTION SITES
  663.  
  664. The following bulletin board systems are official distribution sites 
  665. for Iron Ox and any necessary companion programs.  Note:  this 
  666. information was compiled in May, 1994; some of these telephone numbers
  667. will change over time.  If you find that the numbers listed for systems
  668. in your area are no longer accurate, you may be able to find up-to-date
  669. information in a current FidoNet nodelist.
  670.  
  671. BBS System         Fido Addr   Telephone     Modem        Where
  672.  
  673. The Dreaming City  1:202/704   619-462-8406  USR Dual     La Mesa, CA
  674. TDC 2              1:202/705   619-462-7146  16.8 V.32bis La Mesa, CA
  675. Alien Biker Kat    1:202/1010  619-277-4140  V.32bis      San Diego, CA
  676. Common Sense       1:161/705   510-713-7336  V.32bis      Newark, CA
  677. Comp. Connection   1:157/574   216-671-2574  21.6 Dual    Cleveland, OH
  678. The Harry Beast    1:343/102   206-859-6157  16.8 V.32bis Kent, WA
  679. Hole in the Wall   1:104/651   303-841-5515  16.8K Dual   Parker, CO
  680. Holston River Vlly 1:3615/42   615-932-1490  16.8 Dual    Knoxville, TN
  681. Holston 2          1:3615/43   615-932-1492  16.8 Dual    Knoxville, TN
  682. Land of Gypsy's    1:105/18    503-297-0626  V.32bis      Portland, OR
  683. Mayberry BBS       1:3663/302  910-789-8183  28.8 Hayes   Mt. Airy, NC 
  684. Programming Link   1:301/3     505-822-8944  V.32bis      Albuquerque, NM
  685. SHC Editor's       1:202/1819  619-563-1598  16.8 Dual    San Diego, CA
  686. The Sperm Bank     1:2604/203  201-847-0797  28.8 Zoom    Wyckoff, NJ
  687. Test Pattern BBS   1:259/524   905-890-2531  USR Dual     Ontario, Canada
  688. Unknown Gateway    1:318/7     505-784-3275  V.32bis      Clovis, NM
  689. Ruby's Joint       1:135/373   305-856-4897  28.8 Hayes   Miami, Florida
  690.  
  691. The following files will be available for download, and for FREQ using
  692. the magic names listed, from all of the distribution sites.  The sites
  693. will carry the latest version of Iron Ox and any support programs by
  694. Joel Downer.  Versions of support programs by other authors will be
  695. recent but are not guaranteed to be the latest.
  696.  
  697. Magic Name       Description
  698.  
  699. IRONOX           The Iron Ox doorgame.  (Surprised? <g>)
  700. X00              A recent version of the X00 FOSSIL driver.
  701. BNU              A recent version of the BNU FOSSIL driver.
  702. SIO              A recent version of Ray Gwinn's FOSSIL for OS/2.
  703. OXECHO           Information on picking up the Iron Ox support echo.
  704.  
  705.                             FUTURE PLANS
  706.  
  707. I am committed to supporting this program.  When and if I receive 
  708. reports of bugs, I will do my best to fix them and release updates 
  709. in a timely fashion.
  710.  
  711. I am currently testing a native OS/2 version of this program.  Iron Ox/2
  712. will include all of the features of Iron Ox for DOS, and will be a true
  713. 32-bit, multithreaded executable.  Ox/2 should provide substantially
  714. improved performance both for native OS/2 BBS systems and for DOS
  715. systems running under OS/2's DOS compatibility.  Registered owners of
  716. Iron Ox for DOS will be able to request a registration key for Iron Ox
  717. for OS/2 at no cost.
  718.  
  719. I also am planning to add new features and enhancements to the game -- 
  720. which and how many depending on the feedback and level of enthusiasm 
  721. I encounter in the BBS community.  Here are some examples of additions 
  722. that I am *considering* for future versions:
  723.  
  724. 1. The option to steal from the Bank or the General Store.
  725.  
  726. 2. Sysop-editable, variable messages for common game events (Received
  727.    from the Colony Physician:  "If you need to spew, spew into this!").
  728.  
  729. 3. A "depletion" feature by which players can exhaust the ore and/or
  730.    luxite in mining squares.
  731.  
  732. 4. Full RIP graphics support, including a graphics-mode map with icons
  733.    and mousable game menus.
  734.  
  735. 5. Support for multi-BBS "tournament mode."
  736.  
  737. 6. Computer-controlled players with configurable levels of skill.
  738.  
  739. Your feedback will help to determine which and how many of these 
  740. features (and which features that *aren't* listed here) appear in future 
  741. versions of Iron Ox.  Needless to say, your support will also make it 
  742. possible for me to continue work on this program.
  743.  
  744.                              DISCLAIMER
  745.  
  746. I make no warranty of any kind regarding the usefulness, reliability,
  747. merchantability, or fitness of this software and documentation for any
  748. purpose whatsoever.  While I have tested this program thoroughly, I
  749. cannot and will not make any promises that the program will run well or
  750. safely on your hardware or with your particular software configuration.
  751. This software is guaranteed only to take up disk space, and I make no
  752. absolute guarantee that it will even do a reliable job of that. <g>
  753.  
  754. Your use of Iron Ox and/or any companion material constitutes your 
  755. acceptance of these terms.
  756.  
  757.                           ACKNOWLEDGEMENTS
  758.  
  759. As Iron Ox has been my first doorgame programming effort, I owe thanks to 
  760. many people for helping me through the process.  Special thanks go to 
  761. Dan Roseen and Albin Gersich, two key beta sysops who also have 
  762. provided OpenDoors code patches and other programming suggestions that 
  763. have made this work much easier.  Thanks to all of the version 1.00 beta
  764. team, who, in addition to Dan and Albin, included:  Marty Bogle, Jim
  765. Chapman, Randy Culler, Brenda Donovan, Dave Foy, Paul Fusco, Dan Harvey,
  766. Bud Jamison, and Christian Jones.  Thanks, too, to my superb 1.10 beta
  767. team:  Marty Bogle, Jim Chapman, Randy Culler, Pax Dickinson, Mike
  768. Fergione, Albin Gersich, Dan Harvey, Jay Jackson, Bud Jamison, Tom
  769. Morgan, John Shepard, and Dan Smith.  Many of the things that *do* work
  770. right in the game are to the credit of these testers and their excellent
  771. feedback.  Naturally, any blame for anything that *doesn't* work is
  772. mine. <g>
  773.  
  774. I've especially appreciated the feedback and encouragement of my key 
  775. testers on The Dreaming City, including Greg Allen, Andrew Crispen, 
  776. Lynn Kastleman, Bob Nelson, Sue Redding, Jeff Hobbs, and Bud Jamison.  
  777. (Yeah, Bud, you get to show up twice.)  The enthusiasm I met on the 
  778. "home front" really made a difference.  I appreciate the help of 
  779. everyone who was involved in the beta process and beta echo; several 
  780. participants in the IRONOX_BETA echo from other beta sites, including 
  781. Rich Paul, Chuck Eaves, and Mark Riel, deserve special mention.  If 
  782. you were involved and I haven't mentioned you, please forgive me:  
  783. It's because I'm an addle-brained programmer, not because I didn't
  784. appreciate your contribution. <g>
  785.  
  786. For ideas and assistance subsequent to the release of 1.00, special
  787. thanks go to Andrew Crispen, who went above and beyond the call of duty
  788. helping me distribute the game and who has made a number of valuable
  789. suggestions for improving it.  Thanks also to Jesse Quijano, who has
  790. made a project of uploading the game to places that would be toll calls
  791. for me.  Most of the people thanked in the paragraphs above deserve to
  792. be thanked again, but that would be pretty repetitive. <g>
  793.  
  794. Thanks to Gerard Droege for many stimulating conversations about 
  795. doorgames and game design, and to Evvie Vincow for putting up with me 
  796. and making countless glasses of iced tea.
  797.  
  798. This door uses the OpenDoors C development system by Brian Pirie.  That 
  799. system has saved me countless worries about the details of talking to 
  800. the modem, reading dropfiles, etc., and I'd highly recommend it to 
  801. any C programmer writing a door.  Starting with version 1.10, this door
  802. also uses the superb MCOMM serial I/O library by Mike Dumdei.  Thanks
  803. also to the original authors of the Commodore 64 game, M.U.L.E. -- part
  804. of the basic design of Iron Ox was inspired by that excellent game.
  805.  
  806. Finally, thanks to Gary Martin, Mehul Patel, and Joel Bergen.  If I 
  807. weren't such a junkie for their games, I never would have started this 
  808. project.
  809.