synchro.net/synchro.net.tar/synchro.net/main/BBS/GWAR30.ZIP/HOF.DOC

Text File | 1996-11-30 | 5.8 KB | 127 lines

                               GLOBAL WAR
                               ~~~~~~~~~~
                    Copyright 1989-1997 Joel Bergen
             ProVision BBS: [phone] & [phone]
                            Fidonet 1:343/65

DESCRIPTION
~~~~~~~~~~~
HOF is a Hall Of Fame utility for Global War.  It requires Global War
version 3.0 or later.  This program will create a BULLETIN.ANS bulletin
file which will display the last 6 winners of the Hall of Fame.

HOW DOES IT WORK
~~~~~~~~~~~~~~~~
Global War can be configured to automatically reset your rankings
whenever a player reaches a certain rank (usually 5-Star General).  See
WAR.CFG lines 35 and 29. When a player reaches this rank, the
WINNERS.WAR file (the file in which rankings are stored) is saved under
the name of WINNERS.TOP and then WINNERS.WAR is deleted so that the
rankings can start over again.  What HOF does is read this WINNERS.TOP
file to get the top player's name. The top player's name is then added
to your BULLETIN.ANS file (Global War's opening bulletin).  HOF will
keep track of the last 6 players to win the Hall of Fame.  Players will
enjoy competing to see who will have the glory of seeing their name "up
in lights".

INSTALLING HOF
~~~~~~~~~~~~~~
If you participating in an InterBBS network, do NOT install HOF unless
you are the Hub of the network.  If you are the Hub of an InterBBS
network, simply make sure that HOF.EXE and HOF.ANS exist in your Global
War directory - nothing else needs to be done. If you are a Node in an
InterBBS network, do not use HOF (HOF is only used on the Hub). Delete
HOF.EXE, HOF.DOC, and HOF.ANS if they exist in your Global War
subdirectory. See GWIBBS.DOC for more info on Global War InterBBS
networks.

If you are NOT in an InterBBS network, then you may install HOF as
follows:

Copy HOF.EXE and HOF.ANS into your Global War subdirectory (the same
subdirectory where you have WAR.EXE). Next, edit your WAR.BAT file (or
whatever you have named your batch file that executes Global War).  Add
two lines to your batch file as follows:

cd \bbs\globlwar
war /r \bbs\dorinfo1.def
if exist winners.top hof              <- add this line
if exist winners.top del winners.top  <- and this line
cd \bbs

CUSTOMIZING HOF
~~~~~~~~~~~~~~~
When HOF executes, it does the following steps:

1. Reads HOF.DAT to get the names of past Hall of Famer's.
2. Deletes the oldest name from the list to make room for the new winner.
3. Reads WINNERS.TOP to get the name of the new winner.
4. Saves the new name list to HOF.DAT.
5. Reads HOF.ANS into memory.
6. Adds the 6 names & dates to the copy of HOF.ANS in memory.
7. Writes BULLETIN.ANS (overwriting it if it exists).

HOF.ANS is your template writing BULLETIN.ANS.  You may edit HOF.ANS if
desired.  I recommend using an ansi file editor such as TheDraw to edit
HOF.ANS.  When you edit HOF.ANS you'll see something like this:


                          Global War InterBBS
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 ░▒▓████▓▒░░▒▓█▓▒░░▒▓█▓▒░     HALL OF FAME     ░▒▓█▓▒░░▒▓█▓▒░░▒▓████▓▒░
  ════════════════════════════════════════════════════════════════════
 │ 11111111111111111 from UUUUUUUUUUUUUUUUU Awarded AAAAAAAAAAAAAAAAA │
 │ 22222222222222222 from VVVVVVVVVVVVVVVVV Awarded BBBBBBBBBBBBBBBBB │
 │ 33333333333333333 from WWWWWWWWWWWWWWWWW Awarded CCCCCCCCCCCCCCCCC │
 │ 44444444444444444 from XXXXXXXXXXXXXXXXX Awarded DDDDDDDDDDDDDDDDD │
 │ 55555555555555555 from YYYYYYYYYYYYYYYYY Awarded EEEEEEEEEEEEEEEEE │
 │ 66666666666666666 from ZZZZZZZZZZZZZZZZZ Awarded FFFFFFFFFFFFFFFFF │
  ════════════════════════════════════════════════════════════════════
  ░▒▓██▓▒░  ░▒▓▒░ ░▒▓█▓▒░  ┌──┴────────┴──┐    ░▒▓█▓▒░ ░▒▓▒░  ░▒▓██▓▒░
  ░▒▓██▓▒░ ░▒▓█▓▒░ ┌───────┴──────────────┴───────┐   ░▒▓█▓▒░ ░▒▓██▓▒░
 ░▒▓████▓▒░ ┌──────┴──────────────────────────────┴────────┐ ░▒▓████▓▒░
 ┌──────────┴──────────────────────────────────────────────┴──────────┐
 │  When a player reaches 5-Star General his name will be added to    │
 │        this hall of fame and the rankings will be reset.           │


Note the filds "11111111111111111", "AAAAAAAAAAAAAAAAAA",
"22222222222222222", and so on.  These define where HOF is to place the
player's names, BBS names, and the dates in which they won the Hall of
Fame.  The "111..." field is where the last player to win the Hall of
Fame's name will be placed. "UUU..." is where the BBS name that the
player was playing on is placed (used in InterBBS games). "AAA..." is
where date that the player won the hall of fame will be placed. His
predecessor's name will be moved down to the "222..." field, with his
predecessor's date moving to the "BBB..." field and so on.  Note that
there are a total of 17 1's, 17 A's, 17 2's etc in the file.  There must
be exactly 17 characters, no more, no less. You may change HOF.ANS any
way you like, but these 18 17-character fields must be somewhere in the
file.

When you save HOF.ANS, it is recommended that you do not clear the
screen.  In TheDraw, save the file using the following steps:

        Hit Alt-B
        Move the cursor to the upper left corner of the picture
        Hit the spacebar
        Move the cursor to the lower right corner of the picture
        Hit the spacebar
        Select S)ave
        Select A)nsi
        Select N)one
        Press ENTER
        Press ENTER
        Type in the filename HOF.ANS

IN CONCLUSION
~~~~~~~~~~~~~
I hope you find HOF useful and that your players enjoy competing for
glory as much as mine do.  This program is free.  Please pass it on to
other sysops. If you have any comments or suggestions I'd love to hear
them.  I can be contacted at my BBS.  The numbers are posted at the top
of this file.

                            Happy Wargaming!
                              Joel Bergen