home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09963.iso / fun / nbs.zip / README.TXT < prev   
Text File  |  1996-08-14  |  7KB  |  136 lines
  1. Network Beverage Selector
  2.  
  3. Written by Tony Imbierski (tony.imbierski@uvo.mts.dec.com)
  4. V2.2 14th August 1996
  5.  
  6. The Network Beverage Selector solves the never ending problem of whose turn it is to get the coffees in. 
  7. NBS selects a victim and keeps track of how many drinks each participant has bought and how may they 
  8. have drunk. It uses this information to bias the next selection towards those who haven't bought their fair 
  9. share.
  10.  
  11. System Requirements
  12.  
  13. Networked PC's running Microsoft Windows 95 or Microsoft Windows NT (Intel x86 or DEC Alpha)
  14.  
  15. NBS is designed to be run from a shared directory on a server.
  16.  
  17. Setting Up
  18.  
  19. The program is distributed in ZIP format using the dos version of PKZIP. Some of the program files have 
  20. file names longer than 8.3 that are munged by PKZIP. After unzipping, run LFN.BAT to restore the long 
  21. filenames.
  22.  
  23. Enter the names of  the participants in the file NBS.INI. You may also set other parameters in this file 
  24. (described later). All participants must use the same shared copy of NBS.INI and it must reside in the 
  25. same directory as the NBS.EXE executable. Copy all the files to your network server and you are ready 
  26. to go!
  27.  
  28. (To reduce network overhead, .WAV files may be stored locally to each PC, see the description of 
  29. WavPath below)
  30.  
  31. Command Line Switches
  32. The following switches can be used in any combination (leave spaces between them!)
  33.  
  34. NBS /NAME:"TONY IMBIERSKI" 
  35. Starts NBS using the given round member's name. This bypasses the startup dialog. Note the name must 
  36. be enclosed in double quotes, but capitalisation is not important. If the name given is not present in 
  37. NBS.INI then the program will not start.
  38.  
  39. NBS /WAVPATH:C:\NBS
  40. If your wav files are kept in a different directory to the one specified in NBS.INI then use this switch to 
  41. override.
  42.  
  43. NBS /RESET
  44. NBS will detect if it is already running and will refuse to start a second instance on the same machine. 
  45. However if for any reason NBS terminates abnormally it may refuse to restart, saying that it thinks it is 
  46. already running. If this happens, start NBS with the above switch to override.
  47. NBS.INI settings
  48.  
  49. You should only modify entries in the sections [NAMES] and [GENERAL].
  50.  
  51. [NAMES] 
  52. NAME0=Drinker1
  53. NAME1=Drinker2
  54. NAME2=Drinker3
  55. NAME3=Drinker4
  56. .
  57. .
  58. .
  59. NAME9=Drinker9
  60.  
  61. Enter the names of your participants. Spaces are allowed, so you can use FIRSTNAME LASTNAME or 
  62. whatever combination you like.
  63.  
  64. [GENERAL]
  65. Beverage=Tea    
  66.  This is the name of the drink you have.
  67. Round=Tea Selector
  68.  This is the name of your round. If multiple groups use the program on the same network, the program   
  69. uses the setting of Round to distinguish one from another.
  70. PauseTime=350           
  71. This controls the time the program takes to select a victim. If you want the program to finish faster,  
  72. make this value smaller.
  73. PointsToWin=30    
  74.  This controls how long the selection process lasts. If you want the program to finish faster, make this   
  75. value smaller.
  76. SelectionWaitTime=10   
  77.  When someone proposes a round, the program waits this number of seconds to allow people to join or    
  78. leave the round before it starts.
  79. MessagePopup=1 
  80.   When a text message is sent the program restores itself if it was minimised and comes to the front of   
  81. the screen (in front of any other applications). If you don't want this, set this value to 0. However, you
  82. may then miss messages from other drinkers if the application is covered by windows.
  83. CountdownPopup=1       
  84.  Similar to the above, the program will force itself to the front during countdown to a round unless this 
  85. value is set to 0. This is to ensure that everyone in your round knows it is taking place.
  86. StatusTime=30000         
  87.  Computers running NBS verify their status with each other every so many milliseconds according to 
  88. this parameter. 30000 = 30 seconds.
  89. DisconnectTimeout=3    
  90.  If a computer hasn't verified it's status within this number of StatusTime periods, it is assumed to have 
  91. gone away and is disconnected from the round. Eg if StatusTime is 30000 (30 sec) and 
  92. DisconnectTimeout is 3, computers are timed out after 90 seconds. Disconnected users are marked as 
  93. "Timeout" on the main screen.
  94. DisconnectReset=6        
  95. After being timed out, if this number of StatusTime periods passes with still no update the computer is 
  96. marked "offline".
  97. RandomFactor=8
  98.  This sets a base level for the bias of each round. The higher it is the more truly random a selection will 
  99. be. The lower it is the more the selection will be biased against people who haven't bought their fair 
  100. share.
  101. Sound=1                   
  102.  1=play sounds, 0=don't. The program looks for wav files with the same name (including any spaces) as 
  103. your participants. Eg if Name1=Tony Imbierski then the program looks to play "Tony Imbierski.wav" 
  104. whenever Tony Imbierski is selected as victim. You will need to record wav files with the names of your 
  105. participants.
  106. Commentary=0              
  107.  1=running commentary, 0=no commentary
  108. WavPath=.\
  109.  Normally the program looks for wav files in the same directory as the NBS.EXE executable, which is 
  110. normally on a network server. However, since some of the wav files may be large, you can copy them to 
  111. a local directory on each computer and set the WavPath to this directory. This saves the network 
  112. bandwidth of all your participants loading the wav file from the server every time the program wants to 
  113. play a wav. Beware, though, that since everyone must read the same copy of NBS.INI, the wav path 
  114. must be the same for all users (eg C:\NBS). If this is not possible, individual computers can override 
  115. this setting using the command line switch /WAVPATH.
  116. SoundMode=RANDOM
  117. During selection, the program will play any wav file matching the name PROGRES*.WAV. This is done 
  118. in one of two ways according to the setting of this parameter:
  119. RANDOM: Play any one of the proges*.wav files randomly.
  120. BIAS: Play a specific wav file according to the round member with the highest bias. Eg if round 
  121. member 3 has the highest bias, the 3rd wav file (in alphabetical order) will be played.
  122.  
  123. The other sections of NBS.INI are used to store running totals for each round, so you must keep the same 
  124. copy of NBS.INI to preseve this information between rounds. Also, all users must have write access to this 
  125. file in order to update the round statistics after each round.
  126.  
  127. If the program detects that two computers are using different copies of NBS.INI, it will not allow 
  128. them to communicate. Thus if you find you cannot see your fellow round members as ONLINE, check 
  129. that you are all running the same shared NBS.INI.
  130.  
  131. Frequently Asked Questions
  132.  
  133. Q: Does the program run on Windows 3.1 or 3.11?
  134. A: No
  135.  
  136.