home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / FAIR403.ZIP / SYSOP1.DOC < prev    next >
Text File  |  1995-11-30  |  21KB  |  534 lines
  1. If you are running LORD County Fair, IGM, DO NOT INSTALL THIS IN THE
  2. SAME DIRECTORY unless you UNINSTALL IT FIRST! Since this is a wide
  3. beta, you may wish to install this in a separate directory and use
  4. both versions for a while until this one seems stable on your system.
  5.  
  6. REGISTERED USERS OF LFAIR31.ZIP or EARLIER!!
  7. NOTICE TO REGISTERED FAIR USERS! This upgrade version requires a new KEY
  8. since someone hacked my other FAIR key. All upgraded keys are FREE!
  9. Simply send a self-addressed stamped envelope for your key or write me
  10. in the SHINING*STAR support echo to put your key on hold for pickup,
  11. or write me at my internet address (nannette@southwind.net) to send your
  12. key via internet. I know.... I know... it's a hassle for ALL of us. :(
  13.  
  14. MOONDUST'S COUNTY FAIR:
  15.  
  16. NOTICE! If you are TIGHT on memory, do NOT try to install this via DesqView
  17. or a networked system. You may use Desqview or the Network AFTER the install, 
  18. but take them down during install. The install routine creates the majority 
  19. of databases and this uses a lot of memory.
  20.  
  21. Quick and Easy install:
  22. 1. Create a unique directory for COUNTY FAIR with any name.
  23. 2. Unzip this archive within that directory.
  24. 3. Type:
  25.    INSTFAIR SYSOP
  26.    Do item #1, and item #2. 
  27.    
  28.    UPGRADES UPGRADES UPGRADES: If Upgrading, do item #2 only via
  29.    Sysop mode. 
  30.  
  31. 4. If you wish to run as an IGM for LORD answer Yes to the question
  32.    in item #1 when it asks if you wish to run it as an IGM.
  33. 5. See the sample.bat file for setting up as a standalone game for
  34.    your non-LORD playing players. Both standalone and IGM will use the
  35.    same game from the same directory at the same time. Yeah!
  36.    Your players will need to choose if they wish to play it as an IGM
  37.    or as a standalone. They will be allowed to enter once per day.
  38. 6. For further details, keep reading.
  39.  
  40. This games will not be supported if you wish to run it using LORD's
  41. local mode from the DOS prompt. You must load it via your BBS so a drop
  42. file will be created, if you wish to run it from a local node. If you
  43. wish to run COUNTY FAIR locally, just type: FAIR local "Your Name"
  44.  
  45. CONTENTS:
  46. ──────────────────────────────────────────────────────────────
  47. LORD IGM OR STANDALONE
  48. RUNNING WITH MULTIPLE LORD GAMES
  49. SYSOP MODE
  50.    INSTALLATION
  51.    NEW INSTALLATIONS
  52.    UPGRADE
  53.    UNINSTALL
  54.    REGISTER
  55.    RESET
  56. SYSOP2.DOC
  57. MAINTENANCE
  58.    NIGHTLY MAINTENANCE
  59.    MONTHLY RESET
  60.    RESET
  61. Sample Door Batch File for Standalone Mode
  62.    OPTIONAL CUSTOM CONFIG FILES
  63. CONFIG FILES
  64. Local Mode
  65. Running from Type 7 Shell to DOS
  66. MULTI-NODE FAIR
  67. MULTI-NODE SUPPORT
  68. SHAREWARE -- TRYING IT OUT
  69. Full Features in the Registered Version
  70. Benefits of registering
  71. SYSOP PAGING
  72. ERRORS/PROBLEMS
  73.  
  74. LORD IGM OR STANDALONE:
  75. ──────────────────────────────────────────────────────────────
  76. COUNTY FAIR:
  77. can be played as an IGM for LORD or as a standalone game
  78. or both at the same time. If a player enters FAIR from "Other
  79. Places" within LORD, the gold and experience they have earned
  80. for the day (as well as other items of value) will be passed
  81. back into their player record for LORD.
  82.  
  83. If you have players who do not play LORD, they can still get
  84. in on the fun of playing FAIR without having to enter LORD.
  85. Set up a menu item for COUNTY FAIR and set it
  86. up as a regular standalone game. All LORD related menu items
  87. will be disabled for them. LORD players and non-LORD players
  88. can play the game at the SAME time, competing with one another!
  89.  
  90. RUNNING WITH MULTIPLE LORD GAMES:
  91. ──────────────────────────────────────────────────────────────
  92. If you choose to run this IGM with multiple LORD games, you
  93. should have a different directory with a different game for
  94. each version of LORD you are running as well. This game only
  95. allows players to enter once per day.
  96.  
  97. INSTALLATION:
  98. ──────────────────────────────────────────────────────────────
  99. COUNTY FAIR SHOULD NOT be loaded in the LORD
  100. directory. It should be loaded in its own directory with ANY name,
  101. ANYWHERE on the system! Pains have been taken to ensure that file
  102. names will be unique so as not to copy over any LORD files, if you
  103. do accidentally unzip this archive in your LORD directory (except
  104. for the REGISTER.DOC), so if you did unzip in the LORD directory,
  105. type INSTFAIR SYSOP and use UNINSTALL to remove the COUNTY FAIR files.
  106. Then create a new directory and install it in there.
  107.  
  108. This game must be loaded in its own unique directory.
  109. Unzip the archive in the unique directory created.
  110.  
  111. SYSOP MODE:
  112. ──────────────────────────────────────────────────────────────
  113. FAIR SYSOP
  114.  
  115. NEW INSTALLATIONS:
  116. ──────────────────
  117. Type:
  118. INSTFAIR SYSOP
  119. For new installations, you must do item #1, creating the needed
  120. installation files.
  121.  
  122. You must also do item #2, installing and setting attributes for
  123. the needed files.
  124.  
  125. If you are runnin WindowsNT, the file system does not support the dos
  126. attributes command and you will need to manually set the attributes for
  127. these types of files to READ ONLY:
  128. *.EXE
  129. *.ANS
  130. *.TXT
  131. If you are upgrading, you will need to undo the read only attribute before
  132. running #2 for the upgrade. Then you will need to set them again after.
  133.  
  134. UPGRADE:
  135. ────────
  136. Type:
  137. INSTFAIR SYSOP
  138. You must do item #2, installing and setting attributes for the
  139. needed files.
  140. 1. You will be asked if you wish to run with or without a fossil
  141.    driver. A fossil driver such as X00 or BNU is recommended for
  142.    best system operation, but use with no fossil is supported.
  143.    After answering this question, config.cfg will be created with
  144.    ; NoFossil
  145.    or
  146.    NoFossil
  147.    in the file. If you wish to add more unusual settings pertaining
  148.    to IRQ's, etc. see the section in the documention on the config.cfg
  149.    file.
  150. 2. You will be asked if you wish to run this as a LORD IGM. If you
  151.    answer yes, the correct lines will be added to the 3rdparty.dat
  152.    file in the LORD directory. You will input the path to the LORD
  153.    directory. The system will check for a valid directory by looking
  154.    for lord.exe. If this is not found, it will exit and ask you to
  155.    find the correct lord path.
  156. 3. MOONCHAT is a new feature which will be added to all Shining
  157.    Star Software games and doors. This will allow users to page and
  158.    chat multi-node with one another while on-line and using any
  159.    SSS game or door. Select a desired directory where you wish to
  160.    load the MOONCHAT files. When you upgrade to a SSS door with
  161.    this feature, use the same path for all SSS doors so that users
  162.    can chat and page one another no matter what SSS door they are
  163.    using.
  164. 4. Bulletin file path and names. You will be asked for the path and
  165.    name to your ansi bulletin file and to your ascii bulletin file.
  166. 5. You will be asked how many nodes you run and the path and name
  167.    of the drop file for each node. If you copy your drop file to
  168.    your game directory, DO NOT enter the path, just the drop file
  169.    name.
  170.  
  171. UNINSTALL:
  172. ──────────
  173. After installation, if you wish to uninstall, type:
  174. FAIR SYSOP
  175. And select the Uninstall option.
  176.  
  177. REGISTER:
  178. ─────────
  179. If you are registered. Make sure you have your key handy.
  180. After installation, type:
  181. FAIR SYSOP
  182. Select the Register option.
  183.  
  184. RESET:
  185. ──────
  186. Use this option if you wish to delete all players and reset the
  187. game. The high scorers list will be retained.
  188. Type: FAIR MAINT R
  189.  
  190. ──────────────────────────────────────────────────────────────
  191. For legal junk, support and sysop commands, read SYSOP2.DOC
  192. ──────────────────────────────────────────────────────────────
  193.  
  194. ──────────────────────────────────────────────────────────────
  195. NIGHTLY MAINTENANCE:
  196. ────────────────────
  197. This game uses databases. To keep it cleaned up, delete old
  198. records, and reindex databases, maintenance must be performed
  199. in your nightly maintenance batch file:
  200. FAIR MAINT
  201.  
  202. MONTHLY RESET:
  203. ──────────────
  204. COUNTY FAIR can be played for contests. If you
  205. begin your contest on the first of each month, you can have
  206. it automatically reset every month by using this in your
  207. nightly maintenance file:
  208. FAIR MAINT M
  209.  
  210. RESET:
  211. ──────
  212. If you wish to start your contest in the middle of the month
  213. and wish to reset the game at any time, you may delete all
  214. players and reset the game by running this from DOS:
  215. FAIR MAINT R
  216.  
  217. Sample Door Batch File for Standalone Mode
  218. ──────────────────────────────────────────────────────────────────────
  219. See the sample.bat file for setting up a standalone game.
  220. Example:
  221.  
  222. @echo off
  223. cd\games\FAIR
  224. FAIR game 1
  225. cd\pb\node1
  226.  
  227. or
  228.  
  229. @echo off
  230. cd\games\lord\FAIR
  231. FAIR game %1
  232. cd\pb\node%1
  233.  
  234. In the above example:
  235. Change to the FAIR directory.
  236. Call the .exe name:
  237. FAIR
  238. The Second Parameter tells the game whether you are running as a LORD
  239. IGM or as a standalone game.
  240. If running as a standalone game, the second parameter will be "game."
  241. The third parameter is the node #. You may use a macro for the node
  242. number or pass it as the actual number if single node or if creating
  243. a separate .bat file for each node.
  244.  
  245. If you answer "yes" during installation that this is to be run as an
  246. IGM, the command lines will automatically be added to your LORD
  247. 3rdparty.dat file:
  248. In the 3rdparty.dat file for IGMs, the second parameter will be "lord."
  249. In the 3rdparty.dat file for LORD IGMs, the node number will show as "*".
  250.  
  251. OPTIONAL CUSTOM CONFIG FILES
  252. ────────────────────────────
  253. If your system requires unusual settings be added to your *.cfg file,
  254. you may obtain customized information in the sample.cfg file. Rarely,
  255. but sometimes, a system might require a separate .CFG file per node.
  256. If this is true for you, create a separate .CFG file for each node
  257. and name them:
  258. CONFIG1.CFG
  259. CONFIG2.CFG
  260. CONFIG3.CFG etc.
  261. Then, on the command line pass this parameter at the end like so:
  262.  
  263. FAIR game 1 custom
  264.  
  265. This will tell the system to NOT look for CONFIG.CFG, but instead to look
  266. for custom .CFG files with the number of the appropriate node as above.
  267.  
  268. If running as a LORD IGM, edit the 3rdparty.dat file and add the word
  269. "custom" to the end like so:
  270. c:\games\FAIR\FAIR lord * custom
  271.  
  272.  
  273. CONFIG FILES:
  274. ──────────────────────────────────────────────────────────────────────
  275. DO NOT ALTER THE *.CFG FILE(S) UNLESS YOU HAVE SPECIAL CONSIDERATIONS!
  276. IF you do need to alter the .CFG file(s), please see the SAMPLE.CFG
  277. for instructions on options which you may add to your CONFIG.CFG file.
  278.  
  279. NOTE: THE SAMPLE.CFG FILE IS NOT NECESSARY IN 99% OF ALL CASES.
  280. It allows you to optionally customize the game if you wish to use
  281. unusual IRQs or PORTS, etc.
  282. The file to refer to is the sample.cfg file. Most BBS systems will have no
  283. need of looking at this file. If you DO need any of the options in the
  284. sample.cfg file, simply add them at the bottom of your existing CONFIG.CFG
  285. file.
  286.  
  287. Local Mode
  288. ──────────
  289. The door can be tested in Local Mode before setting up your .bat file(s):  
  290.  
  291. FAIR local "Your Name"
  292.  
  293. If you just type:
  294. FAIR local
  295. The system will default to "Sysop" as your name. Within the game you will
  296. be asked to give an alias for play.
  297.  
  298. If your entire family is playing locally, each one can pass their real
  299. name on the command line for identfication and then if they play via
  300. the BBS as well, it will use the same record for play.
  301.  
  302. Running from Type 7 Shell to DOS
  303. ────────────────────────────────
  304. FAIR can be run from your bbs with a type 7 shell to dos. An example
  305. command line within your BBS system config would be:
  306.  
  307. Quickbbs:
  308. command.com /c FAIR.bat or
  309. command.com *C FAIR.bat
  310.  
  311. Proboard:
  312. *Z FAIR.bat
  313.  
  314. COUNTY FAIR runs on MANY, MANY BBS systems, the above
  315. two are JUST examples.
  316.  
  317. MULTI-NODE FAIR:
  318. ─────────────────
  319. CALL FAIR MULTI-NODE THE SAME AS SINGLE NODE.
  320.  
  321. The drop file paths and names are setup when you first install FAIR.
  322. Drop file path and name information is stored in:
  323. SETUP.FIL
  324. The 15th line of SETUP.FIL contains the drop file path and name for
  325. node 1. The next line for node 2, the next line for node 3 and so on.
  326. If you wish to alter the drop file path and names or add nodes,
  327. please edit the SETUP.FIL with a normal text editor for alteration.
  328.  
  329. MULTI-NODE SUPPORT
  330. ──────────────────
  331. FAIR is a true Multi-User Door Game. It supports multi-nodes. We have
  332. tested it on six nodes successfully, and I'm sure it will support even more.
  333.  
  334. Chat feature allows sending public or private messages to other on-line
  335. players. It also features "rewinding" up to 9 messages and "putting messages
  336. on hold" to "play back" later. The score list shows "who's on line" and 
  337. from what "node" they are calling.
  338.  
  339. The installation automatically takes care of setting the *.exe, *.ans,
  340. and *.txt files to READ ONLY. This is necessary for multi-user play since
  341. users will get a sharing violation if they try to access those files at
  342. the same time from within the game. This is a (hak kaff) "feature" of
  343. using Turbo C/C++ as a compiler. Sorry. ;)
  344.  
  345. FAIR will use the record locking options built into SHARE from MS DOS
  346. 3.30 or later. Or you may use your Network's Sharing capabilities.
  347.  
  348. SHAREWARE -- TRYING IT OUT
  349. ──────────────────────────
  350. You may run FAIR from DOS to try it out first. Just issue the
  351. following command from dos: 
  352.  
  353. FAIR local
  354.  
  355. The non-registered version allows you to experience EVERYTHING in
  356. the REGISTERED version...BUT instead of getting the full number of
  357. Quests, users will only be allowed to go on 3 quests which will
  358. reloop. Once the game is registered, they can REALLY get into
  359. some competition by tackling all the Quests.
  360. There is no expiration date. There is no request to remove it from 
  361. your system after so many days.
  362.  
  363. When you can afford to register, all you will need to do is plug in a 
  364. number. You won't need to install a new EXE. You won't need to download
  365. a key every few weeks. Your key will be valid for new versions. All
  366. upgrades are FREE. *We reserve the right to change keys if we find our
  367. key has been hacked and released to others. In that case we will notify
  368. you of the new key when the new version comes out.
  369.  
  370. Everything is fully tested for many weeks before final release.
  371.  
  372. Full Features in the Registered Version
  373. ────────────────────────────────────────
  374.    You are not limited to a trial time period.
  375.    You may keep the unregistered version on your BBS as long as you wish.
  376.    Yet, remember, this is NOT FREEWARE, it is SHAREWARE, and at such a
  377.    time as you can afford the SHAREWARE registration fee, please send it.
  378.  
  379.    The game is fully functional, but with the registered version, your
  380.    users will get more Quests.
  381.  
  382. Benefits of registering
  383. ───────────────────────
  384.  
  385.    1. More Quests!
  386.    2. All future updates FREE when freqed from BBS's carrying the files.
  387.    3. Author support.
  388.    4. Top priority for suggested game features and enhancements.
  389.  
  390.  
  391. SYSOP PAGING:
  392. If you wish to allow sysop paging, please add the following section of
  393. text, altered according to your wishes to the CONFIG.CFG file(s).
  394.  
  395. ;------------------------------------------------------------------------------
  396. ;
  397. ;  Sysop paging hours. Sysop paging will be permitted beginning at the start
  398. ;  time, up until, but not including, the end time. Times should be in 24-hour
  399. ;  format. To disable paging on a particular day, set the paging start and end
  400. ;  times to the same time.
  401. ;
  402. ;                      Start Time    End Time
  403. SundayPagingHours         9:00        22:00
  404. MondayPagingHours         8:30        22:00
  405. TuesdayPagingHours        8:30        22:00
  406. WednesdayPagingHours      8:30        22:00
  407. ThursdayPagingHours       8:30        22:00
  408. FridayPagingHours         8:30        22:00
  409. SaturdayPagingHours       9:00        22:00
  410. ;
  411. ;------------------------------------------------------------------------------
  412. ;
  413. ;  Duration of sysop page. Value indicates the number of beeps that compose the
  414. ;  sysop page alarm.
  415. ;
  416. PageDuration    10
  417. ;
  418. ;------------------------------------------------------------------------------
  419.  
  420. ERRORS/PROBLEMS:
  421. ────────────────
  422. If you get an error -70 during packing and reindexing of a database,
  423. refer to the database name on the screen. That error will happen if someone
  424. else is using the game while you are trying to do maintenance on the
  425. other node.
  426.  
  427. If that is NOT the problem, then that database is probably corrupted.
  428. If you run "FAIR MAINT" and it happens again, you will need to
  429. unarchive the game and replace the corrupted files.
  430.  
  431. If your remote callers get aschii dumped characters on the screen when
  432. playing, but locally it looks okay:
  433. If you have a config.cfg file, please edit it and make sure anything
  434. referring to Personality is totally deleted. For some reason on some
  435. systems the Personality profile causes this to happen.
  436. Deleting it seems to resolve the problem.
  437.  
  438. ERROR -120: This error occurs when your disk is full. Check and make
  439. sure you have a lot of hard disk memory. Perhaps you're getting low.
  440. Clear up some hard disk space.
  441.  
  442. ERROR -200, -300, -310: One of your database files or indexes is 
  443. probably corrupted.
  444. Run the nightly maintenance. If that fails, you will have to delete
  445. your entire directory and unarchive the original and install it new.
  446. To uninstall the entire directory, enter sysop mode:
  447. FAIR SYSOP
  448. And use the Uninstall option.
  449. If you are registered, make sure you have a backup of your key, it
  450. is stored in the file: reg.key.
  451.  
  452. ERROR -920: Out of memory. The game tried to allocate memory from the heap,
  453. but no memory was available.
  454.  
  455. When entering IGM from LORD, it says:
  456. "Screw it! .... is missing!"
  457. You didn't do the INSTFAIR SYSOP item #2 for updating or installing the files.
  458. Make sure when you upgrade or install that you do #2:
  459. INSTFAIR SYSOP
  460. If this is a new installation, you must also do item #1. Order doesn't matter.
  461.  
  462. I will NOT try to offer support of this game when used with a
  463. wide beta release of LORD. Don't report bugs to me unless
  464. they are reproduced in a working non-beta version of LORD.
  465.  
  466.  
  467. INSTALLATION PROBLEMS: Here is a letter and reply from someone who as having
  468. installation problems:
  469.  
  470.  >     I tried to set up your new IGM, but apparently
  471.  > have some corrupted .dbf files. At first I couldn't
  472.  > even get it to install correctly. Finally had to get
  473.  > out of DESQview and QEMM to get the install to finish
  474.  > renaming the INSTFAIR executable.
  475. The installation routine actually creates the majority of the databases to 
  476. keep the archive small. The creation process can be memory intensive. If you 
  477. are installing it from within desqview or from a network, it may be that 
  478. your memory is so low that it cannot finish creating the databases.
  479.  
  480. Even if you went back in to finish up, the database that had trouble being
  481. created would not work for you.
  482.  
  483.  >     Once it had done this I figured I was all set.
  484.  > Yet, when I tried to fire up the game, it began to
  485.  > give me an error. The Error Number was -330 Tag Name
  486.  > Not Found. TAG_MC_ALIAS  <Press A Key> After a few key
  487. Yes, this indicates the moonchat.dbf or moonchat.cdx was either not created, 
  488. or partially created and is corrupt.
  489.  
  490.  > presses I would get another line of text saying: Talk
  491.  > defined with nothing to say! 197108  I then ran the
  492.  > nightly maintenace as recommended to fix the
  493.  > databases, but it still did the same thing. I then
  494. Unfortunately, the nightly won't fix this kind of problem.
  495.  
  496.  > uninstalled and did a complete reinstall with the same
  497.  > results. I figure maybe I have a bad file somewhere. I
  498. Sounds like you again tried to uninstall via DesqView?
  499.  
  500.  > am running Wildcat 3.90 Multi-Line using DESQview
  501.  > v2.62 and QEMM v7.04. I have 12 meg of RAm and I am
  502.  > running the LORD game in a 4 meg RAM cache. I would
  503. RAM cache? Where did you place moonchat? On an area on your hard drive or 
  504. in a temporary cache? It needs to be permanent.
  505.  > like to get this running and register both IGMS for
  506.  > the $20 that you offered. I can do it snail mail can't
  507.  > I? My credit card is taking a rest right now. <vbg>
  508. Yes, mail is fine.
  509.  >     Hope to hear from you soon! I am FREQ'ing the file
  510.  > from you and going to try it again. Thanks for your
  511.  > time...
  512. Here is my suggestion:
  513. Do *NOT* install from within desqview. Take it down and do it when no one is
  514. on-line. I know this is a hassle, but evidentally, you just don't have the
  515. memory for the install routine if done via Desqview.
  516. FAIR uses databases and the database creation routine is just a memory
  517. hog!! I use the codebase library for creation of these. It should work with
  518. just doing it from dos and no desqview loaded taking up all your memory. If 
  519. you had stuff in your moonchat directory when you tried to reinstall, it 
  520. would not try to recreate the files again, and you'd still be working with 
  521. old files. So when it asks you if you want to uninstall moonchat portion, 
  522. say yes.
  523.  
  524. Run the uninstall. Check the 3rdparty.dat file and make sure
  525. all references to FAIR are gone. Check the Moonchat directory and make 
  526. sure everything in it is gone. Check the FAIR directory and make sure 
  527. all is gone.
  528.  
  529. Then unarchive in the FAIR directory again. Run your first test from DOS by
  530. typing: FAIR sysop "Your Name"
  531. This will go in and make sure all is running and created correctly. Not usually
  532. necessary, but might as well. Then you can load up desqview and go from there.
  533.  
  534.