home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / ox2v3wb2.zip / INTERBBS.DOC < prev    next >
Text File  |  1995-12-01  |  13KB  |  256 lines
  1.                              INTERBBS SETUP
  2.  
  3. One of the most exciting new features of Iron Ox is full support for
  4. interBBS league play.  Ox allows your callers to compete with up to 99
  5. other BBS'es for dominance of the universe!  In order to participate in
  6. an Ox league, you will usually need your BBS to have a connection to the
  7. outside world -- either by Fido mailer or by UUCP/Internet -- but that's
  8. about all it takes.
  9.  
  10. Setting up your BBS to participate in an Ox league is easy; just follow
  11. the step-by-step instructions below to join a league or to start your
  12. own league!  (At the end, we cover some advanced topics like running
  13. maintenance on receipt, setting up UUCP/Internet, running a league
  14. without a mailer, and routing through passive hubs.)
  15.  
  16.                             Joining a League
  17.  
  18. 1. Decide which league you want to join.  InterBBS gaming is very
  19.    popular, so Ox league games may be available in many areas.  If you
  20.    have trouble finding one in your area, or if you're looking for one
  21.    where you can use UUCP, check the list at the end of this document or
  22.    the FidoNet IRONOX echo for help locating a league.
  23.  
  24. 2. The League Coordinator (LC) of your league should provide you with
  25.    two files, OXNODES.DAT and NVDATA.NEW.  Copy both of those files into
  26.    your Iron Ox game directory.
  27.  
  28. 3. (Running INSTALL.BAT will walk you through step three and step four.)
  29.    Run OxConfig to set up your game.  Be sure to visit the League Setup
  30.    menu to tell the game which BBS you are in the nodelist, what league
  31.    number you're a member of, what directory paths to use to interface
  32.    with your mailer/UUCP tosser, and where to send your interBBS game
  33.    packets.  (Don't worry... This all may sound confusing, but online
  34.    help is available for each option.)
  35.  
  36. 4. Run IRONOX /LOCAL /RESET to reset your game.  Assuming that you've
  37.    run OxConfig and set up your IBBS options correctly, the door will
  38.    read the game setup information (map size and so forth) from the
  39.    NVDATA.NEW file your League Coordinator gave you instead of making
  40.    you select it.
  41.  
  42. 5. Get Iron Ox interfacing with your BBS.  See SAMPLE.BAT for several
  43.    sample batch files that may work for your configuration, or look at
  44.    the installation section of SYSOP.DOC for full instructions on
  45.    command-line arguments and so forth.
  46.  
  47. 6. Add a line to run IRONOX /PLANETARY (and IRONOX /MAINT, if you
  48.    haven't added this already) to your nightly maintenance file.
  49.    IRONOX /PLANETARY may be run any number of times per day, but usually
  50.    it needs to be run at least once per day.
  51.  
  52. 7. *IF* you are using UUCP instead of or in addition to Fido to transfer
  53.    packets, see the docs below about "Setting up UUCP."
  54.  
  55. That's it!  You're ready to rock and roll! :-)
  56.  
  57.                             Hosting a League
  58.  
  59. Hosting an Iron Ox league is only a little more work than joining one,
  60. but the sense of dizzying power is easily worth the trouble. <g>  As
  61. League Coordinator, you have just a few more responsibilities than other
  62. members of the league.
  63.  
  64. 1. Create a nodelist of all the systems in the league, using
  65.    OXNODES.SAM as a sample.  Most of the nodelist work is pretty
  66.    mechanical (typing in node numbers, addresses, and so forth).
  67.    Important:  You, as the League Coordinator, must be listed as Node 1
  68.    in the nodelist.  Node numbers may range from 1 to 100.  Having gaps
  69.    in the nodelist is acceptable, but large gaps should be avoided for
  70.    best performance (in other words, you don't want a 3-BBS league with
  71.    numbers 1, 50, and 99...).
  72.  
  73. 2. Rename the nodelist to the name OXNODES.DAT and copy it into the Iron
  74.    Ox directory.  Run OxConfig and access the League Settings menu to
  75.    select your own BBS settings.  (At very least, tell the program which
  76.    BBS you are, choose a league number, and set your directory paths.)
  77.  
  78. 3. Next, run
  79.  
  80.    IRONOX /LOCAL /RESET
  81.  
  82.    to create a new game.  The settings you select for map size, max
  83.    players, difficulty, etc., will apply to every system in the league.
  84.  
  85. 4. When you exit Iron Ox, type
  86.  
  87.    COPY NVDATA.DAT NVDATA.NEW
  88.  
  89.    to create a "Settings File" that other sysops in the league can use
  90.    when resetting their games.  People joining the league will need the
  91.    files OXNODES.DAT and NVDATA.NEW *before* they can start a game for
  92.    the league!  (You will probably want to create a .ZIP file containing
  93.    the current OXNODES.DAT, NVDATA.NEW, and a .DOC file that you can
  94.    give to people who want to join the league.)
  95.  
  96. That's about it!  Iron Ox includes features like automatic nodelist
  97. updates, so any changes you make to OXNODES.DAT will automatically be
  98. sent out to other BBS'es in the league.  Automated reset isn't
  99. implemented yet, so you'll need to send out a new NVDATA.NEW when you're
  100. ready to reset the game -- but then, there's a good chance that a new
  101. version with automated reset will be ready by then. <g>
  102.  
  103.                             ADVANCED TOPICS
  104.  
  105.                          Maintenance on Receipt
  106.  
  107. Many Fido-style IBBS leagues, especially those all in the same area
  108. code, require that inbound packets be processed immediately on receipt
  109. (so that you can't let enemy attacks moulder in your inbound
  110. directory... <g>).
  111.  
  112. Iron Ox fully supports this practice.  To set up "maintenance on
  113. receipt," just add a line to run IRONOX /PLANETARY right before you run
  114. your tosser to import inbound mail, and packets will be processed within
  115. seconds of receipt.  IRONOX /PLANETARY should run fine multinode, such
  116. that it shouldn't even matter if people are in the game on other nodes.
  117. Two warnings for multinode sysops, though:
  118.  
  119. 1. If you run multinode with Fidonet mailers on more than one node, you
  120.    should only set up Ox to do /PLANETARY on one BBS node.
  121.  
  122. 2. By default, IRONOX /PLANETARY runs the game as "Node 0."  If you play
  123.    locally using node 0, you will want to force Iron Ox to use another
  124.    node number for planetary maintenance (one that isn't used by any of
  125.    your nodes) by using IRONOX /PLANETARY /N:x.
  126.  
  127.                             Setting Up UUCP
  128.  
  129. Iron Ox has full support for leagues run via UUCP -- in other words,
  130. through the Internet.  It even supports "mixed leagues" where some
  131. boards are Fido-style systems and some are internet connected, as long
  132. as there's at least one system that runs both to act as a "gateway."  In
  133. order to use UUCP to transfer Ox packets, your system must be set up so
  134. that you can receive e-mail for users (i.e., not just for yourself).
  135.  
  136. In general, if you are drawing Internet e-mail and newsgroups through
  137. UUCP, your system will use a batch file something like this to poll your
  138. internet service provider for mail ("REM" statements added for purposes
  139. of illustration):
  140.  
  141.    CD\TOSSER
  142.    TOSSER /OUT
  143.    REM   WE MAY (OPTIONALLY) RUN "IRONOX /PLANETARY" HERE
  144.    UUCICO -r 10 -s host
  145.    REM   WE *MUST* RUN "IRONOX /PLANETARY" HERE
  146.    TOSSER /IN
  147.  
  148. Naturally, your paths and program names will be different than shown
  149. above, but the basic idea is this:  pack up any outbound mail, poll the
  150. provider, and then process any inbound mail.
  151.  
  152. What you need to do is give Iron Ox a chance to check for special
  153. messages to the game before you import the inbound mail.  To do that,
  154. just add the following line right between the line where you run your
  155. UUCICO program and the line where you run your tosser to import mail:
  156.  
  157.    C:\DOOR\IRONOX\IRONOX.EXE /PLANETARY
  158.  
  159. If you like, you can also run this line right *before* you run your
  160. UUCICO so that new outbound data will go out right away rather than
  161. waiting for your next poll.  This is particularly a good idea if you
  162. only poll your internet provider once or twice a day.  Keep in mind,
  163. though:  while the call to Iron Ox *before* running UUCICO is optional,
  164. the call to it right *after* running UUCICO is not!  Ox can't find your
  165. IBBS packets once they've already been imported into your BBS message
  166. areas. :-(
  167.  
  168. If you have trouble with these instructions or your e-mail setup doesn't
  169. work the way described here, feel free to contact the author at the
  170. e-mail address listed in the sysop docs for further assistance.  The
  171. UUCP support has been tested with Waffle's UUCICO and FXUUCICO; if you
  172. have trouble using it with your UUCICO program, let me know.
  173.  
  174.                        InterBBS without a Mailer
  175.  
  176. Running Iron Ox interBBS without a front door program or UUCP feed is
  177. possible -- you can transfer packets back and forth between BBSes
  178. manually, or use an automation program like Robocomm to handle the
  179. transfers automatically.  The steps are the same for running a normal Ox
  180. league, with the following exceptions:
  181.  
  182. 1. When you create your OXNODES.DAT nodelist, put in fake FidoNet
  183.    addresses for each of the nodes in the list (for instance, 1:1/1,
  184.    2:2/2, and so forth).  Put in NONE for your UUCP addresses.
  185.  
  186. 2. Create subdirectories under your Iron Ox game directory called
  187.    INBOUND, OUTBOUND, and MAIL.  Enter these (e.g.,
  188.    "C:\DOOR\IRONOX\INBOUND" and so forth) for your "Inbound Path,"
  189.    "Outbound Path," and "Netmail Directory" in the OxConfig league setup
  190.    menu.
  191.  
  192. 3. When you run IRONOX /PLANETARY, the game will create outbound packets
  193.    in the OUTBOUND directory and .MSG files (FidoNet-style messages) in
  194.    the MAIL directory.  You may delete the .MSG files; they're not
  195.    needed.  What you need to do is deliver the packets in the OUTBOUND
  196.    directory so that they get to the INBOUND directories on the other
  197.    BBSes -- and, of course, get any packets they have for you and put
  198.    them in your INBOUND directory.
  199.  
  200.    Let's say that there are three boards in the league, and your board
  201.    is number two.  The files that need to go to BBS #1 will match the
  202.    file spec *.01.  The files that need to go to BBS #3 will match *.03.
  203.    So, for instance, you'd need to log into BBS 1 and upload all the
  204.    files you have ending in .01 and download all the files they have
  205.    ending with .02.  On BBS 3, you'd be uploading *.03, and, again,
  206.    downloading *.02.
  207.  
  208. While I can't offer any help configuring file transfer programs or
  209. automation utilities, I'm happy to help with any questions about the
  210. Iron Ox side of the equation.  Good luck!
  211.  
  212.                      Routing Through "Passive Hubs"
  213.  
  214. Some leagues route files through Fido-style networks where not all of
  215. the hubs are participating in the game.  For instance, I may need to
  216. route my game packets to my hub, and my hub (who doesn't run Iron Ox)
  217. may forward the packets to another node which connects to the rest of
  218. the network.
  219.  
  220. To set up a system of this kind with Iron Ox, do the following:
  221.  
  222. 1. Set your OXNODES.DAT file to send packets *directly* to the node who
  223.    connects to the network.  (Your hub doesn't appear in the nodelist,
  224.    so he/she can't be listed as a route-through.)
  225.  
  226. 2. Make certain that you *don't* have Crash status set for Iron Ox
  227.    packets.  If you are using "Crash *" to make Crash status the
  228.    default, use a "Normal x" line to make an exception.  For instance,
  229.    if the system you need to get to is system 5 in the nodelist, use:
  230.  
  231.    Normal 5
  232.  
  233.    to disable Crash status for this system.
  234.  
  235. 3. Many mailers support a ROUTE-FILES keyword or something comparable in
  236.    their route configuration files.  Configure your mailer to route file
  237.    attachments for the other node through your hub.  (The details for
  238.    how to do this vary from mailer to mailer; check your mailer
  239.    documentation for instructions.
  240.  
  241.                             INTERBBS LEAGUES
  242.  
  243. For the most current information on Iron Ox IBBS leagues, check the
  244. FidoNet IRONOX echo.  For people who don't have access to FidoNet,
  245. however, I will include some information on IBBS leagues in this
  246. document.  If you'd like your league to be listed here, let me know!
  247.  
  248. ┌──────────────────────────────────────────────────────────────────────┐
  249. │          IRON OX IBBS LEAGUE LIST -- CURRENT AS OF 11/28/95          │
  250. └───┬─────────────┬────┬────┬─────┬─────────────┬──────────────────────┘
  251. Tag │Network/Title│Fido│UUCP│Nodes│Area         │Contact
  252. ────┼─────────────┼────┼────┼─────┼─────────────┼───────────────────────
  253.  277│ Dragon Net  │ Yes│ Yes│ 22  │ U.S./Canada/│ 1:202/704 or 1:137/217
  254.     │ (Zone 277)  │    │    │     │ Internet    │ joel@dreamcty.cts.com
  255. ────┼─────────────┼────┼────┼─────┼─────────────┼───────────────────────
  256.