home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FAIR407.ZIP / SYSOP1.DOC < prev    next >
Encoding:
Text File  |  1996-05-27  |  22.1 KB  |  558 lines

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